Na maioria das implementações do Immich baseadas em Docker, uma bridge definida pelo utilizador é a opção predefinida mais simples; a rede do anfitrião é uma solução alternativa direcionada, não uma melhoria de desempenho universal.
O Immich precisa sobretudo de caminhos fiáveis entre cliente e servidor, servidor e base de dados, servidor e Redis, aprendizagem automática e proxy inverso. Ambos os modos de rede podem disponibilizá-los. A escolha deve basear-se na reprodução da falha ou do requisito de acesso real, na experimentação de um modo de cada vez e na manutenção da configuração mais fácil de monitorizar e recuperar.
Comece pelos caminhos de que o Immich realmente precisa
Represente a pilha como ligações, não como contentores: os clientes acedem ao ponto de acesso público ou local do Immich; o proxy acede ao servidor do Immich; a aplicação acede ao PostgreSQL e ao Redis; e o servidor acede à aprendizagem automática. Indique quais as ligações que permanecem dentro do Docker e quais atravessam o limite do anfitrião.
Uma bridge definida pelo utilizador dá aos contentores o seu próprio namespace de rede, permitindo ao mesmo tempo que os serviços na mesma rede se encontrem pelo nome do serviço. A visão geral das modalidades de rede do Docker é útil para perceber esta diferença: as portas publicadas servem clientes no anfitrião ou externos, enquanto o DNS dos contentores trata do tráfego entre serviços.
Se todos os caminhos necessários já funcionam numa bridge, a rede do anfitrião não resolveu nenhum problema comprovado. Mantenha a bridge e documente os nomes dos serviços, as redes e as portas publicadas, para que uma futura alteração do proxy ou do Compose possa ser verificada face a uma topologia conhecida.
Prefira uma bridge definida pelo utilizador quando o isolamento e os nomes de serviço estáveis são importantes
O modo bridge permite que os serviços do Immich comuniquem numa rede de aplicação explícita, sem expor todas as portas dos contentores no anfitrião. Isto é especialmente útil quando um proxy inverso partilha a rede e pode aceder diretamente ao serviço Immich pelo nome, reduzindo a dependência de um endereço IP do contentor que pode mudar após a sua recriação.
A análise das vantagens e desvantagens da rede do anfitrião em homelabs observa que remover o NAT do Docker raramente proporciona um ganho de desempenho significativo para o tráfego Web habitual num homelab. As diferenças mais importantes são o isolamento de namespaces, a publicação de portas e a forma como os serviços se descobrem entre si.
O modo bridge só falha como opção de conceção quando um caminho necessário não pode ser configurado ou continua pouco fiável depois de corrigidos a rede, o DNS, a firewall e a participação do proxy na rede. Não mude simplesmente de modo porque um cliente indica que o «servidor está inacessível»; primeiro, confirme que o pedido está a ser bloqueado na fronteira do Docker.
Use a rede do anfitrião apenas para um requisito específico e reproduzível
O modo host coloca o contentor no espaço de nomes de rede do anfitrião, eliminando a tradução de portas do Docker e dando ao serviço acesso ao contexto de rede do anfitrião. Isso pode simplificar certos casos de deteção ou encaminhamento invulgar, mas também elimina o limite de portas ao nível do contentor e aumenta a probabilidade de conflitos de portas no anfitrião.
Uma comparação atual entre as redes bridge e host enquadra a escolha em função do desempenho, isolamento, exposição de serviços e depuração. Aplique esses critérios ao percurso do Immich, em vez de presumir que o modo host é inerentemente mais fiável.
Se o modo host resolver um sintoma, repita o teste duas vezes e explique porquê. Por exemplo, confirme que o mesmo nome de anfitrião, conta, proxy e cliente falham na bridge e funcionam no modo host, enquanto os registos da aplicação se mantêm saudáveis nos restantes aspetos. Se não conseguir reproduzir o resultado, a alteração do modo poderá ter apenas ocultado um problema de DNS ou um estado de rede obsoleto.
Mantenha o proxy inverso numa rota explícita e recuperável
Após reiniciar qualquer um dos contentores, o proxy inverso deve conseguir chegar ao Immich através de uma definição de servidor de origem estável. Numa bridge, prefira uma rede definida pelo utilizador partilhada e um servidor de origem com o nome do serviço, em vez de um IP de contentor copiado manualmente. No modo host, direcione o proxy para o endereço e a porta pretendidos do anfitrião, verificando se existem conflitos.
O padrão de teste host-versus-bridge do ZimaSpace usa uma regra condicional semelhante: a simplicidade da deteção pode justificar o modo host, enquanto o isolamento e a integração explícita com o proxy favorecem uma bridge. O Immich utiliza protocolos diferentes, por isso reutilize o método de decisão e não as suposições sobre portas específicas do Plex.
Reinicie apenas o proxy, depois apenas o Immich e, por fim, toda a pilha. Uma configuração que passa restaura sempre as mesmas rotas locais e remotas sem alterar endereços IP. Uma topologia que exige reconfiguração manual após a recriação não é suficientemente estável, quer use a rede host, quer bridge.
Escolha o modo que passa no mesmo teste de aceitação com menos riscos
Teste o início de sessão na Web local, a ligação da aplicação móvel, um carregamento pequeno, um carregamento grande, o acesso através do proxy inverso, o estado de funcionamento entre serviços e um reinício completo. Registe a latência e as falhas, mas não dê demasiada importância a pequenas diferenças de débito se ambos os modos continuarem muito abaixo do limite da rede.
Escolha bridge quando todas as funções passarem e beneficiar de exposição explícita, DNS de contentores e isolamento. Escolha host quando um percurso necessário falhar de forma reproduzível numa bridge corretamente configurada e o modo host resolver o problema sem criar conflitos de portas nem alargar a exposição para além do que aceita.
Se ambos os modos falharem da mesma forma, pare de alternar as definições de rede. A causa estará provavelmente no DNS, TLS, cabeçalhos do proxy, autenticação, firewall, armazenamento ou na própria aplicação. Guarde o pedido que falhou e os registos, regresse à topologia conhecida mais simples que funciona e diagnostique o limite seguinte.
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...



