Varför returnerar en omvänd proxy 502 efter att en container har byggts om?

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

En omvänd proxy returnerar 502 efter att en container återskapats när den inte längre kan upprätta en giltig anslutning till den återskapade upstream-containern.

Återskapning kan ersätta containern, tilldela den en ny adress, koppla från eller byta namn på ett Docker-nätverk, ändra den exponerade porten, återställa en ofullständig konfiguration eller starta proxyn innan programmet är redo. En korrekt diagnos börjar med proxyns fellogg och följer den exakta upstream-adressen från proxyn till containern i stället för att starta om båda tjänsterna tills felet tillfälligt försvinner.

Bekräfta att 502-felet beror på ett anslutningsfel till upstream

Gör en förfrågan till den berörda domänen och anteckna tidsstämpeln, proxystatusen, upstream-adressen och det fullständiga felmeddelandet. Skilj mellan nekad anslutning, värdnamnet hittades inte, tidsgränsen överskreds, anslutningen återställdes, TLS-handskakningen misslyckades och ogiltigt svar.

Ett 502-fel betyder att proxyn inte fick något användbart svar från upstream, men felinformationen avgör om målet saknades, var oåtkomligt, inte lyssnade eller använde fel protokoll. En aktuell felsökningsguide för NGINX påpekar att en återskapad container kan göra att proxyn fortsätter använda en gammal backend-adress tills namnuppslagningen eller konfigurationen uppdateras.

Testa programmet direkt från proxyvärden eller proxycontainern med det loggade upstream-namnet, adressen, porten och protokollet. Om den direkta förfrågan misslyckas på samma sätt, fortsätt felsökningen mellan proxyn och containern i stället för att ändra offentlig DNS eller certifikat.

Jämför upstream-målet före och efter återskapningen

Granska den återskapade containerns namn, tjänstenamn, interna IP-adress, exponerade port, publicerade port, nätverksalias och nätverksanslutningar. Jämför dem med proxykonfigurationen och dess senast fungerande mål.

Ett problem med nginx-proxy beskriver en återskapning som ändrade programmets container-IP medan proxyn fortsatte att skicka förfrågningar till den oåtkomliga upstream-containern. Den offentliga domänen förblev korrekt medan endast den privata upstream-identiteten ändrades.

Föredra ett stabilt Compose-tjänstenamn eller nätverksalias framför en container-IP. Om IP-adressen är avsiktligt fast, verifiera att den återskapade tjänsten faktiskt fick den och att ingen annan container nu använder adressen.

Verifiera att proxyn och programmet fortfarande delar ett Docker-nätverk

Lista nätverken som proxyn och programmet är anslutna till och bekräfta att de delar minst ett användardefinierat nätverk. En publicerad värdport gör inte automatiskt att containernamnet kan nås från ett annat isolerat Docker-nätverk.

I ett fall med Docker-nätverk löstes de återkommande 502-felen direkt när en beroende tjänst flyttades till rätt nätverk. Det visar hur en otillgänglig uppströms sökväg kan orsaka problem även när alla containrar förblir igång.

Anslut tjänster via Compose i stället för med engångskommandon, så att kopplingen består efter ombyggnader. Testa DNS-uppslagning och uppströmsporten inifrån proxycontainern efter att stacken återskapats.

Single board computer zimaboard2

Kontrollera den interna lyssningsporten och bindningsadressen

Bekräfta att applikationen lyssnar på den port som proxyn använder och på en adress som kan nås från containernätverket. Blanda inte ihop en port som publicerats på värddatorn med containerns interna lyssningsport.

En proxy kan ansluta först när appen lyssnar på en adress utöver loopback. En tjänst som lyssnar på 127.0.0.1 i sin egen container är inte tillgänglig för proxyn, även om ett lokalt hälsokommando lyckas.

Granska applikationsloggen, listan över sockets och en direkt förfrågan från proxycontainern. Om porten avvisar anslutningar ska du åtgärda appens lyssnare eller konfiguration innan du lägger till återförsök eller längre tidsgränser för proxyn.

Vänta tills applikationen är redo, inte bara tills containern har startat

En återskapad container kan vara igång samtidigt som migreringar, databasåterställning, cacheuppvärmning eller konfigurationsgenerering fortfarande hindrar applikationen från att ta emot förfrågningar. Jämför tidpunkten för det första 502-felet med hälsokontroller och uppstartsloggar.

En diskussion om felsökning av Grist visar hur Docker-arkitektur, miljöinställningar och uppströms beredskap tillsammans kan leda till återkommande 502-fel på containersidan efter en ombyggnad.

Lägg till en meningsfull hälsokontroll och låt proxyn eller beroende tjänster vänta på den funktion som klienterna behöver, inte bara på att en process finns. Begränsa antalet återförsök så att en app som har slutat fungera permanent inte verkar vara långsam att starta.

Uppdatera proxyupplösningen och återskapa den stabila sökvägen

Läs in proxyn på nytt eller återskapa den när tjänstens namn, nätverk, port och hälsostatus är korrekta. Om proxyn bara slår upp namn vid start ska du konfigurera en lösning som stöds för namnuppslagning vid körning eller en förutsägbar omstartsordning.

ZimaSpaces arbetsflöde för att isolera ett felande containerberoende ger närliggande diagnostik när den uppströms tjänsten avslutas gång på gång i stället för att förbli felfri.

Reparationen är klar först när proxyn kan slå upp tjänstens namn efter ännu en ombyggnad, nå rätt intern port, vänta tills uppstarten är klar och visa domänen utan manuella IP-ändringar. Ta bort tillfälliga direkt-IP-mål och odokumenterade nätverksanslutningar efter valideringen.

Support och tips

Mer att läsa

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.