Vous pouvez tester l’accès en écriture de Jellyfin sans rien créer, renommer ou supprimer dans vos véritables dossiers de médias. Commencez par vérifier quel chemin le processus Jellyfin voit réellement, puis contrôlez l’identité du processus et le mode de montage avant toute tentative d’écriture.
Cela est particulièrement important après une migration de conteneur, un remontage du stockage ou une modification des autorisations, lorsque le chemin de l’hôte peut sembler correct tandis que Jellyfin voit un autre montage bind ou une cible en lecture seule. La méthode de diagnostic la plus sûre consiste d’abord à observer, puis à utiliser une sonde jetable, et à n’apporter des modifications en production qu’une fois la couche défaillante identifiée.
Confirmer le chemin réellement vu par Jellyfin
Commencez dans Jellyfin ou dans son conteneur, et non depuis le shell de l’hôte. Un répertoire de l’hôte tel que /mnt/media/movies peut être présenté à Jellyfin sous la forme de /media/movies, de sorte qu’un test d’autorisation effectué uniquement sur le chemin de l’hôte peut démontrer la mauvaise chose.
Le guide officiel du conteneur Jellyfin indique que l’accès aux médias dépend du montage bind ou du volume présenté au conteneur, et qu’un montage de médias peut être explicitement en lecture seule. Vérifiez d’abord la définition du conteneur afin que le chemin et le mode d’accès testés correspondent au chemin utilisé par Jellyfin en production. définition du montage du conteneur
Si le chemin de bibliothèque attendu est absent dans le conteneur, arrêtez-vous là. Il s’agit d’un problème de montage, pas d’un problème de propriété Unix. Corrigez le mappage ou recréez le conteneur avec le chemin prévu avant de modifier les autorisations sur l’hôte.
Vérifier l’identité d’exécution avant de tester les autorisations
Trouvez l’UID et le GID utilisés par le processus Jellyfin. Sur une installation Linux native, il s’agit généralement de jellyfin compte de service ; dans un conteneur, il peut s’agir d’un UID/GID numérique fourni par l’environnement d’exécution. Comparez cette identité avec le propriétaire, le groupe, les bits de mode et les ACL du répertoire cible.
Un répertoire peut sembler accessible en écriture avec votre compte administrateur tout en restant inaccessible à l’identité Jellyfin. Les recommandations de migration de Jellyfin préconisent précisément de vérifier l’UID/GID et de conserver des chemins correspondants lors du déplacement des installations ; c’est pourquoi l’identité doit être vérifiée avant toute modification récursive de la propriété. UID et GID d’exécution
Utilisez des commandes d’inspection en lecture seule telles que id, stat, namei -l, ou getfacl lorsqu’il est disponible. Si un répertoire parent n’accorde pas la permission d’exécution à l’identité Jellyfin, le dossier final peut disposer de permissions généreuses tout en restant inaccessible.
Utiliser un répertoire de vérification temporaire sur le même stockage
N’exécutez pas touchles tests de création, de renommage ou de suppression dans un répertoire de films ou de séries en production simplement pour prouver l’accès en écriture. Créez plutôt un dossier de vérification dédié en dehors de la bibliothèque, sur le même système de fichiers ou partage, et montez-le dans le conteneur avec le même mode d’accès et le même modèle de propriété.
Exécutez la vérification avec le même UID/GID que Jellyfin, puis créez et supprimez un fichier de test au nom unique uniquement dans ce répertoire temporaire. La création et la suppression réussies prouvent que l’identité, le système de fichiers, le mode de montage et le chemin d’écriture de base fonctionnent ensemble sans modifier les médias de production.
Si la vérification échoue, lisez l’erreur exacte. Permission refusée oriente vers l’identité, les bits de mode, les ACL ou l’étiquetage de sécurité ; Système de fichiers en lecture seule oriente vers l’état du montage ou du système de fichiers ; Aucun fichier ou dossier de ce type renvoie au mappage des chemins. Chaque résultat mène à une correction différente.
Séparer les permissions de l’hôte des montages en lecture seule du conteneur
Lorsque l’hôte indique que le répertoire est accessible en écriture, mais que la vérification du conteneur signale un système de fichiers en lecture seule, n’assouplissez pas les permissions de l’hôte. Un montage bind déclaré avec ro bloque les écritures indépendamment de chmod ou chown sur l’hôte.
Les exemples officiels de conteneurs présentent intentionnellement les montages de médias en lecture seule comme une configuration prise en charge et indiquent que l’accès en écriture nécessite de modifier le comportement de ce montage. Le mode de montage constitue donc un critère de distinction fiable avant toute modification de la propriété du système de fichiers. montage de médias en lecture seule
Si votre flux de travail Jellyfin doit seulement lire les médias, conserver la bibliothèque en lecture seule peut être l’état final le plus sûr. Accordez un accès en écriture uniquement aux répertoires qui en ont réellement besoin, comme un chemin dédié aux téléchargements, aux métadonnées, aux sous-titres ou à une bibliothèque gérée, plutôt que de considérer un accès en écriture étendu comme un prérequis à la lecture.
Vérifiez l’action au niveau de l’application sans toucher aux médias
Une fois la vérification sur le chemin jetable réussie, vérifiez la fonction Jellyfin réelle qui nécessitait un accès en écriture. Par exemple, si le problème concerne un répertoire de métadonnées ou de sous-titres, redirigez cette fonction vers un emplacement de test hors production et confirmez que Jellyfin peut y créer le fichier attendu.
Si votre objectif est uniquement d’utiliser Jellyfin comme serveur multimédia, comparez la conception de vos chemins avec une structure standard de serveur multimédia Jellyfin et gardez distincts les emplacements des médias, de la configuration, du cache et des écritures temporaires. Cette séparation facilite les futurs tests de permissions et limite les écritures accidentelles.
Répétez le test après le redémarrage du conteneur ou de l’hôte. Une modification des permissions qui ne fonctionne que jusqu’au montage suivant ou à la recréation du conteneur n’est pas une solution complète ; la configuration finale doit conserver le même UID/GID, le même mode de montage et le même mappage des chemins après les redémarrages.
Arrêtez-vous avant d’appliquer des modifications récursives étendues des permissions
Si la vérification échoue toujours, résistez au raccourci courant qui consiste à appliquer chmod -R 777 ou de modifier récursivement le propriétaire de l’ensemble d’un pool multimédia. Ces actions peuvent supprimer des limites de permissions utiles, affecter des services sans rapport et rendre la cause initiale plus difficile à déterminer.
Modifiez le plus petit objet identifié par le test ayant échoué : un bit d’exécution manquant sur un répertoire parent, une entrée ACL, l’UID/GID du conteneur, un montage en lecture seule ou le propriétaire d’un répertoire de données appartenant à Jellyfin. Relancez ensuite la même vérification au lieu d’empiler plusieurs correctifs.
Arrêtez-vous lorsque le chemin jetable est accessible et que l’opération Jellyfin prévue réussit après le redémarrage. Si les permissions semblent correctes mais que les écritures échouent toujours, recueillez le chemin exact, l’UID/GID d’exécution, les options de montage, l’état des étiquettes de sécurité et le texte de l’erreur avant de faire remonter le problème ; ces éléments sont bien plus utiles qu’une nouvelle modification globale des permissions.
Assistance et conseils
Plus à lire

Faut-il sauvegarder Home Assistant en fonctionnement ou arrêter d’abord le service ?
Les sauvegardes intégrées de Home Assistant peuvent s’exécuter à chaud ; les simples copies du système de fichiers doivent arrêter ou mettre en veille...

Pourquoi un serveur Home Assistant chauffe-t-il ou est-il bruyant pendant les périodes d’inactivité ?
Corrélez les pics du ventilateur ou de température de Home Assistant avec Recorder, les sauvegardes, les intégrations et les tâches exécutées en parallèle avant...

Quand faut-il reconstruire Home Assistant plutôt que le réparer ?
Réparez d’abord la plus petite couche défaillante de Home Assistant, restaurez ensuite un état connu comme fiable et ne reconstruisez que lorsque la configuration...

