Waarom verliest Home Assistant sessies na een wijziging van de proxy of DNS?

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Verlies van sessies na een proxy- of DNS-wijziging komt meestal door een verschil tussen de URL-origin die de client gebruikt en de route die Home Assistant nu ziet, niet door beschadigde gebruikersaccounts.

Een browser kan nog cookies en frontendstatus voor de oude hostnaam bevatten, terwijl een telefoon het nieuwe adres opzoekt, of de proxy kan de inlogpagina weergeven maar de geauthenticeerde WebSocket laten mislukken. Begin met één privébrowservenster en één directe LAN-test, noteer voor elk resultaat het exacte schema en de hostnaam, en verwijder niet alle sessies voordat je hebt vastgesteld in welke laag de fout zit.

Maak onderscheid tussen status van één client en een gedeelde padfout

Open Home Assistant in een privévenster met de beoogde definitieve URL en vergelijk dit vervolgens met de getroffen browser en mobiele app. Noteer of het inloggen lukt, of het dashboard vijf minuten verbonden blijft en of de sessie behouden blijft na het vernieuwen van een pagina. Met deze omkeerbare vergelijking test je op verouderde clientstatus zonder de server te wijzigen.

Een proxy kan de inlogpagina weergeven, terwijl de geauthenticeerde frontend later meldt dat er geen verbinding kan worden gemaakt. Deze verbindingsfout na geslaagde aanmelding laat zien waarom het weergeven van HTML geen bewijs is dat het volledige sessiepad werkt.

Als alleen de oude browser problemen geeft en het privévenster stabiel blijft, verwijder dan op die client de sitegegevens voor de oude en nieuwe Home Assistant-origins en meld je daarna opnieuw aan. Als alle clients problemen ondervinden met de proxy-URL, maar directe LAN-toegang werkt, behoud dan de clientstatus en onderzoek het proxypad.

Controleer WebSocket- en Forwarded-Origin-afhandeling

Controleer tijdens het inloggen het netwerkoverzicht van de browser of het proxylogboek en let op de WebSocket-upgrade, de status, het moment van verbreken, het doorgestuurde schema, de doorgestuurde host en het clientadres. Het relevante verschil is tussen een HTTP-pagina die wordt geladen en een blijvend geauthenticeerd kanaal dat wordt geüpgraded en open blijft.

Bij het oplossen van problemen met de reverse proxy van Home Assistant wordt WebSocket-doorsturing herhaaldelijk als een afzonderlijke vereiste genoemd, naast gewone HTTP-proxying. Gebruik dit mechanisme alleen om het upgradepad te interpreteren, niet als bewijs dat één Nginx-configuratie voor elke proxy geschikt is.

Als de upgrade mislukt, corrigeer dan alleen de proxyrout, de upgradeheaders, het doorgestuurde schema of de grens van vertrouwde proxies waarvan de logs aantonen dat die onjuist is. Als de upgrade slaagt en de verbinding behouden blijft, laat de proxy dan ongewijzigd en onderzoek in plaats daarvan DNS en de herkomststatus van de client.

DNS-antwoorden en uiteindelijke URL’s vergelijken

Zoek de hostnaam van Home Assistant op vanaf de falende client, een werkende client en de proxyhost. Vergelijk IPv4-, IPv6- en split-DNS-antwoorden, de certificaatnaam, de bestemmingsredirect en de URL die in de companion-app is opgeslagen. Een DNS-wijziging is pas voltooid als clients het beoogde eindpunt bereiken via dezelfde canonieke hostnaam.

De bredere samenhang tussen detectie, naamomzetting en routering wordt beschreven in het bereikbaarheidsmodel van Home Assistant. Gebruik dit om een verouderd DNS-antwoord te onderscheiden van een fout in de sessielaag.

Als clients verschillende eindpunten vinden, wacht dan de gedocumenteerde TTL af of wis de resolvercache alleen op de betreffende client en lokale resolver. Maak geen concurrerende tijdelijke hostnamen aan, want elke extra origin vormt een nieuwe grens voor cookies en redirects.

Test het oorspronkelijke sessiepad opnieuw en escaleer gericht

Meld je aan via de uiteindelijke openbare of privé-URL, laat een live dashboard openstaan, laad een onderliggende weergave opnieuw, wissel één keer van netwerk als externe toegang deel uitmaakt van het ontwerp en herhaal dit nadat je één client opnieuw hebt gestart. De test slaagt als dezelfde canonieke URL, stabiele WebSocket en behouden sessie ook na de oorspronkelijke trigger blijven werken.

Als de schone client werkt maar één bestaande client nog steeds faalt, herstel dan alleen het profiel of de app-verbinding van die client. Als alle proxyclients falen met hetzelfde bewijs van een mislukte upgrade of redirect, draai dan de laatste proxy- of DNS-wijziging terug en bewaar de logs voordat je iets anders probeert.

Escaleren met de exacte klasse van de falende URL, DNS-antwoorden, proxystatuscodes, WebSocket-resultaat, tijdstempels en vergelijking tussen clients. Stop zodra twee verschillende clients hun sessie behouden na vernieuwen en opnieuw verbinden; extra wijzigingen aan cookies of de proxy brengen dan risico’s met zich mee zonder diagnostische waarde.

Ondersteuning en tips

Meer om te lezen

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.