Um proxy inverso devolve 502 após a recriação de um contentor quando deixa de conseguir estabelecer uma ligação válida ao destino upstream recriado.
A recriação pode substituir o contentor, atribuir-lhe um novo endereço, desligar ou renomear uma rede Docker, alterar a porta exposta, repor uma configuração incompleta ou iniciar o proxy antes de a aplicação estar pronta. O diagnóstico correto começa pelo registo de erros do proxy e segue o endereço upstream exato do proxy até ao contentor, em vez de reiniciar ambos os serviços até o erro desaparecer temporariamente.
Confirme que o 502 é causado por uma falha na ligação upstream
Aceda uma vez ao domínio afetado e registe a data e hora, o estado do proxy, o endereço upstream e a mensagem de erro completa. Distinga entre ligação recusada, anfitrião não encontrado, tempo limite excedido, ligação reposta, falha no handshake TLS e resposta inválida.
Um 502 significa que o proxy não recebeu uma resposta upstream utilizável, mas o detalhe do erro determina se o destino não existia, estava inacessível, não estava a escutar ou usava o protocolo errado. Um guia atual de resolução de problemas do NGINX refere que um contentor recriado pode deixar o proxy a usar um endereço de backend antigo até a resolução de nomes ou a configuração serem atualizadas.
Teste a aplicação diretamente a partir do anfitrião ou do contentor do proxy, usando o nome ou endereço upstream, a porta e o protocolo indicados no registo. Se esse pedido direto falhar da mesma forma, continue a investigação entre o proxy e o contentor, em vez de alterar o DNS público ou os certificados.
Compare o destino upstream antes e depois da recriação
Inspecione o nome do contentor recriado, o nome do serviço, o IP interno, a porta exposta, a porta publicada, os aliases de rede e as redes associadas. Compare-os com a configuração do proxy e com o último destino que funcionou.
Um problema do nginx-proxy descreve uma recriação que alterou o IP do contentor da aplicação, enquanto o proxy continuou a enviar pedidos para o destino upstream inacessível do contentor. O domínio público manteve-se correto, tendo mudado apenas a identidade do destino upstream privado.
Prefira um nome de serviço do Compose ou um alias de rede estável em vez de um IP de contentor. Se o IP for intencionalmente fixo, verifique se o serviço recriado o recebeu efetivamente e se nenhum outro contentor passou a usar esse endereço.
Verifique se o proxy e a aplicação continuam a partilhar uma rede Docker
Liste as redes associadas ao proxy e à aplicação e confirme que partilham pelo menos uma rede definida pelo utilizador. A publicação de uma porta no anfitrião não torna automaticamente o nome do contentor acessível a partir de outra rede Docker isolada.
Um caso de rede Docker revelou que transferir um serviço dependente para a rede adequada eliminou imediatamente as respostas 502 recorrentes, demonstrando como um percurso para o serviço a montante inacessível pode causar problemas mesmo quando todos os contentores continuam em execução.
Ligue os serviços através do Compose, em vez de usar comandos pontuais, para que a relação se mantenha após as reconstruções. Teste a resolução DNS e a porta do serviço a montante a partir do contentor do proxy depois de recriar a pilha.
Verifique a porta interna de escuta e o endereço de ligação
Confirme que a aplicação está à escuta na porta usada pelo proxy e num endereço acessível a partir da rede do contentor. Não confunda uma porta publicada no anfitrião com a porta interna em que o contentor está à escuta.
O proxy só consegue estabelecer ligação depois de a aplicação aceitar ligações para além do loopback. Um serviço que esteja à escuta em 127.0.0.1 dentro do próprio contentor não está disponível para o proxy, mesmo que um comando de verificação de saúde local seja bem-sucedido.
Inspecione o registo da aplicação, a lista de sockets e um pedido direto a partir do contentor do proxy. Se a porta recusar ligações, corrija o listener ou a configuração da aplicação antes de adicionar tentativas ou aumentar os tempos limite do proxy.
Aguarde até a aplicação estar pronta em vez de se basear no arranque do contentor
Um contentor reconstruído pode estar em execução enquanto as migrações, a recuperação da base de dados, o aquecimento da cache ou a geração da configuração ainda impedem a aplicação de aceitar pedidos. Compare a hora do primeiro erro 502 com o estado de saúde e os registos de arranque.
Uma discussão sobre a resolução de problemas do Grist mostra como a arquitetura do Docker, as definições do ambiente e a disponibilidade do serviço a montante podem combinar-se e provocar falhas 502 no lado do contentor persistentes após uma reconstrução.
Adicione uma verificação de saúde significativa e faça com que o proxy ou os serviços dependentes aguardem pela operação de que os clientes precisam, não apenas pela existência de um processo. Limite as tentativas para que uma aplicação com falhas permanentes não pareça estar apenas a arrancar lentamente.
Atualize a resolução do proxy e reconstrua o percurso estável
Recarregue ou recrie o proxy depois de o nome do serviço, a rede, a porta e o estado de saúde estarem corretos. Se o proxy só resolver nomes no arranque, configure a resolução em tempo de execução suportada ou uma ordem de reinício previsível.
O fluxo de trabalho do ZimaSpace para isolar uma dependência de contentor com falhas fornece o diagnóstico complementar quando o serviço a montante termina repetidamente em vez de permanecer saudável.
A reparação só está concluída quando o proxy resolve o nome do serviço após outra reconstrução, acede à porta interna pretendida, aguarda durante o arranque e disponibiliza o domínio sem edições manuais de IP. Remova os destinos temporários de IP direto e as ligações de rede não documentadas após a validação.
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...



