Dlaczego logowanie do Home Assistant nie działa po ponownym uruchomieniu odwrotnego serwera proxy?

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.

Jeśli logowanie do Home Assistant nie działa tylko po ponownym uruchomieniu odwrotnego proxy, najpierw przetestuj logowanie przez sieć LAN bezpośrednio i nie zmieniaj bazy użytkowników, dopóki nie ustalisz, że przyczyną jest ścieżka przez proxy.

Ponowne uruchomienie proxy może zmienić adres kontenera, przekazywane informacje o kliencie, obsługę WebSocketów, docelowy serwer DNS lub serwer zaplecza, nie zmieniając przy tym żadnego hasła Home Assistant. Dlatego usuwanie konta i zbiorcowe resetowanie sesji to kiepskie pierwsze kroki. Porównaj bezpośredni adres URL Home Assistant ze zwykłą nazwą hosta proxy, zapisz błędy z przeglądarki i proxy oraz ustal, czy problem występuje przed uwierzytelnieniem, podczas żądania logowania czy przy otwieraniu przez frontend trwałego połączenia.

Najpierw oddziel uwierzytelnianie Home Assistant od problemów z połączeniem przez proxy

Użyj tego samego sprawdzonego konta, logując się zarówno przez bezpośredni lokalny adres Home Assistant, jak i przez publiczną lub wewnętrzną nazwę hosta proxy. Jeśli logowanie bezpośrednie działa, a przez proxy nie, konto i stan uwierzytelniania Core są prawdopodobnie wystarczająco sprawne, by ich nie ruszać. Jeśli oba sposoby zawodzą, skieruj dochodzenie z powrotem na Home Assistant, przywrócony stan lub same dane logowania.

W jednym przypadku logowania przez odwrotne proxy zachowanie przy bezpośrednim połączeniu różniło się od tego przy połączeniu przez Apache, dopóki nie poprawiono ustawień WebSocketów i proxy. Takie porównanie połączenia bezpośredniego z połączeniem przez proxy jest bardziej pomocne w diagnozie niż wielokrotna zmiana haseł.

Zanim zmienisz konfigurację, zapisz kod statusu HTTP, łańcuch przekierowań, błąd konsoli przeglądarki, odpowiedź serwera nadrzędnego proxy oraz znacznik czasu odpowiadający wpisowi w dzienniku Home Assistant. Błąd 400 spowodowany niezaufanym proxy, nieudane połączenie WebSocket, przekierowanie do niewłaściwego schematu i nieprawidłowe hasło to różne problemy, nawet jeśli na ekranie pojawia się ten sam ogólny komunikat o braku możliwości połączenia.

Cztery przyczyny po stronie proxy pozostawiają różne ślady

Najczęstsze przyczyny to zmieniony adres źródłowy proxy, który nie pasuje już do reguły zaufanych proxy, zmienione nagłówki przekazywane dalej lub schemat, nieprawidłowa obsługa WebSocketów albo kierowanie ruchu do niewłaściwego zaplecza Home Assistant. Ponowne utworzenie kontenera proxy może zmienić jeden z tych elementów, podczas gdy sama instancja Home Assistant pozostaje bez zmian.

Niedawny przypadek rozwiązywania problemów z proxy odwrotnym pokazuje, że Home Assistant odrzuca przekazywany ruch, dopóki bezpośrednie proxy nie znajdzie się we właściwym zaufanym zakresie. Ta weryfikacja tożsamości zaufanego proxy jest bezpieczniejsza niż trwałe rozszerzenie zakresu: sprawdź, który adres proxy faktycznie łączy się z Home Assistant, i zaufaj tylko tej granicy.

Skorzystaj z poniższych oznak i zmieniaj tylko jedną gałąź naraz. Po testach nie pozostawiaj szerokiego zakresu zaufanych proxy; osłabia to ważną ochronę przed fałszowaniem przekazywanych adresów klientów.

Przyczyna 1: Ponowne uruchomienie zmieniło źródłowy adres proxy

  • Oznaka: żądania są natychmiast odrzucane, a logi Home Assistant wskazują niezaufane proxy odwrotne.
  • Sprawdź: porównaj podsieć/adres kontenera proxy ze skonfigurowanym zakresem zaufanym.
  • JEŚLI–TO: jeśli przywrócenie właściwego, wąskiego zakresu zaufanych adresów naprawia logowanie, pozostaw stan konta i sesji bez zmian.

