Una semplice pagina bianca Unauthorized in qBittorrent non indica sempre lo stesso problema dell’inserimento di un nome utente o di una password errati. La discussione nella community di IceWhale comprende entrambe le situazioni: alcuni utenti non riuscivano a raggiungere correttamente la WebUI di qBittorrent finché non aprivano il server ZimaOS con un URL http:// esplicito, mentre in seguito altri utenti riuscivano a visualizzare la schermata di accesso ma non sapevano dove fosse memorizzata la password qBittorrent generata.
L’approccio di risoluzione dei problemi più sicuro consiste quindi nel separare la convalida della richiesta della WebUI dall’autenticazione della WebUI. Innanzitutto, assicurati che il browser raggiunga qBittorrent tramite l’URL e il protocollo corretti. Solo dopo il caricamento della schermata di accesso dovrai verificare il nome utente amministratore e la password temporanea.
Prova prima l’URL http:// esplicito
Una risposta della community di febbraio 2025 ha riferito che è bastato aggiungere http:// anteponendolo all’indirizzo IP del server ha risolto la pagina Unauthorized:
http://ZIMAOS_LAN_IP:QBITTORRENT_PORT
In seguito, un altro utente ha confermato che questo gli ha permesso di raggiungere la pagina di accesso alla WebUI di qBittorrent.
Usa la porta effettiva della WebUI di qBittorrent sul lato host, indicata nelle impostazioni dell’app ZimaOS. Se l’app espone direttamente la porta 8080, l’URL potrebbe essere simile a:
http://192.168.1.50:8080
Non dare per scontato che ogni pacchetto qBittorrent di ZimaOS utilizzi la stessa porta host.
Perché l’URL stesso può causare “Unauthorized”?
La WebUI di qBittorrent include controlli di sicurezza oltre al modulo di accesso. Il codice sorgente attuale di qBittorrent può restituire una risposta Unauthorized quando la convalida dell’intestazione Host o la protezione dalle richieste tra siti rifiuta una richiesta.
Ciò significa che questi elementi possono comportarsi in modo diverso:
192.168.1.50:8080
http://192.168.1.50:8080
https://192.168.1.50:8080
https://some-dashboard-link.example/...
se il browser, la dashboard, il proxy inverso, l’origine o il protocollo causano intestazioni di richiesta diverse. Il risultato della community non dimostra che ogni pagina Unauthorized sia causata dall’assenza di http://, ma rende l’URL LAN esplicito un buon primo controllo diagnostico.
Una finestra del browser privata è uno strumento diagnostico, non una soluzione completa
Il primo suggerimento della community è stato provare una finestra del browser privata. Un utente ha riferito che ha funzionato una volta, facendo inizialmente pensare a un problema di cookie. I test successivi hanno mostrato che la navigazione privata non risolveva il problema in modo coerente.
Usa una finestra in incognito/privata per escludere dati di sessione obsoleti, ma non fermarti qui nella risoluzione del problema. Se l’errore ricompare, prova l’URL HTTP esplicito e controlla i log di qBittorrent.
Se riesci a raggiungere la schermata di accesso, risolvi separatamente il problema della password
Un utente successivo è riuscito a raggiungere la pagina di accesso di qBittorrent dopo aver aggiunto http:// ma poi ha provato combinazioni della password di ZimaOS, una password vuota e admin. Tali credenziali non sono necessariamente correlate.
Le versioni moderne di qBittorrent hanno modificato il comportamento di autenticazione della WebUI al primo avvio. L'attuale documentazione ufficiale sul recupero della password di qBittorrent afferma che qBittorrent 4.6.1 e versioni successive possono fornire una password temporanea per la WebUI quando non è configurata alcuna password.
Nella discussione della community, il testo rilevante del log del container era:
Il nome utente dell'amministratore della WebUI è: admin
La password dell'amministratore della WebUI non è stata impostata.
Per questa sessione è stata fornita una password temporanea:
La password temporanea effettiva appare nell'output del container dopo quel messaggio.
Come ottenere la password temporanea di qBittorrent in ZimaOS
Un utente della community ha suggerito di aprire il Terminale basato sul Web di ZimaOS ed eseguire:
docker logs qbittorrent
Il nome esatto del container può variare; quindi, se il comando indica che il container non esiste, prima individualo:
docker ps --format '{{.Names}}' | grep -i qbit
Quindi leggi i log appropriati del container.
Dopo aver effettuato l'accesso, imposta immediatamente una password personale sicura per la WebUI nelle opzioni della WebUI di qBittorrent. Una password temporanea generata per la sessione non è destinata a diventare la tua credenziale permanente.
Per conoscere il comportamento di ripristino upstream attuale, consulta la documentazione sul recupero della password della WebUI di qBittorrent.
Cosa fare se docker logs restituisce «Permission Denied»?
L'ultimo messaggio nella discussione della community riportava:
ATTENZIONE: errore durante il caricamento del file di configurazione: apertura di /DATA/.docker/config.json: autorizzazione negata
autorizzazione negata durante il tentativo di connessione al socket del daemon Docker all'indirizzo unix:///var/run/docker.sock
Questo è un problema di autorizzazioni di Docker sull'host, non un errore della password di qBittorrent. L'utente della shell che esegue docker logs non dispone dell'autorizzazione per comunicare con il daemon Docker.
Utilizza il flusso di lavoro autorizzato del terminale amministrativo di ZimaOS per la diagnostica di Docker. Non /var/run/docker.sock accessibili in scrittura a tutti e non ampliare i permessi dell'host solo per leggere un singolo log.
Non dare per scontato che adminadmin sia la password predefinita attuale
Le versioni e la documentazione meno recenti di qBittorrent utilizzavano comunemente:
Nome utente: admin
Password: adminadmin
L'attuale documentazione sul recupero di qBittorrent distingue tra le versioni precedenti e successive alla 4.6.1. Nelle versioni più recenti, l'eliminazione o l'assenza della password configurata fa sì che qBittorrent stampi una password temporanea invece di ripristinare semplicemente una password permanente predefinita e prevedibile.
Pertanto, quando ZimaOS ti indica di “recuperare dal log”, usa i log del container invece di riprovare ripetutamente adminadmin.
Imposta un nome utente e una password permanenti per la WebUI
Quando riesci ad accedere:
- Apri Strumenti > Opzioni > WebUI.
- Imposta una password forte per la WebUI.
- Mantieni il nome utente amministratore oppure modificalo in base alle opzioni disponibili nella versione installata.
- Salva le impostazioni.
- Apri una nuova sessione del browser e verifica che le nuove credenziali funzionino.
La risposta della community suggeriva anche di ignorare l'autenticazione per i client localhost. Non abilitare un bypass dell'autenticazione più ampio del necessario. Una WebUI di qBittorrent può aggiungere download e modificare le impostazioni dell'applicazione, quindi l'accesso deve rimanere limitato ai client attendibili.
Non disabilitare la protezione dell'header Host o contro il CSRF come prima soluzione
qBittorrent include protezioni per l'header Host e contro il CSRF per un motivo. Disabilitarle globalmente può ampliare l'esposizione della WebUI e nascondere un reverse proxy o un link del dashboard configurato erroneamente.
Se l'accesso diretto tramite:
http://ZIMAOS_LAN_IP:PORT
funziona, ma un dominio personalizzato o un link tramite reverse proxy restituisce “Non autorizzato”, configura il proxy affinché invii le informazioni corrette sull'host e sull'origine e segui le indicazioni aggiornate di qBittorrent per i reverse proxy. Evita di impostare wildcard permissivi solo per rimuovere l'errore.
Controlla i log di qBittorrent per individuare il rifiuto specifico della WebUI
Il codice attuale della WebUI di qBittorrent registra condizioni come header Host non validi o incompatibilità dell'origine. Se il browser mostra “Non autorizzato” prima della pagina di accesso, leggi i log del container mentre riproduci la richiesta.
Potresti visualizzare messaggi che indicano:
- convalida dell'header Host;
- incompatibilità tra Origin e Referer;
- autenticazione non riuscita;
- generazione di una password temporanea;
- o un problema non correlato all'avvio dell'applicazione.
Questo è più affidabile che considerare ogni pagina in stile 401 come un problema dei cookie.
Checklist per la risoluzione dei problemi di qBittorrent «Non autorizzato»
- Verifica che il container qBittorrent sia in esecuzione.
- Controlla la porta host corrente di ZimaOS per la WebUI di qBittorrent.
- Apri l’URL esplicito
http://ZIMAOS_LAN_IP:PORT. - Prova una finestra privata del browser solo come strumento diagnostico per la sessione o la cache.
- Se viene visualizzata la pagina di accesso, interrompi la verifica delle intestazioni Host e recupera le credenziali effettive di qBittorrent.
- Per qBittorrent 4.6.1 e versioni successive, controlla i log del container per individuare la password temporanea quando non è impostata alcuna password permanente.
- Imposta una nuova password WebUI complessa dopo aver effettuato l’accesso.
- Se l’accesso tramite IP diretto funziona ma un proxy o un dominio non funziona, esegui il troubleshooting della configurazione Host/Origin del reverse proxy.
- Non disabilitare globalmente i controlli di sicurezza della WebUI di qBittorrent come prima soluzione alternativa.
- Se non è possibile leggere i log Docker, risolvi separatamente il problema di accesso amministrativo all’host.
Domande frequenti sulla risoluzione dell’errore «Non autorizzato» di qBittorrent su ZimaOS
Perché aggiungere http:// ha risolto la pagina «Non autorizzato»?
Ha costretto il browser a utilizzare l’origine HTTP prevista invece di interpretare o aggiornare l’indirizzo in modo diverso. qBittorrent esegue la convalida dell’host della WebUI e tra siti diversi, quindi il protocollo e le intestazioni delle richieste possono influire sull’accettazione della richiesta.
Qual è la password della WebUI di qBittorrent su ZimaOS?
Dipende dalla versione di qBittorrent installata e dalla configurazione esistente. Nelle versioni moderne senza una password configurata, qBittorrent può generare una password temporanea e stamparla nei log del container. ZimaOS potrebbe indicarti esplicitamente di recuperare la password da quei log.
admin/adminadmin è ancora la password predefinita?
Non farci affidamento per le versioni attuali di qBittorrent. Il progetto qBittorrent ha modificato la gestione della password al primo avvio nella versione 4.6.1, quindi l’assenza di una password WebUI impostata può comportare la generazione temporanea di una password.
L’errore «Non autorizzato» è causato dai cookie del browser?
Non necessariamente. Una finestra privata ha aiutato temporaneamente un utente della community, ma i test successivi non hanno dimostrato che il problema scomparisse in modo coerente. Anche la convalida dell’URL e del protocollo e la sicurezza della WebUI lato server possono essere possibili cause.
Perché docker logs qbittorrent restituisce «permesso negato per il socket Docker»?
L’account del terminale corrente non è autorizzato ad accedere al demone Docker. Questo è separato dall’autenticazione di qBittorrent. Usa una shell amministrativa autorizzata invece di indebolire i permessi del socket Docker.
