Soluzione della community

qBittorrent su ZimaOS: usa la cartella di download corretta

A user mapped a secondary HDD into qBittorrent but entered the ZimaOS host path inside the app; switching to /downloads fixed it.

La soluzione confermata in questa discussione consisteva nell’impostare il percorso di salvataggio predefinito di qBittorrent sul percorso del container Docker /downloads, non sul percorso dell’host ZimaOS. L’utente aveva già montato correttamente il disco rigido secondario; qBittorrent veniva semplicemente configurato per salvare in un percorso comprensibile solo dall’host.

La modifica di PUID/PGID in root non ha risolto il caso originale. Una volta corretto il percorso, l’autore del post ha confermato esplicitamente che i download funzionavano.

Come appariva la mappatura originale

File di ZimaOS che mostrano una cartella Downloads sul disco rigido GERAL
L’utente voleva che i download di qBittorrent venissero salvati nella cartella Downloads dell’unità GERAL secondaria. Fonte: forum della community IceWhale.
Vista dello spazio di archiviazione di ZimaOS che mostra GERAL come disco rigido separato da 2 TB
ZimaOS aveva già riconosciuto GERAL come HDD separato da 2 TB, quindi il problema non era il rilevamento dell’unità. Fonte: forum della community IceWhale.
Mappatura del volume Docker di qBittorrent da GERAL Downloads a /downloads
La mappatura dell’applicazione esponeva correttamente la cartella dell’host a qBittorrent come percorso del container /downloads. Fonte: forum della community IceWhale.

La mappatura importante è concettualmente:

Host: /media/GERAL/Downloads → Container: /downloads

ZimaOS vede il lato sinistro. qBittorrent viene eseguito all’interno di Docker e normalmente dovrebbe usare il lato destro.

Il percorso errato era impostato in qBittorrent

Percorso di salvataggio predefinito di qBittorrent impostato erroneamente sul percorso dell’host ZimaOS
In qBittorrent, l’utente aveva inserito il percorso /media dell’host invece del percorso del container montato. Fonte: forum della community IceWhale.

La WebUI di qBittorrent era configurata con /media/GERAL/Downloads. Quel percorso dell’host non era il percorso esposto all’applicazione all’interno del container.

L’attuale guida alle cartelle di qBittorrent documenta lo stesso caso originale e la soluzione verificata.

Perché PUID e PGID impostati su root non hanno aiutato

Permessi e visibilità del percorso sono problemi distinti. L’esecuzione come root non può far comparire magicamente in un container un percorso dell’host non montato. Prima verifica il percorso del container; indaga sulla proprietà dei file solo quando il percorso mappato corretto restituisce Permission denied.

La guida ai permessi di qBittorrent correlata tratta questa seconda modalità di errore.

Le immagini Docker attuali usano lo stesso schema

L’immagine attuale di qBittorrent di LinuxServer documenta un volume dei download montato su /downloads. Consulta la documentazione di qBittorrent di LinuxServer prima di modificare una definizione dell’app personalizzata.

In sintesi

Se ZimaOS associa già il disco di destinazione a qBittorrent come /downloads, usa /downloads o una sottocartella al suo interno in qBittorrent. Non incollare nell’applicazione il percorso dell’host ZimaOS, a meno che quel percorso esatto non sia montato anche nel container.