Quando Jellyfin funziona prima di un riavvio ma la riproduzione si interrompe dopo, verifica le dipendenze che dovevano essere ripristinate durante l’avvio prima di modificare la libreria.
Il riavvio può modificare i tempi di montaggio, le mappature dei dispositivi del container, i permessi, il DNS o l’ordine in cui i servizi diventano disponibili. Un processo Jellyfin attivo non dimostra che il percorso dei contenuti multimediali o la GPU siano utilizzabili. Confronta l’ambiente dopo l’avvio con la configurazione funzionante di riferimento e ripara la prima dipendenza mancante.
Verifica che il montaggio dei contenuti multimediali sia effettivo
Una directory può esistere anche quando il NAS o il disco che normalmente la occupa non è stato montato. Jellyfin potrebbe quindi vedere un percorso locale vuoto e segnalare contenuti multimediali mancanti invece di mostrare un errore di montaggio evidente.
La verifica del montaggio prima dell’avvio dei servizi impedisce alle applicazioni di scrivere in un punto di montaggio vuoto o di eseguirne la scansione.
Conferma l’identità del filesystem con `findmnt` o con l’equivalente della piattaforma, quindi leggi un file multimediale noto utilizzando l’utente del servizio Jellyfin. Non eseguire una nuova scansione finché lo storage previsto non è disponibile.
Verifica la proprietà dei dati dell’app dopo il ripristino del runtime
La ricreazione del container o le modifiche all’host possono cambiare l’utente numerico che accede alla configurazione persistente. Il solo accesso in lettura non è sufficiente, perché Jellyfin deve anche aggiornare lo stato del database e della configurazione.
I servizi containerizzati rimangono prevedibili quando la mappatura di UID e GID corrisponde alla proprietà del filesystem tra i bind mount.
Esegui un test temporaneo di creazione ed eliminazione nella directory principale dei dati dell’app utilizzando l’identità del servizio. Il percorso persistente dei dati dell’app dovrebbe sopravvivere alla sostituzione del runtime senza dover correggere ricorsivamente la proprietà.
Conferma che i dispositivi hardware siano ricomparsi
Una transcodifica che utilizzava la iGPU prima del riavvio potrebbe passare alla CPU o non riuscire se manca la mappatura di `/dev/dri` o di un altro acceleratore. La riproduzione diretta potrebbe continuare a funzionare, facendo sembrare il problema specifico dei contenuti multimediali.
Una mappatura del dispositivo non riuscita può spostare la stessa riproduzione dall’elaborazione hardware a quella software; un benchmark della transcodifica di Jellyfin mostra quanto cambino il carico della CPU e quello della GPU tra percorsi con accelerazione hardware e percorsi filtrati.
Riproduci un test noto di transcodifica hardware e controlla il processo attivo insieme alla mappatura del dispositivo. Ripristina l’accesso del runtime al dispositivo prima di ridurre la qualità o cambiare codec.
Ripeti il test del percorso di rete solo dopo aver verificato la riproduzione locale
I servizi DNS remoti, VPN o proxy possono avviarsi dopo Jellyfin e causare un errore solo da remoto. Mantieni la riproduzione locale e la raggiungibilità remota come test di accettazione separati.
La capacità di rete dovrebbe essere verificata sul punto effettivo di distribuzione; un modello della larghezza di banda per lo streaming separa i limiti di LAN, Wi‑Fi, NAS e upload remoto invece di attribuire ogni errore di riproduzione all’elaborazione del server.
Verifica prima un client locale cablato, quindi un client remoto. Se la riproduzione locale funziona, concentra la riparazione restante sulla configurazione di routing, DNS, proxy o tunnel invece di ricostruire lo stato del server.
Supporto e consigli
Altro da leggere

È meglio eseguire il backup di Jellyfin mentre è in funzione o arrestare prima il servizio?
Per semplicità, preferisci i backup con il servizio arrestato; usa gli snapshot a caldo solo quando lo stato dell’applicazione viene acquisito in modo coerente...

Perché Jellyfin funziona a temperature elevate o è rumoroso quando nessuno sta guardando contenuti in streaming?
Il calore in stato di inattività di solito indica attività in background o un carico di lavoro su un host condiviso, quindi identifica il...

Quando dovresti ricostruire Jellyfin invece di ripararlo?
Scegli la ricostruzione invece della riparazione quando il problema è la deriva dell’ambiente di esecuzione e lo stato persistente è stato sottoposto a backup;...

