Warum verliert Home Assistant nach einer Proxy- oder DNS-Änderung Sitzungen?

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Ein Sitzungsverlust nach einer Proxy- oder DNS-Änderung ist meist auf eine Abweichung zwischen dem URL-Ursprung des Clients und der Route zurückzuführen, die Home Assistant jetzt erkennt, nicht auf beschädigte Benutzerkonten.

Ein Browser kann noch Cookies und Frontendstatus für den alten Hostnamen speichern, während ein Telefon die neue Adresse auflöst, oder der Proxy stellt die Anmeldeseite bereit, aber die authentifizierte WebSocket-Verbindung schlägt fehl. Beginnen Sie mit einem privaten Browserfenster und einem direkten LAN-Test, notieren Sie für jedes Ergebnis das genaue Schema und den Hostnamen und vermeiden Sie es, alle Sitzungen zu löschen, bevor die fehlerhafte Ebene ermittelt ist.

Clientseitigen Status von einem gemeinsamen Pfadfehler unterscheiden

Öffnen Sie Home Assistant in einem privaten Fenster mit der vorgesehenen endgültigen URL und vergleichen Sie das Ergebnis anschließend mit dem betroffenen Browser und der mobilen App. Halten Sie fest, ob die Anmeldung abgeschlossen wird, ob das Dashboard fünf Minuten lang verbunden bleibt und ob die Sitzung nach dem Aktualisieren einer Seite erhalten bleibt. Dieser reversible Vergleich prüft, ob der Clientstatus veraltet ist, ohne den Server zu verändern.

Ein Proxy kann die Anmeldeseite zurückgeben, während das authentifizierte Frontend später meldet, dass keine Verbindung hergestellt werden kann. Dieser Verbindungsfehler nach erfolgreicher Anmeldung zeigt, warum eine gerenderte HTML-Seite kein Beweis dafür ist, dass der gesamte Sitzungspfad funktioniert.

Wenn nur der alte Browser fehlschlägt und das private Fenster stabil bleibt, löschen Sie auf diesem Client die Websitedaten für die alten und neuen Home-Assistant-Ursprünge und melden Sie sich dann erneut an. Wenn jeder Client über die Proxy-URL fehlschlägt, der direkte LAN-Zugriff aber funktioniert, behalten Sie den Clientstatus bei und konzentrieren Sie sich auf den Proxy-Pfad.

WebSocket- und Forwarded-Origin-Verarbeitung überprüfen

Prüfen Sie während der Anmeldung die Netzwerkansicht des Browsers oder das Proxy-Protokoll und achten Sie auf das WebSocket-Upgrade, den Status, den Zeitpunkt der Verbindungsabbrüche, das weitergeleitete Schema, den weitergeleiteten Host und die Client-Adresse. Entscheidend ist der Unterschied zwischen einer ladenden HTTP-Seite und einem dauerhaften authentifizierten Kanal, der das Upgrade durchführt und geöffnet bleibt.

Bei der Fehlerbehebung von Home Assistant mit Reverse-Proxy wird WebSocket-Weiterleitung wiederholt als separate Anforderung neben dem normalen HTTP-Proxying genannt. Verwenden Sie diesen Mechanismus nur, um den Upgrade-Pfad zu verstehen, nicht als Beweis dafür, dass eine Nginx-Konfiguration für jeden Proxy geeignet ist.

Wenn das Upgrade fehlschlägt, korrigieren Sie nur die Proxy-Route, die Upgrade-Header, das weitergeleitete Schema oder die Vertrauensgrenze des Proxys, die laut Protokollen fehlerhaft ist. Wenn es gelingt und die Verbindung bestehen bleibt, lassen Sie den Proxy unverändert und untersuchen Sie stattdessen DNS und den Ursprungsstatus des Clients.

DNS-Antworten und endgültige URLs vergleichen

Lösen Sie den Home-Assistant-Hostnamen auf dem fehlerhaften Client, einem funktionierenden Client und dem Proxy-Host auf. Vergleichen Sie IPv4-, IPv6- und Split-DNS-Antworten, den Zertifikatsnamen, das Weiterleitungsziel und die in der Begleit-App gespeicherte URL. Eine DNS-Änderung ist erst abgeschlossen, wenn Clients den vorgesehenen Endpunkt unter demselben kanonischen Hostnamen erreichen.

Der umfassendere Zusammenhang zwischen Erkennung, Namensauflösung und Routing ist im Erreichbarkeitsmodell von Home Assistant dargestellt. Nutzen Sie es, um eine veraltete DNS-Antwort von einem Fehler auf Sitzungsebene zu unterscheiden.

Wenn Clients unterschiedliche Endpunkte auflösen, warten Sie die dokumentierte TTL ab oder leeren Sie den Resolver-Cache nur auf dem betroffenen Client und dem lokalen Resolver. Erstellen Sie keine konkurrierenden temporären Hostnamen, da jeder zusätzliche Ursprung eine weitere Cookie- und Weiterleitungsgrenze schafft.

Den ursprünglichen Sitzungspfad erneut testen und gezielt eskalieren

Melden Sie sich über die endgültige öffentliche oder private URL an, lassen Sie ein Live-Dashboard geöffnet, laden Sie eine verschachtelte Ansicht neu, wechseln Sie einmal das Netzwerk, falls der Fernzugriff Teil des Konzepts ist, und wiederholen Sie den Test nach einem Neustart eines Clients. Der Test ist bestanden, wenn dieselbe kanonische URL, eine stabile WebSocket-Verbindung und die Sitzung über den ursprünglichen Auslöser hinweg erhalten bleiben.

Wenn der saubere Client funktioniert, aber ein vorhandener Client weiterhin fehlschlägt, reparieren Sie nur das Profil oder die App-Verbindung dieses Clients. Wenn alle Proxy-Clients mit denselben Upgrade- oder Weiterleitungsnachweisen fehlschlagen, machen Sie die letzte Proxy- oder DNS-Änderung rückgängig und sichern Sie die Protokolle, bevor Sie eine weitere Änderung vornehmen.

Eskalieren Sie mit der genauen Klasse der fehlerhaften URL, den DNS-Antworten, Proxy-Statuscodes, dem WebSocket-Ergebnis, Zeitstempeln und dem Client-Vergleich. Beenden Sie die Prüfung, sobald zwei verschiedene Clients ihre Sitzungen nach Aktualisieren und erneutem Verbinden beibehalten; weitere Änderungen an Cookies oder Proxys bergen dann Risiken, ohne diagnostischen Nutzen zu bringen.

Support und Tipps

Mehr zum Lesen

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.