La source prouve clairement une chose : qBittorrent pouvait atteindre le dossier Btrfs externe monté, mais le processus ne pouvait pas créer son sous-répertoire incomplete. L’erreur était Permission denied, et non « chemin introuvable ». La vérification de l’identité et des permissions du système de fichiers constitue donc la piste de dépannage la plus pertinente.
La discussion ne prouve pas quelle est la solution définitive. La seule réponse indiquait que l’UID 1000 n’existait pas sur ce système ZimaOS et suggérait de tester le conteneur en tant que root. L’auteur initial n’est jamais revenu confirmer un résultat positif. Exécuter qBittorrent en tant que root doit donc être considéré uniquement comme un diagnostic ciblé, et non comme une configuration finale recommandée.
Le mappage des volumes était explicite
La source indiquait le mappage suivant :
/media/SSD-1TBStorage/Downloads → /downloadsDans qBittorrent, l’application tentait de créer :
/downloads/incomplete/...Puisque l’erreur était « permission refusée », le mappage existait probablement et le conteneur avait atteint le système de fichiers de l’hôte.
Le dossier de l’hôte disposait d’une permission d’écriture pour le groupe
L’utilisateur a indiqué :
drwxrwxr-x 1 1000 samba /media/SSD-1TBStorage/Downloadset a précisé que le conteneur s’exécutait avec l’UID/GID 1000. Il a également essayé chown -R 1000:1000 et chmod -R 775.
Le fait que l’erreur se soit produite signifie que l’une de ces hypothèses — identité réelle au moment de l’exécution, accès aux répertoires parents, comportement du montage ou permissions effectives — était incomplète.
Ne codez pas en dur un UID ZimaOS à partir d’une réponse de forum
La personne ayant répondu indiquait que le premier utilisateur ZimaOS utilisait l’UID 999 plutôt que 1000. Même si cela était exact pour une version donnée, les identifiants utilisateur peuvent varier selon la plateforme et la version, et le conteneur qBittorrent peut utiliser une identité PUID/PGID distincte.
Examinez la configuration actuelle réelle du conteneur ainsi que l’identité du processus au lieu de deviner.
L’exécution en tant que root peut confirmer un problème de permissions, mais ne doit pas être permanente
Si un conteneur ne fonctionne qu’avec l’UID 0, cela indique fortement que le chemin monté refuse l’accès à l’identité normale de l’application. Cela ne signifie pas que qBittorrent doit rester exécuté en tant que root.
Un téléchargeur exposé à des entrées provenant du Web ou du réseau ne devrait disposer que des privilèges de système de fichiers nécessaires.
Vérifiez chaque répertoire parent du chemin sur l’hôte
L’accès en écriture au dernier répertoire Downloads ne suffit pas si l’identité du conteneur ne peut pas traverser l’un des répertoires parents. Vérifiez le chemin complet ainsi que les ACL, et pas uniquement les bits de mode du dernier répertoire.
Btrfs était utilisé, mais la source ne prouve pas que Btrfs était à l’origine de l’échec
Le SSD utilisait Btrfs, mais les règles Unix ordinaires de propriété et de permissions s’appliquent toujours. Rien dans la discussion ne prouve qu’un bug propre à Btrfs, une règle de sous-volume ou un montage en lecture seule ait causé l’erreur.
Vérifiez l’état du système de fichiers monté avant d’incriminer son type.
Les versions actuelles de ZimaOS exposent explicitement les mappages de volumes des applications
La documentation actuelle d’IceWhale explique les chemins côté hôte et côté conteneur et permet de modifier les mappages de stockage des applications depuis les paramètres de l’application.
Consultez le modèle actuel des chemins Docker de ZimaOS avant de modifier la propriété.
Utilisez un dossier de téléchargement dédié à qBittorrent
Accordez à qBittorrent un accès en écriture à un dossier de téléchargement ou de préparation créé à cet effet, plutôt qu’à l’intégralité d’un volume multimédia ou de sauvegarde. Sonarr/Radarr pourront ensuite importer ou déplacer les fichiers terminés avec leurs propres permissions contrôlées.
Une procédure plus sûre pour corriger définitivement les permissions
- Confirmez le mappage exact entre l’hôte et le conteneur.
- Vérifiez l’UID/GID/PUID/PGID réellement utilisés par le conteneur qBittorrent.
- Vérifiez les permissions du dossier hôte et de ses répertoires parents.
- Créez un petit répertoire de test dédié.
- Accordez uniquement les droits d’écriture nécessaires à l’utilisateur ou au groupe concerné.
- Redémarrez l’application et testez un petit téléchargement légal.
FAQ sur les permissions qBittorrent avec Btrfs
La solution finale indiquée par la source a-t-elle été confirmée ?
Non. La discussion s’arrête après une seule réponse de la communauté.
« Permission denied » prouve-t-il que le mappage du volume Docker est absent ?
Non. Cela signifie généralement que le chemin est accessible, mais que le processus ne peut pas effectuer l’opération d’écriture demandée.
qBittorrent doit-il être exécuté en permanence en tant que root ?
Non. Root peut servir de test de diagnostic, mais la solution permanente doit appliquer le principe du moindre privilège nécessaire au système de fichiers.
