O Immich pode funcionar de forma fiável com os dados armazenados numa partilha de rede?

Eva Wong é a redatora técnica e entusiasta residente na ZimaSpace. Uma geek desde sempre, apaixonada por homelabs e software de código aberto, dedica-se a traduzir conceitos técnicos complexos em guias práticos. A Eva acredita que a auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ajuda a comunidade a desmistificar configurações de hardware, desde montar o primeiro NAS até dominar os contentores Docker.

O Immich pode usar uma partilha de rede de forma fiável para multimédia ou para uma biblioteca externa, desde que a montagem, as permissões, a latência e o comportamento em caso de indisponibilidade sejam devidamente configurados e testados. No entanto, o diretório de dados do PostgreSQL deve permanecer num armazenamento de baixa latência suportado, em vez de numa partilha SMB ou NFS genérica.

A palavra «dados» esconde cargas de trabalho diferentes: os originais são ficheiros grandes e duradouros, as miniaturas geram muitas operações mais pequenas, as bibliotecas externas podem ser só de leitura e o PostgreSQL exige as características de um sistema de ficheiros de base 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 tanto através do reinício do anfitrião como de uma interrupção controlada da partilha.

Classifique cada caminho do Immich antes de o mover

Identifique separadamente a biblioteca de carregamentos, as miniaturas ou os conteúdos 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 de multimédia pode ser viável; tratar todos os volumes como intercambiáveis não cumpre os requisitos do projeto.

Um guia prático de NFS demonstra como associar uma biblioteca externa do Immich a partir de um armazenamento partilhado. O seu padrão de montagem de bibliotecas externas é útil para planear caminhos e permissões, mas não prova que a base de dados deva usar NFS.

Mantenha o PostgreSQL num armazenamento recomendado para bases de dados e proteja-o com despejos nativos e cópias de segurança. Se o armazenamento local ativo for limitado, mova apenas o caminho de multimédia que ocupe mais espaço, conforme medido, e documente o limite, em vez de relocalizar todo o estado da aplicação.

Torne determinística a ordem das montagens remotas

Monte a partilha no anfitrião com credenciais explícitas ou regras de exportação, 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 o caminho já montado no anfitrião aos contentores.

Configure o gestor de serviços para que o Immich aguarde pela montagem remota e não inicie perante um diretório de recurso vazio. O arranque só passa quando o marcador estiver visível dentro do contentor e um ficheiro de teste tiver o proprietário esperado; um diretório vazio ou um ficheiro pertencente a root são motivos para interromper o processo.

Reinicie uma vez com a partilha disponível e outra vez com a partilha deliberadamente indisponível durante uma janela de manutenção. O primeiro teste só passa quando o marcador aparece antes de o Immich iniciar; o segundo só passa quando o Immich para ou falha de forma visível, em vez de escrever no ponto de montagem local vazio.

Comprove a identidade do contentor e as permissões da partilha

Faça corresponder as identidades numéricas de utilizador e grupo no servidor, cliente e contentor; 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 da família.

Repita o teste com um ficheiro descartável dentro do contentor do servidor Immich, e não apenas no anfitrião. Confirme que o NAS apresenta o proprietário numérico esperado e que o Immich consegue voltar a abrir o ficheiro após a recriação de um contentor. Um teste bem-sucedido apenas no anfitrião não comprova o funcionamento do caminho do contentor.

Se as identidades ou o comportamento de criação e mudança de nome forem diferentes, pare e corrija a configuração específica da exportação, da montagem ou do mapeamento do contentor. Volte a testar antes de analisar uma biblioteca real; alterações amplas à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

Faça um carregamento representativo, gere miniaturas, navegue pela cronologia, transfira um original e analise uma biblioteca externa, medindo a latência do servidor e o progresso das tarefas. Para ser aprovado, o teste deve proporcionar uma interação aceitável e não apresentar um 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 limitado de falha do NFS justifica tratar as desconexões durante as gravações como um risco de recuperação, sem presumir que o NFS corrompe sempre o Immich.

Durante uma janela de manutenção e com as cópias de segurança concluídas, interrompa a partilha de multimédia enquanto um teste não crítico estiver em curso. O Immich deve apresentar uma falha visível, em vez de escrever no ponto de montagem vazio. Restabeleça a partilha e confirme que o elemento de teste e o respetivo registo na base de dados ficam sincronizados, sem entrar num ciclo de reinícios.

Tome a decisão de avançar ou não após os 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 podem ser abertos, que as análises externas não duplicam os elementos e que um novo carregamento persiste após 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 emitir alertas sobre indisponibilidade, latência, espaço e pressão sobre os inodes. Escolha armazenamento local ou diretamente ligado quando a rede ou o NAS não puderem garantir 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 arrancar sem conteúdo, criar ficheiros pertencentes ao root ou apresentar erros de ficheiros em falta após uma interrupção. Escale o problema indicando 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.

Assistência 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.