Een reverse proxy geeft na de heropbouw van een container een 502 terug wanneer deze geen geldige verbinding meer met de opnieuw opgebouwde upstream kan maken.
Bij een heropbouw kan de container worden vervangen, een nieuw adres krijgen, van een Docker-netwerk worden losgekoppeld of een andere netwerknaam krijgen, kan de blootgestelde poort veranderen, kan een onvolledige configuratie worden teruggezet of kan de proxy starten voordat de applicatie klaar is. Een juiste diagnose begint bij het proxyfoutenlogboek en volgt het exacte upstream-adres van de proxy naar de container, in plaats van beide services steeds opnieuw te starten totdat de fout tijdelijk verdwijnt.
Bevestig dat de 502 wordt veroorzaakt door een upstream-verbindingsfout
Vraag het getroffen domein één keer op en noteer het tijdstip, de proxystatus, het upstream-adres en de volledige foutmelding. Maak onderscheid tussen verbindingsweigering, host niet gevonden, time-out, verbroken verbinding, TLS-handshakefout en ongeldig antwoord.
Een 502 betekent dat de proxy geen bruikbare upstream-respons heeft ontvangen, maar de foutdetails bepalen of het doel ontbrak, onbereikbaar was, niet luisterde of het verkeerde protocol gebruikte. Een actuele handleiding voor NGINX-probleemoplossing vermeldt dat een opnieuw opgebouwde container ervoor kan zorgen dat de proxy een oud backendadres blijft gebruiken totdat de naamomzetting of configuratie is vernieuwd.
Test de applicatie rechtstreeks vanaf de proxyhost of proxycontainer met de upstream-naam, het adres, de poort en het protocol uit het logboek. Als dat rechtstreekse verzoek op dezelfde manier mislukt, beperk het onderzoek dan tot de verbinding tussen proxy en container in plaats van de openbare DNS of certificaten te wijzigen.
Vergelijk het upstream-doel vóór en na de heropbouw
Controleer de naam van de opnieuw opgebouwde container, de servicenaam, het interne IP-adres, de blootgestelde poort, de gepubliceerde poort, de netwerkaliassen en de netwerkkoppelingen. Vergelijk deze met de proxyconfiguratie en het laatst werkende doeladres.
Een nginx-proxy-issue beschrijft een heropbouw waarbij het IP-adres van de applicatiecontainer veranderde, terwijl de proxy verzoeken bleef sturen naar de onbereikbare upstream-container. Het openbare domein bleef correct, terwijl alleen de identiteit van de private upstream veranderde.
Gebruik liever een stabiele Compose-servicenaam of netwerkalias dan een container-IP. Als het IP-adres bewust vast is ingesteld, controleer dan of de opnieuw opgebouwde service dat adres daadwerkelijk heeft gekregen en of geen andere container het adres nu gebruikt.
Controleer of de proxy en de app nog steeds een Docker-netwerk delen
Vermeld de netwerken die aan de proxy en de applicatie zijn gekoppeld en bevestig dat ze minstens één door de gebruiker gedefinieerd netwerk delen. Een gepubliceerde hostpoort maakt de containernaam niet automatisch bereikbaar vanaf een ander geïsoleerd Docker-netwerk.
In een Docker-netwerkgeval verdwenen terugkerende 502-reacties onmiddellijk nadat een afhankelijke service naar het juiste netwerk was verplaatst. Dit toont aan hoe een onbereikbaar upstream-pad problemen kan veroorzaken, zelfs wanneer alle containers actief blijven.
Koppel services via Compose in plaats van met eenmalige opdrachten, zodat de relatie behouden blijft na rebuilds. Test de DNS-omzetting en de upstream-poort vanuit de proxycontainer nadat u de stack opnieuw hebt aangemaakt.
Controleer de interne luisterpoort en het bindadres
Controleer of de applicatie luistert op de poort die de proxy gebruikt en op een adres dat bereikbaar is via het containernetwerk. Verwar een op de host gepubliceerde poort niet met de interne luisterpoort van de container.
Een proxy kan pas verbinding maken nadat de app luistert op een adres buiten de loopbackinterface. Een service die in de eigen container luistert op 127.0.0.1, is niet beschikbaar voor de proxy, zelfs wanneer een lokale gezondheidscontrole slaagt.
Inspecteer het applicatielogboek, de lijst met sockets en één rechtstreeks verzoek vanuit de proxycontainer. Als de verbinding met de poort wordt geweigerd, herstel dan de app-listener of configuratie voordat u meer pogingen of langere proxy-time-outs instelt.
Wacht tot de applicatie gereed is in plaats van alleen tot de container is gestart
Een opnieuw opgebouwde container kan actief zijn terwijl migraties, databaseherstel, het opwarmen van de cache of het genereren van configuratie de applicatie nog verhinderen verzoeken te accepteren. Vergelijk het tijdstip van de eerste 502 met de gezondheids- en opstartlogboeken.
Een discussie over het oplossen van problemen met Grist laat zien hoe de Docker-architectuur, omgevingsinstellingen en gereedheid van de upstream na een rebuild kunnen leiden tot aanhoudende 502-fouten aan de containerzijde.
Voeg een betekenisvolle gezondheidscontrole toe en zorg dat de proxy of afhankelijke services wachten op de bewerking die clients nodig hebben, niet alleen op de aanwezigheid van een proces. Houd het aantal pogingen beperkt, zodat een app die permanent is uitgevallen niet op een trage start lijkt.
Proxyomzetting vernieuwen en het stabiele pad opnieuw opbouwen
Herlaad of maak de proxy opnieuw aan nadat de servicenaam, het netwerk, de poort en de gezondheidsstatus in orde zijn. Als de proxy namen alleen bij het opstarten omzet, configureer dan ondersteunde runtime-omzetting of een voorspelbare herstartvolgorde.
De ZimaSpace-werkwijze voor het isoleren van een falende containerafhankelijkheid biedt aanvullende diagnostiek wanneer de upstream herhaaldelijk afsluit in plaats van gezond te blijven.
De reparatie is pas voltooid wanneer de proxy de servicenaam na een nieuwe rebuild kan omzetten, de bedoelde interne poort bereikt, wacht tot het opstarten is voltooid en het domein beschikbaar maakt zonder handmatige IP-aanpassingen. Verwijder tijdelijke directe IP-doelen en niet-gedocumenteerde netwerkverbindingen na de validatie.
Ondersteuning en tips
Meer om te lezen

Zo houd je pornofilms op je NAS verborgen voor gezinsleden
Houd video's voor volwassenen privé op een NAS voor het hele gezin. Controleer mapmachtigingen, toegang tot Plex- en Jellyfin-bibliotheken, miniaturen, kijkgeschiedenis, gedeelde tv-aanmeldingen en...

Wat je moet controleren voordat je een communitymodel in Transformers laadt
Gebruik de Transformers Jinja-sandboxupdate om de herkomst van modellen, chatsjablonen, externe code, geserialiseerde gewichten en geïsoleerde eerste uitvoeringen te controleren.

Voer Mirage lokaal uit: OCR en objectdetectie vanuit één afbeelding
Probeer het kleine lokale visiemodel van Cactus Compute, test OCR en objectextractie met echte invoer en krijg inzicht in de beperkingen op het gebied...



