Perché un reverse proxy restituisce un errore 502 dopo la ricostruzione di un container?

Eva Wong è la redattrice tecnica e appassionata di tecnologia di ZimaSpace. Geek da sempre, appassionata di homelab e software open source, è specializzata nel tradurre concetti tecnici complessi in guide pratiche. Eva crede che l’hosting autonomo debba essere divertente, non intimidatorio. Attraverso i suoi tutorial, aiuta la community a comprendere meglio le configurazioni hardware, dalla costruzione del primo NAS alla padronanza dei container Docker.

Un proxy inverso restituisce un errore 502 dopo la ricreazione di un container quando non riesce più a stabilire una connessione valida con l'upstream ricreato.

La ricreazione può sostituire il container, assegnargli un nuovo indirizzo, scollegare o rinominare una rete Docker, modificare la porta esposta, ripristinare una configurazione incompleta o avviare il proxy prima che l'applicazione sia pronta. La diagnosi corretta parte dal log degli errori del proxy e segue l'indirizzo upstream esatto dal proxy al container, anziché riavviare entrambi i servizi finché l'errore non scompare temporaneamente.

Conferma che l'errore 502 dipenda da un problema di connessione all'upstream

Invia una richiesta al dominio interessato e annota l'ora, lo stato del proxy, l'indirizzo upstream e il messaggio di errore completo. Distingui tra connessione rifiutata, host non trovato, timeout, connessione interrotta, errore di handshake TLS e risposta non valida.

Un errore 502 significa che il proxy non ha ricevuto una risposta upstream valida, ma i dettagli dell'errore indicano se il target era assente, irraggiungibile, non in ascolto o usava il protocollo sbagliato. Una guida aggiornata alla risoluzione dei problemi di NGINX osserva che la ricreazione di un container può lasciare il proxy collegato a un vecchio indirizzo del backend finché la risoluzione del nome o la configurazione non vengono aggiornate.

Prova l'applicazione direttamente dall'host del proxy o dal container del proxy, usando il nome upstream, l'indirizzo, la porta e il protocollo indicati nel log. Se la richiesta diretta fallisce allo stesso modo, concentra l'indagine sul collegamento tra proxy e container, anziché modificare il DNS pubblico o i certificati.

Confronta il target upstream prima e dopo la ricreazione

Controlla il nome del container ricreato, il nome del servizio, l'IP interno, la porta esposta, la porta pubblicata, gli alias di rete e le reti collegate. Confrontali con la configurazione del proxy e con l'ultimo target funzionante.

Un problema di nginx-proxy descrive una ricreazione che ha modificato l'IP del container dell'applicazione mentre il proxy continuava a inviare richieste all'upstream del container irraggiungibile. Il dominio pubblico è rimasto corretto, mentre è cambiata solo l'identità dell'upstream privato.

Preferisci un nome di servizio Compose stabile o un alias di rete all'IP del container. Se l'IP è volutamente fisso, verifica che il servizio ricreato lo abbia effettivamente ricevuto e che nessun altro container ora utilizzi quell'indirizzo.

Verifica che il proxy e l'app condividano ancora una rete Docker

Elenca le reti collegate al proxy e all'applicazione e verifica che condividano almeno una rete definita dall'utente. La pubblicazione di una porta dell'host non rende automaticamente raggiungibile il nome del container da un'altra rete Docker isolata.

Un caso di rete Docker ha mostrato che spostare un servizio dipendente sulla rete appropriata ha eliminato immediatamente i ripetuti errori 502, dimostrando come un percorso verso il servizio a monte irraggiungibile possa causare problemi anche quando tutti i container restano in esecuzione.

Collega i servizi tramite Compose anziché con comandi eseguiti una tantum, così la relazione viene mantenuta dopo le ricompilazioni. Dopo aver ricreato lo stack, verifica la risoluzione DNS e la porta del servizio a monte dall’interno del container del proxy.

Controlla la porta di ascolto interna e l’indirizzo di binding

Verifica che l’applicazione sia in ascolto sulla porta usata dal proxy e su un indirizzo raggiungibile dalla rete dei container. Non confondere una porta pubblicata sull’host con la porta di ascolto interna del container.

Il proxy può connettersi solo se l’app è in ascolto su un indirizzo accessibile dall’esterno dell’interfaccia loopback. Un servizio in ascolto su 127.0.0.1 nel proprio container non è accessibile al proxy, anche se un controllo di stato locale riesce.

Esamina il log dell’applicazione, l’elenco dei socket e una richiesta diretta dal container del proxy. Se la porta rifiuta le connessioni, correggi il listener o la configurazione dell’app prima di aggiungere tentativi o aumentare i timeout del proxy.

Attendi che l’applicazione sia pronta, non solo che il container si avvii

Un container ricompilato può risultare in esecuzione mentre migrazioni, ripristino del database, riscaldamento della cache o generazione della configurazione impediscono ancora all’applicazione di accettare richieste. Confronta l’ora del primo 502 con i log di stato e di avvio.

Una discussione sulla risoluzione dei problemi di Grist mostra come l’architettura Docker, le impostazioni dell’ambiente e la disponibilità del servizio a monte possano causare errori 502 persistenti lato container dopo una ricompilazione.

Aggiungi un controllo di stato significativo e fai in modo che il proxy o i servizi dipendenti attendano l’operazione necessaria ai client, non la semplice presenza di un processo. Limita i tentativi, così un’app che ha smesso di funzionare definitivamente non sembrerà solo lenta ad avviarsi.

Aggiorna la risoluzione del proxy e ricostruisci il percorso stabile

Ricarica o ricrea il proxy dopo aver verificato il nome del servizio, la rete, la porta e lo stato di salute. Se il proxy risolve i nomi solo all’avvio, configura la risoluzione dinamica supportata oppure un ordine di riavvio prevedibile.

La procedura di ZimaSpace per isolare una dipendenza del container che non funziona offre la diagnosi complementare quando il servizio a monte continua a terminare invece di rimanere in stato di salute.

La riparazione è completa solo quando, dopo un’altra ricompilazione, il proxy risolve il nome del servizio, raggiunge la porta interna corretta, attende l’avvio e serve il dominio senza modifiche manuali all’IP. Dopo la verifica, rimuovi le destinazioni temporanee con IP diretto e i collegamenti di rete non documentati.

Assistenza e consigli

Altre letture

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.