Pourquoi l’analyse de la médiathèque ignore-t-elle les films d’un partage monté ?
Un scan multimédia ignore des films lorsque le serveur ne peut pas parcourir le chemin monté, voit un chemin différent ou rejette les fichiers lors de leur identification.
Sur un NAS domestique, « le partage est monté » peut simplement signifier que le shell de l’hôte voit un répertoire. Le processus du serveur multimédia peut se trouver dans Docker, utiliser un autre chemin de liaison, s’exécuter avec un autre UID ou analyser un point de montage local vide laissé après la déconnexion du partage distant. Diagnostiquez un seul film manquant, du stockage à l’application, au lieu de relancer constamment des analyses complètes incapables de corriger un problème de chemin, d’autorisation, de nommage ou d’analyseur.
Vérifiez que le partage monté contient bien le film maintenant
Vérifiez le chemin source exact de la bibliothèque depuis l’hôte et recherchez un film manquant à l’aide de son nom de fichier complet. Confirmez le type de système de fichiers, la source du montage, les options de montage, l’espace disponible et le nombre de fichiers connu, plutôt que de vous fier au simple fait que le répertoire du point de montage existe.
Un partage réseau déconnecté peut laisser un répertoire local ordinaire vide au même point de montage, permettant à une analyse de se terminer sans trouver de fichiers multimédias. Un rapport Jellyfin décrit une analyse qui semblait réussie alors que le chemin cible ne renvoyait aucun élément.
Lisez une petite partie du fichier manquant et listez ses répertoires parents. Si le partage est absent, rétablissez le montage avant l’analyse et configurez le service multimédia pour qu’il ne démarre qu’une fois le système de fichiers distant disponible. N’ajoutez pas le point de montage local vide comme second chemin de bibliothèque.
Vérifiez le chemin depuis l’intérieur du conteneur du serveur multimédia
Entrez dans le conteneur en cours d’exécution et inspectez le chemin exact configuré dans la bibliothèque. L’hôte peut utiliser /mnt/media/movies tandis que le conteneur le voit comme /media/movies ; seul le chemin côté conteneur doit être utilisé dans l’application.
De nouveaux fichiers multimédias peuvent rester invisibles même si les anciens sont toujours lisibles lorsque le conteneur en cours d’exécution ne voit plus le chemin actuel de l’hôte ou reçoit le contenu obsolète d’un montage. Un cas Jellyfin a signalé que de nouveaux fichiers multimédias n’apparaissaient pas après plusieurs analyses.
Comparez la définition du montage du conteneur avec le montage effectif affiché par le moteur d’exécution. Vérifiez que la source de liaison est bien le partage réellement monté, et non un répertoire parent ou un ancien chemin. Ne recréez le conteneur qu’après avoir confirmé que ses montages de configuration persistante et de base de données n’ont pas changé.
Testez le parcours des répertoires avec l’utilisateur réel du service
Utilisez l’UID et le GID du serveur multimédia pour lister chaque répertoire entre la racine de la bibliothèque et le fichier du film. La lecture du fichier ne suffit pas : le processus a également besoin de l’autorisation d’exécution sur chaque répertoire parent pour parcourir le chemin.
Un problème de visibilité d’une bibliothèque Jellyfin identifie l’absence d’autorisations de lecture et d’exécution des répertoires comme une cause directe de la non-apparition des éléments. Le point essentiel est l’autorisation de parcours des répertoires, et non la capacité d’un compte administrateur à parcourir le partage.
Corrigez la règle d’appartenance, de groupe ou d’ACL la plus restrictive qui accorde au service un accès en lecture seule aux fichiers multimédias. Le guide ZimaSpace sur les autorisations après le déplacement de fichiers décrit la procédure complémentaire lorsque le partage fonctionne via SMB mais pas à l’intérieur du conteneur.
Comparez un film manquant avec un film détecté
Choisissez deux dossiers sous le même partage monté : un film détecté par la bibliothèque et un film ignoré. Comparez le nom de fichier, l’extension, la profondeur du dossier, les majuscules et minuscules, les caractères spéciaux, la taille du fichier, l’utilisation de liens symboliques, les autorisations, les horodatages et l’intégrité du fichier.
Certaines erreurs d’analyse concernent un élément précis plutôt que l’ensemble du partage. Un cas Jellyfin signalé a montré que certains films n’apparaissaient qu’après avoir été déplacés dans un autre dossier, ce qui explique pourquoi une comparaison contrôlée entre un élément détecté et un élément manquant est plus utile qu’une nouvelle analyse globale.
Renommez ou déplacez uniquement un élément de test copié vers une structure simple telle que Movies/Movie Name (Year)/Movie Name (Year).mkv. Si la copie apparaît, examinez le nommage du dossier original, les marqueurs cachés, les autorisations ou le comportement du système de fichiers avant de modifier toute la bibliothèque.
Lisez le journal de l’analyseur au premier chemin manquant
Lancez une analyse ciblée et suivez le journal dès que l’analyseur entre dans le répertoire concerné. Recherchez les messages d’accès refusé, de répertoire introuvable, d’erreur d’entrée-sortie, de fichier non pris en charge, d’échec de détection, de contrainte de base de données, d’erreur du fournisseur de métadonnées et d’annulation de l’analyse.
Une analyse complète peut s’arrêter ou ignorer certaines opérations après une exception liée à un chemin, tandis que l’interface utilisateur n’affiche qu’une bibliothèque incomplète. Jellyfin a documenté des analyses affectées par une exception de répertoire manquant, ce qui rend la première erreur plus importante que l’indicateur de progression final.
Corrigez la première erreur reproductible, puis relancez l’analyse la plus ciblée possible. Ne supprimez pas la base de données, les métadonnées ou le cache de la bibliothèque avant d’avoir prouvé la visibilité du chemin et les autorisations ; une réinitialisation destructive peut supprimer des éléments de diagnostic sans réparer le partage monté.
Vérifiez la correction avec une importation contrôlée et un redémarrage
Ajoutez un film de test au nom propre sur le même partage, analysez la bibliothèque concernée et confirmez qu’il apparaît une seule fois avec le chemin et les métadonnées corrects. Redémarrez ensuite le conteneur, puis l’hôte.
Après le redémarrage, confirmez que le partage distant est monté avant le service multimédia, que le conteneur voit le chemin rempli, que l’utilisateur du service peut le parcourir et que l’analyseur détecte un nouveau fichier de test sans modification manuelle des autorisations.
La réparation n’est terminée que lorsque les véritables films manquants apparaissent depuis leur emplacement monté prévu, qu’aucun répertoire de secours vide n’est analysé et que le résultat persiste après remontage, recréation du conteneur et redémarrage de l’hôte. Supprimez la copie de test après avoir confirmé la stabilité du chemin de bibliothèque d’origine.
Produits recommandés
Assistance et conseils
Plus à lire
Plex peut-il partager un GPU avec un autre conteneur Docker ?
Plex et un autre conteneur peuvent souvent accéder au même GPU, mais vous devez tester la prise en charge des pilotes, le mappage des...
Comment déterminer si une erreur Plex vient du client ou du serveur
Reproduisez le même élément sur un autre client, comparez le chemin de session, puis recueillez les preuves côté serveur uniquement après que la portée...
Comment configurer le cache de Plex et le stockage temporaire du transcodage
Protégez l’état persistant de Plex en plaçant les fichiers temporaires de transcodage sur un stockage local adapté, puis vérifiez le nettoyage, l’espace libre et...
