Ein Reverse-Proxy gibt nach dem erneuten Erstellen eines Containers einen 502 zurück, wenn er keine gültige Verbindung zum neu erstellten Upstream mehr herstellen kann.
Durch einen erneuten Build kann der Container ersetzt, ihm eine neue Adresse zugewiesen, ein Docker-Netzwerk getrennt oder umbenannt, der exponierte Port geändert, eine unvollständige Konfiguration wiederhergestellt oder der Proxy gestartet werden, bevor die Anwendung bereit ist. Die richtige Diagnose beginnt mit dem Proxy-Fehlerprotokoll und verfolgt die genaue Upstream-Adresse vom Proxy bis zum Container, anstatt beide Dienste so lange neu zu starten, bis der Fehler vorübergehend verschwindet.
Bestätige, dass der 502 durch einen Verbindungsfehler zum Upstream verursacht wird
Rufe die betroffene Domain einmal auf und notiere den Zeitstempel, den Proxy-Status, die Upstream-Adresse und die vollständige Fehlermeldung. Unterscheide zwischen Verbindungsverweigerung, unbekanntem Host, Zeitüberschreitung, Verbindungsabbruch, TLS-Handshake-Fehler und ungültiger Antwort.
Ein 502 bedeutet, dass der Proxy keine brauchbare Antwort vom Upstream erhalten hat. Die Fehlerdetails zeigen jedoch, ob das Ziel fehlte, nicht erreichbar war, nicht lauschte oder das falsche Protokoll verwendete. Ein aktueller NGINX-Leitfaden zur Fehlerbehebung weist darauf hin, dass ein neu erstellter Container dazu führen kann, dass der Proxy weiterhin eine alte Backend-Adresse verwendet, bis die Namensauflösung oder Konfiguration aktualisiert wird.
Teste die Anwendung direkt vom Proxy-Host oder Proxy-Container aus mit dem protokollierten Upstream-Namen, der Adresse, dem Port und dem Protokoll. Wenn diese direkte Anfrage auf dieselbe Weise fehlschlägt, beschränke die Untersuchung auf die Verbindung zwischen Proxy und Container, statt öffentliche DNS-Einträge oder Zertifikate zu ändern.
Vergleiche das Upstream-Ziel vor und nach dem erneuten Erstellen
Prüfe den Namen des neu erstellten Containers, den Dienstnamen, die interne IP-Adresse, den exponierten Port, den veröffentlichten Port, die Netzwerkaliase und die Netzwerkverbindungen. Vergleiche sie mit der Proxy-Konfiguration und dem zuletzt funktionierenden Ziel.
In einem nginx-proxy-Problem wird ein erneuter Build beschrieben, bei dem sich die IP-Adresse des Anwendungscontainers geändert hat, während der Proxy weiterhin Anfragen an den nicht erreichbaren Container-Upstream sendete. Die öffentliche Domain blieb unverändert, während sich nur die Identität des privaten Upstreams änderte.
Verwende lieber einen stabilen Compose-Dienstnamen oder Netzwerkalias statt einer Container-IP. Wenn die IP absichtlich festgelegt ist, prüfe, ob der neu erstellte Dienst sie tatsächlich erhalten hat und kein anderer Container die Adresse belegt.
Prüfe, ob Proxy und Anwendung weiterhin ein Docker-Netzwerk gemeinsam nutzen
Liste die Netzwerke auf, mit denen Proxy und Anwendung verbunden sind, und bestätige, dass sie mindestens ein benutzerdefiniertes Netzwerk gemeinsam nutzen. Ein veröffentlichter Host-Port macht den Containernamen nicht automatisch aus einem anderen isolierten Docker-Netzwerk erreichbar.
Ein Docker-Netzwerkfall zeigte, dass das Verschieben eines abhängigen Dienstes in das passende Netzwerk wiederkehrende 502-Antworten sofort beseitigte. Dies veranschaulicht, wie ein nicht erreichbarer Upstream-Pfad Probleme verursachen kann, obwohl alle Container weiterhin laufen.
Binden Sie Dienste über Compose statt über einmalige Befehle an, damit die Verbindung Neuaufbauten übersteht. Testen Sie nach dem Neuerstellen des Stacks die DNS-Auflösung und den Upstream-Port im Proxy-Container.
Internen Listener-Port und Bind-Adresse prüfen
Vergewissern Sie sich, dass die Anwendung am vom Proxy verwendeten Port und an einer Adresse lauscht, die über das Containernetzwerk erreichbar ist. Verwechseln Sie einen auf dem Host veröffentlichten Port nicht mit dem internen Listener-Port des Containers.
Der Proxy kann erst eine Verbindung herstellen, wenn die App an eine Adresse außerhalb des Loopback-Interfaces gebunden ist. Ein Dienst, der in seinem eigenen Container auf 127.0.0.1 lauscht, ist für den Proxy nicht erreichbar, selbst wenn eine lokale Zustandsprüfung erfolgreich ist.
Prüfen Sie das Anwendungsprotokoll, die Socket-Liste und eine direkte Anfrage aus dem Proxy-Container. Wenn Verbindungen am Port abgelehnt werden, beheben Sie zuerst den App-Listener oder die Konfiguration, bevor Sie Wiederholungsversuche hinzufügen oder die Proxy-Zeitlimits verlängern.
Auf die Bereitschaft der Anwendung warten, nicht nur auf den Containerstart
Ein neu aufgebauter Container kann laufen, während Migrationen, Datenbankwiederherstellung, Cache-Aufwärmung oder Konfigurationsgenerierung die Anwendung noch daran hindern, Anfragen anzunehmen. Vergleichen Sie den Zeitpunkt des ersten 502-Fehlers mit den Zustands- und Startprotokollen.
Eine Grist-Diskussion zur Fehlerbehebung zeigt, wie Docker-Architektur, Umgebungsvariablen und die Bereitschaft des vorgelagerten Dienstes nach einem Neuaufbau zu anhaltenden 502-Fehlern auf Container-Seite führen können.
Richten Sie eine aussagekräftige Zustandsprüfung ein und sorgen Sie dafür, dass der Proxy oder abhängige Dienste auf den benötigten Client-Vorgang warten, nicht bloß darauf, dass ein Prozess existiert. Begrenzen Sie Wiederholungsversuche, damit eine dauerhaft ausgefallene App nicht wie ein langsamer Start wirkt.
Proxy-Auflösung aktualisieren und den stabilen Pfad neu aufbauen
Laden Sie den Proxy neu oder erstellen Sie ihn neu, sobald Dienstname, Netzwerk, Port und Gesundheitsstatus stimmen. Wenn der Proxy Namen nur beim Start auflöst, konfigurieren Sie eine unterstützte Laufzeitauflösung oder eine vorhersehbare Neustartreihenfolge.
Der ZimaSpace-Workflow zum Isolieren einer fehlerhaften Container-Abhängigkeit bietet die passende ergänzende Diagnose, wenn der vorgelagerte Dienst wiederholt beendet wird, statt dauerhaft einen fehlerfreien Zustand zu erreichen.
Die Reparatur ist erst abgeschlossen, wenn der Proxy den Dienstnamen nach einem weiteren Neuaufbau auflösen kann, den vorgesehenen internen Port erreicht, die Startzeit abwartet und die Domain ohne manuelle IP-Änderungen bereitstellt. Entfernen Sie nach der Validierung vorübergehende direkte IP-Ziele und nicht dokumentierte Netzwerkanbindungen.
Support und Tipps
Mehr zum Lesen

So halten Sie Erwachsenenvideos auf Ihrem NAS vor Familienmitgliedern verborgen
Bewahre Videos für Erwachsene auf einem Familien-NAS privat auf. Prüfe Ordnerberechtigungen, den Bibliothekszugriff in Plex und Jellyfin, Vorschaubilder, den Wiedergabeverlauf, gemeinsam genutzte TV-Logins und...

Was vor dem Laden eines Community-Modells in Transformers zu beachten ist
Nutze das Transformers-Jinja-Sandbox-Update, um die Herkunft des Modells, Chat-Vorlagen, Remote-Code, serialisierte Gewichte und isolierte erste Ausführungen zu überprüfen.

Mirage lokal ausführen: OCR und Objekterkennung aus einem einzigen Bild
Testen Sie das kleine lokale Vision-Modell von Cactus Compute, überprüfen Sie die OCR- und Objektextraktion anhand realer Eingaben und verstehen Sie die Grenzen in...



