Dlaczego Home Assistant traci sesje po zmianie proxy lub DNS?

Eva Wong jest redaktorką techniczną i rezydentką majsterkowania w ZimaSpace. Jest geekiem od zawsze, z pasją do domowych laboratoriów i oprogramowania open source, a jej specjalnością jest przekładanie złożonych zagadnień technicznych na przystępne, praktyczne poradniki. Eva wierzy, że samodzielne hostowanie powinno sprawiać radość, a nie onieśmielać. Dzięki swoim samouczkom pomaga społeczności oswoić konfigurację sprzętu, od budowy pierwszego serwera NAS po opanowanie kontenerów Docker.

Utrata sesji po zmianie proxy lub DNS zwykle wynika z niezgodności między źródłem adresu URL używanym przez klienta a trasą widzianą teraz przez Home Assistant, a nie z uszkodzenia kont użytkowników.

Przeglądarka może nadal przechowywać pliki cookie i stan interfejsu dla starej nazwy hosta, podczas gdy telefon rozpoznaje nowy adres, albo proxy może wyświetlać stronę logowania, lecz nie obsługiwać uwierzytelnionego połączenia WebSocket. Zacznij od jednego okna prywatnego i jednego testu bezpośredniego dostępu przez LAN, zapisz dokładny schemat i nazwę hosta dla każdego wyniku i nie usuwaj wszystkich sesji, dopóki nie ustalisz, która warstwa zawodzi.

Oddziel stan jednego klienta od awarii wspólnej ścieżki

Otwórz Home Assistant w oknie prywatnym, używając docelowego adresu URL, a następnie porównaj działanie z problematyczną przeglądarką i aplikacją mobilną. Zapisz, czy logowanie się powiodło, czy pulpit pozostaje połączony przez pięć minut i czy odświeżenie strony nie przerywa sesji. To odwracalne porównanie pozwala sprawdzić, czy przyczyną jest nieaktualny stan klienta, bez wprowadzania zmian na serwerze.

Proxy może wyświetlać stronę logowania, a uwierzytelniony interfejs później zgłaszać brak możliwości połączenia. Ta awaria połączenia po pomyślnym logowaniu pokazuje, dlaczego samo wyświetlenie kodu HTML nie dowodzi, że cała ścieżka sesji działa.

Jeśli problem występuje tylko w starej przeglądarce, a w oknie prywatnym połączenie pozostaje stabilne, usuń dane witryn dla starego i nowego adresu Home Assistant w tej przeglądarce, a następnie zaloguj się ponownie. Jeśli na adresie proxy problem występuje we wszystkich klientach, ale bezpośredni dostęp przez LAN działa, nie zmieniaj stanu klientów i przejdź do sprawdzania ścieżki przez proxy.

Weryfikacja obsługi WebSocketów i nagłówków Forwarded-Origin

Podczas logowania obserwuj widok sieci w przeglądarce lub log proxy, zwracając uwagę na przełączanie protokołu WebSocket, status, czas do rozłączenia, przekazywany schemat, przekazywaną nazwę hosta i adres klienta. Istotna różnica polega na tym, czy ładuje się strona HTTP, czy też nawiązywane jest trwałe, uwierzytelnione połączenie, które pozostaje otwarte.

Diagnostyka problemów z odwrotnym proxy Home Assistant wielokrotnie wskazuje przekazywanie WebSocketów jako odrębny wymóg, niezależny od standardowego proxy HTTP. Użyj tego mechanizmu wyłącznie do interpretacji ścieżki przełączania protokołu, a nie jako dowodu, że jedna konfiguracja Nginx sprawdzi się w każdym proxy.

Jeśli przełączenie połączenia nie powiedzie się, popraw tylko trasę proxy, nagłówki przełączenia, przekazywany schemat lub granicę zaufanego proxy, które według logów są nieprawidłowe. Jeśli się powiedzie i połączenie pozostanie aktywne, nie zmieniaj ustawień proxy i zamiast tego sprawdź DNS oraz stan originu klienta.

Porównaj odpowiedzi DNS i końcowe adresy URL

Rozwiąż nazwę hosta Home Assistant na kliencie, na którym występuje problem, działającym kliencie i hoście proxy. Porównaj odpowiedzi IPv4, IPv6 i split-DNS, nazwę certyfikatu, docelowy adres przekierowania oraz adres URL zapisany w aplikacji towarzyszącej. Zmianę DNS można uznać za zakończoną dopiero wtedy, gdy klienty łączą się z właściwym punktem końcowym pod tą samą kanoniczną nazwą hosta.

Szersze zależności między wykrywaniem, rozpoznawaniem nazw i routingiem przedstawiono w modelu osiągalności Home Assistant. Skorzystaj z niego, aby odróżnić nieaktualną odpowiedź DNS od problemu na poziomie sesji.

Jeśli klienty rozwiązują nazwę na różne punkty końcowe, odczekaj określony czas TTL lub wyczyść pamięć podręczną resolvera tylko na kliencie, którego dotyczy problem, oraz lokalnym resolverze. Nie twórz konkurujących tymczasowych nazw hostów, ponieważ każdy dodatkowy origin tworzy kolejną granicę dla plików cookie i przekierowań.

Ponownie przetestuj pierwotną ścieżkę sesji i zgłoś problem w wąskim zakresie

Zaloguj się za pomocą końcowego publicznego lub prywatnego adresu URL, pozostaw otwarty działający pulpit, odśwież widok podrzędny, jednorazowo przełącz sieć, jeśli projekt zakłada dostęp zdalny, a następnie powtórz test po jednym restarcie klienta. Test zalicza się, jeśli ten sam kanoniczny adres URL, stabilne połączenie WebSocket i sesja zostaną zachowane podczas pierwotnego zdarzenia wyzwalającego problem.

Jeśli czysty klient działa poprawnie, ale jeden z dotychczasowych nadal zawodzi, napraw tylko profil tego klienta lub połączenie aplikacji. Jeśli wszystkie klienty korzystające z proxy zawodzą i wskazują na ten sam problem z przełączeniem połączenia lub przekierowaniem, cofnij ostatnią zmianę proxy lub DNS i zachowaj logi, zanim spróbujesz wprowadzić kolejną zmianę.

Zgłoś problem, podając dokładną klasę błędnego adresu URL, odpowiedzi DNS, kody statusu proxy, wynik WebSocket, znaczniki czasu i porównanie klientów. Zakończ, gdy dwa różne klienty utrzymają sesje po odświeżeniu i ponownym połączeniu; dalsze zmiany dotyczące plików cookie lub proxy zwiększają ryzyko, nie dostarczając wartości diagnostycznej.

Wsparcie i porady

Więcej do przeczytania

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.