Como configurar a cache e o armazenamento temporário do Immich

Configure a cache e o armazenamento temporário do Immich, começando por separar o estado duradouro da biblioteca dos derivados gerados, da cache reutilizável de modelos e dos dados temporários verdadeiramente descartáveis dos contentores.

As miniaturas e os vídeos codificados podem parecer cache porque o Immich consegue regenerá-los, mas são ativos de trabalho persistentes que podem tornar-se grandes e dispendiosos de reconstruir. Os downloads de modelos têm um ciclo de vida diferente, enquanto os registos e os dados temporários da camada gravável não devem consumir silenciosamente o disco de arranque. Atribua o armazenamento por função e, em seguida, teste o comportamento de limpeza e reinício.

Classifique Cada Função de Armazenamento Antes de a Mover

Crie um inventário com, pelo menos, quatro classes: originais e estado necessário da aplicação; miniaturas e pré-visualizações geradas; vídeos codificados gerados; e dados de modelos, registos ou execução temporária. Para cada classe, registe o caminho atual, o tamanho, a taxa de crescimento, a política de cópias de segurança, o custo de reconstrução e o serviço que escreve os dados.

Um relatório de utilizador sobre o crescimento das miniaturas e dos vídeos gerados demonstra por que motivo as miniaturas e os vídeos codificados devem ser medidos separadamente. As proporções individuais não são universais, porque a combinação de conteúdos multimédia e as definições de processamento alteram a quantidade produzida.

Não classifique um diretório como “cache” apenas porque eliminá-lo liberta espaço. Se a sua perda causar dias de regeneração, interromper a reprodução ativa ou remover um estado que o seu plano de recuperação prevê conservar, atribua-lhe uma função persistente explícita, mesmo que a aplicação consiga tecnicamente recriá-lo.

Coloque os Dados Gerados de Elevada Rotação Onde a Latência e a Durabilidade Sejam Adequadas

As miniaturas e as pré-visualizações servem a navegação interativa e envolvem frequentemente muitas leituras pequenas, enquanto os vídeos codificados podem consumir uma capacidade sequencial muito maior. Um SSD rápido pode melhorar a atividade centrada nos derivados, mas apenas se mover essa função eliminar a espera medida, em vez de criar outro volume pequeno que fique inesperadamente cheio.

A explicação da ZimaSpace sobre o crescimento do armazenamento de miniaturas apresenta uma lição de armazenamento aplicável a outros contextos: o armazenamento ativo da aplicação pode ficar cheio mesmo quando os originais estão noutro local. Os caminhos específicos do Immich são diferentes, mas a necessidade de monitorizar a função gravável real é a mesma.

Se os conteúdos multimédia principais permanecerem num HDD ou armazenamento NAS enquanto os derivados são movidos para um SSD, monitorize os limites mínimos de espaço livre em ambos e confirme cada montagem após o reinício. Uma camada rápida para derivados só é útil quando é suficientemente grande para o crescimento normal e quando uma falha sua não pode ser confundida com a perda dos originais autoritativos.

Torne a Cache de Modelos Persistente de Forma Deliberada, mas Trate-a como Reconstruível

Os modelos de aprendizagem automática são descarregados ou preparados para inferências repetidas e podem consumir uma quantidade significativa de armazenamento. Tornar a cache de modelos persistente evita downloads e trabalho de arranque desnecessários, sobretudo com ligações mais lentas, mas não deve ser confundida com a base de dados ou com os originais da família na hierarquia de recuperação.

Uma discussão da comunidade sobre a arquitetura de armazenamento do Immich ilustra por que motivo os operadores separam os dados rápidos semelhantes a cache do armazenamento principal de fotografias. Utilize estas disposições apenas como exemplos; confirme os caminhos e as montagens atuais na sua própria definição do Compose antes de mover qualquer elemento.

Se a cache de modelos for perdida, a recuperação aceitável consiste normalmente em recriá-la ou voltar a descarregá-la, desde que o serviço consiga aceder à origem necessária e disponha de espaço em disco suficiente. Documente esse comportamento para que uma ferramenta de cópias de segurança não consuma acidentalmente a capacidade limitada externa a proteger uma cache grande que pode ser regenerada.

-15% OFF

ZimaBoard 2 - Mini Servidor Doméstico para a Sua Grande Ideia

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

Mantenha Limitados as Camadas Graváveis, os Registos e o Espaço Temporário

As camadas graváveis dos contentores não devem tornar-se um local não documentado para derivados persistentes, transcodificações temporárias ou registos grandes. Inspecione a utilização do disco pelo Docker e as montagens dos contentores, para que cada caminho grande em crescimento seja deliberadamente persistente ou intencionalmente descartável. Um aumento inexplicado da camada gravável é um sintoma de configuração, não um alvo de limpeza por defeito.

O fluxo de trabalho do Docker HQ de 2026 para uma limpeza segura do disco do Docker salienta a auditoria antes da remoção e a proteção dos volumes que possam conter bases de dados. Aplique essa cautela aqui: nunca execute comandos de limpeza abrangentes num anfitrião Immich de produção até conhecer a propriedade de cada volume e camada.

Defina a rotação dos registos, mantenha os caminhos temporários num armazenamento com margem suficiente para picos e monitorize os inodes, além da utilização em bytes, quando forem criados muitos ficheiros pequenos. Se um caminho temporário ficar cheio, a solução correta é limitar ou relocalizar essa função, não eliminar diretórios desconhecidos até a aplicação arrancar por acaso.

Valide as Alterações de Armazenamento com Testes de Reinício, Reconstrução e Espaço Livre

Depois de alterar os caminhos, abra conteúdos antigos e recentes, navegue por vários álbuns, reproduza um vídeo, execute uma tarefa de miniaturas ou de aprendizagem automática e carregue um novo ficheiro controlado. Confirme que as escritas são feitas nos dispositivos pretendidos e que a base de dados continua a referenciar conteúdos multimédia legíveis.

Reinicie os contentores e, em seguida, o anfitrião. Uma configuração correta volta a montar automaticamente todas as funções, conserva os derivados e a cache de modelos esperados, mantém os dados temporários descartáveis e indica espaço livre suficiente em cada camada ativa. Observe o armazenamento durante um período de carga normal para confirmar que o crescimento ocorre onde foi planeado.

Reverta uma alteração de caminho se o Immich criar diretórios duplicados, indicar conteúdos em falta ou escrever silenciosamente na camada do contentor porque uma montagem falhou. Ao solicitar assistência, inclua os mapas de montagem, os tamanhos dos caminhos, a propriedade, o espaço livre do sistema de ficheiros, a utilização do disco pelos contentores e a tarefa exata que escreveu pela primeira vez no local incorreto.