Table des matières

,

Deluge

Deluge est un client BitTorrent basé sur Python et GTK+. il s'intègre donc bien dans Gnome, XFCE, Mate et LXDE.

Fonctionnalités de base :

Greffons intégrés :

Installation

Version Desktop

Installez le paquet deluge.

Si vous souhaitez utiliser Deluge en ligne de commandes, installez le paquet deluge-console.

Version Serveur

Il peut être intéressant d'installer Deluge dans ce mode si vous avez un ordinateur qui tourne en permanence et qui n'a pas d'écran ou de mode graphique installé. Vous pourrez y accéder depuis un autre poste au travers d'une interface web très proche de la version desktop.

Installez les paquets deluged deluge-web

Configuration de la version serveur

Gestion des utilisateurs

Premièrement, par securité, nous allons créer un utilisateur deluge. C'est avec les privilèges de cet utilisateur que le serveur sera lancé pour des raisons de sécurité.

sudo adduser --system  --gecos "Deluge Service" --disabled-password --group --home /var/lib/deluge deluge

Il est intéressant d'en profiter pour inclure les utilisateurs qui vont utiliser Deluge dans le groupe deluge afin qu'ils puissent facilement récupérer les fichiers téléchargés. En effet, les fichiers téléchargés seront la propriété de l'utilisateur deluge du groupe deluge, donc initialement inaccessibles aux autres utilisateurs de votre machine. Exemple pour inclure l'utilisateur Toto au groupe deluge :

sudo adduser Toto deluge

Création du service Deluge Daemon (deluged)

Créez le fichier /etc/systemd/system/deluged.service avec les droits d'administration et remplissez-le comme ceci :

/etc/systemd/system/deluged.service
[Unit]
Description=Deluge Bittorrent Client Daemon
After=network-online.target
 
[Service]
Type=simple
User=deluge
Group=deluge
UMask=007
 
ExecStart=/usr/bin/deluged -d
 
Restart=on-failure
 
# Configures the time to wait before service is stopped forcefully.
TimeoutStopSec=300
 
[Install]
WantedBy=multi-user.target
Modifiez UMask=007 selon votre convenance :
  • 007 donne l'accès complet à l'utilisateur et les membres du groupe deluge, aucun accès aux autres
  • 022 donne l'accès complet à l'utilisateur deluge et l'accès en lecture seul aux membres du groupe deluge et aux autres
  • 000 donne l'accès complet à tout le monde

Vous pouvez maintenant configurer le service pour qu'il soit lancé au démarrage, le lancer et vérifier son bon fonctionnement :

systemctl enable /etc/systemd/system/deluged.service
systemctl start deluged
systemctl status deluged
Ces lignes de commandes sont également à utiliser avec les droits d'administration. Erreur reçu sans :
Failed to execute operation: The name org.freedesktop.PolicyKit1 was not provided by any .service files

Failed to start deluged.service: The name org.freedesktop.PolicyKit1 was not provided by any .service files
See system logs and 'systemctl status deluged.service' for details.

Création du service Deluge Web UI (deluge-web)

Créez le fichier /etc/systemd/system/deluge-web.service avec les droits d'administration et remplissez-le comme ceci :

/etc/systemd/system/deluge-web.service
[Unit]
Description=Deluge Bittorrent Client Web Interface
After=network-online.target
 
[Service]
Type=simple
 
User=deluge
Group=deluge
UMask=027
 
ExecStart=/usr/bin/deluge-web -d -p 9092
 
Restart=on-failure
 
[Install]
WantedBy=multi-user.target

Vous pouvez maintenant configurer le service pour qu'il soit lancé au démarrage, le lancer et vérifier son bon fonctionnement :

systemctl enable /etc/systemd/system/deluge-web.service
systemctl start deluge-web
systemctl status deluge-web

Mise en service des log

Pour le débogage, il est recommandé de mettre en service les logs en créant le répertoire /var/log/deluge et en assignant les logs à l'utilisateur deluge

