Dados desatualizados do Immich após uma alteração do caminho de armazenamento podem ter três causas distintas, que não devem ser confundidas: uma mudança da raiz de multimédia gerida, uma alteração do caminho de importação de uma biblioteca externa ou um cliente que ainda apresenta dados em cache. As versões modernas do Immich conseguem reconciliar uma localização de multimédia gerida que tenha sido movida, desde que a localização de multimédia configurada e a montagem do volume se mantenham consistentes; já as mudanças de bibliotecas externas ainda podem ser tratadas como novas identidades de ativos.
Preserve o caminho antigo e a base de dados antes de voltar a analisar. Primeiro, confirme que caminho o contentor em execução consegue ver; depois, determine se o registo do lado do servidor do Immich está incorreto ou se apenas um cliente está desatualizado. Essa distinção determina se deve reparar uma montagem, restaurar um caminho estável visível no contentor, voltar a analisar um subconjunto de teste ou limpar apenas a cache do cliente.
Distinga uma mudança da raiz de multimédia gerida de uma mudança da biblioteca externa
Se alterou a localização no anfitrião dos carregamentos geridos pelo Immich, verifique se a definição efetiva da localização de multimédia e a montagem entre o anfitrião e o contentor foram alteradas em conjunto. Uma mudança moderna de localização de multimédia gerida não deve ser diagnosticada da mesma forma que uma alteração do nome do caminho de importação de uma biblioteca externa.
O mapa do estado persistente do Immich da ZimaSpace é útil neste caso, porque a base de dados e os caminhos do sistema de ficheiros formam um único limite de recuperação. Os ficheiros corretos no anfitrião não chegam se o contentor estiver montado noutro local.
Se a raiz de multimédia gerida estiver incorreta, corrija primeiro o ambiente e o mapeamento de volumes e reinicie o serviço antes de executar tarefas da biblioteca. Se o caminho alterado pertencer a uma biblioteca externa, mantenha a base de dados intacta e teste esse caso separadamente.
Mantenha estável o caminho da biblioteca externa no contentor, sempre que possível
Numa biblioteca externa, a forma mais segura de mover o armazenamento no anfitrião é manter inalterado o caminho de importação visível no contentor. Se o caminho apresentado ao Immich mudar, registe um pequeno conjunto de IDs de ativos, álbuns, pessoas e caminhos antigos antes de iniciar uma análise, para poder verificar se os ativos existentes foram associados novamente ou recriados.
Um relatório de alteração do caminho de uma biblioteca externa do Immich descreveu ficheiros relocados a serem tratados como novos ativos, com reprocessamento e perda de relações exclusivas do Immich. É um caso específico de uma versão, mas sustenta a regra prudente de que uma alteração no caminho de uma biblioteca externa não equivale automaticamente a uma mudança de nome transparente.
Se um subconjunto de teste aparecer como novos recursos enquanto os registos antigos passam a estar em falta ou são movidos para o lixo, interrompa a nova análise completa. Restaure, se possível, o caminho antigo visível para o contentor ou utilize uma abordagem de migração adequada à versão; não altere manualmente os caminhos na base de dados de produção sem uma cópia de segurança testada.
Não confunda este caso com uma migração de modelos de armazenamento para ficheiros geridos pelo Immich. O sintoma pode parecer semelhante na linha cronológica, mas a propriedade dos ficheiros e o processo de migração suportado são diferentes.
Distinga os caminhos guardados no servidor da cache do cliente
Inspecione o mesmo recurso conhecido no cliente Web e noutro cliente autenticado e compare com os registos do servidor ou o caminho visível para o servidor. Se as tarefas do lado do servidor continuarem a indicar o caminho antigo, limpar a cache do navegador não irá corrigir o registo subjacente.
Um problema posterior de metadados do caminho antigo no Immich revelou que o processamento continuava a referenciar um caminho anterior da biblioteca externa após uma alteração de nome. É um forte indício de que deve verificar os caminhos usados pelas tarefas antes de culpar a interface Web ou móvel.
Se o caminho no servidor estiver correto, mas apenas uma vista Web estiver desatualizada, atualize ou limpe a cache desse cliente e volte a testar o ficheiro original. Miniaturas em cache e um estado desatualizado no cliente podem fazer parecer que o servidor corrigido está avariado, enquanto uma pré-visualização em cache também pode fazer um caminho do servidor avariado parecer funcional.
Repare o limite mínimo do caminho e valide uma nova análise controlada
Faça uma única correção reversível: sincronize a definição de suportes geridos com a montagem, restaure o caminho anterior da biblioteca externa no contentor, corrija um caminho de importação ou limpe a cache de um cliente. Faça uma cópia de segurança da base de dados antes de qualquer ação que possa levar à redescoberta de uma grande biblioteca.
Execute a menor nova análise possível e verifique se os registos existentes continuam associados, se os erros relativos ao caminho antigo cessam e se não surgem recursos antigos/novos duplicados. Depois, abra alguns originais, verifique as relações com álbuns e pessoas, faça uma pesquisa e reinicie a stack.
Escale se os registos dos caminhos antigo e novo permanecerem ativos em simultâneo, uma grande biblioteca externa for reprocessada inesperadamente ou as relações desaparecerem enquanto os originais continuarem legíveis. Preserve o mapa exato das montagens antes/depois, a versão do Immich, os IDs dos recursos afetados, o comportamento do sistema de ficheiros quanto a maiúsculas e minúsculas e o carimbo temporal da cópia de segurança da base de dados.
Assistência e dicas
Mais para ler

Como manter vídeos para adultos no seu NAS ocultos dos membros da família
Mantenha os vídeos para adultos privados num NAS familiar. Verifique as permissões das pastas, o acesso às bibliotecas do Plex e do Jellyfin, as...

O que verificar antes de carregar um modelo da comunidade em Transformers
Utilize a atualização da sandbox Jinja do Transformers para rever a proveniência dos modelos, os modelos de chat, o código remoto, os pesos serializados...

Execute o Mirage localmente: OCR e deteção de objetos a partir de uma imagem
Experimente o pequeno modelo de visão local da Cactus Compute, valide o OCR e a extração de objetos com dados reais e compreenda os...



