Soluzione della community

Imposta la cartella di download corretta di qBittorrent su 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.

Se qBittorrent continua a salvare i download sull'unità di sistema ZimaOS anche dopo aver selezionato un altro HDD nelle impostazioni dell'app, controlla quale percorso hai inserito direttamente in qBittorrent. Nella discussione della community IceWhale del novembre 2025, l'unità secondaria era già montata nel container qBittorrent, ma l'utente aveva inserito il percorso dell'host ZimaOS invece del percorso del container Docker.

La soluzione confermata è stata semplice: usare /downloads in qBittorrent, non il percorso dell'host ZimaOS come /media/GERAL/downloads. La modifica di PUID/PGID in 0/0 non ha risolto il caso originale; la correzione del percorso sì, e l'autore originale ha confermato esplicitamente che i download hanno quindi funzionato.

La differenza fondamentale: percorso dell'host e percorso del container

Una mappatura di volume Docker ha due lati:

HOST_PATH:CONTAINER_PATH

Ad esempio:

/media/GERAL/downloads:/downloads

ZimaOS vede il lato sinistro. qBittorrent viene eseguito all'interno del container e normalmente dovrebbe usare il lato destro.

Corretto in qBittorrent: /downloads
Errato in qBittorrent:   /media/GERAL/downloads

Configurazione originale dell'utente

Impostazioni di qBittorrent in ZimaOS che mostrano la mappatura dei download sull'unità secondaria GERAL
Il post originale mostra qBittorrent configurato con l'archiviazione sull'unità secondaria GERAL.
Impostazioni di download di qBittorrent che utilizzano un percorso dell'host ZimaOS invece del percorso Docker
L'impostazione di qBittorrent utilizzava un percorso dell'host invece del percorso montato del container.
Percorso di archiviazione ZimaOS per l'unità GERAL utilizzata dal container qBittorrent
ZimaOS espone il percorso fisico dell'host, ma qBittorrent non deve usare internamente la stessa stringa di percorso.
campo della cartella di download di qBittorrent tratto dalla discussione sulla risoluzione dei problemi di ZimaOS
La soluzione confermata è stata usare il percorso montato del container /downloads.

Perché la modifica di PUID e PGID non ha risolto questo caso

Una risposta della community ha suggerito inizialmente di provare diverse PUID/PGID valori, inclusi 0/0. L’autore originale ci ha provato e ha riferito che non funzionava.

Questo è importante perché distingue questo caso da un problema di permessi. I privilegi di root non trasformano un percorso dell’host non mappato nel percorso corretto del container.

L’attuale qBittorrent di LinuxServer utilizza lo stesso schema

La documentazione Docker attuale di qBittorrent per LinuxServer usa:

/path/to/downloads:/downloads

e definisce /downloads come posizione di download all’interno del container. Questo corrisponde esattamente alla soluzione della community.

Documentazione Docker di qBittorrent per LinuxServer

Come correggere la cartella di download

  1. Apri le impostazioni dell’app qBittorrent in ZimaOS.
  2. Individua la mappatura del volume di download.
  3. Verifica che la cartella desiderata sull’unità secondaria si trovi sul lato host di ZimaOS.
  4. Verifica che il percorso del container sia stabile, ad esempio /downloads.
  5. Salva e riavvia l’app se la mappatura Docker è cambiata.
  6. Apri la WebUI di qBittorrent.
  7. Vai a Strumenti → Opzioni → Download.
  8. Imposta il percorso di salvataggio predefinito su /downloads o una sottocartella come /downloads/complete.
  9. Avvia un piccolo torrent di prova e verifica quale unità fisica riceve i dati.

Quando i permessi PUID/PGID sono effettivamente importanti

Se /downloads è corretto, ma nei log di qBittorrent compare Accesso negato, quindi controlla proprietario e permessi. L’immagine di LinuxServer supporta PUID e PGID specificamente per i permessi dei bind mount dell’host.

Si tratta di un errore diverso da quello del thread originale. Verifica prima la correttezza del percorso, poi i permessi.

Domande frequenti sulla cartella di download di qBittorrent su ZimaOS

Perché qBittorrent continua a usare l’unità di sistema di ZimaOS?

Nel caso originale, qBittorrent era configurato con il percorso dell’host invece del percorso montato del container.

Quale percorso ha risolto il problema del thread originale?

/downloads. L’autore ha confermato che funzionava.

Devo impostare PUID e PGID su 0?

Non per questo problema. L’autore originale ci ha provato senza successo. Usa prima il percorso corretto del container.