sudo mkdir -p /var/log/deluge
sudo chown -R deluge:deluge /var/log/deluge
sudo chmod -R 750 /var/log/deluge

Pour que nos 2 services précédemment créés et lancés activent les logs, il faut modifier la ligne ExecStart= en y ajoutant l'option -l et -L

ExecStart=/usr/bin/deluged -d -l /var/log/deluge/daemon.log -L warning
ExecStart=/usr/bin/deluge-web -p 9092 -l /var/log/deluge/web.log -L warning

Il n'y a plus qu'a relancer les services pour que les modifications prennent effet.

systemctl restart deluged
systemctl restart deluge-web

Et configurer la rotation des logs en creant le fichier /etc/logrotate.d/deluge avec le contenu suivant

/etc/logrotate.d/deluge
/var/log/deluge/*.log {
        rotate 4
        weekly
        missingok
        notifempty
        compress
        delaycompress
        sharedscripts
        postrotate
                systemctl restart deluged >/dev/null 2>&1 || true
                systemctl restart deluge-web >/dev/null 2>&1 || true
        endscript
}

Utilisation

Version Desktop

Lancez l'application via le tableau de bord (Unity) ou via le terminal (toutes versions d'Ubuntu) avec la commande suivante :

deluge

Version Web / Serveur

Par défaut l'interface est joignable sur le port 8112. Mais dans le fichier de configuration ci-dessus, on a spécifié le port 9092, donc rendez-vous à l'adresse : http://localhost:9092 en local ou http://xxx.xxx.xxx.xxx:9092 depuis un autre poste (où xxx.xxx.xxx.xxx est l'adresse IP de votre serveur). Notez que vous ne pouvez pas configurer un port inférieur à 1024.

Lors de la connexion à l'interface web, celle-ci vous demande de rentrer un mot de passe. Par défaut (lors de la première connexion), le mot de passe est deluge. Le système vous demandera alors d'en changer.

Chiffrer vos échanges

Si vous utilisez Deluge en dehors de votre réseau local (en déplacement, ou via votre mobile avec une application comme Transdroid), il est possible que vous souhaitiez chiffrer vos échanges avec votre serveur.

Pour ce faire, Deluge supporte le chiffrement via SSL que vous pouvez activer dans Préférences>Interface>Use SSL de l'interface Web de Deluge. Vous pouvez éventuellement créer vos propres certificats SSL que vous placerez dans le dossier /var/lib/deluge/ssl avant de modifier vos préférences.

Problèmes connus

Deluge refuse de démarrer

Si Deluge refuse de démarrer, il peut y avoir plusieurs raisons à cela. Lancer Deluge dans un terminal pour voir un peu plus en détail ce qui se passe.

Si vous obtenez quelque chose qui ressemble à l'analyse des trackers actifs suivi d'une erreur semblable, lisez la méthode de résolution après.

Exemple :

Torrent Size 71904023.0
Available Space 5355061248
Raising error: 
deluge_core; using libtorrent 0.11.0.0. Compiled with NDEBUG value: 1
terminate called after throwing an instance of 'boost::filesystem::filesystem_error'
  what():  boost::filesystem::default_name_check: default name check already set
Abandon (core dumped)

il suffit d'exécuter cette commande dans un terminal :

$ rm ~/.config/deluge/*.state && rm ~/.config/deluge/torrentfiles/*.fastresume

Impossible de créer un torrent

Certaines versions de Deluge (dont la 1.3.10-3) peuvent comporter un bug empêchant la création d'un torrent. Il suffit de mettre à jour vers la version suivante 1.3.12-1. Voir discussion ici.

Désinstallation

Pour supprimer cette application, il suffit de supprimer son paquet. Selon la méthode choisie, la configuration globale de l'application est conservée ou supprimée. Les journaux du système, et les fichiers de préférence des utilisateurs dans leurs dossiers personnels sont toujours conservés.

Voir aussi


Contributeurs :Id2ndR, pmd, mavosaure,deathdwarf,linuxforhumanbeings, lexuor76, , zarmu.