Jeśli strona główna uruchamia się w ZimaOS, ale przeglądarka wyświetla tylko komunikat Host validation failed, kontener może działać prawidłowo. Błąd wynika z kontroli bezpieczeństwa wewnątrz samej aplikacji Homepage, a niekoniecznie z zapory sieciowej ZimaOS lub problemu z portem.
Dlaczego Homepage odrzuca adres IP ZimaOS
Homepage wymaga ustawienia zmiennej HOMEPAGE_ALLOWED_HOSTS, gdy uzyskuje się do niej dostęp za pomocą nazwy hosta lub adresu IP innego niż zawsze dozwolone adresy localhost. Wartość musi odpowiadać hostowi, który Homepage wykrywa w żądaniu, czasami wraz z portem.
Aktualny projekt Homepage wyjaśnia, że zmienna zawiera listę rozdzielaną przecinkami, i zaleca użytkownikom napotykającym ten błąd skopiowanie dokładnie odrzuconego hosta z dziennika aplikacji.
Przy wyborze wartości skorzystaj z aktualnych zasad walidacji hosta w projekcie Homepage.
Odczytaj błąd przed zmianą konfiguracji kontenera
Najważniejsza była kolejność działań zaproponowana w odpowiedzi społeczności: najpierw potwierdź, że Homepage działa na porcie 3000, a następnie sprawdź dziennik kontenera przed zmianą zmiennych środowiskowych. Dziennik zwykle wskazuje, który host został odrzucony.
Jeśli na przykład dziennik odrzuca 192.168.1.20:3000, dodanie innego adresu IP lub nazwy domenowej nie rozwiąże problemu z tym żądaniem. Użyj dokładnie tego hosta, pod którym faktycznie otwierasz stronę.
Ustaw zmienną HOMEPAGE_ALLOWED_HOSTS w środowisku aplikacji
W ustawieniach aplikacji ZimaOS dodaj zmienną środowiskową lub popraw jej wartość, tak aby zawierała docelowy adres IP sieci LAN, nazwę hosta, nazwę używaną przez odwrotny serwer proxy albo kilka hostów rozdzielonych przecinkami.
HOMEPAGE_ALLOWED_HOSTS=192.168.1.20:3000Powyższa wartość jest tylko przykładem. Użyj hosta wskazanego w dzienniku własnej aplikacji Homepage.
Nie używaj * jako domyślnego rozwiązania
Homepage może wyłączyć kontrolę hosta po ustawieniu zmiennej na *, ale w aktualnych instrukcjach wyraźnie odradza takie rozwiązanie. Kontrola hosta pomaga chronić serwer proxy API aplikacji przed nieoczekiwanymi nagłówkami Host.
Jeśli Homepage jest dostępna spoza zaufanej sieci LAN, projekt nadrzędny zaleca również użycie odwrotnego serwera proxy lub VPN wymuszającego uwierzytelnianie i TLS.
Odwrotne serwery proxy wymagają własnego dozwolonego hosta
Jeśli zwykle otwierasz Homepage przez domenę za pośrednictwem Nginx Proxy Manager, Traefika lub innego serwera proxy, host widziany przez Homepage może różnić się od bezpośredniego adresu IP ZimaOS. Dodaj wartość faktycznie wskazaną w dzienniku kontenera, zamiast zgadywać wyłącznie na podstawie adresu URL w przeglądarce.
Często zadawane pytania dotyczące walidacji hosta Homepage
Czy ten błąd oznacza, że port 3000 jest zamknięty?
Niekoniecznie. Jeśli strona błędu Homepage się ładuje, żądanie dotarło już do aplikacji.
Co powinna zawierać zmienna HOMEPAGE_ALLOWED_HOSTS?
Dokładną nazwę hosta lub adres IP, które Homepage wskazuje jako odrzucone, wraz z portem, jeśli dziennik go zawiera.
Czy mogę ustawić HOMEPAGE_ALLOWED_HOSTS=*?
Homepage na to pozwala, ale odradza takie rozwiązanie. W miarę możliwości używaj jawnej listy dozwolonych hostów.
Czy w tym wątku potwierdzono błąd dotyczący konkretnie ZimaOS?
Nie. Jedyna odpowiedź społeczności wskazywała na standardową walidację hosta Homepage, a aktualne działanie aplikacji Homepage zgodnie z projektem nadrzędnym potwierdza to wyjaśnienie.
