Como configurar bibliotecas externas do Immich como fontes só de leitura

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.

Uma biblioteca externa do Immich indexa fotografias que já se encontram fora da árvore de carregamentos gerida. Montar essa origem com acesso só de leitura protege os originais de erros da aplicação ou do operador, mas o Immich continua a precisar de armazenamento com permissão de escrita para miniaturas, vídeo codificado, dados de perfil e estado da base de dados.

A configuração utiliza, assim, duas zonas de confiança: pastas de origem imutáveis e dados gerados com permissão de escrita. Uma pequena biblioteca de teste deve passar os testes de descoberta, metadados, miniaturas, nova análise e remoção antes de ser adicionado um arquivo de grandes dimensões. O mesmo teste também confirma que o caminho no contentor, a propriedade e o plano de recuperação são compatíveis.

Mapeie separadamente o armazenamento de origem e o gerido

Escolha um caminho no anfitrião para o arquivo existente e um caminho distinto no contentor, como /external/family-photos. Não o coloque dentro do armazenamento de carregamentos do Immich, porque os recursos externos e os geridos seguem regras de ciclo de vida diferentes.

O fluxo de trabalho de bibliotecas externas do Immich exige que o servidor consiga ver o caminho que será atribuído a um utilizador. Registe ambos os lados da montagem para que o administrador não cole na aplicação um caminho que só existe no anfitrião.

Confirme que as localizações de escrita do Immich para carregamentos, miniaturas, vídeo codificado e dados da base de dados têm cópias de segurança normais e monitorização do espaço livre. Os originais só de leitura não protegem os dados gerados nem os registos dos recursos que tornam a biblioteca utilizável.

Aplique uma montagem de contentor só de leitura

Adicione o arquivo como uma montagem bind com a opção de só de leitura no Compose ou no gestor de contentores. Um padrão habitual associa /srv/photos/archive no anfitrião a /external/archive no contentor, com :ro.

Conceda ao processo do contentor permissões de acesso e leitura em todos os diretórios ascendentes. O acesso só de leitura não dispensa permissões: a falta de permissão de execução num diretório impede a descoberta, mesmo que os ficheiros individuais possam ser lidos.

Se a origem for uma partilha de rede, estabilize a montagem no anfitrião antes de iniciar o contentor. O guia de fiabilidade das partilhas de rede do Immich explica a diferença entre um caminho disponível e uma dependência fiável da aplicação.

Adicione uma biblioteca externa de teste e analise-a

Crie ou selecione o utilizador proprietário do Immich, adicione uma biblioteca externa e introduza o caminho de importação visível no contentor. Comece com uma pasta que contenha cópias ou originais não críticos, em vez de apontar para o arquivo completo.

Execute uma análise e verifique se aparecem as quantidades esperadas de fotografias e vídeos. Abra recursos de pastas aninhadas, verifique as datas e localizações e confirme que as miniaturas e as pré-visualizações codificadas são gravadas no armazenamento gerido, e não junto dos originais.

No anfitrião, compare as datas de modificação ou os hashes do ficheiro de origem de teste antes e depois da análise. Tente também criar um ficheiro no caminho montado a partir do interior do contentor; a operação deverá falhar, enquanto a leitura deverá ser bem-sucedida.

Testar nova análise, ficheiros em falta e recuperação

Adicione um ficheiro à origem no anfitrião, execute uma nova análise e confirme que aparece. Depois, retire temporariamente um ficheiro de teste da origem, execute outra análise e observe como a versão instalada do Immich assinala ou remove o registo do recurso, antes de repetir o processo com dados reais.

Faça cópias de segurança da base de dados e dos dados do Immich com permissões de escrita, de acordo com o seu plano de recuperação habitual. Os originais externos precisam de uma cópia de segurança independente, pois uma montagem da aplicação só de leitura não protege contra falhas do disco, eliminações no anfitrião ou corrupção de dados.

O teste é bem-sucedido se o Immich conseguir indexar e apresentar o arquivo, não conseguir escrever nele e puder ser reconstruído sem tratar a origem externa como carregamentos geridos. Pare se surgirem ficheiros gerados junto dos originais ou se uma montagem em falta for confundida com uma biblioteca vazia.

Perguntas frequentes

Uma montagem só de leitura impede o Immich de eliminar o original? Impede as escritas através dessa montagem do contentor. Não protege contra eliminações no anfitrião, outra partilha com permissões de escrita, falhas do sistema de ficheiros ou alterações ao modo de montagem por parte de um administrador.

Onde ficam as miniaturas de uma biblioteca externa? Permanecem no armazenamento gerido pelo Immich, com permissões de escrita. Mantenha essa localização separada dos originais só de leitura e inclua-a no plano de recuperação, juntamente com a base de dados.

Vários utilizadores podem indexar a mesma pasta externa? Evite sobrepor proprietários até testar o comportamento exato da versão instalada. A indexação duplicada pode gerar confusão quanto à propriedade e à partilha.

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.