1 20/04/2026 10 min

qBittorrent su Debian 11 Bullseye: scelta del pacchetto e obiettivo dell’installazione

Su Debian 11 Bullseye qBittorrent si può installare in due modi sensati: da repository Debian, con il vantaggio della semplicità e dell’integrazione con il sistema, oppure usando una sorgente esterna se serve una versione più aggiornata. In un contesto server o desktop amministrato bene, la priorità non è “avere l’ultima release”, ma ottenere un servizio stabile, avviabile con systemd, con un’interfaccia Web accessibile in modo controllato e senza esporre inutilmente porte o credenziali.

La differenza pratica è questa: il pacchetto Debian tende a essere più conservativo, quindi meno sorprese in aggiornamento; una sorgente esterna può risolvere problemi di funzionalità o di bugfix, ma richiede più disciplina su pinning, upgrade e rollback. Qui parto dal percorso più lineare e sicuro, poi mostro come verificare il servizio e come mettere in piedi l’accesso remoto in modo ragionato.

Installazione da repository Debian

Prima di installare, conviene aggiornare l’indice pacchetti e verificare che il sistema sia allineato. Non è una formalità: su Bullseye molti problemi “strani” nascono da repository parzialmente aggiornati o da dipendenze rimaste in stato incoerente dopo upgrade precedenti.

sudo apt update
sudo apt install qbittorrent qbittorrent-nox

Il pacchetto qbittorrent installa il client grafico, utile su desktop o sessioni con X11/Wayland. Il pacchetto qbittorrent-nox installa invece la variante senza GUI, pensata per server, VPS e ambienti headless. Se stai lavorando su una macchina remota, nella maggior parte dei casi è qbittorrent-nox la scelta giusta.

Per controllare cosa è stato installato e da quale repository arriva il pacchetto, usa:

apt policy qbittorrent qbittorrent-nox

Il comando mostra versione candidata, versione installata e origine del pacchetto. Se il pacchetto non arriva da Debian ma da una sorgente terza, conviene saperlo subito: è il punto in cui si decide se mantenere quella fonte o rientrare su repository ufficiali.

qBittorrent-nox come servizio systemd

Su Debian il pacchetto qbittorrent-nox può essere avviato in modalità non interattiva. Il vantaggio è evidente: niente sessione grafica, niente X server, niente dipendenze inutili. Per un nodo da amministrare bene, questa è la forma corretta.

Dopo l’installazione, verifica che l’eseguibile sia presente e che il servizio possa essere gestito da systemd. In alcune configurazioni il pacchetto crea un’unità dedicata; in altre conviene creare un utente di servizio e un’unità custom. Prima di inventare, controlla cosa hai realmente sul sistema:

systemctl list-unit-files | grep -i qbittorrent
systemctl status qbittorrent-nox

Se l’unità esiste, il passo successivo è verificarne lo stato. Se non esiste, significa che dovrai gestire un’unità personalizzata. In quel caso la strada più pulita è creare un utente dedicato, senza shell interattiva, e usare una directory dati separata.

Esempio di utente di servizio:

sudo adduser --system --group --home /var/lib/qbittorrent --shell /usr/sbin/nologin qbittorrent

Questo approccio riduce la superficie d’attacco: il processo non gira come root, non ha una shell utile e conserva i file in una home dedicata. È il minimo sindacale quando il client torrent viene esposto in rete, anche solo tramite Web UI.

Unità systemd personalizzata per ambiente headless

Se il pacchetto non fornisce un servizio già pronto, o se vuoi controllare in modo esplicito percorso dati e utente di esecuzione, crea un’unità dedicata. Prima fai un backup del file se ne esiste già uno, poi procedi con una modifica minima e reversibile.

sudo nano /etc/systemd/system/qbittorrent-nox.service

Contenuto esempio:

[Unit]
Description=qBittorrent Command Line Client
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=qbittorrent
Group=qbittorrent
UMask=007
ExecStart=/usr/bin/qbittorrent-nox --webui-port=8080
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

Dopo aver salvato il file, ricarica systemd e avvia il servizio:

sudo systemctl daemon-reload
sudo systemctl enable --now qbittorrent-nox
sudo systemctl status qbittorrent-nox

Il controllo importante non è solo “active (running)”, ma anche il fatto che il processo ascolti sulla porta prevista e che i log non mostrino errori di permessi o di accesso al profilo utente. Se il servizio parte e poi muore, il primo posto da guardare è il journal:

