O Immich pode utilizar de forma fiável uma partilha de rede para ficheiros multimédia ou uma biblioteca externa quando a montagem, as permissões, a latência e o comportamento em caso de indisponibilidade são devidamente configurados e testados, mas o diretório de dados do PostgreSQL deve permanecer num armazenamento de baixa latência compatível, em vez de uma partilha SMB ou NFS genérica.
A palavra dados esconde diferentes cargas de trabalho: os originais são ficheiros grandes e duráveis, as miniaturas geram muitas operações menores, as bibliotecas externas podem ser só de leitura e o PostgreSQL requer semântica própria de sistemas de ficheiros de bases de dados. Decida caminho a caminho, monte a partilha antes de iniciar os contentores, impeça que um diretório local vazio se faça passar pelo NAS e comprove o comportamento através de um reinício do anfitrião e de uma interrupção controlada da partilha.
Classifique Cada Caminho do Immich Antes de o Mover
Liste separadamente a biblioteca de carregamentos, as miniaturas ou os ficheiros multimédia codificados, as bibliotecas externas, o diretório da base de dados, a cache de modelos e as cópias de segurança. Indique quem escreve em cada caminho e o impacto da sua perda. Uma partilha multimédia pode ser viável; tratar todos os volumes como equivalentes faz falhar a validação da arquitetura.
Um guia prático de NFS demonstra o mapeamento de uma biblioteca externa do Immich a partir de armazenamento partilhado. O seu padrão de montagem de biblioteca externa é útil para planear caminhos e permissões, mas não comprova que a base de dados deva utilizar NFS.
Mantenha o PostgreSQL num armazenamento recomendado para bases de dados e proteja-o com cópias nativas e cópias de segurança. Se o armazenamento local ativo for limitado, mova apenas o caminho multimédia que consome mais capacidade, depois de o medir, e documente o limite em vez de relocalizar todo o estado da aplicação.
Torne Determinística a Ordem de Montagem Remota
Monte a partilha no anfitrião com credenciais ou regras de exportação explícitas, um endereço estável e o modo de leitura e escrita pretendido. Verifique a identidade esperada do sistema de ficheiros e um ficheiro marcador conhecido antes de iniciar o Immich. Associe aos contentores o caminho do anfitrião já montado.
Configure o gestor de serviços para que o Immich aguarde pela montagem remota e não seja iniciado sobre um diretório de recurso vazio. O arranque só é aprovado quando o marcador está visível dentro do contentor e um ficheiro de teste recebe o proprietário esperado; um diretório vazio ou um ficheiro pertencente ao root é motivo para interromper o processo.
Reinicie uma vez com a partilha disponível e outra vez com ela deliberadamente indisponível durante uma janela de manutenção. O primeiro teste só é aprovado quando o marcador aparece antes de o Immich iniciar; o segundo só é aprovado quando o Immich para ou falha de forma visível, em vez de escrever no ponto de montagem local vazio.
Comprove a Identidade dos Contentores e as Permissões da Partilha
Faça corresponder as identidades numéricas de utilizador e grupo no servidor, no cliente e no contentor, e depois teste a criação, a mudança de nome, a leitura e a eliminação numa pasta descartável dedicada. Não resolva uma incompatibilidade com permissões globais de escrita que exponham a biblioteca familiar.
Repita o teste do ficheiro descartável a partir do interior do contentor do servidor Immich, e não apenas a partir do anfitrião. Confirme que o NAS vê o proprietário numérico pretendido e que o Immich consegue reabrir o ficheiro depois de recriar um contentor. Um teste bem-sucedido apenas no anfitrião não comprova o caminho do contentor.
Se a identidade ou o comportamento de criação e mudança de nome forem diferentes, pare e corrija a exportação, a montagem ou o mapeamento do contentor de forma restrita. Volte a testar antes de analisar uma biblioteca real; alterações abrangentes às permissões podem ocultar a incompatibilidade e, ao mesmo tempo, expor todas as fotografias da família a serviços não relacionados.
Meça a Latência e Teste uma Interrupção da Partilha
Execute um carregamento representativo, a geração de miniaturas, a navegação pela cronologia, a transferência de um original e uma análise da biblioteca externa, medindo a latência do servidor e o progresso das tarefas. A aprovação exige uma interação aceitável e ausência de crescimento persistente da fila; a velocidade bruta da ligação, por si só, não comprova o desempenho dos metadados.
Um problema do Immich relata inconsistências entre a base de dados e os ficheiros numa implementação com NFS instável. O caso delimitado de falha do NFS sustenta tratar as desconexões durante as escritas como um risco de recuperação, sem presumir que o NFS corrompe sempre o Immich.
Durante uma janela de manutenção, com as cópias de segurança concluídas, interrompa a partilha multimédia enquanto um teste não crítico estiver ativo. O Immich deve falhar de forma visível, em vez de escrever no ponto de montagem local vazio. Restaure a partilha e confirme que o recurso de teste e o registo da base de dados ficam reconciliados sem um ciclo de reinícios.
Tome a Decisão de Avançar ou Não Depois dos Testes de Reinício
Reinicie os contentores e o anfitrião separadamente. Confirme que a partilha correta é montada primeiro, que os originais antigos e novos abrem, que as análises externas não duplicam recursos e que um novo carregamento sobrevive a outro reinício. A comparação entre DAS e NAS da ZimaSpace apresenta o compromisso entre latência e domínio de falha.
Utilize a partilha quando estes testes forem aprovados e a monitorização puder alertar para ausência, latência, espaço e pressão sobre os inodes. Escolha armazenamento local ou diretamente ligado quando a rede ou o NAS não conseguirem cumprir a disponibilidade necessária, ou quando não for possível impedir o comportamento de montagem permissivo em caso de falha.
Reverta para o caminho local anterior se o Immich iniciar vazio, criar ficheiros pertencentes ao root ou produzir erros de ficheiros em falta após uma interrupção. Ao solicitar assistência, inclua o protocolo, as opções de montagem, as identidades, os mapeamentos de caminhos, a latência e a ordem de arranque; nunca volte a analisar de forma destrutiva até conhecer os originais autoritativos e o estado da base de dados.
Suporte e Dicas
Mais para Ler

Como otimizar as ligações à base de dados do Immich para contentores simultâneos
Não aumente primeiro o valor de max_connections. Meça as sessões do Immich, some a procura total de cada contentor, preserve margem para o administrador...

Como evitar trabalhos ou importações duplicados no Immich
Separe os trabalhos repetidos dos recursos duplicados. Utilize um único caminho de ingestão canónico, controle as novas tentativas e as alterações de caminho e,...

Como reparar o Immich depois de o volume da base de dados ficar cheio
Nunca elimine o WAL do PostgreSQL para libertar espaço. Pare as escritas do Immich, preserve o estado da base de dados, adicione capacidade de...

