Czy Home Assistant może działać za odwrotnym serwerem proxy w podścieżce?

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.

Home Assistant może działać za odwrotnym proxy, ale niezawodne udostępnianie go pod przepisaną podścieżką zasadniczo nie jest obsługiwanym sposobem wdrożenia.

Strona pod adresem example.com/homeassistant może zwrócić HTML, podczas gdy późniejsze żądania nadal będą kierowane do zasobów ze ścieżkami względem katalogu głównego, tras uwierzytelniania, WebSocketów lub callbacków integracji. Przetestuj więcej niż pierwszy ekran: użyj nowej sesji przeglądarki, zaloguj się, otwórz aktualizowany na żywo panel, wczytaj ponownie zagnieżdżoną trasę i wykonaj jeden callback. Jeśli którakolwiek warstwa zgubi prefiks, przenieś Home Assistant pod własną nazwę hosta zamiast dodawać kolejne reguły przepisywania.

Oddziel obsługę odwrotnego proxy od obsługi podścieżek

Odwrotne proxy może terminować TLS i przekazywać żądania z katalogu głównego hosta do Home Assistant. Podścieżka stawia dodatkowy wymóg: każdy generowany adres URL, zasób, wywołanie API, WebSocket, przekierowanie i callback muszą konsekwentnie zachowywać prefiks rozpoznawany przez aplikację. Sukces na poziomie proxy nie potwierdza spełnienia tego kontraktu przez aplikację.

Testy społeczności Home Assistant prowadzą do jednoznacznego wniosku: aplikacja nie obsługuje wdrożenia pod prefiksem URL. Ostateczna odpowiedź na pytanie o umieszczenie Home Assistant w podścieżce zaleca użycie subdomeny niezależnie od wyboru proxy.

WYNIK POZYTYWNY dla obsługi odwrotnego proxy oznacza, że Home Assistant działa w katalogu głównym dedykowanej nazwy hosta przy poprawnym przekazywaniu żądań. WYNIK NEGATYWNY dla proponowanej podścieżki oznacza, że co najmniej jedna trasa aplikacji gubi prefiks. Nie łącz tych werdyktów w twierdzenie, że same odwrotne proxy są niekompatybilne.

Najpierw przetestuj zasoby frontendu — to test obarczony niskim ryzykiem

Otwórz proponowaną podścieżkę w prywatnym profilu przeglądarki i sprawdź żądania sieciowe, zanim zmienisz konfigurację Home Assistant. Jeśli dokument bazowy się ładuje, ale żądania JavaScriptu, ikon, manifestów lub tłumaczeń trafiają do katalogu głównego hosta, topologia już nie przeszła pierwszego odwracalnego testu rozstrzygającego.

Udokumentowana próba przepisywania ścieżki zwróciła stronę główną, podczas gdy frontend żądał zasobów pod ścieżkami zaczynającymi się od ukośnika, bez prefiksu Home Assistant. Ta awaria zasobów ze ścieżek względem katalogu głównego wynika z niezgodności ścieżki aplikacji, a nie z braku pliku na proxy.

WYNIK POZYTYWNY oznacza, że wszystkie zasoby frontendu są poprawnie zwracane pod zamierzoną trasą. WYNIK NEGATYWNY oznacza odpowiedzi 404 lub żądania kierowane do ścieżki głównej. Na tym poprzestań i przetestuj dedykowaną nazwę hosta; podmiana treści odpowiedzi jest zawodna, bo przyszłe kompilacje frontendu mogą wprowadzić nowe ścieżki, których reguła przepisywania nie obejmie.

Testowanie WebSocketów, uwierzytelniania i zagnieżdżonych tras

Statyczna powłoka panelu nie oznacza kompletnej sesji. Zaloguj się z czystego profilu przeglądarki, przez kilka minut obserwuj aktualizacje encji, odśwież adres zagnieżdżonego panelu, wyloguj się i zaloguj ponownie. Następnie sprawdź, czy aktualizacje HTTP, tokeny, przekierowania i ponowne ładowanie tras zachowują ten sam publiczny origin i ścieżkę.

