Czy Jellyfin może działać za odwrotnym serwerem proxy w ścieżce podrzędnej?

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.

Tak. Jellyfin może działać za odwrotnym proxy w podścieżce, takiej jak https://example.com/jellyfin, ale Jellyfin i proxy muszą używać tej samej ścieżki bazowej.

Awaria podścieżki zazwyczaj objawia się jako częściowo działająca witryna: strona logowania może się ładować, podczas gdy JavaScript, obrazy, WebSockety, przekierowania lub klienci natywni nie działają. Testuj ścieżkę etapami — najpierw podstawowy adres URL, potem trasa proxy, a na końcu przekazywane nagłówki i adres klienta — aby odróżnić niezgodność ścieżki od problemu z TLS lub tożsamością proxy.

Dopasuj podstawowy adres URL Jellyfin do publicznej podścieżki

Ustaw podstawowy adres URL Jellyfin na dokładny publiczny prefiks, którego chcesz używać, na przykład /jellyfin. Nie dodawaj innego prefiksu wewnętrznego tylko dlatego, że proxy używa bloku lokalizacji o nazwie; ścieżka widoczna w przeglądarce i podstawowy adres URL Jellyfin muszą wskazywać ten sam katalog główny aplikacji.

Dokumentacja Jellyfin dotycząca odwrotnego proxy Apache zawiera przykład podścieżki i wyraźnie zaleca ustawienie podstawowego adresu URL na /jellyfin przed połączeniem klientów z pełnym adresem. oficjalny przykład podścieżki

Po zmianie podstawowego adresu URL uruchom ponownie Jellyfin, a następnie otwórz publiczną podścieżkę w nowym oknie przeglądarki prywatnej. Jeśli początkowe przekierowanie od razu usuwa /jellyfin lub powiela ten fragment, popraw podstawowy adres URL, zanim zmienisz ustawienia WebSocketów lub uwierzytelniania.

Kieruj ten sam prefiks przez odwrotne proxy

Skonfiguruj odwrotne proxy tak, aby żądania rozpoczynające się od publicznego prefiksu były przekazywane do Jellyfin bez wprowadzania dodatkowych przekształceń ścieżki. Najprostsza konfiguracja to jeden publiczny prefiks, zgodny z nim podstawowy adres URL Jellyfin i jedna usługa upstream.

Przewodnik Caddy dotyczący Jellyfin pokazuje ten sam schemat: skonfiguruj ścieżkę bazową Jellyfin, przekieruj sam prefiks do wersji zakończonej ukośnikiem i przekazuj żądania pod tym prefiksem do serwera zaplecza Jellyfin. zgodna ścieżka bazowa i trasa proxy

Jeśli przeglądarka otrzymuje od proxy błąd 404, zanim Jellyfin zarejestruje żądanie, problem dotyczy routingu na poziomie proxy. Jeśli Jellyfin otrzymuje żądanie, ale generuje linki bez prefiksu, nieprawidłowy jest podstawowy adres URL na poziomie aplikacji. Nie myl tych dwóch oznak awarii.

Sprawdź zasoby statyczne i WebSockety, a nie tylko stronę logowania

Poprawna odpowiedź HTML nie wystarczy, by uznać konfigurację podścieżki za prawidłową. Otwórz narzędzia deweloperskie lub dziennik proxy i sprawdź, czy żądania dotyczące JavaScriptu, CSS, obrazów, API i WebSocketów pozostają pod tym samym publicznym prefiksem.

Przykłady konfiguracji reverse proxy dla Jellyfin obejmują obsługę WebSocket, ponieważ interaktywne klienty utrzymują połączenie przez gniazdo obok zwykłych żądań HTTP. Reguła proxy obsługująca tylko żądania dotyczące stron może więc wyglądać na poprawną, dopóki nie przestaną działać informacje o stanie odtwarzania, aktualizacje sesji lub działanie interfejsu na żywo. wymagania dotyczące reverse proxy

Warunek zaliczenia jest prosty: brak powtarzających się odpowiedzi 404/502 dla zasobów z prefiksem, pomyślna aktualizacja połączenia WebSocket i nawigacja, która nie przechodzi do głównej ścieżki witryny. Jeśli zawodzi tylko jedna klasa żądań, popraw tę regułę proxy zamiast zmieniać ustawienia biblioteki lub uwierzytelniania Jellyfin.

Zachowaj tożsamość klienta za pośrednictwem proxy

Gdy ścieżka już działa, sprawdź przekazywane informacje o kliencie. Jellyfin używa konfiguracji zaufania do proxy, aby zdecydować, czy akceptować przekazywane adresy i protokoły, co wpływa na rozróżnianie dostępu lokalnego i zdalnego oraz reguły dostępu zewnętrznego.

Poradnik sieciowy Jellyfin ostrzega, że nagłówki przekazywane przez niezaufane proxy są odrzucane, i zaleca skonfigurowanie adresu proxy w sekcji Known Proxies. Ustawienie Known Proxies Osobna weryfikacja adresu IP klienta jest przydatna, gdy witryna działa, ale wygląda na to, że wszystkie żądania pochodzą z proxy.

Nie rozwiązuj problemu z identyfikacją, ufając każdej prywatnej podsieci ani wszystkim przekazywanym nagłówkom. Dodaj tylko rzeczywisty przeskok proxy lub kontrolowaną sieć proxy, a następnie porównaj w logach Jellyfin jedno żądanie z sieci LAN i jedno zdalne, aby potwierdzić, że są klasyfikowane zgodnie z oczekiwaniami.

Testuj osobno adresy przeglądarki i klienta natywnego

Gdy klient Jellyfin poprosi o adres URL serwera, wpisz pełny adres, łącznie z podścieżką. Klientowi z zapisanym adresem https://example.com nie uda się ustalić, że Jellyfin działa pod adresem /jellyfin.

Przetestuj jedną przeglądarkę i jednego natywnego klienta w sieci LAN, a następnie powtórz test przez publiczną nazwę hosta. Jeśli nazwa hosta działa, ale bezpośredni dostęp przez lokalny adres IP nie, może to być oczekiwane, gdy trasa proxy i certyfikat zależą od nazwy hosta; testowanie nazwy hosta i adresu IP pomaga rozpoznać taki przypadek bez osłabiania zabezpieczeń proxy.

Zatrzymaj się, gdy prefiksowany URL działa po zalogowaniu, podczas nawigacji, korzystania z WebSocket i odtwarzania na obsługiwanych przez Ciebie klientach. Jeśli problem występuje tylko w jednym kliencie, a przeglądarka i pozostałe klienty działają, potraktuj to jako problem z adresem klienta lub jego zgodnością, zamiast zmieniać działającą konfigurację proxy.

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.