Przyczyna 2: Przekazywany host lub schemat nie pasuje już do publicznego adresu

  • Oznaka: przekierowania przełączają się między HTTP/HTTPS lub alternatywnymi nazwami hosta albo pliki cookie wydają się powiązane z nieoczekiwanym źródłem.
  • Sprawdź: porównaj nagłówki Host i przekazywany schemat przed ponownym uruchomieniem i po nim.
  • JEŚLI–TO: jeśli skorygowanie tych wartości naprawia pętlę przekierowań/logowania, problem dotyczył tożsamości punktu wejściowego, a nie użytkowników Home Assistant.

Przyczyna 3: Strona logowania się ładuje, ale aktualizacja połączenia WebSocket kończy się niepowodzeniem

  • Oznaka: interfejs statyczny się ładuje, po czym połączenie frontendu zostaje przerwane lub nie może on zakończyć inicjalizacji.
  • Sprawdź: sprawdź żądanie WebSocket w przeglądarce i nagłówki proxy służące do aktualizacji połączenia.
  • JEŚLI–TO: jeśli przy dostępie bezpośrednim połączenie WebSocket pozostaje otwarte, a przy dostępie przez nazwę hosta nie, zajmij się warstwą proxy.

Przyczyna 4: Proxy wskazuje inny lub świeżo utworzony serwer zaplecza

  • Oznaka: serwer wygląda na nowo skonfigurowany, znani użytkownicy znikają albo stan specyficzny dla serwera różni się przy dostępie przez proxy.
  • Sprawdź: porównaj adres serwera nadrzędnego, tożsamość instancji i ścieżkę konfiguracji.
  • JEŚLI–TO: jeśli proxy trafia do niewłaściwego kontenera lub przywróconej instancji, popraw routing przed zmianą danych uwierzytelniających.

Wykorzystaj działanie WebSocket, aby nie mylić błędu interfejsu z błędem logowania

Interfejs Home Assistant po początkowej wymianie HTTP wymaga trwałego połączenia WebSocket. Dlatego proxy może poprawnie wyświetlać stronę logowania, ale chwilę później przestać działać, gdy połączenie zmienia protokół lub pozostaje otwarte. Użytkownicy często opisują tę sekwencję jako błąd logowania, ponieważ występuje zaraz po przesłaniu danych logowania.

Konfiguracja odwrotnego proxy dla Home Assistant na Synology docierała do strony logowania, ale nadal nie działała, dopóki nie poprawiono obsługi przełączania protokołu WebSocket. Sprawdzenie obsługi przełączania protokołu WebSocket przez proxy pozwala uniknąć niepotrzebnego resetowania kont, gdy ścieżka logowania HTTP działa prawidłowo.

Jeśli połączenie nie działa, sprawdź obsługę przełączania protokołu HTTP/1.1, limity czasu, terminację TLS, nazwę hosta oraz ewentualne oprogramowanie pośredniczące CDN lub uwierzytelniające przed proxy. Ogranicz zakres zmian do minimum. Nie dodawaj niezwiązanych nagłówków skopiowanych z innego stosu proxy, chyba że nieudane żądanie wykaże, dlaczego są potrzebne.

Zweryfikuj poprawkę po dwóch restartach proxy i użyciu czystego klienta

Po zastosowaniu odpowiedniej poprawki zaloguj się i wyloguj przez standardową nazwę hosta, otwórz pulpit nawigacyjny na tyle długo, by potwierdzić stabilność połączenia WebSocket, a następnie powtórz test w prywatnym oknie przeglądarki lub na drugim kliencie. Potem dwukrotnie zrestartuj proxy i uruchom ponownie hosta proxy, jeśli przyczyną może być adres kontenera lub sieć.

Porównanie lokalnych i zdalnych ścieżek połączenia z Home Assistant w ZimaSpace opiera się na tej samej zasadzie izolacji: zachowaj działającą lokalną ścieżkę aplikacji, testując dodatkowe warstwy DNS, TLS, proxy i routingu używane przy połączeniu zdalnym.

Uznaj test za zaliczony, gdy logowanie bezpośrednie i przez proxy prowadzi do tej samej instancji Home Assistant, zaufany jest oczekiwany, wąski adres proxy, przekierowania zachowują zamierzony schemat i host, WebSocket działa stabilnie przy normalnym użytkowaniu, a restart proxy nie zmienia wyniku. Zgłoś problem z uwierzytelnianiem Home Assistant tylko wtedy, gdy to samo sprawdzone konto nie działa również przy połączeniu bezpośrednim.

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.