qBittorrent

qBittorrent est un client torrent gratuit et open source, écrit en C++ avec Qt. C’est l’un des rares clients du genre sans publicité, sans offre groupée ni palier payant : tout est dans la même version gratuite, point final. Il tourne sous Windows, macOS et Linux, et son interface Web fait partie du cœur de l’application, pas vendue à part ni ajoutée en option. C’est précisément ce qui le rend pratique pour un homelab : on le pointe vers un serveur sans écran, et on pilote tout depuis un onglet de navigateur.

Licence : le code source de qBittorrent est sous licence GPL-2.0-or-later. Les versions binaires, elles, sont distribuées sous GPL-3.0-or-later, parce qu’elles embarquent des éléments sous GPLv3+ comme les icônes. C’est écrit noir sur blanc dans le fichier COPYING du dépôt GitHub qbittorrent/qBittorrent. Une exception spécifique autorise la liaison avec OpenSSL. Le moteur de téléchargement en dessous, libtorrent-rasterbar (développé par Arvid Norberg), est une dépendance à part sous licence BSD à 3 clauses, pas sous GPL.

En bref : site officiel qbittorrent.org · GitHub qbittorrent/qBittorrent, plus de 29 000 étoiles · image Docker linuxserver/qbittorrent (communautaire, pas maintenue par le projet qBittorrent lui-même) · port par défaut de l’interface Web : 8080.

Cette page ne couvre que des usages légaux. BitTorrent est un protocole, pas un outil de piratage. C’est la même technologie qu’utilisent Ubuntu, Debian et les autres distributions Linux pour publier leurs fichiers torrent officiels, que l’Internet Archive utilise pour diffuser des contenus du domaine public, et que de nombreux développeurs indépendants emploient pour distribuer des logiciels open source et des contenus sous licence Creative Commons. Tout ce qui est décrit ici part du principe que vous téléchargez des fichiers que vous avez réellement le droit de télécharger : images ISO de distributions Linux, versions open source, contenus du domaine public ou sous licence Creative Commons, et sauvegardes personnelles via un tracker privé que vous gérez ou en qui vous avez confiance. Cette page ne couvre pas, ne renvoie pas vers, et ne discute pas des trackers publics, des sites d’indexation, ni d’aucune configuration visant à échapper à la détection pour des téléchargements non autorisés. Et ça ne changera pas.

Ce que fait vraiment qBittorrent

Sous le capot, qBittorrent reste une interface assez fine posée sur libtorrent-rasterbar, le même moteur que plusieurs autres clients utilisent aussi. Ce qui le distingue au quotidien : le téléchargement séquentiel, pratique pour lancer la lecture d’une vidéo avant que tout le torrent soit terminé, la planification de la bande passante selon l’heure, des catégories et des tags par torrent, un lecteur RSS qui récupère automatiquement les nouvelles versions correspondant à un filtre (les flux de sortie des distributions Linux s’y prêtent bien), et un système de plugins pour chercher des sources de contenu libre ou du domaine public directement depuis l’interface. Rien de tout ça ne nécessite d’application complémentaire. L’interface Web intégrée affiche exactement la même chose qu’une installation de bureau, simplement accessible depuis n’importe quel navigateur du réseau.

Installer qBittorrent avec Docker

Il n’existe pas d’image Docker maintenue par le projet qBittorrent lui-même. La référence communautaire, celle vers laquelle pointent la plupart des guides self-hosting, c’est linuxserver/qbittorrent de LinuxServer.io : plus de 100 millions de pulls, des reconstructions hebdomadaires, et le même schéma PUID/PGID que le reste du catalogue LinuxServer.io.

docker run -d \
  --name=qbittorrent \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e WEBUI_PORT=8080 \
  -p 8080:8080 \
  -p 6881:6881 \
  -p 6881:6881/udp \
  -v /path/to/qbittorrent/config:/config \
  -v /path/to/downloads:/downloads \
  --restart unless-stopped \
  lscr.io/linuxserver/qbittorrent:latest

Ou avec un docker-compose.yml :

services:
  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent:latest
    container_name: qbittorrent
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - WEBUI_PORT=8080
    volumes:
      - /path/to/qbittorrent/config:/config
      - /path/to/downloads:/downloads
    ports:
      - 8080:8080
      - 6881:6881
      - 6881:6881/udp
    restart: unless-stopped

Lancez docker compose up -d, puis vérifiez docker logs qbittorrent pour récupérer le mot de passe admin temporaire affiché au premier démarrage.
Ouvrez http://ip-de-votre-serveur:8080 et connectez-vous avec ce mot de passe temporaire.
Changez immédiatement l’identifiant et le mot de passe dans les paramètres de l’interface Web ; un nouveau mot de passe temporaire est généré à chaque redémarrage tant que vous ne l’avez pas fait.
Faites pointer le dossier de téléchargements vers l’emplacement déjà surveillé par votre bibliothèque média ou votre outil d’archivage.

