---
title: qBittorrent
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, downloads, torrent, bittorrent, client, cpp, qt, webui]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=downloads, https://github.com/qbittorrent/qBittorrent]
---

# qBittorrent

> Client BitTorrent libre, open source et multiplateforme, écrit en C++ avec Qt. Référence des utilisateurs recherchant une alternative sans publicité à uTorrent.

| Métadonnée | Valeur |
| :--- | :--- |
| **Site web** | https://www.qbittorrent.org/ |
| **GitHub** | https://github.com/qbittorrent/qBittorrent |
| **License** | GPL-2.0 |
| **Langage** | C++ / Qt 6 |
| **Étoiles GitHub** | 4 717 ⭐ |
| **Dernière MAJ** | 2026-05 |
| **Catégorie** | [[cat-downloads]] |

## Description

qBittorrent est un client BitTorrent complet, écrit en C++ avec le framework Qt, publié sous licence GPL-2.0. Le projet vise à offrir une alternative libre et éthique à uTorrent : pas de publicités, pas de logiciels embarqués, pas de télémétrie. Il est disponible sur Windows, macOS, Linux, FreeBSD et propose des paquets pour les principales distributions (Arch, Debian, Ubuntu, Fedora, etc.).

L'application intègre nativement un **moteur de recherche multi-sources** (recherche de torrents simultanée sur plusieurs sites), une **interface web** (WebUI) accessible à distance, le **chiffrement de protocole**, le support des **liens magnet**, des **liens DHT, PEX et LSD** pour la découverte de pairs, ainsi qu'un **planificateur de bande passante** et des **priorités par torrent**. La WebUI historique, minimaliste, peut être remplacée par des frontends modernes comme [[app-vuetorrent]] pour une expérience plus riche.

qBittorrent supporte également les **catégories et étiquettes**, les **filtres IP**, le **blocage de pairs** et un **système de torrents séquentiels**. L'API HTTP exposée par la WebUI (au format `/api/v2/...`) est largement utilisée par les outils d'automatisation (Sonarr, Radarr, Prowlarr, etc.) qui poussent les torrents directement depuis leur interface.

## Installation

### Option 1 : Docker Compose (recommandé)

```yaml
services:
  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent:latest
    container_name: qbittorrent
    restart: unless-stopped
    ports:
      - "8080:8080"     # WebUI
      - "6881:6881"     # BitTorrent TCP
      - "6881:6881/udp" # BitTorrent UDP
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Paris
      - WEBUI_PORT=8080
    volumes:
      - ./config:/config
      - ./downloads:/downloads
```

Identifiants par défaut : `admin` / `adminadmin` (à changer immédiatement). UI sur `http://localhost:8080`.

### Option 2 : Installation manuelle

- **Linux** : paquet `qbittorrent` ou `qbittorrent-nox` (variante sans interface graphique) disponible sur la plupart des distributions.
- **Windows / macOS** : installeur officiel sur le site du projet.
- **FreeBSD** : port `net-p2p/qbittorrent-nox` (variante serveur, idéale sur NAS ou serveur headless).

## Configuration

1. **Outils → Options → Téléchargements** : choisir le dossier par défaut, activer la gestion des `.torrent` et `.magnet`.
2. **Connexion** : configurer le port d'écoute (par défaut 6881), ouvrir ce port sur le routeur ou utiliser un VPN ([[app-gluetun]]).
3. **Vitesse** : limites globales et horaires alternés (scheduler) pour libérer la bande passante la nuit.
4. **WebUI** : changer le mot de passe par défaut, activer la protection anti-brute-force. Possibilité de brancher un frontend alternatif.
5. **Recherche** : ajouter des plugins de recherche (sites open source type LinuxTracker, Internet Archive, AcademicTorrents).
6. **Proxy / VPN** : en cas d'utilisation d'un container VPN (Gluetun, WireGuard), ajouter `network_mode: "service:vpn"` au service qBittorrent.

## Alternatives

### Open Source
- [[app-transmission]] — Client léger, base sur GTK/macOS, plus simple mais moins de fonctionnalités
- [[app-deluge]] — Client modulaire, support de plugins, daemon + frontend séparés
- [[app-vuetorrent]] — Frontend web moderne qui remplace la WebUI native de qBittorrent
- [[app-jackett]] — Agrégateur d'indexeurs torrents (complémentaire, pas concurrent)

### Propriétaires
- **uTorrent** / **BitTorrent** — Clients historiques, désormais adossés à des pubs et à un bundleware
- **Deluge Pro / BiglyBT** — Clients avec fonctionnalités avancées mais fermés
- **Popcorn Time** — Lecture en streaming BitTorrent (légalité variable selon juridiction)

## Sécurité

- Changer **immédiatement** le mot de passe par défaut `adminadmin` depuis la WebUI
- Ne **jamais** exposer la WebUI (port 8080) sur Internet sans reverse proxy authentifié (Authelia, Authentik)
- Restreindre les ports BitTorrent sortants à un VPN ([[app-gluetun]], [[app-wireguard]]) pour éviter de fuiter son IP
- Activer l'**authentification WebUI 2FA** via plugin ou via un reverse proxy
- Mettre à jour régulièrement : qBittorrent corrige périodiquement des CVE (notamment sur libtorrent)
- Limiter les permissions par utilisateur de la WebUI (lecture seule / téléchargement)

## Ressources

- Site officiel : https://www.qbittorrent.org/
- Code source : https://github.com/qbittorrent/qBittorrent
- Wiki : https://github.com/qbittorrent/qBittorrent/wiki
- WebUI API : https://github.com/qbittorrent/qBittorrent/wiki/WebUI-API-(qBittorrent-4.1)
- Forum : https://qbforums.shiki.hu/

## Pages Liées
- [[cat-downloads]] — Vue d'ensemble de la catégorie Downloads
- [[app-vuetorrent]] — Frontend web moderne pour qBittorrent
- [[app-jackett]] — Proxy d'indexeurs torrents (complémentaire)
- [[app-transmission]] — Client BitTorrent alternatif
- [[app-deluge]] — Client BitTorrent modulaire
- [[app-gluetun]] — Container VPN pour cacher le trafic BitTorrent
- [[app-sonarr]] / [[app-radarr]] — Outils *arr qui s'intègrent à qBittorrent
- [[recettes-docker-compose]] — Templates Docker
