Evita i film duplicati rendendo i percorsi vecchio e nuovo mutuamente esclusivi prima che il server multimediale analizzi la libreria migrata.
Una migrazione dello spazio di archiviazione può rendere lo stesso film accessibile tramite due bind mount, due radici della libreria, una copia temporanea o un record obsoleto del database che rimane dopo la rimozione del vecchio percorso. Il flusso di lavoro più sicuro consiste nel sospendere le scansioni automatiche, eseguire il backup del database dell’applicazione, mappare i percorsi vecchi e nuovi esatti, spostare o copiare i file multimediali in una finestra controllata, rimuovere dalla libreria la sorgente obsoleta ed eseguire una sola nuova scansione intenzionale dopo che il server può vedere un’unica posizione canonica.
Mappa ogni percorso che può raggiungere lo stesso film
Elenca le radici della libreria, i bind mount Docker, i link simbolici, i filesystem di tipo merger, i mount di rete e le cartelle temporanee della migrazione. Risolvi il percorso reale di un film sia dall’host sia dal container.
I duplicati compaiono spesso perché lo scanner riceve lo stesso file tramite un nuovo percorso mentre l’elemento precedente del database rimane valido. Un rapporto su una migrazione Jellyfin ha riprodotto il problema quando lo spostamento delle cartelle della libreria ha creato duplicati.
Scegli un unico percorso canonico nel container, ad esempio /media/movies, e mantienilo stabile anche se cambia la sorgente dello spazio di archiviazione sull’host. Un percorso stabile nel container riduce le modifiche future al database, perché l’applicazione non deve apprendere una nuova posizione per ogni migrazione di pool o unità.
Sospendi le scansioni automatiche prima di copiare o rinominare i file multimediali
Disabilita il monitoraggio in tempo reale e le scansioni pianificate della libreria durante la migrazione. In caso contrario, il server potrebbe indicizzare copie parziali, vedere entrambe le posizioni o registrare lo stesso titolo mentre le cartelle vengono rinominate in più fasi.
Esegui un backup della configurazione e del database del server multimediale prima di modificare i percorsi. In questo modo proteggi lo stato di visione, le scelte relative alle copertine, le raccolte, gli utenti e gli identificativi dei provider, che una ricostruzione della libreria da zero potrebbe non riprodurre esattamente.
Copia o sposta prima una piccola cartella di prova, verifica i checksum o le dimensioni dei file e lascia intatta la vecchia sorgente finché la nuova posizione non è leggibile dall’account del servizio. Non lasciare entrambi i percorsi come radici attive della libreria durante questa finestra di verifica.
Rimuovi il vecchio percorso della libreria prima di analizzare quello nuovo
Dopo aver verificato il nuovo percorso, rimuovi la cartella obsoleta dalla configurazione della libreria oppure rimappa il percorso esistente nel container alla nuova sorgente sull’host. Verifica che il vecchio percorso non sia più raggiungibile tramite un’altra libreria o un link simbolico.
La rimozione di un percorso non elimina sempre immediatamente tutti i record associati. Un problema di Jellyfin segnala che i metadati collegati ai percorsi rimossi sono rimasti persistenti; per questo la pulizia dei percorsi deve essere verificata e non data per scontata.
Esegui la procedura supportata di pulizia della libreria o una scansione completa dell’applicazione solo dopo che la vecchia sorgente non è più disponibile. Evita di modificare manualmente il database, a meno che tu non disponga di un backup verificato e di un piano di ripristino specifico per la versione in uso.
Preserva l’identità dei file multimediali durante lo spostamento
Mantieni coerenti i nomi delle cartelle dei film, i nomi dei file, gli indicatori dell’anno, le etichette dell’edizione, gli identificativi dei provider e i file di metadati locali. Un titolo rinominato durante la stessa migrazione potrebbe essere trattato come un elemento diverso anche se i dati video sono invariati.
Conserva con attenzione i metadati e le copertine locali. Se identificativi come quelli di TMDB o IMDb sono incorporati nei nomi o nei file NFO, preservali affinché il nuovo percorso venga associato alla stessa identità del film invece di generare una seconda corrispondenza ambigua.
Il flusso di lavoro per la migrazione dei dati NAS di ZimaSpace è il controllo complementare per proteggere i dati sorgente e verificare i permessi prima di rimuovere la vecchia copia.
Distingui due percorsi da due versioni o edizioni
Apri entrambe le voci duplicate e confronta i percorsi dei file, le informazioni multimediali, gli identificativi dei provider, la durata, le etichette dell’edizione e la disponibilità. Due voci possono riferirsi allo stesso file tramite due percorsi, a due copie fisiche oppure a versioni legittime raggruppate in modo errato.
I record obsoleti possono rimanere accessibili anche dopo la scomparsa di un percorso. Un rapporto su Jellyfin li definisce voci fantasma, che non devono essere confuse con un secondo file reale del film.
Se entrambe le voci puntano a percorsi attivi, rimuovi dall’ambito della libreria il percorso indesiderato. Se uno dei percorsi non esiste più, usa la procedura di pulizia supportata e verifica che il record scompaia. Se i file sono edizioni intenzionali, applica le regole supportate dal server multimediale per la denominazione e il raggruppamento invece di eliminarne una alla cieca.
| Schema del duplicato | Causa probabile | Azione corretta |
|---|---|---|
| Due voci, due percorsi attivi | Le radici vecchia e nuova sono state entrambe analizzate | Mantieni un unico percorso canonico |
| Due voci, un percorso non più attivo | Record obsoleto del database | Pulisci la libreria dopo il backup |
| Due file, stesso titolo | La copia della migrazione è ancora presente | Verifica e ritira la vecchia copia |
| Due edizioni intenzionali | Errore di denominazione o raggruppamento | Usa la denominazione supportata per le edizioni |
Questa classificazione impedisce che una pulizia del database elimini una versione alternativa legittima o una copia di qualità superiore.
Esegui una nuova scansione controllata e verifica lo stato
Riattiva le scansioni solo dopo aver montato il percorso canonico, rimosso quello vecchio e verificato che l’utente del servizio possa leggere la nuova posizione. Avvia una scansione completa e osserva gli eventi di rimozione e aggiunta relativi al film migrato.
Alcune librerie non sono riuscite a rimuovere i file dopo uno spostamento dello spazio di archiviazione, anche quando il vecchio percorso era stato eliminato dalle impostazioni. Un rapporto su Jellyfin documenta la persistenza dei file rimossi nella libreria; perciò il controllo finale deve confrontare le voci del database con i percorsi reali.
Verifica che ogni film compaia una sola volta, si apra dal nuovo percorso, mantenga lo stato di visione e le raccolte e rimanga disponibile dopo il riavvio del servizio. Mantieni il vecchio spazio di archiviazione offline ma intatto finché questo controllo non è superato; quindi ritiralo secondo il piano di backup e migrazione.
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...