Home Assistant w dużym stopniu korzysta z WebSocketów do komunikacji z interfejsem na żywo, dlatego serwer proxy musi zachować ścieżkę aktualizacji i nagłówki. Relacja użytkownika o obsłudze WebSocketów przez odwrotne proxy pokazuje, dlaczego samo wczytanie HTML-a nie wystarcza do sprawdzenia zgodności.

PASS oznacza, że uwierzytelnianie, aktualizacje na żywo, nawigacja i bezpośrednie przeładowania działają bez błędów tłumaczenia ścieżek. FAIL ograniczony do gniazd lub przekierowań nadal oznacza odrzucenie konfiguracji z podścieżką. Naprawienie jednego polecenia serwera proxy nie dowodzi, że wywołania zwrotne i przyszłe trasy będą obsługiwać prefiks.

Wybierz dedykowaną nazwę hosta jako stabilną granicę

Udostępnij Home Assistant w katalogu głównym dedykowanej nazwy hosta, takiej jak ha.example.com, a następnie przekieruj tę nazwę hosta przez odwrotne proxy do usługi w sieci wewnętrznej. Dzięki temu zachowasz jeden publiczny origin bez konieczności obsługi prefiksu ścieżki przez aplikację. Prywatna sieć VPN lub tunel może zapewnić równie przejrzystą granicę katalogu głównego bez publicznego udostępniania usługi.

Jeśli dotychczasowy zdalny dostęp przestanie działać po zmianach w sieci, sprawdź osobno DNS, publiczny adres, NAT, tunel i routing serwera proxy. Diagnostyka ZimaSpace dotycząca zdalnego dostępu po zmianie routera obejmuje tę pokrewną kontrolę ścieżki.

Alternatywne rozwiązanie przechodzi test, gdy czysta przeglądarka może wczytać zasoby, nawiązać połączenie WebSocket, uwierzytelnić się, odświeżać zagnieżdżone trasy i uzyskać dostęp do Home Assistant po ponownym uruchomieniu serwera proxy. Zachowaj starą trasę tylko na tyle długo, by móc cofnąć zmiany DNS lub konfiguracji serwera proxy; nie utrzymuj bezterminowo dwóch niejednoznacznych publicznych adresów URL.

Zakończ, gdy cała sesja przetrwa ponowne uruchomienie

Uruchom ponownie serwer proxy i Home Assistant, a następnie powtórz pełny test z sieci LAN i docelowej sieci zdalnej. Sprawdź nazwę certyfikatu, przekazywany adres klienta, granicę zaufanych serwerów proxy, logowanie, aktualizacje na żywo, wylogowanie i jedno wywołanie zwrotne integracji. To ten sam test funkcjonalności, a nie ograniczona kontrola strony statycznej.

Ogłoś sukces tylko wtedy, gdy konfiguracja z nazwą hosta w katalogu głównym przejdzie wszystkie testy. Podścieżka działająca wyłącznie po niestandardowym przepisywaniu odpowiedzi nadal stanowi nieobsługiwane ryzyko związane z utrzymaniem, ponieważ aktualizacja może zmienić sposób obsługi zasobów lub wywołań zwrotnych. Udokumentuj sprawdzoną nazwę hosta, adres serwera nadrzędnego i konfigurację przywracania.

Przestaw się na inne rozwiązanie, jeśli konfiguracja z nazwą hosta w katalogu głównym nadal nie działa, ponieważ przyczyną jest wtedy prawdopodobnie zaufanie do serwera proxy, przekazywanie WebSocketów, DNS, certyfikat lub routing, a nie obsługa ścieżki bazowej. Nie udostępniaj Home Assistant bezpośrednio przez niezabezpieczony port tylko po to, by zachować pożądany format adresu URL.

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.