O Immich deve usar a rede do anfitrião ou uma rede em ponte?

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.

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

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.