Il problema originale di qBittorrent aveva due livelli. Innanzitutto, qBittorrent deve salvare in un percorso esistente all'interno del container. In secondo luogo, il processo di qBittorrent deve disporre dei permessi di scrittura sulla cartella dell'host sottostante a quel percorso del container. L'utente aveva già risolto il livello della mappatura: la cartella era visibile, ma il registro di esecuzione mostrava ancora Autorizzazione negata.
La soluzione della community ha creato una cartella di download dedicata e utilizzato un'impostazione molto permissiva chmod -R 777 come test rapido dei permessi. L'autore originale ha confermato che i download hanno quindi funzionato. Questo risultato dimostra che il problema era dovuto ai permessi di scrittura, ma 777 non dovrebbe essere la raccomandazione permanente su un sistema attuale.
Le impostazioni di archiviazione di qBittorrent di ZimaOS mappavano una cartella Movies dell'host al percorso container /Movies-TV
/Movies-TV.La fonte utilizzava:
-
Host:
/media/Main Storage/Media/Movies -
Container:
/Movies-TV
All'interno di qBittorrent, il percorso di salvataggio deve usare /Movies-TV/..., non il percorso effettivo dell'host.
La visibilità ha dimostrato che la mappatura funzionava; l'autorizzazione negata ha dimostrato che la scrittura non funzionava
Il registro di esecuzione di qBittorrent dell'utente riportava Autorizzazione negata. È diverso da File o directory inesistente:
- File o directory inesistente: la mappatura o il percorso probabilmente non sono corretti.
- Autorizzazione negata: il container riesce a raggiungere il percorso, ma non può scrivervi.
Una cartella di download dedicata rende più semplice configurare correttamente i permessi
La community ha creato una sottocartella, ad esempio:
/media/Main Storage/Media/Movies/qbittorrent-downloadse impostare la destinazione sul lato container di qBittorrent su:
/Movies-TV/qbittorrent-downloadsÈ meglio che concedere a un downloader l'accesso in scrittura a un intero albero multimediale, se gli serve una sola directory di staging.
chmod 777 era una scorciatoia diagnostica, non un buon modello di autorizzazioni definitivo
La risposta della community utilizzava il comando ricorsivo chmod 777 e l'autore originale ha confermato che questo ha risolto il problema. Ciò stabilisce il nesso causale, ma i permessi di scrittura per tutti consentono a ogni processo locale di scrivere nella directory.
Una soluzione permanente più sicura consiste nell'identificare l'UID/GID di runtime del container qBittorrent e concedere solo a quell'utente/gruppo l'accesso in scrittura necessario.
Controlla la proprietà prima di modificarla
Tra i controlli di sola lettura utili rientrano l'ispezione del proprietario/gruppo della cartella e della modalità prima di modificare qualsiasi cosa. Se qBittorrent viene eseguito con un PUID/PGID configurabile, allinea questi valori a un gruppo host che disponga dei permessi di scrittura sulla directory dei download.
Evita di modificare ricorsivamente la proprietà di un'intera libreria multimediale condivisa quando è necessario rendere scrivibile una sola cartella.
ZimaOS attualmente rende espliciti i percorsi dei volumi delle app
La documentazione attuale di IceWhale spiega che le applicazioni dell'App Store vengono eseguite all'interno di container e che le relative cartelle importanti sono mappate sullo spazio di archiviazione reale dell'host. Queste mappature possono essere visualizzate e modificate dalle impostazioni dell'app.
Usa l'attuale modello dei percorsi Docker di ZimaOS prima di modificare i permessi.
Separa la cartella di staging dei download dalla libreria multimediale finale
Un'architettura comune è:
- qBittorrent scrive in una cartella download dedicata;
- Sonarr/Radarr o un altro organizzatore importa i file completati;
- Jellyfin/Plex legge la libreria multimediale finale, spesso in sola lettura.
In questo modo ogni applicazione ottiene solo l'accesso di cui ha bisogno.
Esegui prima il test con un solo download di piccole dimensioni
Dopo aver modificato la mappatura o i permessi:
- riavvia qBittorrent;
- conferma che il percorso di salvataggio punti a una posizione interna al container;
- scarica un piccolo file di test legale;
- controlla il registro di esecuzione;
- verifica che il file compaia nello spazio di archiviazione host previsto.
FAQ sul percorso di download di qBittorrent
La mappatura del volume di origine era errata?
La community ha concluso che era visibile/corretto; l'errore rimanente riguardava i permessi di scrittura.
chmod 777 ha risolto il problema del caso in questione?
Sì, e l'autore originale del post ha confermato che ha funzionato. Dovrebbe essere considerato una scorciatoia diagnostica generica, non l'autorizzazione permanente preferita.
Quale percorso dovrebbe usare internamente qBittorrent?
Il percorso sul lato container definito nella mappatura dei volumi di ZimaOS, ad esempio /Movies-TV/qbittorrent-downloads.
