Sì. Jellyfin può funzionare dietro un reverse proxy su un sottopercorso come https://example.com/jellyfin, ma Jellyfin e il proxy devono usare lo stesso percorso di base.
Un problema con il sottopercorso di solito si manifesta come un sito che funziona solo in parte: la pagina di accesso può caricarsi, mentre JavaScript, immagini, WebSocket, reindirizzamenti o client nativi non funzionano. Verifica i livelli del percorso in sequenza: prima il Base URL, poi la route del proxy, infine le intestazioni inoltrate e l'indirizzo del client. Così potrai distinguere un percorso non corrispondente da un problema di TLS o di identità del proxy.
Fai corrispondere il Base URL di Jellyfin al sottopercorso pubblico
Imposta il Base URL di Jellyfin sul prefisso pubblico esatto che intendi usare, ad esempio /jellyfin. Non aggiungere un prefisso interno diverso solo perché il proxy usa un blocco location con nome; il percorso visibile nel browser e il Base URL di Jellyfin devono indicare la stessa radice dell'applicazione.
La documentazione di Jellyfin sul reverse proxy Apache include esplicitamente un esempio con un sottopercorso e indica agli amministratori di impostare il Base URL su /jellyfin prima di collegare i client all'indirizzo completo. esempio ufficiale con sottopercorso
Riavvia Jellyfin dopo aver modificato il Base URL, quindi apri il sottopercorso pubblico in una nuova finestra di navigazione privata. Se il reindirizzamento iniziale elimina subito /jellyfin o lo duplica, correggi il Base URL prima di modificare le impostazioni di WebSocket o autenticazione.
Instrada lo stesso prefisso tramite il reverse proxy
Configura il reverse proxy in modo che le richieste che iniziano con il prefisso pubblico vengano inoltrate a Jellyfin senza introdurre trasformazioni aggiuntive del percorso. La configurazione più semplice prevede un unico prefisso pubblico, un Base URL di Jellyfin corrispondente e un unico servizio upstream.
La guida di Caddy per Jellyfin mostra lo stesso schema: configura il percorso di base di Jellyfin, reindirizza il prefisso senza barra finale alla versione con la barra finale e inoltra al backend Jellyfin le richieste che usano quel prefisso. percorso di base e route del proxy corrispondenti
Se il browser riceve un 404 dal proxy prima che Jellyfin registri la richiesta, il percorso è errato a livello del proxy. Se Jellyfin riceve la richiesta ma genera link senza il prefisso, il Base URL è errato a livello dell'applicazione. Tieni separate queste due casistiche.
Controlla le risorse statiche e i WebSocket, non solo la pagina di accesso
Una risposta HTML riuscita non basta per considerare corretta la configurazione del sottopercorso. Apri gli strumenti per sviluppatori o il log del proxy e verifica che le richieste JavaScript, CSS, immagini, API e WebSocket rimangano tutte sotto lo stesso prefisso pubblico.
Gli esempi di proxy inverso di Jellyfin includono la gestione di WebSocket perché i client interattivi mantengono una connessione socket oltre alle normali richieste HTTP. Una regola proxy che gestisce solo le richieste delle pagine può quindi sembrare corretta finché non si interrompono lo stato della riproduzione, gli aggiornamenti della sessione o il comportamento dell'interfaccia in tempo reale. requisiti del proxy inverso
Il criterio di verifica è semplice: nessuna risposta 404/502 ripetuta per le risorse con prefisso, aggiornamento WebSocket riuscito e navigazione che non ritorna alla radice del sito. Se non funziona una sola categoria di richieste, correggi quella regola del proxy invece di modificare la libreria o le impostazioni di autenticazione di Jellyfin.
Mantieni l'identità del client attraverso il proxy
Dopo aver verificato il funzionamento del percorso, controlla le informazioni inoltrate sul client. Jellyfin usa la configurazione di attendibilità del proxy per decidere se accettare gli indirizzi e i protocolli inoltrati; ciò influisce sul comportamento locale o remoto e sulle regole di accesso esterno.
La guida di rete di Jellyfin avverte che le intestazioni inoltrate da un proxy non attendibile vengono ignorate e consiglia di configurare l'indirizzo del proxy in Proxy attendibili. Impostazione Proxy attendibili Una verifica separata dell'IP del client è utile se il sito funziona, ma tutte le richieste sembrano provenire dal proxy.
Non risolvere un problema di identificazione fidandoti di ogni subnet privata o di ogni intestazione inoltrata. Aggiungi solo il passaggio effettivo del proxy o la rete proxy controllata, poi confronta una richiesta dalla LAN e una remota nei log di Jellyfin per verificare che siano classificate come previsto.
Prova separatamente gli indirizzi del browser e del client nativo
Quando un client Jellyfin chiede l'URL del server, inserisci l'indirizzo completo, compreso il sottopercorso. Un client configurato con https://example.com non può dedurre che Jellyfin si trovi in /jellyfin.
Prova un browser e un client nativo dalla LAN, poi ripeti usando il nome host pubblico. Se il nome host funziona ma l'accesso diretto tramite IP locale no, potrebbe essere normale quando il percorso del proxy e il certificato dipendono dal nome host; i test del nome host rispetto all'IP aiutano a isolare il caso senza indebolire il proxy.
Fermati quando l'URL con prefisso continua a funzionare dopo l'accesso, durante la navigazione, l'uso di WebSocket e la riproduzione sui client effettivamente supportati. Se non funziona un solo client, mentre il browser e gli altri client funzionano, considera il problema legato all'indirizzo o alla compatibilità del client, anziché riscrivere una configurazione proxy funzionante.
Assistenza e consigli
Altre letture

Come tenere nascosti i video per adulti sul tuo NAS ai tuoi familiari
Tieni privati i video per adulti su un NAS familiare. Controlla le autorizzazioni delle cartelle, l’accesso alle librerie di Plex e Jellyfin, le miniature,...

Cosa controllare prima di caricare un modello della community in Transformers
Usa l’aggiornamento della sandbox Jinja di Transformers per esaminare la provenienza dei modelli, i template di chat, il codice remoto, i pesi serializzati e...

Esegui Mirage in locale: OCR e rilevamento degli oggetti da una sola immagine
Prova il piccolo modello di visione locale di Cactus Compute, verifica l’OCR e l’estrazione degli oggetti con input reali e comprendi i limiti di...



