Soluzione della community

Scarica i torrent di qBittorrent direttamente su un’unità USB esterna in ZimaOS: correggi il volume e il percorso di salvataggio

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 non può scrivere su un'unità esterna di ZimaOS solo perché l'unità appare in File. Il container qBittorrent deve prima ricevere quella cartella dell'host come volume Docker, quindi qBittorrent deve utilizzare il percorso lato container, non il percorso fisico dell'host ZimaOS, come posizione di salvataggio.

La discussione originale indica la direzione corretta, ma non mostra una soluzione finale confermata dall'utente. Le schermate sono utili perché rivelano l'architettura prevista: cartelle dell'host esterno mappate su percorsi semplici come /Torrents e /Active Torrents.

Impostazioni dei volumi Docker di ZimaOS che mostrano la cartella Downloads di un'unità esterna mappata in un container per il download
Lo schema fondamentale è: percorso dell'host a sinistra, percorso semplice del container a destra.

Una mappatura di volume Docker ha due lati

Ad esempio:

/media/Expansion/Torrents  →  /Torrents

ZimaOS utilizza il percorso a sinistra. qBittorrent utilizza quello a destra. Pertanto, all'interno di qBittorrent, il percorso di salvataggio predefinito dovrebbe essere /Torrents, non /media/Expansion/Torrents.

L'utente della fonte ha mappato le cartelle dei torrent in qBittorrent

Impostazioni dei download di qBittorrent che mostrano il percorso di salvataggio predefinito /Torrents e il percorso dei torrent incompleti /Active Torrents
Le impostazioni di qBittorrent utilizzano percorsi nel container, che devono corrispondere esattamente ai percorsi creati dalle mappature dei volumi ZimaOS.
Impostazioni di download di qBittorrent con percorsi nel container per i torrent completati e incompleti
I percorsi per i torrent completati e incompleti possono essere separati, ma per entrambi è necessario uno storage mappato con autorizzazioni di scrittura.

La mappatura dei volumi ZimaOS deve corrispondere a quei percorsi nel container

Impostazioni del percorso di download di qBittorrent che richiedono mappature di volumi Docker ZimaOS corrispondenti
Se il volume manca o è mappato a un percorso diverso nel container, qBittorrent può mostrare il torrent come In errore.

La documentazione attuale di ZimaOS utilizza lo stesso modello host-container

La documentazione attuale di Docker di IceWhale spiega esplicitamente che un'applicazione deve usare il percorso montato all'interno del proprio container, mentre il lato ZimaOS indica la cartella di archiviazione reale.

Usa l'attuale modello dei volumi Docker di ZimaOS.

Se il percorso esiste ma i torrent continuano a generare errori, verifica le autorizzazioni di scrittura

Dal container o dal terminale di qBittorrent, verifica che la directory mappata esista e che sia possibile creare un file temporaneo. Un percorso valido senza autorizzazioni di scrittura produce un errore diverso da un volume mancante.

Evita di risolvere ogni problema di autorizzazioni con permessi permanenti 0777 o root. Quando possibile, fai corrispondere l'identità/il gruppo del container alla cartella di destinazione.

Controlla il filesystem dell'unità esterna

La versione attuale di ZimaOS supporta filesystem USB comuni, tra cui NTFS, exFAT, ext4 e Btrfs. Le caratteristiche del filesystem possono influire su proprietari e permessi, soprattutto con NTFS/exFAT.

I torrent incompleti e completati possono usare la stessa unità esterna

Se abiliti “Mantieni i torrent incompleti in”, mappa anche quel percorso. Altrimenti qBittorrent potrebbe tentare di scrivere i dati incompleti in un percorso interno non mappato, anche se il percorso dei download completati è corretto.

Mantieni i dati voluminosi dei torrent lontani dall'unità di sistema da 128 GB

Il caso d'uso della fonte è esattamente quello in cui lo spazio di archiviazione esterno è utile. Mantieni la configurazione/AppData di qBittorrent ridotta e persistente, collocando invece i dati di diversi terabyte sul dispositivo di archiviazione esterno.

Testa il percorso dall'interno del container qBittorrent

Un modo rapido per distinguere i problemi di percorso da quelli di autorizzazione consiste nell'aprire il terminale dell'app e controllare la cartella interna al container. Se /Torrents non esiste, il mapping del volume Docker è errato. Se esiste ma non è possibile creare un piccolo file di test, il mapping funziona e il livello successivo da verificare riguarda i permessi e il comportamento del filesystem.

Assicurati che l'unità esterna sia montata prima che qBittorrent inizi a scrivere

Se un disco USB esterno viene scollegato o non viene montato, un vecchio percorso dell'host può far sì che un'app scriva invece in una directory locale non prevista. Dopo il riavvio o il ricollegamento, verifica che l'unità sia presente in Archiviazione/File di ZimaOS prima di avviare download di grandi dimensioni.

Anche i percorsi delle categorie devono rimanere all'interno dello spazio di archiviazione mappato del container

Le categorie di qBittorrent possono sovrascrivere il percorso di salvataggio predefinito. Pertanto, un torrent può generare un errore anche quando /Torrents è corretto se la categoria punta a un altro percorso non mappato. Controlla i percorsi di salvataggio specifici delle categorie quando solo alcuni torrent presentano errori.

I torrent esistenti potrebbero mantenere il vecchio percorso di salvataggio

La modifica del percorso di salvataggio predefinito globale non riscrive sempre il percorso di ogni torrent esistente. Per i torrent già aggiunti, controlla il percorso di salvataggio corrente del torrent e usa la funzione di qBittorrent per “impostare il percorso”/rilocare i file, invece di spostare i file parziali autonomamente.

FAQ sull'unità esterna di qBittorrent

qBittorrent dovrebbe usare il percorso completo dell'host ZimaOS come percorso di salvataggio?

Di norma no. Dovrebbe usare il percorso interno al container creato dal mapping del volume Docker.

La fonte contiene una soluzione finale confermata?

No. Il thread termina dopo che l'utente pubblica le proprie impostazioni.

Cosa occorre controllare dopo il percorso del volume?

Verifica che la directory mappata esista all'interno del container e che l'identità di runtime di qBittorrent possa scrivervi.