Porque é que o Immich deixa de devolver fotografias privadas pesquisáveis depois de um reinício?

Eva Wong é a Redatora Técnica e e entusiasta residente na ZimaSpace. Uma geek de longa data com paixão por homelabs e software de código aberto, ela é especialista em traduzir conceitos técnicos complexos em guias acessíveis e práticos . Eva acredita que o auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ela capacita a comunidade adesmistificar configurações de hardware , desde a construção do seu primeiro NAS até dominar os contêineres Docker., from building their first NAS to mastering Docker containers.

O Immich normalmente deixa de devolver fotografias privadas pesquisáveis após um reinício porque a Pesquisa Inteligente perdeu o caminho para a aprendizagem automática, ainda não terminou de preparar o modelo ou não consegue concluir as tarefas e leituras de armazenamento que criam os embeddings de pesquisa.

Se a linha temporal ainda mostrar os originais, é provável que as fotografias não estejam em falta; a camada de pesquisa é que está incompleta. Trate um resultado vazio primeiro como um problema do percurso do serviço, preserve a base de dados e a biblioteca de carregamentos e, antes de reconstruir seja o que for, distinga entre um contentor de aprendizagem automática indisponível, tarefas atrasadas, um endpoint incompatível ou uma falha de permissões no caminho persistente.

Separe resultados de pesquisa em falta de fotografias em falta

Abra diretamente vários recursos conhecidos a partir da linha temporal, dos álbuns e de uma biblioteca privada antes de testar a pesquisa. Se funcionar, significa que a base de dados consegue localizar os registos e que o Immich consegue ler os ficheiros; se falhar, trata-se de um incidente mais abrangente da biblioteca ou do armazenamento. Nesse caso, pare de fazer alterações específicas à pesquisa e proteja os caminhos afetados.

Faça três pesquisas repetíveis: um termo que funcionava anteriormente, um termo visualmente óbvio e um recurso carregado recentemente, depois de o respetivo trabalho em segundo plano dever estar concluído. Registe se os resultados estão vazios, desatualizados ou limitados a fotografias mais antigas. Estes resultados permitem distinguir uma falha total do endpoint de um atraso na indexação.

Um tópico comunitário de resolução de problemas reúne verificações da Pesquisa Inteligente relacionadas com reinícios, incluindo a acessibilidade do endpoint e a repetição de tarefas. Use a sua sequência de diagnóstico da camada de pesquisa como evidência do caso, não como motivo para eliminar a base de dados ou regenerar todos os recursos.

Verifique o percurso da aprendizagem automática após o reinício

Inspecione o estado do servidor e do contentor de aprendizagem automática e, em seguida, teste o URL de aprendizagem automática configurado a partir do espaço de nomes de rede que o chama. Um endpoint acessível com pedidos de modelo bem-sucedidos passa este ramo; uma recusa de ligação, uma falha de resolução de nomes ou um contentor não saudável identifica o percurso do serviço a reparar.

Compare o nome do serviço implementado, a porta, o valor da variável de ambiente, a versão da imagem e a pertença à rede com a última definição Compose conhecida por funcionar. Recrie apenas o contentor afetado depois de corrigir a incompatibilidade. Um simples reinício não substitui o ambiente obsoleto do contentor, por isso confirme o valor efetivo na carga de trabalho recriada.

Um caso comunicado do Immich v2.6.1 associou a Pesquisa Inteligente falhada a um contentor de aprendizagem automática não saudável. O relatório de falha específico da versão apoia a verificação do estado e dos registos; não prova que todas as falhas após um reinício sejam causadas por essa regressão.

Verifique a preparação do modelo, as tarefas e os caminhos persistentes

Observe os registos da aprendizagem automática enquanto envia uma pesquisa conhecida. O primeiro pedido pode carregar ou transferir um modelo e utilizar temporariamente mais memória; se houver progresso seguido de uma resposta bem-sucedida, este ramo passa. Evicções repetidas, terminações por falta de memória ou falhas de transferência apontam para reparações de memória, persistência da cache ou rede.

Inspecione as contagens de tarefas da Pesquisa Inteligente e as falhas recentes sem as limpar. Se o endpoint estiver saudável, mas as tarefas continuarem falhadas ou em fila, repita um pequeno lote controlado e observe se as contagens diminuem. Se um recurso for processado com êxito, repare a simultaneidade dos trabalhadores ou a dependência falhada antes de agendar uma reindexação completa.

Confirme que a base de dados, a biblioteca de carregamentos e a cache do modelo estão montadas nos caminhos persistentes pretendidos e com a identidade esperada. O guia relacionado da ZimaSpace sobre o comportamento do reconhecimento do Immich ajuda a distinguir o acesso e o âmbito da indexação de um original em falta.

Aplique a correção correspondente e volte a testar após dois reinícios

Corrija apenas a causa confirmada: restaure o nome do endpoint, recrie o contentor com o ambiente correto, torne a cache do modelo persistente, reduza a simultaneidade medida, repare a propriedade ou repita as tarefas falhadas da Pesquisa Inteligente. Mantenha disponível o ficheiro Compose anterior e uma cópia de segurança da base de dados; não elimine os embeddings como primeira resposta.

Volte a testar as mesmas três consultas, um recurso antigo e um carregamento novo. Para passar, deve obter resultados úteis, filas de tarefas a diminuir, originais legíveis e um estado estável da aprendizagem automática. Reinicie a pilha pela ordem normal das dependências e repita o teste; depois reinicie o anfitrião uma vez para confirmar que as montagens e a resolução de nomes sobrevivem ao arranque.

Reverta as alterações se os resultados diminuírem, os originais deixarem de ser legíveis ou a base de dados comunicar erros de consistência. Escale o problema com a versão do Immich, o endpoint efetivo, o estado do contentor, os registos relevantes, as contagens de tarefas, o nome do modelo e os mapeamentos de montagem se a mesma falha regressar após dois reinícios; mantenha a instância pesquisável anterior isolada, mas recuperável.

Suporte e Dicas

Mais para Ler

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.