Come configurare l'interfaccia web di qBittorrent su Linux

Per configurare l' interfaccia web di qBittorrent su Linux , installate qBittorrent qbittorrent-nox, avviatelo una volta come utente non root, quindi accedete tramite un browser. Al primo avvio verranno visualizzati l'indirizzo dell'interfaccia web e i dettagli di accesso. Impostate una password complessa prima di lasciare il servizio online. Per l'accesso remoto, utilizzate un tunnel SSH o un proxy HTTPS anziché esporre la porta HTTP predefinita a Internet.

1. Installa qbittorrent-nox

Il qbittorrent-noxpacchetto headless viene eseguito senza una finestra desktop e viene controllato tramite un browser. Installalo tramite il gestore di pacchetti della tua distribuzione:

• Ubuntu o Debian: sudo apt update && sudo apt install qbittorrent-nox
• Fedora: sudo dnf install qbittorrent-nox
• Arch Linux: sudo pacman -S qbittorrent-nox

I pacchetti di Ubuntu si trovano nel componente Universe; abilitalo se APT non riesce a trovare il pacchetto. Le versioni dei pacchetti variano a seconda della release. Consulta il catalogo ufficiale dei pacchetti di Ubuntu , Debian , Arch o Fedora se il pacchetto non è disponibile. La guida all'installazione originale spiega le opzioni relative ai pacchetti e alle versioni.

2. Avvia qBittorrent come utente normale

Non avviare il client con sudo. qBittorrent memorizza le impostazioni e i download per l'account che lo avvia. Per un test rapido, usa il tuo normale account non root. Su un server, usa un account dedicato come qbtuser; crealo con sudo adduser qbtusero, se disponibile, con sudo useradd -m -s /bin/bash qbtuser. Inizializza il client con lo stesso account:

sudo -iu qbtuser
qbittorrent-nox

Accetta l'informativa legale quando richiesto. qBittorrent visualizza l'URL dell'interfaccia web, solitamente http://localhost:8080, e il nome utente dell'amministratore. Le versioni correnti senza password salvata visualizzano una password casuale temporanea nel terminale. Alcuni pacchetti più vecchi potrebbero ancora mostrare adminadmin; usa il valore visualizzato dalla tua versione e cambia immediatamente qualsiasi password predefinita.

3. Accedi e cambia la password

Sulla macchina Linux, apri l'indirizzo stampato in un browser ed effettua l'accesso come admin. Se il client è in esecuzione su un server senza interfaccia grafica, connettiti tramite SSH come descritto di seguito. In Impostazioni o Preferenze → Interfaccia Web , imposta una password univoca e sicura. Mantieni la porta 8080a meno che non sia già in uso. Per una configurazione solo localhost, associa l'interfaccia Web a 127.0.0.1, quindi salva la modifica.

4. Connettersi da remoto tramite un tunnel SSH

L'interfaccia web utilizza HTTP per impostazione predefinita, quindi un port forwarding pubblico diretto può esporre le tue credenziali di accesso. Dal tuo computer, apri un tunnel SSH verso il server Linux:

ssh -L 8080:127.0.0.1:8080 linux_user@server_address

Mantieni aperta la sessione del terminale e visita il sito http://127.0.0.1:8080dal tuo computer. Per accedere senza SSH, utilizza una VPN o configura la terminazione TLS con un proxy inverso. La guida di qBittorrent su Linux HTTPS e NGINX illustra un approccio supportato. Non disabilitare l'autenticazione né esporre l'interfaccia web a reti non attendibili.

5. Mantienilo in esecuzione con systemd

Dopo aver salvato le impostazioni iniziali, interrompi il processo in primo piano con Ctrl+C , quindi esci dalla shell dell'account. Molti pacchetti di distribuzione includono il qbittorrent-nox@.servicetemplate. Abilitalo per l'account utilizzato in precedenza e verificane lo stato:

sudo systemctl enable --now qbittorrent-nox@qbtuser
sudo systemctl status qbittorrent-nox@qbtuser

Sostituire qbtuserse è stato scelto un altro account. Se l'unità non è presente, seguire la guida di configurazione di systemd upstream per la propria distribuzione. Per un'esecuzione temporanea in background senza gestione dell'avvio, utilizzare qbittorrent-nox -d.

6. Aggiungi torrent e trova i file scaricati

Nell'interfaccia web, fai clic su Aggiungi torrent o sull'icona più. Scegli un .torrentfile oppure seleziona l'opzione link magnetico e incolla l'URI del link magnetico. Conferma il percorso di salvataggio prima di iniziare e aggiungi solo contenuti che sei autorizzato a scaricare o condividere.

Il sistema host Linux scarica i dati; questi non vengono inviati al dispositivo che visualizza il browser. Verifica il percorso di salvataggio configurato nelle impostazioni di download. I file di un account di servizio vengono archiviati nei percorsi di quell'account, non necessariamente nella tua directory home personale. Utilizza SSH, SFTP o una cartella condivisa per recuperarli. Quando rimuovi un torrent completato, leggi la conferma e scegli se conservare o eliminare i dati.

Risoluzione dei problemi

• La pagina non si carica: controlla sudo systemctl status qbittorrent-nox@qbtuser, conferma la porta nelle Impostazioni e verifica che il tunnel utilizzi la stessa porta.
• L'accesso non riesce: controlla l'output di avvio o il registro del servizio con sudo journalctl -u qbittorrent-nox@qbtuser -n 50 --no-pager. Usa lo stesso account Linux proprietario della configurazione di qBittorrent. Consulta la guida al recupero della password del progetto se non riesci ad accedere.
• La porta 8080 è occupata: scegli un'altra porta nelle impostazioni dell'interfaccia web oppure prova con qbittorrent-nox --webui-port=8081. Aggiorna l'URL del browser e il tunnel SSH. Il manuale di qbittorrent-nox elenca le opzioni della riga di comando.