Varför misslyckas inloggningen till Home Assistant efter en omstart av en omvänd proxy?

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.

Om inloggningen till Home Assistant misslyckas först efter en omstart av den omvända proxyn, testa först inloggning direkt via det lokala nätverket och låt användardatabasen vara oförändrad tills du har isolerat proxyvägen.

En omstart av proxyn kan ändra dess containeradress, vidarebefordrad klientinformation, WebSocket-hantering, DNS-mål eller backendserver utan att ändra något Home Assistant-lösenord. Därför är det olämpligt att börja med att ta bort konton eller återställa alla sessioner. Jämför den direkta Home Assistant-URL:en med det vanliga proxade värdnamnet, spara webbläsarens och proxyns felmeddelanden och ta reda på om felet uppstår före autentiseringen, under inloggningsbegäran eller när gränssnittet öppnar sin bestående anslutning.

Börja med att skilja Home Assistant-autentisering från proxyvägen

Använd samma fungerande konto via Home Assistants direkta lokala adress och via proxyns offentliga eller interna värdnamn. Om direktinloggning fungerar men proxyvägen inte gör det, är kontot och Core-autentiseringen sannolikt tillräckligt välfungerande för att lämnas orörda. Om båda vägarna misslyckas, fortsätt undersökningen med Home Assistant, det återställda tillståndet eller själva inloggningsuppgifterna.

Ett fall med inloggning via omvänd proxy visade att direktanslutningen fungerade annorlunda än Apache-vägen tills WebSocket- och proxyinställningarna korrigerades. En sådan jämförelse mellan direktanslutning och proxy ger bättre diagnostik än att ändra lösenord upprepade gånger.

Anteckna HTTP-statusen, omdirigeringskedjan, webbläsarens konsolfel, proxyns svar från uppströmsservern och tidsstämpeln för motsvarande Home Assistant-logg innan du ändrar konfigurationen. Ett 400-fel från en obetrodd proxy, en misslyckad WebSocket-anslutning, en omdirigering till fel schema och ett ogiltigt lösenord är olika fel, även om skärmen visar samma generiska meddelande om att det inte går att ansluta.

De fyra orsakerna på proxysidan ger olika tecken

De vanligaste orsakerna är att proxykällans adress har ändrats och inte längre matchar regeln för betrodda proxyservrar, att vidarebefordrade headers eller schemat har ändrats, att hanteringen av WebSocket-uppgraderingar har slutat fungera eller att trafiken dirigeras till fel Home Assistant-backend. När en proxycontainer återskapas kan något av detta ändras trots att själva Home Assistant-instansen förblir stabil.

Ett aktuellt fall av felsökning av omvänd proxy visar att Home Assistant avvisar vidarebefordrad trafik tills den närmaste proxyn placeras i rätt betrott intervall. Den identitetskontrollen av betrodd proxy är säkrare än att permanent bredda intervallet: verifiera vilken proxyadress som faktiskt når Home Assistant och lita endast på den gränsen.

Använd kännetecknen nedan och ändra en gren i taget. Låt inte ett brett betrott proxyintervall vara kvar efter testningen; det tar bort ett viktigt skydd mot förfalskade, vidarebefordrade klientadresser.

Orsak 1: Omstarten ändrade proxyns källadress

  • Kännetecken: begäranden avvisas omedelbart och Home Assistant-loggarna identifierar en obetrodd omvänd proxy.
  • Kontrollera: jämför proxyns containerundernät/adress med det konfigurerade betrodda intervallet.
  • OM–SÅ: om återställning av det korrekta, begränsade betrodda intervallet löser inloggningen, låt kontot och sessionstillståndet vara oförändrade.

Orsak 2: Vidarebefordrad värd eller schema matchar inte längre det offentliga ursprunget

  • Kännetecken: omdirigeringar växlar mellan HTTP/HTTPS eller alternativa värdnamn, eller så verkar cookies vara knutna till ett oväntat ursprung.
  • Kontrollera: jämför Host och vidarebefordrat schema före och efter omstarten.
  • OM–SÅ: om korrigering av dessa värden löser omdirigerings-/inloggningsloopen berodde felet på ingressens identitet, inte på Home Assistant-användarna.

Orsak 3: Inloggningssidan läses in men WebSocket-uppgraderingen misslyckas

  • Kännetecken: det statiska gränssnittet läses in, men sedan kopplas frontend från eller kan inte slutföra initieringen.
  • Kontrollera: granska WebSocket-begäran i webbläsaren och proxyns uppgraderingsheaders.
  • OM–SÅ: om direkt åtkomst håller WebSocket-anslutningen öppen medan värdnamnet inte gör det, felsök i proxylagret.

Orsak 4: Proxyn pekar på en annan eller ny backend

  • Kännetecken: servern verkar vara nykonfigurerad, kända användare försvinner eller serverspecifikt tillstånd skiljer sig via proxyn.
  • Kontrollera: jämför uppströmsadressen, instansens identitet och konfigurationssökvägen.
  • OM–SÅ: om proxyn når fel container eller återställd instans, åtgärda routningen innan du rör autentiseringsdata.

Använd WebSocket-beteendet för att undvika att felaktigt klassificera ett fel i gränssnittet som ett inloggningsfel

Home Assistants gränssnitt är beroende av en beständig WebSocket-anslutning efter den inledande HTTP-kommunikationen. En proxy kan därför visa inloggningssidan utan problem men ändå fallera kort därefter, när anslutningen uppgraderas eller hålls öppen. Användare beskriver ofta detta förlopp som ett inloggningsfel eftersom det inträffar omedelbart efter att inloggningsuppgifterna har skickats.

En Home Assistant-konfiguration med omvänd proxy på Synology nådde inloggningssidan men misslyckades ändå tills hanteringen av WebSocket-uppgradering korrigerades. Genom att kontrollera hanteringen av WebSocket-uppgradering via proxy undviker du att slösa tid på att återställa användare när HTTP-inloggningsvägen redan fungerar.

Om socketanslutningen misslyckas ska du kontrollera hanteringen av HTTP/1.1-uppgradering, tidsgränser, TLS-terminering, värdnamn och eventuell CDN- eller autentiseringsmellanvara framför proxyn. Håll ändringarna begränsade. Lägg inte till orelaterade headers kopierade från en annan proxystack om den misslyckade begäran inte visar varför de behövs.

Single board computer zimaboard2

Verifiera korrigeringen genom två proxyomstarter och med en ren klient

När du har genomfört den riktade korrigeringen loggar du in och ut via det vanliga värdnamnet, öppnar en instrumentpanel tillräckligt länge för att bekräfta att WebSocket-anslutningen förblir stabil och upprepar sedan testet från ett privat webbläsarfönster eller på en andra klient. Starta därefter om proxyn två gånger och starta om proxyvärden om dess containeradress eller nätverk kan vara orsaken.

ZimaSpaces jämförelse av Home Assistant-anslutningar via LAN och på distans tillämpar samma isoleringsprincip: behåll den fungerande lokala sökvägen till programmet medan du testar de extra DNS-, TLS-, proxy- och routningslager som används vid fjärranslutning.

Godkänn när både direkt inloggning och inloggning via proxy leder till samma Home Assistant-instans, den förväntade snäva proxyadressen är betrodd, omdirigeringar behåller avsett schema och värdnamn, WebSocket-anslutningen förblir stabil vid normal användning och en omstart av proxyn inte ändrar resultatet. Eskalera till Home Assistants autentisering endast när samma konto, som du vet fungerar, även misslyckas via direktanslutningen.

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.