Solution communautaire

Télécharger directement les torrents qBittorrent sur un disque USB externe sous ZimaOS : corriger le volume et le chemin d’enregistrement

A March 2026 thread where qBittorrent on a 128 GB ZimaOS mini PC errored when the user tried to save torrents to a 14 TB external USB drive. A community reply correctly focused on adding the external folder as a Docker volume. The user posted volume and qBittorrent settings, but the thread ends before a confirmed final fix.

qBittorrent cannot write to an external ZimaOS drive just because the drive appears in Files. The qBittorrent container must first receive that host folder as a Docker volume, and qBittorrent must then use the container-side path—not the physical ZimaOS host path—as its save location.

qBittorrent ne peut pas écrire sur un lecteur ZimaOS externe simplement parce que celui-ci apparaît dans Fichiers. Le conteneur qBittorrent doit d’abord recevoir ce dossier hôte en tant que volume Docker, puis qBittorrent doit utiliser le chemin du conteneur, et non le chemin physique de l’hôte ZimaOS, comme emplacement d’enregistrement. /Torrents Le fil de discussion source va dans la bonne direction, mais ne présente pas de résolution finale confirmée par l’utilisateur. Les captures d’écran sont utiles, car elles révèlent l’architecture prévue : des dossiers de l’hôte externe mappés vers des chemins simples tels que /Active Torrents.

Paramètres des volumes Docker de ZimaOS montrant le mappage du dossier Downloads d’un lecteur externe vers un conteneur de téléchargement
Le modèle clé est le chemin de l’hôte à gauche et le chemin simple du conteneur à droite.

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

Par exemple :

/media/Expansion/Torrents  →  /Torrents

ZimaOS utilise le chemin de gauche. qBittorrent utilise celui de droite. Dans qBittorrent, le chemin d’enregistrement par défaut devrait donc être /Torrents, et non /media/Expansion/Torrents.

L’utilisateur source a mappé des dossiers de torrents dans qBittorrent

Paramètres de téléchargement qBittorrent affichant le chemin d’enregistrement par défaut /Torrents et le chemin des torrents incomplets /Active Torrents
Les paramètres de qBittorrent utilisent des chemins du conteneur, qui doivent correspondre exactement aux chemins créés par les mappages de volumes ZimaOS.
Paramètres de téléchargement qBittorrent avec les chemins du conteneur pour les torrents terminés et incomplets
Les chemins des torrents terminés et incomplets peuvent être distincts, mais tous deux doivent pointer vers un stockage mappé accessible en écriture.

Le mappage de volumes ZimaOS doit correspondre à ces chemins du conteneur

Paramètres du chemin de téléchargement de qBittorrent nécessitant des mappages de volumes Docker ZimaOS correspondants
Si le volume est manquant ou mappé vers un autre chemin du conteneur, qBittorrent peut afficher le torrent comme étant en erreur.

La documentation actuelle de ZimaOS utilise le même modèle hôte-conteneur

La documentation Docker actuelle d’IceWhale explique explicitement qu’une application doit utiliser le chemin monté à l’intérieur de son conteneur, tandis que le côté ZimaOS pointe vers le véritable dossier de stockage.

Utilisez le modèle actuel des volumes Docker de ZimaOS.

Si le chemin existe mais que les torrents génèrent toujours une erreur, vérifiez les permissions d’écriture

Depuis le conteneur ou le terminal qBittorrent, vérifiez que le répertoire mappé existe et qu’il peut créer un fichier temporaire. Un chemin valide sans permission d’écriture entraîne une erreur différente de celle d’un volume manquant.

Évitez de résoudre chaque problème de permissions de manière permanente 0777 ou root. Dans la mesure du possible, faites correspondre l’identité et le groupe du conteneur au dossier cible.

Vérifiez le système de fichiers du disque externe

La version actuelle de ZimaOS prend en charge les systèmes de fichiers USB courants, notamment NTFS, exFAT, ext4 et Btrfs. Les caractéristiques du système de fichiers peuvent avoir une incidence sur la propriété et les autorisations, en particulier avec NTFS/exFAT.

Les torrents incomplets et terminés peuvent utiliser le même disque externe

Si vous activez « Conserver les torrents incomplets dans », mappez également ce chemin. Sinon, qBittorrent peut essayer d’écrire les données incomplètes dans un chemin interne non mappé, même si le chemin de téléchargement terminé est correct.

Gardez les données volumineuses des torrents hors du disque système de 128 Go

Le cas d’utilisation de la source est précisément celui où le stockage externe est pertinent. Gardez la configuration et les données d’application de qBittorrent compactes et persistantes, tout en plaçant les données de plusieurs téraoctets sur le périphérique de stockage externe.

Tester le chemin depuis le conteneur qBittorrent

Pour distinguer rapidement les problèmes de chemin des problèmes d’autorisations, ouvrez le terminal de l’application et examinez le dossier côté conteneur. Si /Torrents n’existe pas, le mappage du volume Docker est incorrect. S’il existe, mais qu’un petit fichier test ne peut pas être créé, le mappage fonctionne et le problème suivant concerne les autorisations ou le comportement du système de fichiers.

Assurez-vous que le disque externe est monté avant que qBittorrent ne commence à écrire

Si un disque USB externe est déconnecté ou ne parvient pas à être monté, un ancien chemin d’hôte peut amener une application à écrire par erreur dans un répertoire local différent. Après un redémarrage ou une reconnexion, vérifiez que le disque est présent dans la section Stockage/Fichiers de ZimaOS avant de lancer des téléchargements volumineux.

Les chemins des catégories doivent également rester dans le stockage mappé du conteneur

Les catégories de qBittorrent peuvent remplacer le chemin d’enregistrement par défaut. Un torrent peut donc générer une erreur même lorsque /Torrents est correct si sa catégorie pointe vers un autre chemin non mappé. Vérifiez les emplacements d’enregistrement propres à chaque catégorie lorsque seuls certains torrents échouent.

Les torrents existants peuvent conserver leur ancien chemin d’enregistrement

La modification du chemin d’enregistrement par défaut global ne réécrit pas toujours l’emplacement de chaque torrent existant. Pour les torrents déjà ajoutés, vérifiez leur chemin d’enregistrement actuel et utilisez la fonction gérée de qBittorrent pour « définir l’emplacement » ou les relocaliser, plutôt que de déplacer les fichiers partiels sans passer par qBittorrent.

FAQ sur le disque externe de qBittorrent

qBittorrent doit-il utiliser le chemin complet de l’hôte ZimaOS comme chemin d’enregistrement ?

Normalement, non. Il doit utiliser le chemin côté conteneur créé par le mappage du volume Docker.

La source contient-elle une solution finale confirmée ?

Non. Le fil de discussion se termine après que l’utilisateur a publié ses paramètres.

Que faut-il vérifier après le chemin du volume ?

Vérifiez que le répertoire mappé existe dans le conteneur et que l’identité d’exécution de qBittorrent peut y écrire.