Perché la scansione della libreria multimediale non rileva i film in una condivisione montata?
Una scansione dei contenuti multimediali non rileva i film quando il server non riesce ad attraversare il percorso montato, visualizza un percorso diverso oppure rifiuta i file durante l'identificazione.
Su un NAS domestico, “la condivisione è montata” può significare soltanto che la shell dell'host riesce a vedere una directory. Il processo del server multimediale potrebbe trovarsi all'interno di Docker, utilizzare un altro percorso di bind, essere eseguito con un UID diverso oppure scansionare un punto di montaggio locale vuoto rimasto dopo la disconnessione della condivisione remota. Diagnostica un film mancante dall'archiviazione all'applicazione invece di avviare ripetutamente scansioni complete che non possono correggere un problema di percorso, autorizzazioni, denominazione o analisi.
Dimostra che la condivisione montata contiene il film in questo momento
Controlla il percorso esatto della sorgente della libreria dall'host ed elenca un film mancante usando il nome file completo. Conferma il tipo di filesystem, la sorgente del montaggio, le opzioni di montaggio, lo spazio libero e il numero di file noto, invece di fidarti del semplice fatto che la directory del punto di montaggio esista.
Una condivisione di rete disconnessa può lasciare una normale directory vuota nello stesso punto di montaggio, consentendo alla scansione di terminare senza trovare contenuti multimediali. Un report di Jellyfin descrive una scansione che sembrava riuscita anche se il percorso di destinazione risultava contenere zero elementi.
Leggi una piccola parte del file mancante ed elenca le directory principali. Se la condivisione è assente, ripristina il montaggio prima della scansione e configura il servizio multimediale in modo che si avvii solo dopo che il filesystem remoto è disponibile. Non aggiungere il punto di montaggio locale vuoto come secondo percorso della libreria.
Controlla il percorso dall'interno del contenitore del server multimediale
Accedi al contenitore in esecuzione e controlla il percorso esatto configurato nella libreria. L'host potrebbe utilizzare /mnt/media/movies, mentre il contenitore lo visualizza come /media/movies; nell'applicazione va utilizzato solo il percorso visibile dal contenitore.
I nuovi contenuti possono rimanere invisibili anche quando gli elementi meno recenti continuano a essere riprodotti, se il contenitore in esecuzione non vede più il percorso host corrente oppure riceve contenuti di montaggio obsoleti. Un caso di Jellyfin ha segnalato che i nuovi contenuti non comparivano dopo scansioni ripetute.
Confronta la definizione del montaggio del contenitore con il montaggio effettivo mostrato dal runtime. Verifica che la sorgente del bind sia la condivisione realmente montata, non una directory principale o un percorso obsoleto. Ricrea il contenitore solo dopo aver confermato che i montaggi della configurazione persistente e del database non siano cambiati.
Verifica l'attraversamento delle directory con l'utente effettivo del servizio
Usa UID e GID del server multimediale per elencare ogni directory dalla radice della libreria fino al file del film. Non basta leggere il file: il processo deve avere anche il permesso di esecuzione su ogni directory principale per attraversare il percorso.
Un problema di visibilità della libreria di Jellyfin identifica l'assenza dei permessi di lettura ed esecuzione delle directory come causa diretta della mancata comparsa degli elementi. Il punto fondamentale è il permesso di attraversamento della directory, non la possibilità per un account amministratore di navigare nella condivisione.
Correggi la regola più circoscritta di proprietà, gruppo o ACL che fornisce al servizio l'accesso in sola lettura ai contenuti multimediali. La guida di ZimaSpace sulle autorizzazioni dopo lo spostamento dei file descrive il flusso di lavoro correlato quando la condivisione funziona tramite SMB ma non dall'interno del contenitore.
Confronta un film mancante con uno rilevato
Scegli due cartelle nella stessa condivisione montata: una relativa a un film rilevato dalla libreria e una relativa a un film ignorato. Confronta nome file, estensione, profondità della cartella, maiuscole e minuscole, caratteri speciali, dimensione del file, utilizzo di collegamenti simbolici, permessi, date e completezza del file.
Alcuni errori dello scanner riguardano singoli elementi e non l'intera condivisione. Un caso segnalato di Jellyfin ha rilevato film comparsi solo dopo essere stati spostati in un'altra cartella, dimostrando perché un confronto controllato tra elemento rilevato e mancante sia più utile di un'altra scansione globale.
Rinomina o sposta soltanto un elemento di prova copiato in una struttura semplice come Movies/Movie Name (Year)/Movie Name (Year).mkv. Se la copia compare, analizza la denominazione della cartella originale, i marcatori nascosti, i permessi o il comportamento del filesystem prima di modificare l'intera libreria.
Leggi il registro dello scanner in corrispondenza del primo percorso mancante
Avvia una scansione mirata e segui il registro dal momento in cui lo scanner entra nella directory interessata. Cerca messaggi relativi ad accesso negato, directory inesistente, errori di I/O, file non supportati, errori di analisi, vincoli del database, errori dei provider di metadati e annullamento della scansione.
Una scansione completa può interrompere o saltare operazioni dopo un'eccezione a livello di percorso, mentre l'interfaccia mostra soltanto una libreria incompleta. Jellyfin ha documentato scansioni influenzate da un'eccezione relativa a una directory mancante, rendendo il primo errore più importante dell'indicatore finale di avanzamento.
Correggi il primo errore riproducibile ed esegui nuovamente la scansione più piccola possibile. Non eliminare il database della libreria, i metadati o la cache finché non hai verificato la visibilità del percorso e i permessi; i ripristini distruttivi possono rimuovere le prove diagnostiche senza riparare la condivisione montata.
Verifica la correzione con un'importazione controllata e un riavvio
Aggiungi un film di prova con un nome semplice alla stessa condivisione, scansiona la libreria interessata e conferma che compaia una sola volta con il percorso e i metadati corretti. Riavvia quindi il contenitore e l'host.
Dopo il riavvio, conferma che la condivisione remota venga montata prima dell'avvio del servizio multimediale, che il contenitore veda il percorso popolato, che l'utente del servizio possa attraversarlo e che lo scanner rilevi un nuovo file di prova senza modifiche manuali ai permessi.
La riparazione è completa solo quando i film realmente mancanti compaiono dalla posizione montata prevista, nessuna directory locale vuota viene scansionata e il risultato persiste dopo il rimontaggio, la ricreazione del contenitore e il riavvio dell'host. Rimuovi la copia di prova dopo aver confermato che il percorso originale della libreria sia stabile.
Prodotti consigliati
Supporto e consigli
Altro da leggere
Plex può condividere una GPU con un altro container Docker?
Plex e un altro container possono spesso accedere alla stessa GPU, ma è necessario testare il supporto dei driver, la mappatura dei dispositivi, il...
Come capire se un errore di Plex proviene dal client o dal server
Riproduci lo stesso elemento su un altro client, confronta il percorso della sessione, quindi raccogli le prove dal server solo dopo che l’ambito ti...
Come configurare la cache di Plex e l’archiviazione temporanea per la transcodifica
Proteggi lo stato persistente di Plex collocando i file temporanei di transcodifica su un’unità locale adatta, quindi verifica la pulizia, lo spazio libero e...
