Évitez les doublons de films en rendant les anciens et les nouveaux chemins mutuellement exclusifs avant que le serveur multimédia n’analyse la bibliothèque migrée.
Une migration de stockage peut rendre un même film accessible par deux montages, deux racines de bibliothèque, une copie temporaire ou une ancienne entrée de la base de données conservée après la suppression de l’ancien chemin. La méthode la plus sûre consiste à suspendre les analyses automatiques, à sauvegarder la base de données de l’application, à cartographier précisément les anciens et les nouveaux chemins, à déplacer ou copier les fichiers multimédias dans un créneau contrôlé, à retirer l’ancienne source de la bibliothèque, puis à lancer une seule nouvelle analyse délibérée, une fois que le serveur ne voit plus qu’un seul emplacement de référence.
Cartographiez tous les chemins permettant d’accéder au même film
Répertoriez les racines de bibliothèque, les montages Docker, les liens symboliques, les systèmes de fichiers fusionnés, les montages réseau et les dossiers temporaires de migration. Déterminez le chemin réel d’un film depuis l’hôte et depuis le conteneur.
Les doublons apparaissent souvent parce que le scanner trouve le même fichier à un nouvel emplacement tandis que l’ancienne entrée reste valide dans la base de données. Un rapport de migration de Jellyfin a reproduit le problème lors d’un déplacement de dossiers de bibliothèque ayant créé des doublons.
Choisissez un chemin de conteneur de référence, par exemple /media/movies, et conservez-le même si la source de stockage sur l’hôte change. Un chemin de conteneur stable limite les modifications futures de la base de données, car l’application n’a pas besoin d’enregistrer un nouvel emplacement à chaque migration de pool ou de disque.
Mettez en pause les analyses automatiques avant de copier ou de renommer les fichiers multimédias
Désactivez la surveillance en temps réel et les analyses programmées de la bibliothèque pendant la migration. Sinon, le serveur risque d’indexer des copies partielles, de détecter les deux emplacements ou d’enregistrer plusieurs fois le même titre pendant le renommage progressif des dossiers.
Sauvegardez la configuration et la base de données du serveur multimédia avant de modifier les chemins. Vous préserverez ainsi les éléments marqués comme vus, les choix d’illustrations, les collections, les utilisateurs et les identifiants des fournisseurs, que la reconstruction d’une bibliothèque vide risque de ne pas reproduire à l’identique.
Copiez ou déplacez d’abord un petit dossier de test, vérifiez les sommes de contrôle ou les tailles de fichiers, et ne touchez pas à l’ancienne source tant que le nouvel emplacement n’est pas lisible par le compte de service. Ne laissez pas les deux chemins servir de racines actives de bibliothèque pendant cette période de vérification.
Supprimer l’ancien chemin de bibliothèque avant d’analyser le nouveau
Une fois le nouvel emplacement vérifié, retirez le dossier obsolète de la configuration de la bibliothèque ou remappez le chemin de conteneur existant vers la nouvelle source sur l’hôte. Confirmez que l’ancien chemin n’est plus accessible par une autre bibliothèque ou un lien symbolique.
La suppression d’un chemin n’efface pas toujours immédiatement tous les enregistrements associés. Un problème signalé dans Jellyfin indique que des métadonnées liées aux chemins supprimés ont persisté, d’où la nécessité de vérifier le nettoyage des chemins plutôt que de le tenir pour acquis.
N’exécutez le nettoyage de la bibliothèque ou l’analyse complète pris en charge par l’application qu’une fois l’ancienne source inaccessible. Évitez de modifier manuellement la base de données, sauf si vous disposez d’une sauvegarde testée et d’un plan de récupération adapté à la version.
Préserver l’identité des médias pendant le déplacement des fichiers
Veillez à la cohérence des noms de dossiers de films, des noms de fichiers, des marqueurs d’année, des étiquettes d’édition, des identifiants de fournisseur et des fichiers de métadonnées locales. Un titre renommé pendant la même migration peut être considéré comme un élément différent, même si les données vidéo sont inchangées.
Stockez volontairement les métadonnées locales et les illustrations. Si des identifiants tels que ceux de TMDB ou IMDb sont intégrés aux noms ou aux fichiers NFO, conservez-les afin que le nouvel emplacement corresponde au même film, plutôt qu’à une deuxième correspondance ambiguë.
Le flux de migration des données NAS de ZimaSpace est l’étape de contrôle complémentaire qui permet de protéger les données source et de vérifier les autorisations avant la suppression de l’ancienne copie.
Distinguer deux chemins de deux versions ou éditions
Ouvrez les deux entrées en double et comparez leurs chemins de fichiers, leurs informations sur les médias, leurs identifiants de fournisseur, leur durée, leurs étiquettes d’édition et leur disponibilité. Il peut s’agir du même fichier accessible par deux chemins, de deux copies physiques ou de versions légitimes regroupées par erreur.
Les enregistrements obsolètes peuvent rester accessibles après la disparition d’un chemin. Un rapport Jellyfin les qualifie d’entrées fantômes ; il ne faut pas les confondre avec un second fichier vidéo réel.
Si les deux entrées pointent vers des chemins actifs, retirez de la bibliothèque le chemin non souhaité. Si un chemin n’existe plus, utilisez la procédure de nettoyage prise en charge et vérifiez que l’entrée disparaît. Si les fichiers sont des éditions intentionnelles, appliquez les règles de nommage et de regroupement prises en charge par le serveur multimédia au lieu d’en supprimer une à l’aveugle.
| Type de doublon | Cause probable | Action appropriée |
|---|---|---|
| Deux entrées, deux chemins actifs | Les anciens et les nouveaux répertoires racines sont tous deux analysés | Conserver un seul chemin canonique |
| Deux entrées, un chemin invalide | Enregistrement obsolète dans la base de données | Nettoyer la bibliothèque après la sauvegarde |
| Deux fichiers, même titre | Copie de migration toujours présente | Vérifier et retirer l’ancienne copie |
| Deux éditions intentionnelles | Incohérence de nommage ou de regroupement | Utiliser une nomenclature des éditions prise en charge |
Cette classification évite qu’un nettoyage de la base de données supprime une version alternative légitime ou une version de meilleure qualité.
Effectuer une analyse contrôlée et vérifier l’état
Ne réactivez l’analyse qu’une fois le chemin canonique monté, l’ancien chemin supprimé et le nouvel emplacement accessible en lecture par l’utilisateur du service. Lancez une seule analyse complète et surveillez les événements de suppression et d’ajout concernant le film migré.
Certaines bibliothèques n’ont pas supprimé les fichiers après un déplacement du stockage, même après la suppression de l’ancien chemin dans les paramètres. Un rapport Jellyfin documente des fichiers supprimés restant dans la bibliothèque ; la vérification finale doit donc comparer les entrées de la base de données aux chemins réels.
Vérifiez que chaque film apparaît une seule fois, s’ouvre depuis le nouveau chemin, conserve son statut de visionnage et ses collections, et reste présent après le redémarrage du service. Gardez l’ancien stockage hors ligne, mais intact, jusqu’à la réussite de cet audit ; retirez-le ensuite conformément au plan de sauvegarde et de migration.
Assistance et conseils
À lire aussi

Comment cacher les vidéos pour adultes stockées sur votre NAS à votre famille
Gardez les vidéos pour adultes privées sur un NAS familial. Vérifiez les autorisations des dossiers, l’accès aux bibliothèques Plex et Jellyfin, les vignettes, l’historique...

Ce qu’il faut vérifier avant de charger un modèle communautaire dans Transformers
Utilisez la mise à jour du bac à sable Jinja de Transformers pour examiner la provenance des modèles, les modèles de conversation, le code...

Exécutez Mirage localement : OCR et détection d’objets à partir d’une seule image
Essayez le petit modèle de vision local de Cactus Compute, testez la reconnaissance optique de caractères et l’extraction d’objets à partir de données réelles,...



