La discussione originale del luglio 2025 è iniziata con un errore di installazione di qBittorrent dall’App Store e si è conclusa con l’installazione manuale di un container LinuxServer.io. In precedenza, la versione breve di questa pagina passava troppo rapidamente da «pull non riuscito» a «usa LinuxServer». La discussione completa contiene un’importante deviazione legata alla versione: IceWhale ha chiesto all’utente di testare la beta1 di ZimaOS 1.4.2 perché il comportamento durante l’installazione delle app era stato migliorato; la beta si è installata, ma ha creato un nuovo problema legato alla GPU GTX 1070 dell’utente, che alla fine è tornato alla 1.4.1.
Il container qBittorrent installato manualmente funzionava abbastanza bene per l’utente originale, ma la soluzione alternativa storica per la WebUI disabilitava la convalida dell’header Host e la protezione CSRF. Questa configurazione non deve essere adottata come correzione predefinita in un’installazione attuale.
Il problema originale era un problema di pull dell’immagine
Un errore durante il pull dell’immagine è diverso da un container che si avvia e poi va in crash. L’obiettivo della diagnosi è il riferimento dell’immagine, l’accesso al registro, la definizione nell’App Store o il livello di installazione delle app di ZimaOS.
IceWhale ha suggerito ZimaOS 1.4.2 Beta1
Zima-Giorgio ha chiesto all’utente di provare la beta1 di ZimaOS 1.4.2, allora l’ultima versione disponibile, perché quella release migliorava l’esperienza di installazione delle app e avrebbe potuto risolvere il problema. Quando l’aggiornamento non è comparso automaticamente, Giorgio ha fornito la procedura ufficiale di aggiornamento offline per quella beta storica.
Quei comandi appartengono a una build pre-release del 2025 e non devono essere riutilizzati su un server attuale. La loro importanza è storica: IceWhale considerava il problema di pull dall’App Store potenzialmente correlato alla versione di ZimaOS.
La beta ha creato un problema diverso per l’utente
L’utente ha installato la versione beta, ma in seguito è tornato alla 1.4.1 perché, a suo dire, la beta ignorava la GPU GTX 1070. Questo dimostra perché un aggiornamento a una versione beta effettuato solo per correggere un’app dovrebbe includere controlli di regressione sul resto del server.
Un sistema attuale dovrebbe utilizzare la versione stabile corrente di ZimaOS, salvo che non vi sia un motivo specifico di supporto per testare una versione preliminare.
L'utente ha quindi installato l'immagine qBittorrent di LinuxServer.io
L'attuale qBittorrent di LinuxServer.io utilizza lscr.io/linuxserver/qbittorrent. Le sue principali impostazioni persistenti e di rete includono:
-
/configper la configurazione di qBittorrent; - una cartella dei download sull'host mappata nel container;
- PUID e PGID per la proprietà dei file;
- una porta WebUI;
- una porta di ascolto BitTorrent su TCP e UDP.
Usa le impostazioni attuali del container qBittorrent di LinuxServer.io invece di ricostruire a memoria la configurazione del 2025.
Mantieni sincronizzati WEBUI_PORT e la mappatura delle porte Docker
L'immagine attuale serve normalmente la WebUI sulla porta 8080. Se vuoi usare un'altra porta dell'host, puoi mappare tale porta dell'host al servizio del container. Se viene modificata la porta interna della WebUI, LinuxServer.io richiede il WEBUI_PORT valore dell'ambiente e la mappatura Docker in modo che corrispondano.
Una porta WebUI non corrispondente può causare errori di connessione che sembrano problemi di autenticazione o di intestazioni di sicurezza.
Usa la password temporanea dal log di avvio
L'utente della fonte ha correttamente osservato che la prima password può essere trovata nei log. Il comportamento attuale di LinuxServer.io genera una password temporanea per l' admin account all'avvio.
Apri il log del container qBittorrent, usa il valore temporaneo per il primo accesso e imposta subito una password permanente dalla WebUI.
Non disabilitare HostHeaderValidation e CSRFProtection per impostazione predefinita
L'utente della fonte ha aggiunto storicamente:
WebUI\HostHeaderValidation=false
WebUI\CSRFProtection=falseal file di configurazione di qBittorrent. È stato segnalato che l'applicazione sembrava quindi funzionare, ma queste opzioni indeboliscono deliberatamente i controlli di sicurezza rivolti al browser.
In un'installazione attuale, occorre innanzitutto risolvere la configurazione corretta della porta, dell'URL della WebUI, delle intestazioni del reverse proxy e dell'autenticazione. Non rendere “disabilita CSRF” la risposta standard a un problema di accesso alla WebUI.
Se è coinvolto un reverse proxy, configuralo correttamente
Gli errori relativi all'host header compaiono spesso quando si accede a un'applicazione tramite un hostname o un proxy che la WebUI non si aspetta. La soluzione corretta consiste normalmente nel configurare in modo coerente il proxy e le impostazioni della WebUI di qBittorrent, non nel disabilitare globalmente ogni convalida.
Il traffico della WebUI e quello dei peer BitTorrent utilizzano porte diverse
La porta utilizzata per amministrare qBittorrent in un browser non è la porta utilizzata per le connessioni dei peer in entrata. Pubblica la porta di ascolto torrent scelta tramite TCP e UDP e fai in modo che l'impostazione della porta di ascolto di qBittorrent corrisponda.
Se il server si trova dietro NAT e desideri la connettività in entrata dei peer, la configurazione del router o della VPN è una decisione separata dalla mappatura delle porte Docker.
Mappa i download allo spazio di archiviazione ZimaOS effettivo
Non lasciare che torrent di grandi dimensioni si accumulino nel livello del container usa e getta o su un disco di sistema piccolo. Mappa la directory dei download allo spazio di archiviazione ZimaOS previsto e verifica che l'utente del container possa scrivervi prima di avviare un download di grandi dimensioni.
Preserva /config prima di ricreare il container
Le preferenze, le categorie, i percorsi e lo stato dell'applicazione qBittorrent si trovano nella directory di configurazione persistente. Esegui un backup prima di cambiare immagine o sostituire un'installazione dall'App Store con un container personalizzato.
Domande frequenti su qBittorrent in ZimaOS
Il problema originale era un arresto anomalo di qBittorrent?
No. L'installazione dall'App Store non è riuscita nella fase di scaricamento dell'immagine Docker.
Perché l'utente è tornato dalla versione beta a ZimaOS 1.4.1?
Hanno segnalato che la versione beta non gestiva la loro GTX 1070 come previsto.
Da dove proviene la prima password di qBittorrent?
Gli attuali container LinuxServer.io mostrano una password amministratore temporanea nel registro di avvio.
La protezione CSRF deve essere disabilitata per far funzionare la WebUI?
No, non come approccio predefinito. Prima correggi la configurazione attuale di porta, proxy, hostname e autenticazione.