journalctl -u qbittorrent-nox -b --no-pager

Se compaiono errori su directory non scrivibili, correggi ownership e permessi sulla home del servizio. Un controllo tipico è questo:

sudo chown -R qbittorrent:qbittorrent /var/lib/qbittorrent
sudo chmod 750 /var/lib/qbittorrent

La regola è semplice: meno privilegi, ma sufficienti per scrivere nella cartella dati e nella cartella di download. Se i download finiscono su un mount esterno o una share NFS, verifica anche che il filesystem supporti correttamente owner, permessi e locking. Molti problemi attribuiti a qBittorrent sono in realtà problemi di storage.

Interfaccia Web: configurazione iniziale e credenziali

La Web UI è la modalità più pratica su server, ma è anche il punto in cui si commettono gli errori peggiori: porta esposta sulla WAN, credenziali deboli, accesso senza TLS, oppure reverse proxy configurato male. Il primo accesso va fatto localmente, non pubblicando subito il servizio su Internet.

Di default, qBittorrent-nox espone la Web UI su una porta come 8080. Verifica la porta effettiva con:

ss -ltnp | grep qbittorrent

Se il processo ascolta correttamente, apri la Web UI dal browser sulla LAN o in locale. Al primo accesso è buona pratica cambiare subito username e password. Non lasciare le credenziali di default, perché sono un classico punto di compromissione.

Se vuoi modificare i parametri della Web UI senza passare dall’interfaccia grafica, il file di configurazione si trova tipicamente nel profilo dell’utente del servizio. Il nome preciso può variare in base al pacchetto e alla versione, quindi prima cerca i file effettivi:

sudo find /var/lib/qbittorrent -maxdepth 3 -type f | grep -Ei 'qBittorrent|qBittorrent.conf|qBittorrent.conf.old'

Se hai già configurato la Web UI da browser, il file di configurazione conterrà i parametri salvati. Non editarlo a caso mentre il servizio è in esecuzione: fermalo prima, fai una copia del file e poi intervieni. La modifica deve essere reversibile e leggibile, non una scommessa.

Accesso remoto sicuro: firewall e reverse proxy

Esporre direttamente la Web UI su Internet è una cattiva idea. Molto meglio tenerla su localhost o su una rete privata e pubblicarla solo tramite reverse proxy con TLS, autenticazione e controllo dell’accesso. Se il server è dietro un firewall, la porta di qBittorrent non dovrebbe essere aperta verso l’esterno.

Per verificare quali porte sono esposte localmente, usa:

sudo ss -ltnp

Se vuoi consentire solo l’accesso dalla LAN, puoi limitare il traffico con il firewall del sistema. Esempio con UFW, se presente:

sudo ufw allow from 192.168.1.0/24 to any port 8080 proto tcp

Se usi Nginx come reverse proxy, la configurazione base deve inoltrare correttamente gli header e mantenere la connessione WebSocket dove necessario. Un esempio minimale è questo:

