Como evitar a deriva das permissões nas pastas de dados do Immich

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.

Evitar a deriva das permissões no Immich implica tornar previsíveis as regras de propriedade e acesso dos ficheiros antes de diferentes contentores, protocolos NAS, atualizações ou tarefas de manutenção criarem ficheiros novos com identidades diferentes.

A solução duradoura não é uma reposição periódica e recursiva das permissões. Registe os UID/GID numéricos e os acessos de que cada fluxo de trabalho realmente precisa, defina deliberadamente a propriedade dos pontos de montagem e a herança das ACLs, separe os caminhos só de leitura dos caminhos de escrita e teste o processo de criação após cada alteração. Evita-se a deriva das permissões quando o novo ficheiro de amanhã é criado corretamente, sem um `chown` de emergência, e não quando, por acaso, a biblioteca de hoje pode ser lida.

Registe as identidades que leem e escrevem em cada caminho do Immich

Registe os caminhos do anfitrião montados no Immich e identifique os processos que devem ler, criar, mudar o nome ou eliminar ficheiros em cada um deles. Para cada processo que escreva ficheiros, registe os respetivos UID e GID numéricos no anfitrião e dentro do contentor. Os IDs numéricos são mais importantes do que a correspondência entre nomes de utilizador, porque os ficheiros guardam a propriedade como números.

Inclua no inventário os processos que não sejam do Immich e que escrevam ficheiros. Os carregamentos por SMB, os clientes NFS, as ferramentas de cópia de segurança, os scripts de importação, os contentores de gestão de multimédia e uma shell de administrador podem todos criar ficheiros na mesma árvore. Se o fizerem com identidades diferentes, a biblioteca pode acumular gradualmente proprietários e permissões que funcionam num caminho, mas falham noutro.

Mantenha este mapa de identidades junto à configuração do Compose. Assim, uma futura atualização da imagem, migração do servidor ou conta NAS restaurada poderá ser comparada com uma configuração de referência comprovadamente funcional, em vez de só detetar a incompatibilidade quando os novos carregamentos começarem a falhar.

Use um modelo deliberado de proprietário, grupo partilhado e acesso mínimo

Decida que identidade deve ser proprietária dos dados geridos pela aplicação e que grupo partilhado, se existir, precisa de acesso. Conceda a cada fluxo de trabalho apenas os direitos de leitura ou escrita necessários. Evite tornar toda a árvore do Immich acessível a todos para escrita só porque um contentor não consegue criar uma miniatura ou mover um ficheiro importado.

As incompatibilidades de UID/GID e as permissões demasiado abrangentes são causas comuns de falhas em volumes partilhados. A abordagem mais segura é alinhar as permissões do contentor e do volume, em vez de conceder acesso irrestrito. Isto é importante num servidor doméstico onde vários serviços podem aceder ao mesmo conjunto de armazenamento.

Se vários serviços precisarem de acesso de escrita, use um grupo partilhado e permissões de grupo ou ACLs consistentes, em vez de alternar a propriedade recursiva entre aplicações. Verifique primeiro um diretório representativo. Alterações recursivas abrangentes em toda a biblioteca de fotografias devem ser o último recurso, com uma cópia de segurança atual, e não uma tarefa de manutenção de rotina.

Torne previsíveis as permissões de novos ficheiros

Os ficheiros existentes podem parecer perfeitos, enquanto os novos se desviam imediatamente do esperado devido a regras de criação incorretas. Verifique a ACL do diretório principal, as entradas de ACL predefinidas, a umask, a identidade do serviço e quaisquer definições de criação SMB ou NFS aplicáveis ao caminho. O objetivo da prevenção é a herança, não a limpeza.

Antes de alterar recursivamente os modos, compare a propriedade numérica no anfitrião com o UID/GID efetivamente utilizado no contentor. Esta verificação de montagem vinculada de UID/GID permite distinguir rapidamente uma incompatibilidade de identidades de uma permissão realmente em falta. Corrija a relação entre proprietário e grupo em vez de ocultar o problema com modos permissivos.

Crie um pequeno ficheiro de teste através de cada fluxo de escrita habitual: carregamento no Immich, fluxo de importação, transferência SMB/NFS, se utilizada, e restauro de cópia de segurança. Inspecione o proprietário, o grupo, o modo e a ACL após cada teste. Se dois métodos de criação produzirem resultados incompatíveis, resolva esse conflito de políticas antes de importar mais dados.

Impeça que as alterações às montagens e às atualizações reescrevam a propriedade

Trate uma edição do Compose, uma atualização de imagem, uma nova montagem do NAS ou uma migração como alterações que podem afetar as permissões. Antes de as aplicar, registe a origem e o destino da montagem atuais, se o caminho permite apenas leitura ou também escrita, o utilizador efetivo do contentor e um exemplo de propriedade numérica de cada diretório importante.

As transferências e o armazenamento em rede podem introduzir identidades SMB/NFS diferentes, IDs numéricos, herança de ACL e comportamentos de umask distintos. Consulte os pontos de falha na alteração de permissões do NAS como lista de verificação antes de qualquer alteração sempre que os dados do Immich forem movidos entre sistemas de ficheiros ou métodos de acesso.

Após a alteração, compare as mesmas amostras antes de executar tarefas em lote. Se a propriedade mudar subitamente no arranque, pare a pilha e identifique o ponto de entrada, a tarefa de manutenção ou a identidade remapeada que causou a alteração. Não permita que uma reescrita recursiva da propriedade, sem explicação, continue numa biblioteca de grandes dimensões.

Audite os desvios com testes pequenos e repetíveis

Faça uma auditoria ligeira às permissões de forma periódica ou após atualizações: verifique alguns originais estáveis, um carregamento recente, um derivado gerado recentemente e quaisquer pontos de montagem de bibliotecas externas. Procure proprietários inesperados, falta de acesso ao grupo, pontos de montagem só de leitura que passaram a permitir escrita ou ACL que deixaram de ser herdadas como esperado.

Em seguida, faça um teste de escrita de ponta a ponta. Carregue um ficheiro descartável através do cliente habitual, deixe o Immich processá-lo, abra-o e remova-o através da aplicação. Se a sua configuração incluir bibliotecas externas ou fluxos de importação, adicione um ficheiro representativo por esses meios e confirme que o Immich consegue lê-lo sem alterar inesperadamente o proprietário.

O ciclo de prevenção só está concluído quando os novos ficheiros continuam a receber a identidade e o acesso pretendidos depois de reiniciar o Immich e de reiniciar o anfitrião. Se as permissões exigirem uma reparação manual após qualquer um destes eventos, o sistema continua a desviar-se do comportamento esperado; corrija a regra de criação ou o mapeamento de identidades antes de alargar o acesso.

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.