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

Come tenere nascosti i video per adulti sul tuo NAS ai tuoi familiari
Tieni privati i video per adulti su un NAS familiare. Controlla le autorizzazioni delle cartelle, l’accesso alle librerie di Plex e Jellyfin, le miniature,...

Cosa controllare prima di caricare un modello della community in Transformers
Usa l’aggiornamento della sandbox Jinja di Transformers per esaminare la provenienza dei modelli, i template di chat, il codice remoto, i pesi serializzati e...

Esegui Mirage in locale: OCR e rilevamento degli oggetti da una sola immagine
Prova il piccolo modello di visione locale di Cactus Compute, verifica l’OCR e l’estrazione degli oggetti con input reali e comprendi i limiti di...