server {
    listen 443 ssl http2;
    server_name torrent.example.com;

    ssl_certificate /etc/letsencrypt/live/torrent.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/torrent.example.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

Questa configurazione va adattata al tuo contesto. Se il certificato non è ancora presente, ottienilo con il tuo flusso standard di certificazione. Se il proxy non deve essere pubblico, meglio ancora: usa VPN o accesso tramite rete amministrativa e non esporre affatto la UI su Internet.

Verifica del download path, storage e permessi

Una volta avviato il servizio, il test vero non è la sola apertura della dashboard: devi verificare che i download vadano nel path corretto, che i permessi siano coerenti e che il filesystem regga il carico. Su sistemi con dischi piccoli o root partition stretta, qBittorrent può riempire lo storage molto in fretta.

Controlla i mount attivi e lo spazio libero:

df -h
lsblk -f

Se il download directory è su volume separato, assicurati che il servizio possa scriverci. Un test semplice consiste nel creare un file di prova con l’utente del servizio:

sudo -u qbittorrent touch /var/lib/qbittorrent/.write-test
sudo rm -f /var/lib/qbittorrent/.write-test

Se questo fallisce, il problema non è qBittorrent ma i permessi della directory o il mount sottostante. In caso di share esterne, controlla anche eventuali opzioni come noexec, ro o mapping UID/GID lato server NFS.

Avvio automatico e manutenzione

Per evitare sorprese dopo reboot, il servizio deve essere abilitato in modo esplicito. Il controllo base è semplice:

systemctl is-enabled qbittorrent-nox
systemctl is-active qbittorrent-nox

Se l’unità è abilitata ma non parte, il journal del boot precedente è il primo posto da consultare. In particolare, cerca errori di bind sulla porta, problemi di permessi, mancato montaggio di un filesystem esterno e dipendenze di rete non ancora disponibili al momento dell’avvio.

In manutenzione ordinaria, conviene controllare tre cose: versione installata, stato del servizio e spazio disco. Un set minimo di verifiche periodiche può essere questo:

apt policy qbittorrent qbittorrent-nox
systemctl status qbittorrent-nox --no-pager
journalctl -u qbittorrent-nox -p warning -b --no-pager
df -h

Se vuoi aggiornare il pacchetto, fallo con una finestra di manutenzione e conserva la possibilità di rollback. La via più semplice è tenere traccia della versione installata prima dell’upgrade e, se necessario, ripristinarla dal repository o da un mirror affidabile. Su sistemi critici è meglio evitare upgrade “alla cieca” di componenti esposti in rete.

Risoluzione dei problemi più comuni

Se la Web UI non risponde, la sequenza giusta è sempre la stessa: prima controlla se il processo è attivo, poi se ascolta sulla porta corretta, poi se il firewall o il proxy stanno bloccando il traffico. Saltare direttamente alla modifica della configurazione spesso allunga solo il tempo perso.

Comandi utili in ordine di priorità:

systemctl status qbittorrent-nox
ss -ltnp | grep 8080
journalctl -u qbittorrent-nox -b --no-pager

Se il servizio è attivo ma la porta non c’è, spesso il problema è un parametro di avvio errato o un conflitto con un’altra applicazione. Se la porta c’è ma il browser non raggiunge la UI, allora il problema è quasi sempre firewall, NAT o proxy. Se invece la UI si apre ma download e upload non partono, il nodo successivo è la configurazione delle porte di ascolto del protocollo BitTorrent e la reachability dall’esterno.

Se vuoi verificare che il client stia usando la porta di ascolto prevista, controlla le impostazioni da interfaccia e osserva la connettività dall’esterno. In scenari dietro NAT, l’inbound può non funzionare se il router non inoltra la porta corretta. Qui non serve “indovinare”: serve vedere la configurazione reale del router, del firewall e dello stato della connessione.

Nota pratica sulla sicurezza operativa

qBittorrent è un software legittimo, ma come ogni client di rete va trattato con disciplina. Non usare password banali, non pubblicare la UI senza TLS, non lasciare il servizio in ascolto su tutte le interfacce se non serve, e non dare al processo più permessi del necessario. Se il nodo è multiuso, separa bene il dominio dei download dal resto del filesystem per evitare danni collaterali in caso di file corrotti o riempimento disco.

Se la macchina ospita servizi condivisi, considera qBittorrent un carico potenzialmente rumoroso: può saturare banda, IOPS e spazio disco. La mitigazione migliore è limitare velocità, schedulare i download pesanti e monitorare metriche elementari come utilizzo disco, throughput di rete e numero di connessioni. In pratica, il software funziona bene quando l’ambiente attorno è tenuto sotto controllo.

Checklist finale di installazione

Prima di considerare chiuso il lavoro, verifica questi punti nell’ordine giusto: pacchetto installato, servizio attivo, porta in ascolto, accesso Web protetto, directory di download scrivibile, spazio disco sufficiente. Se uno di questi punti fallisce, il problema è quasi sempre locale e va corretto prima di esporre il servizio a utenti o rete esterna.

  1. Installazione completata con apt install qbittorrent qbittorrent-nox.
  2. Servizio verificato con systemctl status qbittorrent-nox.
  3. Ascolto confermato con ss -ltnp.
  4. Log puliti con journalctl -u qbittorrent-nox -b.
  5. Permessi e storage validati con sudo -u qbittorrent touch ... e df -h.
  6. Accesso remoto limitato da firewall o reverse proxy, non esposto in chiaro.

Assunzione: il sistema è Debian 11 Bullseye aggiornato, con accesso amministrativo e possibilità di gestire systemd, firewall e file di configurazione locali.