Otimize as ligações à base de dados do Immich medindo a procura total de sessões em todos os processos do Immich e nos restantes clientes PostgreSQL, em vez de começar por aumentar o valor de max_connections. A base de dados precisa de sessões suficientes para responder à carga de trabalho real, além de uma margem para tarefas administrativas, mas uma concorrência excessiva pode aumentar o consumo de memória e a contenção sem acelerar as consultas.
Num servidor doméstico com vários contentores, registe as ligações ativas, inativas e em espera, juntamente com a latência das consultas, o CPU, a memória e a latência do armazenamento, durante a utilização normal e durante o arranque simultâneo. Um erro de «demasiados clientes» pode resultar da configuração agregada, de outro serviço ou de uma série de reinícios, mesmo quando um contentor Immich parece ter uma configuração modesta.
Inventarie todos os clientes PostgreSQL antes de alterar os limites
Faça uma lista de cada processo ou réplica do servidor Immich, tarefa de migração/manutenção, tarefa de cópia de segurança, ferramenta de monitorização e aplicação não relacionada que se ligue à mesma instância PostgreSQL. Sempre que possível, atribua-lhes utilizadores de base de dados distintos para que pg_stat_activity possa mostrar quem mantém as sessões. Registe o valor atual de max_connections e mantenha uma via de acesso administrativo para responder a incidentes.
Uma discussão sobre «demasiados clientes» do Immich inclui um comentário do projeto segundo o qual, nessa versão, o Immich usava um conjunto de ligações predefinido de 10. Uma discussão separada de 2026 refere que vários workers do Immich podem manter, cada um, um conjunto de ligações. Considere estes valores como contexto de implementação específico da versão, não como números a multiplicar cegamente em versões futuras. Se a base de dados já estiver perto do limite de ligações quando o Immich está inativo, identifique quem mantém essas sessões antes de ajustar o Immich. Se houver poucas sessões ativas, mas as consultas forem lentas, o número de ligações poderá ser um sintoma da latência do armazenamento ou das consultas, e não o principal estrangulamento.
Crie um orçamento de ligações com base na concorrência medida
Reserve sessões para a administração da base de dados, ferramentas de cópia de segurança/restauro, migrações e monitorização.
Em seguida, distribua as ligações restantes disponíveis para as aplicações pelo número de processos do Immich em execução simultânea e pelas outras aplicações. O objetivo é ter um conjunto suficientemente grande para que o trabalho normal não tenha de esperar desnecessariamente, mas não maior do que aquilo que a base de dados consegue executar de forma eficiente.
Uma análise da dimensão do conjunto de ligações do PostgreSQL descreve o conjunto ideal como suficientemente grande para responder à procura normal, mas tão pequeno quanto possível, uma vez que menos sessões de backend reduzem a contenção. Aplique este princípio à procura observada do Immich, em vez de copiar a dimensão de um conjunto de ligações de um servidor Web usado noutro tipo de carga.
Se a versão do Immich não disponibilizar um controlo do tamanho do conjunto de ligações oficialmente suportado, não altere os componentes internos apenas para atingir um número pretendido. Controle o que puder: o número de réplicas da aplicação, os clientes não relacionados, o momento dos reinícios, a sobreposição com as cópias de segurança e a capacidade da base de dados. Reavalie a configuração suportada quando as versões mudarem.
Reduzir a rotatividade de ligações e a espera na base de dados antes de adicionar mais sessões
Distribua o arranque dos contentores no tempo para evitar que o Immich, a análise, as tarefas de cópia de segurança e as outras aplicações voltem a ligar-se ou executem migrações todas em simultâneo. Use verificações de saúde/prontidão que aguardem até o PostgreSQL estar operacional, mas evite ciclos de novas tentativas demasiado curtos, que criam uma tempestade de ligações enquanto a base de dados ainda está a recuperar.
O guia da ZimaSpace sobre a segurança de bases de dados externas do Immich define um limite importante: quando o PostgreSQL é separado da pilha predefinida, as responsabilidades relativas à versão, às extensões, às permissões, às cópias de segurança e à reversão tornam-se explícitas. Não se deve introduzir um proxy de ligações ou outro anfitrião de base de dados apenas para ocultar consultas lentas ou armazenamento saturado.
Se muitas sessões estiverem inativas e o número de aplicações for legitimamente elevado, um gestor de ligações pode reduzir o número de sessões de backend em algumas arquiteturas PostgreSQL, mas só depois de testar a versão exata do Immich, as migrações, a semântica das transações e o comportamento das instruções preparadas. O agrupamento de ligações não substitui a correção de um cliente descontrolado nem de uma base de dados sobrecarregada.
Validar com carregamentos, pesquisas, tarefas e reinícios em simultâneo
Crie um pico reproduzível: execute carregamentos representativos a partir de dispositivos móveis, uma pesquisa ou navegação mais demorada e o conjunto habitual de tarefas em segundo plano, enquanto os outros contentores esperados estão ativos. Registe o número de ligações por utilizador/estado, os erros de obtenção de ligações ou de pedidos, a latência das consultas, a utilização de CPU e memória da base de dados e a latência do disco. Depois, repita o teste após uma alteração.
Uma configuração aprovada mantém as sessões abaixo do limite que causa a falha, com margem para tarefas administrativas, evita erros de «demasiados clientes», mantém a latência das consultas dentro do objetivo definido para o agregado familiar e permite que as filas sejam processadas depois do pico. Só se justifica aumentar o número de ligações quando há pedidos efetivamente à espera de uma sessão e a base de dados ainda dispõe de capacidade de CPU, memória e E/S.
Reinicie a pilha de aplicações e, em seguida, o anfitrião uma vez para testar o pico máximo de ligações. Se a falha ocorrer apenas durante o arranque, corrija a ordem de arranque ou o comportamento das tentativas, em vez de aumentar o limite permanente. Se as sessões se acumularem ao longo do tempo, registe os utilizadores e as consultas responsáveis e reporte esse padrão de fuga, incluindo as versões e provas do estado das ligações.
Assistência e dicas
Mais para ler

Como manter vídeos para adultos no seu NAS ocultos dos membros da família
Mantenha os vídeos para adultos privados num NAS familiar. Verifique as permissões das pastas, o acesso às bibliotecas do Plex e do Jellyfin, as...

O que verificar antes de carregar um modelo da comunidade em Transformers
Utilize a atualização da sandbox Jinja do Transformers para rever a proveniência dos modelos, os modelos de chat, o código remoto, os pesos serializados...

Execute o Mirage localmente: OCR e deteção de objetos a partir de uma imagem
Experimente o pequeno modelo de visão local da Cactus Compute, valide o OCR e a extração de objetos com dados reais e compreenda os...



