Solution communautaire

Définir le dossier de téléchargement correct de qBittorrent sur ZimaOS

A ZimaOS user mapped qBittorrent downloads to a second drive but kept entering the ZimaOS host path inside qBittorrent. The confirmed fix was to use the Docker container path /downloads instead.

Si qBittorrent continue d’enregistrer les téléchargements sur le lecteur système de ZimaOS même après avoir sélectionné un autre disque dur dans les paramètres de l’application, vérifiez le chemin que vous avez saisi directement dans qBittorrent. Dans le fil de discussion de la communauté IceWhale de novembre 2025, le lecteur secondaire était déjà monté dans le conteneur qBittorrent, mais l’utilisateur avait saisi le chemin hôte ZimaOS au lieu du chemin du conteneur Docker.

La solution confirmée était simple : utiliser /downloads dans qBittorrent, et non le chemin hôte de ZimaOS tel que /media/GERAL/downloads. La modification de PUID/PGID en 0/0 n’a pas résolu le problème d’origine ; corriger le chemin l’a résolu, et l’auteur d’origine a explicitement confirmé que les téléchargements fonctionnaient ensuite.

La différence essentielle : chemin hôte contre chemin du conteneur

Un mappage de volume Docker comporte deux côtés :

CHEMIN_HÔTE:CHEMIN_CONTENEUR

Par exemple :

/media/GERAL/downloads:/downloads

ZimaOS voit le côté gauche. qBittorrent s’exécute dans le conteneur et doit normalement utiliser le côté droit.

Correct dans qBittorrent : /downloads
Incorrect dans qBittorrent :   /media/GERAL/downloads

Ce que l’utilisateur d’origine avait configuré

Paramètres qBittorrent de ZimaOS montrant le mappage des téléchargements vers le lecteur secondaire GERAL
La publication d’origine montre que qBittorrent était configuré avec un stockage sur le lecteur secondaire GERAL.
Paramètres de téléchargement de qBittorrent utilisant un chemin hôte ZimaOS au lieu du chemin Docker
Le paramètre de qBittorrent utilisait un chemin côté hôte au lieu du chemin du conteneur monté.
Chemin de stockage ZimaOS du lecteur GERAL utilisé par le conteneur qBittorrent
ZimaOS expose le chemin physique de l’hôte, mais qBittorrent n’a pas besoin d’utiliser cette même chaîne de chemin en interne.
Champ du dossier de téléchargement de qBittorrent tiré du fil de dépannage ZimaOS
La solution confirmée consistait à utiliser le chemin du conteneur monté /downloads.

Pourquoi la modification de PUID et PGID n’a pas résolu ce cas

Une réponse de la communauté a d’abord suggéré de tester différentes PUID/PGID valeurs, notamment 0/0. L’auteur original a essayé cette solution et a indiqué qu’elle ne fonctionnait pas.

C’est important, car cela distingue ce cas d’un problème de permissions. Les privilèges root ne transforment pas un chemin d’hôte non mappé en chemin correct dans le conteneur.

La version actuelle de qBittorrent de LinuxServer utilise le même modèle

La documentation Docker actuelle de qBittorrent de LinuxServer utilise :

/path/to/downloads:/downloads

et définit /downloads comme emplacement de téléchargement à l’intérieur du conteneur. Cela correspond exactement à la solution de la communauté.

Documentation Docker de qBittorrent de LinuxServer

Comment corriger le dossier de téléchargement

  1. Ouvrez les paramètres de l’application qBittorrent dans ZimaOS.
  2. Trouvez le mappage du volume de téléchargement.
  3. Vérifiez que le dossier souhaité sur le disque secondaire se trouve du côté hôte de ZimaOS.
  4. Vérifiez que le chemin côté conteneur est stable, par exemple /downloads.
  5. Enregistrez les modifications et redémarrez l’application si le mappage Docker a changé.
  6. Ouvrez l’interface Web de qBittorrent.
  7. Accédez à Outils → Options → Téléchargements.
  8. Définissez le chemin d’enregistrement par défaut sur /downloads ou un sous-dossier tel que /downloads/complete.
  9. Lancez un petit torrent de test et vérifiez sur quel disque physique les données sont enregistrées.

Quand les permissions PUID/PGID sont importantes

Si /downloads est correct, mais les journaux de qBittorrent indiquent Permission denied, puis vérifiez le propriétaire et les permissions. L’image de LinuxServer prend en charge PUID et PGID spécifiquement pour les permissions des montages bind de l’hôte.

Il s’agit d’un problème différent de celui du fil source. Vérifiez d’abord que le chemin est correct, puis examinez les permissions.

FAQ sur le dossier de téléchargement de qBittorrent sur ZimaOS

Pourquoi qBittorrent utilise-t-il toujours le disque système de ZimaOS ?

Dans le cas source, qBittorrent était configuré avec le chemin de l’hôte au lieu du chemin du conteneur monté.

Quel chemin a résolu le problème du fil de discussion original ?

/downloads. L’auteur a confirmé que cela fonctionnait.

Dois-je définir PUID et PGID sur 0 ?

Pas pour ce problème. L’auteur original a essayé cette solution sans succès. Utilisez d’abord le chemin correct dans le conteneur.