Matériel : qBittorrent sollicite peu le CPU. Il passe l’essentiel de son temps à attendre les entrées-sorties réseau, pas à calculer. Un Raspberry Pi 4 ou n’importe quel mini PC basse consommation encaisse une file de téléchargement normale sans forcer ; la vitesse du disque et la bande passante disponible sont le vrai plafond, pas le processeur. Notre guide auto-hébergement homelab détaille comment choisir son matériel pour un premier projet Docker.

Sécuriser l’interface Web

La configuration par défaut expose l’interface Web sur le port 8080 sans HTTPS natif. Mettez-la derrière un reverse proxy comme Nginx Proxy Manager avec un vrai certificat, ou évitez carrément de l’exposer sur internet et passez plutôt par un VPN maillé comme Tailscale ou WireGuard. Le port de torrenting, 6881 par défaut, n’a besoin d’être redirigé sur le routeur que si vous voulez la meilleure connectivité possible aux pairs pour du contenu que vous téléchargez légalement ; qBittorrent fonctionne très bien sans, juste avec une découverte des pairs un peu plus lente.

qBittorrent vs Transmission

Transmission sacrifie une partie des fonctionnalités de qBittorrent au profit d’une empreinte plus légère. C’est le client que la plupart des fabricants de NAS intègrent par défaut, parce qu’il consomme très peu de ressources, mais l’automatisation RSS et les plugins de recherche demandent alors des scripts ou des outils tiers pour arriver au même résultat que qBittorrent nativement. qBittorrent embarque davantage de fonctionnalités dès l’installation de base, au prix d’un processus légèrement plus lourd.

	qBittorrent	Transmission
Licence	GPL-2.0 / GPL-3.0	MIT
Interface	Interface Web complète, même base de code que l’app de bureau	Interface Web minimale, plusieurs frontends tiers
Téléchargement RSS auto	Intégré	Nécessite un plugin ou un script
Plugins de recherche	Intégrés	Non intégrés
Consommation de ressources	Légèrement plus lourde	Très légère

qBittorrent : avantages et inconvénients

Gratuit et open source, sans publicité, sans offre groupée, sans palier payant
Interface Web, lecteur RSS et plugins de recherche intégrés, rien à installer en plus
Téléchargement séquentiel et limites de bande passante par torrent intégrés
Tourne confortablement sur du matériel peu puissant comme un Raspberry Pi

Aucune image Docker maintenue par le projet qBittorrent lui-même ; on dépend du build communautaire LinuxServer.io
L’interface Web par défaut n’a ni HTTPS ni protection anti-brute-force natifs, il faut un reverse proxy ou un VPN
Certaines fonctionnalités avancées, comme les filtres RSS ou les règles de catégorie, demandent de fouiller un peu dans les paramètres pour les trouver

FAQ

qBittorrent est-il gratuit ?

Oui, entièrement, sous GPL-2.0-or-later pour le code source et GPL-3.0-or-later pour les versions binaires. Pas de palier payant, pas de compte, pas de publicité.

Est-il légal d’utiliser qBittorrent ?

Oui. C’est un logiciel généraliste pour le protocole BitTorrent, le même protocole qu’utilisent les distributions Linux et l’Internet Archive pour distribuer leurs fichiers. Ce qui est légal ou non dépend entièrement de ce que vous téléchargez avec, exactement comme pour un lecteur multimédia ou un navigateur web.

Existe-t-il une image Docker officielle de qBittorrent ?

Non. Le projet qBittorrent n’en publie ni n’en maintient. linuxserver/qbittorrent de LinuxServer.io est l’image communautaire vers laquelle pointent la plupart des guides self-hosting, celui-ci compris.

Faut-il rediriger le port de torrenting ?

Non, mais ça aide. qBittorrent fonctionne très bien sans port redirigé ; ouvrir le 6881 améliore simplement le nombre de pairs qui peuvent se connecter directement à vous, ce qui compte surtout pour les torrents moins populaires.

Peut-on faire tourner qBittorrent sur un Raspberry Pi ou un NAS ?

Oui. Il sollicite peu le CPU, et aussi bien le Raspberry Pi que la plupart des NAS grand public font tourner l’image linuxserver/qbittorrent sans problème, tant que le stockage suit la vitesse de votre connexion.

Pour télécharger de manière responsable au-delà des torrents, notre page MeTube couvre la même logique d’usage légal pour la vidéo. Tailscale ou WireGuard permettent de garder l’interface Web complètement à l’écart d’internet, et notre guide auto-hébergement homelab couvre le reste des bases Docker dont tout ceci dépend.