Configurer Deluge en 2026 : le client torrent modulaire à plugins
Guide complet pour Deluge en 2026 : installation, mode Classic vs Client/Daemon, binding VPN, plugins Label/AutoAdd/Execute, ratio, chiffrement. Pour desktop et seedbox.
Ce guide a un but éducatif. monratio.fr n'encourage ni le piratage ni le téléchargement illégal. Deluge est un logiciel libre sous licence GPL-3, utilisé pour distribuer des distributions Linux, des jeux libres et des œuvres sous licence Creative Commons.
🔌 Pourquoi Deluge et pas un autre
Deluge, c'est le client torrent des bricoleurs. Il a deux caractéristiques uniques dans le paysage :
- Architecture client/serveur propre : le moteur (daemon) tourne d'un côté, l'interface (client) de l'autre. Vous pouvez piloter un Deluge sur serveur distant depuis votre PC portable comme s'il tournait en local.
- Écosystème de plugins mature : Label (tags automatiques), AutoAdd (ajout automatique depuis un dossier surveillé), Execute (script à la fin d'un torrent)... des dizaines de plugins qui transforment Deluge en automate.
Deluge face aux autres clients
Deluge, c'est le bon choix si :
- Vous voulez automatiser : tag auto, drop folder, scripts post-téléchargement
- Vous gérez à la fois une instance locale et une distante avec la même UI
- Vous êtes sur seedbox : Deluge est proposé sur la plupart des offres (Seedbox.io, Ultra.cc, Whatbox)
- Vous avez l'habitude de Linux et aimez les fichiers de config
Deluge n'est pas le bon choix si : vous voulez la simplicité ultime. L'interface GTK 3 est vieillissante et la courbe d'apprentissage des plugins est réelle. Voir notre comparatif si vous hésitez.
Deluge 2.x : Python 3, libtorrent-rasterbar, architecture deluged (daemon) + deluge-gtk/deluge-console/deluge-web (clients). Plugins Python officiels et tiers. RPC sur port 58846 par défaut (auth par couple user/pwd). Config path : ~/.config/deluge/. Mode "Classic" = daemon+client dans un seul process, "Thin client" = daemon séparé pilotable à distance. Installation sur Ubuntu via PPA ppa:deluge-team/stable pour avoir la dernière 2.x.
L'histoire de Deluge : projet démarré en 2007, historiquement très populaire dans la communauté Linux pour son architecture modulaire. Deluge 1.x (Python 2) était la référence jusqu'en 2018. La migration vers Deluge 2.x (Python 3) a pris du temps mais est désormais stable. Les anciens tutos peuvent référencer 1.x, préférez toujours 2.x.
Deluge et les seedboxes : la plupart des seedboxes proposent Deluge en option. C'est particulièrement intéressant quand vous voulez combiner Classic local (sur votre PC) et thin client qui se connecte au Deluge de la seedbox pour piloter à distance.
📥 Télécharger et installer Deluge
Source officielle unique : deluge-torrent.org. Évitez absolument les miroirs tiers.
- Allez sur deluge-torrent.org/downloads
- Section Windows : téléchargez Deluge 2.x Installer (64-bit)
- Lancez l'exécutable, acceptez la licence
- Gardez les options par défaut (GTK Runtime inclus)
- Terminez l'installation, lancez Deluge depuis le menu Démarrer
- Au premier lancement, laissez en mode Classic (par défaut)
- Officiel : téléchargez le
.dmgdepuis deluge-torrent.org - Homebrew :
brew install --cask deluge - Ouvrez le
.dmg, glissez Deluge dans Applications - Premier lancement : clic droit > Ouvrir (Gatekeeper)
⚠️ La version macOS est fonctionnelle mais moins polie qu'ailleurs. Si vous êtes sur Mac, Transmission est souvent un meilleur choix. Voir le tuto Transmission.
- Ubuntu / Debian (via PPA officiel pour 2.x à jour) :
sudo add-apt-repository ppa:deluge-team/stablesudo apt updatesudo apt install deluge deluged deluge-console
- Fedora :
sudo dnf install deluge - Arch :
sudo pacman -S deluge - Daemon uniquement (headless NAS/serveur) : installer seulement
delugedetdeluge-web, puissystemctl --user enable --now deluged.service - Web UI accessible sur
http://localhost:8112(mot de passe par défaut :deluge, à changer !)
- Connectez-vous au panel de votre seedbox (Seedbox.io, Ultra.cc, Whatbox, RapidSeedbox…)
- Cherchez Deluge dans la liste des applications disponibles
- Activez-le si nécessaire, récupérez les credentials (user + mot de passe daemon)
- Installez Deluge en local aussi (mode Thin Client) pour piloter la seedbox depuis votre PC
- Préférences > Interface > Classic Mode : décocher, puis relancer
- Connexion > ajouter l'host de la seedbox, port 58846, user/pwd du daemon
💡 Le Thin Client est LA raison d'être de Deluge : une interface locale qui pilote plusieurs daemons distants. Parfait pour gérer PC + seedbox + NAS depuis un seul endroit.
Installation : PPA ppa:deluge-team/stable sur Ubuntu pour 2.x récent. Arch : pacman -S deluge (GTK) ou yay -S deluge-git. Docker : linuxserver/deluge. Daemon : /usr/bin/deluged --config ~/.config/deluge, Web UI : /usr/bin/deluge-web. Config daemon : ~/.config/deluge/core.conf, auth : ~/.config/deluge/auth (format user:password:10 pour level admin). Premier démarrage : deluge-console config --set download_location /path pour config non-interactive.
Deluge 1.x est mort, passez à 2.x : beaucoup de tutos en ligne sont encore basés sur Deluge 1.x (Python 2). Les plugins ne sont pas compatibles entre les deux versions. Sur Ubuntu en particulier, le paquet deluge par défaut peut encore être 1.x. Toujours installer depuis le PPA deluge-team/stable pour 2.x à jour.
Mode Classic vs Thin Client : Classic = tout-en-un (daemon + GUI dans le même process), simple mais non-partageable. Thin Client = daemon séparé, vous pouvez vous y connecter depuis plusieurs machines. Pour un usage mono-PC, Classic suffit. Pour piloter une seedbox ou un NAS, Thin Client obligatoire.
🛡️ Binder Deluge au VPN (kill switch)
La config critique. Sans elle, si le VPN tombe, Deluge continue sur votre vraie connexion et votre IP réelle fuite. Même principe que qBittorrent : on force Deluge à n'utiliser que l'interface VPN.
Étape 1 : Identifier l'IP de votre interface VPN
Connectez votre VPN, ouvrez un terminal, puis :
Trouver l'IP de l'interface VPN
10.x.x.x ou 172.27.x.x. C'est l'IP du tunnel VPN.
Étape 2 : Configurer l'interface dans Deluge
- Ouvrez Deluge
- Préférences (Ctrl+P ou menu Édition > Préférences)
- Onglet "Réseau"
- Section "Interface" : cochez "Interface"
- Dans le champ qui apparaît, entrez l'IP de votre interface VPN (ex.
10.2.0.2) - Cliquez Appliquer puis OK
Deluge > Préférences > Réseau > Interface
Étape 3 : Tester la coupure VPN
- Lancez un torrent (ISO Ubuntu légale par exemple)
- Vérifiez qu'il télécharge (DL > 0)
- Coupez le VPN
- Le torrent passe en "Error" ou "Paused" en quelques secondes
- Vitesse : 0 Ko/s
- Reconnectez le VPN : reprise automatique
Preferences > Network > Interface : IP du tunnel. Deluge utilise libtorrent sous le capot, le bind est transmis comme listen_interfaces. Sur Linux daemon : ~/.config/deluge/core.conf → "listen_interface": "10.2.0.2", puis restart deluged. Pour Docker : pref inutile, utilisez network_mode: service:gluetun dans compose.yaml. Test via ss -tnp | grep deluged.
Deluge et le nom d'interface : contrairement à qBittorrent qui accepte un nom d'interface (tun0, NordLynx), Deluge veut une IP exacte. Si votre VPN attribue une IP différente à chaque reconnexion (ProtonVPN par exemple), vous devez réécrire l'IP à chaque fois, ou scripter la mise à jour via l'API XML-RPC de Deluge.
Pour ProtonVPN avec IP changeante : un petit script Python peut récupérer l'IP du tunnel à chaque reconnexion et update core.conf via deluge-console : deluge-console "config --set listen_interface 10.2.0.2", puis restart daemon.
🌐 Configurer le port d'écoute
Le port d'écoute est le numéro qui permet aux pairs de se connecter à vous. Même principe qu'avec tout client.
- Préférences (Ctrl+P)
- Onglet "Réseau"
- Section "Ports d'écoute entrant" : décochez "Use Random Ports"
- Entrez votre port (deux champs : "Depuis" et "Jusqu'à", mettez la même valeur, ex.
43521et43521) - Section "Découverte de réseau" : décochez UPnP et NAT-PMP (inutiles derrière VPN)
- Cliquez Appliquer
Préférences > Réseau
💡 Si vous êtes derrière un VPN sans port forwarding (Mullvad, NordVPN), le port importe peu : vous serez en mode passif de toute façon. Mettez une valeur élevée (49152-65535) et passez à la suite.
core.conf : "listen_ports": [43521, 43521], "random_port": false, "upnp": false, "natpmp": false. Pour ProtonVPN dynamic port : script qui récupère le port via natpmpc, push via deluge-console : deluge-console "config --set listen_ports [PORT,PORT]" + restart. Sur Docker : mapper le port dans compose + set listen_ports dans core.conf du volume.
Plage de ports ou port fixe ? Deluge accepte une plage (ex. 40000-50000) ou un port fixe (ex. 43521/43521). Avec un VPN qui fait du port forwarding, vous devez mettre le port exact attribué, toujours une valeur unique. Une plage n'a de sens que sans VPN (et sans VPN… on vous recommande pas de torrenter).
🔌 Les 3 plugins essentiels
Le vrai pouvoir de Deluge, c'est ses plugins. Voici les 3 à activer en priorité. Préférences > Plugins > cochez-les un par un.
À quoi ça sert ? Chaque torrent ajouté reçoit un label (ex: "BTN", "HDB", "public"). Vous pouvez définir des règles par label : dossier de destination, limites de vitesse, ratio cible. Imbattable pour gérer plusieurs trackers avec des contraintes différentes.
- Préférences > Plugins > cochez Label
- Un onglet "Label" apparaît dans la fenêtre principale à gauche
- Clic droit dans le panneau Label > Add Label
- Créez par exemple :
HDB,BTN,Public,Seedbox - Pour chaque label : clic droit > Options > settings spécifiques (dossier, ratio, bande passante)
- À l'ajout d'un torrent : assigner manuellement ou auto-label par tracker URL
💡 Auto-labelling : configurez des regex sur les URLs tracker pour que chaque torrent soit catégorisé automatiquement.
À quoi ça sert ? Tous les .torrent déposés dans un dossier sont automatiquement ajoutés à Deluge. Couplé avec Sonarr/Radarr ou un flux RSS, vous avez un pipeline complet sans aucune intervention manuelle.
- Préférences > Plugins > cochez AutoAdd
- Redémarrez Deluge
- Préférences > AutoAdd
- Cliquez Add, sélectionnez un dossier à surveiller (ex.
~/Watch) - Options : label à appliquer, dossier de destination, "Delete original" coché pour ne pas garder les
.torrentaprès ajout - Testez : copiez un
.torrentdans le dossier → il apparaît dans Deluge en quelques secondes
À quoi ça sert ? À la fin d'un torrent, un script bash/python/powershell est exécuté avec les infos du torrent en argument (nom, hash, chemin). Parfait pour : déplacer les fichiers, notifier sur Discord, lancer un scan Plex, etc.
- Préférences > Plugins > cochez Execute
- Préférences > Execute
- Event "Torrent Complete" : chemin vers votre script
- Le script reçoit 3 args :
torrent_id,torrent_name,save_path - Exemple script shell :
#!/bin/bash
echo "$2 terminé dans $3" >> ~/deluge-done.log - Rendez le script exécutable :
chmod +x script.sh
💡 Exemple concret : trigger un scan Plex à chaque fin de torrent avec curl http://plex:32400/library/sections/1/refresh?X-Plex-Token=XXX.
Plugins officiels livrés avec Deluge : Label, AutoAdd, Execute, Blocklist, Extractor, Notifications, Scheduler. Fichiers Python dans /usr/lib/python3.x/dist-packages/deluge/plugins/ ou ~/.config/deluge/plugins/. Pour plugins tiers (LabelPlus par exemple) : télécharger le .egg et drop dans le dossier plugins, puis activer dans Preferences. Execute expose les events : torrent_added, torrent_complete, torrent_removed. Pour automation avancée : couplez avec deluge-console pour exécuter des commandes RPC depuis un script externe.
Plugins tiers intéressants : LabelPlus (Label avec sous-catégories, rules par tracker URL), RatioStars (coloration visuelle des ratios), YaRSS2 (RSS avec filtres regex puissants). À chercher sur GitHub, format .egg, déposer dans ~/.config/deluge/plugins/.
Le combo automation ultime : AutoAdd (dossier watch) + Label (auto-labelling par regex tracker) + Execute (script post-download déplace par label) = pipeline complet sans un clic.
⚡ Ratio, bande passante et file d'attente
Préférences > Bande passante pour les limites, Préférences > Files d'attente pour le ratio.
Bande passante
Bande passante
File d'attente et ratio
Files d'attente
💡 Avec le plugin Label, vous pouvez surcharger ces valeurs par label (ratio 5.0 pour trackers exigeants, 2.0 pour les autres).
core.conf : max_upload_speed, max_download_speed (en KiB/s, -1 = illimité), max_connections_global, max_upload_slots_global. Queue : max_active_downloading, max_active_seeding, max_active_limit, stop_seed_ratio, stop_seed_at_ratio: true, remove_seed_at_ratio: false. Avec Label : override max_upload_speed_per_torrent par label. Pour trackers exigeants (HDB/BTN) : ratio 5.0+, seed time illimité, priorité.
Deluge vs qBittorrent pour le ratio : Deluge + Label est supérieur à qBittorrent natif pour gérer plusieurs trackers avec des règles différentes. Un label HDB avec ratio 5.0 et bande passante illimitée, un label Public avec ratio 1.0 et bande passante bridée : impossible à faire aussi proprement dans qBittorrent.
🔒 Chiffrement et confidentialité
Préférences > Chiffrement :
Chiffrement des pairs
Réseau (retour dans l'onglet Réseau) : désactivez DHT, PEX, LSD si vous utilisez des trackers privés.
Trackers privés : DHT / PEX / LSD partagent vos torrents avec des pairs hors tracker. Bannissement immédiat sur la plupart des sites privés. Toujours désactivés en contexte privé.
core.conf : "enc_in_policy": 2 (forced), "enc_out_policy": 2, "enc_level": 2 (full stream). Réseau : "dht": false, "utpex": false, "lsd": false. Pour ajouter une blocklist (plugin Blocklist) : URL de Level1 / P2P filter, update auto toutes les 48h.
Deluge ne spoofe pas le peer_id : contrairement à qBittorrent qui peut être configuré pour se faire passer pour µTorrent, Deluge envoie toujours son vrai peer_id (-DE200s- en 2.x). C'est bien : pas de hack, pas de problème avec les whitelist trackers. Tous les gros trackers privés acceptent Deluge.
✅ Vérification finale
Dernier test pour valider que tout est étanche.
Test 1 : IP générale
- VPN connecté, allez sur ipleak.net
- IP, DNS, WebRTC : aucune ne doit être votre vraie IP
Test 2 : IP torrent (décisif)
- Toujours sur ipleak.net, section "Torrent Address detection"
- Cliquez Activate, téléchargez le
.torrentgénéré - Ouvrez-le dans Deluge, attendez 30 secondes
- Retour sur ipleak.net : l'IP torrent doit correspondre à l'IP navigateur (celle du VPN)
Test 3 : Coupure VPN
- Torrent actif en téléchargement
- Coupez le VPN
- Deluge doit signaler une erreur ou passer à 0 Ko/s en < 10s
- Reconnexion VPN : reprise auto
Deluge est prêt
Kill switch, plugins, ratio, chiffrement : tout est paramétré. Votre Deluge peut tourner des mois sans intervention.
Audit : ipleak.net pour IP browser + torrent address detection. Coupure : nmcli con down VPN ou ip link set tun0 down. Logs daemon : ~/.config/deluge/deluged.log. Pour audit automatisé : deluge-console "info" via cron + check qu'aucun torrent ne tourne si VPN down. API RPC : client.core.get_session_status() pour monitoring continu.
Si IP torrent ≠ IP navigateur : Deluge n'utilise pas la bonne interface. Retournez à l'étape 3, vérifiez que l'IP configurée dans Préférences > Réseau > Interface correspond exactement à celle de votre tunnel VPN actuelle.
Automatiser l'update IP : pour ProtonVPN/Mullvad avec IP qui change à chaque reconnexion, un script peut récupérer la nouvelle IP (ip addr show wg0 | grep inet) et la pousser dans Deluge via deluge-console "config --set listen_interface $IP" + systemctl restart deluged.