Community-Lösung

qBittorrent-Torrents direkt auf ein externes USB-Laufwerk unter ZimaOS herunterladen: Volume und Speicherpfad korrigieren

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 kann nicht allein deshalb auf ein externes ZimaOS-Laufwerk schreiben, weil das Laufwerk in „Dateien“ angezeigt wird. Der qBittorrent-Container muss diesen Host-Ordner zunächst als Docker-Volume erhalten, und qBittorrent muss anschließend den Container-seitigen Pfad verwenden – nicht den physischen ZimaOS-Host-Pfad – als Speicherort. /Torrents Der Ausgangsbeitrag weist in die richtige Richtung, zeigt jedoch keine endgültige, vom Benutzer bestätigte Lösung. Die Screenshots sind hilfreich, weil sie die vorgesehene Architektur erkennen lassen: Externe Host-Ordner werden einfachen Pfaden wie und.

/Active Torrents
ZimaOS-Docker-Volume-Einstellungen, die den Downloads-Ordner eines externen Laufwerks einem Downloader-Container zuordnen

Das grundlegende Muster ist: Host-Pfad links, einfacher Container-Pfad rechts.

Eine Docker-Volume-Zuordnung hat zwei Seiten

Beispiel:

ZimaOS verwendet den linken Pfad. qBittorrent verwendet den rechten Pfad. Innerhalb von qBittorrent sollte der Standardspeicherpfad daher /media/Expansion/Torrents → /Torrents /Torrents, nicht /media/Expansion/Torrents.

Der Benutzer ordnete die Torrent-Ordner vom Host qBittorrent zu

qBittorrent-Download-Einstellungen mit dem Standardspeicherpfad /Torrents und dem Pfad für unvollständige Torrents /Active Torrents
Die qBittorrent-Einstellungen verwenden Container-Pfade, die exakt mit den durch die ZimaOS-Volume-Zuordnungen erstellten Pfaden übereinstimmen müssen.
qBittorrent-Download-Einstellungen mit Container-Pfaden für abgeschlossene und unvollständige Torrents
Pfade für abgeschlossene und unvollständige Downloads können getrennt sein, aber beide benötigen beschreibbaren, eingebundenen Speicher.

Die ZimaOS-Volume-Zuordnung muss mit diesen Container-Pfaden übereinstimmen

qBittorrent-Downloadpfadeinstellungen, die den entsprechenden ZimaOS-Docker-Volume-Zuordnungen entsprechen müssen
Wenn das Volume fehlt oder einem anderen Container-Pfad zugeordnet ist, kann qBittorrent den Torrent als fehlerhaft anzeigen.

Die aktuelle ZimaOS-Dokumentation verwendet dasselbe Host-vs.-Container-Modell

Die aktuelle Docker-Pfad-Dokumentation von IceWhale erklärt ausdrücklich, dass eine Anwendung den in ihrem Container eingebundenen Pfad verwenden sollte, während die ZimaOS-Seite auf den tatsächlichen Speicherordner verweist.

Verwende das aktuelle ZimaOS-Docker-Volume-Modell.

Wenn der Pfad vorhanden ist, Torrents aber weiterhin Fehler anzeigen, überprüfe die Schreibberechtigung

Überprüfe im qBittorrent-Container/Terminal, ob das eingebundene Verzeichnis vorhanden ist und eine temporäre Datei erstellt werden kann. Ein gültiger Pfad ohne Schreibberechtigung führt zu einem anderen Fehler als ein fehlendes Volume.

Vermeide es, jedes Berechtigungsproblem mit permanenten 0777 oder Root. Stimmen Sie die Container-Identität bzw. -Gruppe nach Möglichkeit mit dem Zielordner ab.

Überprüfen Sie das Dateisystem des externen Laufwerks

Das aktuelle ZimaOS unterstützt gängige USB-Dateisysteme wie NTFS, exFAT, ext4 und Btrfs. Die Semantik des Dateisystems kann sich auf Besitzer und Berechtigungen auswirken, insbesondere bei NTFS/exFAT.

Unvollständige und abgeschlossene Torrents können dasselbe externe Laufwerk verwenden

Wenn Sie „Unvollständige Torrents speichern unter“ aktivieren, müssen Sie auch diesen Pfad einbinden. Andernfalls versucht qBittorrent möglicherweise, unvollständige Daten in einen nicht eingebundenen internen Pfad zu schreiben, obwohl der Pfad für abgeschlossene Downloads korrekt ist.

Halten Sie große Torrent-Daten vom 128-GB-Systemlaufwerk fern

Der beschriebene Anwendungsfall ist genau der Bereich, in dem sich externer Speicher eignet. Halten Sie die qBittorrent-Konfiguration bzw. AppData klein und dauerhaft, während Sie mehrere Terabyte an Daten auf dem externen Speichergerät ablegen.

Testen Sie den Pfad innerhalb des qBittorrent-Containers

Eine schnelle Möglichkeit, Pfad- und Berechtigungsprobleme zu unterscheiden, besteht darin, das App-Terminal zu öffnen und den Ordner innerhalb des Containers zu überprüfen. Wenn /Torrents existiert nicht, ist die Docker-Volume-Zuordnung falsch. Wenn es existiert, aber keine kleine Testdatei erstellt werden kann, funktioniert die Zuordnung und die nächste Ebene betrifft Berechtigungen bzw. das Verhalten des Dateisystems.

Stellen Sie sicher, dass das externe Laufwerk eingebunden ist, bevor qBittorrent mit dem Schreiben beginnt

Wenn eine externe USB-Festplatte getrennt wird oder nicht eingebunden werden kann, kann ein veralteter Hostpfad dazu führen, dass eine App stattdessen in ein unbeabsichtigtes lokales Verzeichnis schreibt. Überprüfen Sie nach einem Neustart oder dem erneuten Anschließen in ZimaOS unter „Speicher“ bzw. „Dateien“, ob das Laufwerk vorhanden ist, bevor Sie große Downloads starten.

Kategoriepfade müssen ebenfalls innerhalb des eingebundenen Container-Speichers bleiben

qBittorrent-Kategorien können den Standardspeicherpfad überschreiben. Daher kann bei einem Torrent ein Fehler auftreten, selbst wenn /Torrents ist korrekt, wenn die Kategorie auf einen anderen, nicht eingebundenen Pfad verweist. Überprüfen Sie die kategoriespezifischen Speicherorte, wenn nur einige Torrents fehlschlagen.

Bestehende Torrents behalten möglicherweise ihren alten Speicherpfad

Das Ändern des globalen Standardspeicherpfads ändert nicht immer den Speicherort aller bereits vorhandenen Torrents. Überprüfen Sie bei bereits hinzugefügten Torrents deren aktuellen Speicherpfad und verwenden Sie qBittorrents verwaltete Funktion zum „Festlegen des Speicherorts“ bzw. Verschieben, anstatt Teildateien eigenmächtig zu verschieben.

FAQ zum externen qBittorrent-Laufwerk

Sollte qBittorrent den vollständigen ZimaOS-Hostpfad als Speicherpfad verwenden?

Normalerweise nicht. Es sollte der Pfad innerhalb des Containers verwendet werden, der durch die Docker-Volume-Zuordnung erstellt wurde.

Enthält die Quelle eine bestätigte endgültige Lösung?

Nein. Der Thread endet, nachdem der Benutzer seine Einstellungen veröffentlicht hat.

Was sollte nach dem Volume-Pfad überprüft werden?

Überprüfen Sie, ob das eingebundene Verzeichnis im Container vorhanden ist und ob die Laufzeitidentität von qBittorrent Schreibzugriff darauf hat.