Kan Jellyfin fungera bakom en omvänd proxy på en undersökväg?

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

Ja. Jellyfin kan fungera bakom en omvänd proxy på en undersökväg som https://example.com/jellyfin, men Jellyfin och proxyn måste använda samma bassökväg.

Ett problem med en undersökväg märks oftast på att webbplatsen fungerar delvis: inloggningssidan kan läsas in medan JavaScript, bilder, WebSockets, omdirigeringar eller inbyggda klienter inte fungerar. Testa sökvägen i flera steg - först Base URL, sedan proxyrutten och sist vidarebefordrade headers och klientadress - så att du kan skilja en felaktig sökväg från ett TLS- eller proxyidentitetsproblem.

Se till att Jellyfins Base URL matchar den offentliga undersökvägen

Ställ in Jellyfins Base URL på exakt det offentliga prefix du tänker använda, till exempel /jellyfin. Lägg inte till ett annat internt prefix bara för att proxyn använder ett namngivet platsblock; den sökväg som visas i webbläsaren och Jellyfins Base URL måste ange samma programrot.

Jellyfins dokumentation för omvänd proxy med Apache innehåller uttryckligen ett exempel på en undersökväg och instruerar administratörer att ställa in Base URL på /jellyfin innan klienter ansluter till den fullständiga adressen. officiellt exempel på undersökväg

Starta om Jellyfin efter att du har ändrat Base URL och öppna sedan den offentliga undersökvägen i ett nytt privat webbläsarfönster. Om den första omdirigeringen omedelbart tar bort /jellyfin eller lägger till det två gånger ska du åtgärda Base URL innan du ändrar inställningarna för WebSocket eller autentisering.

Dirigera samma prefix genom den omvända proxyn

Konfigurera omvänd proxy så att förfrågningar som börjar med det offentliga prefixet vidarebefordras till Jellyfin utan någon extra sökvägsomskrivning. Den enklaste utformningen är ett offentligt prefix, en matchande Base URL i Jellyfin och en uppströms tjänst.

Caddys Jellyfin-guide visar samma mönster: konfigurera Jellyfins bassökväg, omdirigera det nakna prefixet till formen med avslutande snedstreck och skicka förfrågningar under prefixet vidare till Jellyfin-serverdelen. matchande bassökväg och proxyrutt

Om webbläsaren får ett 404-svar från proxyn innan Jellyfin loggar förfrågan är routen felaktig på proxynivå. Om Jellyfin tar emot förfrågan men genererar länkar utan prefixet är Base URL felaktig på applikationsnivå. Håll isär dessa två felbilder.

Kontrollera statiska resurser och WebSockets, inte bara inloggningssidan

Ett lyckat HTML-svar räcker inte för att avgöra om konfigurationen av undersökvägen fungerar som den ska. Öppna utvecklarverktygen eller proxyloggen och kontrollera att JavaScript-, CSS-, bild-, API- och WebSocket-förfrågningar alla stannar under samma offentliga prefix.

Jellyfins exempel på omvänd proxy omfattar hantering av WebSocket, eftersom interaktiva klienter upprätthåller en socketanslutning utöver vanliga HTTP-begäranden. En proxyregel som bara hanterar sidbegäranden kan därför verka fungera tills uppspelningsstatus, sessionsuppdateringar eller det direkta gränssnittets funktioner slutar fungera. krav för omvänd proxy

Godkänt resultat är enkelt: inga upprepade 404/502-svar för resurser med prefix, WebSocket-anslutningen uppgraderas och navigeringen leder inte till webbplatsens rot. Om bara en typ av begäran misslyckas åtgärdar du den proxyregeln i stället för att ändra Jellyfins bibliotek eller autentiseringsinställningar.

Bevara klientens identitet genom proxyn

När sökvägen fungerar kontrollerar du vidarebefordrad klientinformation. Jellyfin använder proxyinställningen för betrodda proxyer för att avgöra om vidarebefordrade adresser och protokoll ska godtas, vilket påverkar beteendet för lokala respektive fjärranslutningar och reglerna för extern åtkomst.

Jellyfins nätverksguide varnar för att vidarebefordrade headers från en proxy som inte är betrodd ignoreras och rekommenderar att proxyadressen konfigureras under Known Proxies. inställningen Known Proxies En separat kontroll av klientens IP-adress är användbar när webbplatsen fungerar men varje begäran verkar komma från proxyn.

Försök inte lösa ett identitetsproblem genom att lita på alla privata undernät eller vidarebefordrade headers. Lägg endast till det faktiska proxyhoppet eller det kontrollerade proxynätverket och jämför sedan en begäran från det lokala nätverket med en fjärrbegäran i Jellyfins loggar för att bekräfta att de klassificeras som förväntat.

Testa adresser för webbläsare och inbyggd klient separat

Ange hela serveradressen, inklusive underkatalogen, när en Jellyfin-klient frågar efter serverns URL. En klient som har sparat https://example.com kan inte veta att Jellyfin finns på /jellyfin.

Testa en webbläsare och en inbyggd klient från det lokala nätverket och upprepa sedan testet via det offentliga värdnamnet. Om värdnamnet fungerar men direkt åtkomst via lokal IP-adress inte gör det kan det vara förväntat när proxyrutten och certifikatet är beroende av värdnamnet; test av värdnamn kontra IP-adress hjälper dig att ringa in det fallet utan att försvaga proxyn.

Gå vidare först när den prefixade URL:en fungerar efter inloggning, vid navigering, WebSocket-användning och uppspelning på de klienter du faktiskt stöder. Om bara en klient misslyckas medan webbläsaren och övriga klienter fungerar, bör du se det som ett problem med klientens adress eller kompatibilitet i stället för att skriva om en fungerande proxykonfiguration.

Support och tips

Mer att läsa

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.