ruTorrent est l’interface web de rTorrent, un client BitTorrent sans fenêtre : installée sur un serveur, elle permet d’utiliser rTorrent depuis un navigateur, avec la liste des torrents, des plugins et des flux RSS. C’est l’interface la plus répandue sur les seedbox.
rTorrent et ruTorrent en trois points
- rTorrent télécharge et partage ; ruTorrent n’est que la fenêtre web qui le pilote.
- Les deux dialoguent par un socket SCGI, réglé des deux côtés.
- Les plugins de ruTorrent permettent de créer un torrent, de lire des flux RSS, de gérer les ratios et de déplacer les fichiers téléchargés sur la seedbox.
rTorrent et ruTorrent : deux logiciels qui travaillent ensemble
rTorrent est un client BitTorrent libre écrit en C++ par Jari Sundell, qui fonctionne dans un terminal, sans interface graphique. Il repose sur sa propre bibliothèque libtorrent, différente de libtorrent-rasterbar utilisée par d’autres clients. Très léger, il peut gérer des centaines de torrents sur un petit serveur, ce qui explique sa place sur la plupart des seedbox, ces serveurs distants dédiés au partage.
ruTorrent, publié par le développeur Novik sur GitHub sous licence GPLv3, ajoute à rTorrent une interface web proche de celle de µTorrent : une colonne de catégories et d’étiquettes, la liste des torrents au centre, et en bas des onglets pour les pairs, les trackers, les fichiers et un journal. ruTorrent ne télécharge rien lui-même : il envoie des commandes à rTorrent et lit ses réponses. Si rTorrent s’arrête, l’interface affiche une erreur de connexion, mais les fichiers restent en place sur le disque.
Cette séparation a un avantage pratique : on peut fermer le navigateur, éteindre son ordinateur, le client continue de partager sur le serveur. Elle a un coût : deux logiciels à installer, à mettre à jour et à configurer pour qu’ils se parlent.
Comment installer ruTorrent sur un serveur ?
L’installation de ruTorrent sur un serveur Linux suit toujours le même ordre, sur Ubuntu Server comme sur Debian. Il faut d’abord installer rTorrent, disponible dans les paquets de la distribution (sudo apt install rtorrent), puis un serveur web capable d’exécuter PHP : Apache, nginx ou lighttpd. La documentation du projet demande PHP 7.4 ou plus récent, avec les extensions json et pcre.
Viennent ensuite trois étapes :
- récupérer ruTorrent depuis la page GitHub du projet (dernière version publiée) et placer son dossier dans la racine du serveur web, par exemple
/var/www/rutorrent; - ouvrir dans le fichier de configuration de rTorrent,
.rtorrent.rcdans le dossier home de l’utilisateur, un socket SCGI que ruTorrent pourra joindre ; - indiquer le même port, ou le même socket local, dans
conf/config.phpde ruTorrent, puis lancer rTorrent, souvent dans une session screen ou tmux, ou comme service système.
Le dossier de profil, qui conserve les réglages de chaque utilisateur, gagne à être placé hors de la racine du site, par exemple sous /var/lib/rutorrent, comme le conseille la documentation. Des images Docker communautaires réunissent rTorrent, ruTorrent et le serveur web dans un seul container, une solution courante pour un serveur personnel.
Configurer ruTorrent quand on débute
La configuration de ruTorrent tient pour l’essentiel dans le fichier conf/config.php. Les deux réglages qui comptent au départ sont $scgi_port et $scgi_host : par défaut 5000 et 127.0.0.1, ils doivent correspondre à la ligne SCGI de .rtorrent.rc. Une erreur à cet endroit produit le message le plus fréquent chez les débutants, qui signale que ruTorrent ne peut pas joindre rTorrent.
Trois autres points évitent la plupart des ennuis :
- protéger l’accès : ruTorrent n’a pas de comptes propres, l’authentification se règle dans le serveur web (fichier
.htpasswdsous Apache, directiveauth_basicsous nginx), avec HTTPS pour que le mot de passe ne circule pas en clair ; - ne jamais exposer le port SCGI sur internet : il doit rester limité à la machine (127.0.0.1) ou à un socket local, car il donne un contrôle complet de rTorrent ;
- vérifier les droits : le serveur web et rTorrent doivent pouvoir lire et écrire les mêmes dossiers de téléchargement, par exemple
/home/user/download.
Dans l’interface, le bouton Paramètres règle ensuite la langue, les limites de vitesse, le nombre de connexions et le port d’écoute de rTorrent. Les réglages faits à cet endroit valent jusqu’au redémarrage de rTorrent ; pour les rendre permanents, il faut les reporter dans .rtorrent.rc.
Quelles sont les fonctionnalités de ruTorrent ?
Les fonctionnalités de ruTorrent couvrent l’ajout de torrents par fichier ou par lien magnet, le choix du dossier de destination, la priorité des fichiers, les étiquettes (labels) et les statistiques de chaque torrent : ratio, vitesse, pairs connectés, trackers. L’essentiel du reste vient des plugins livrés avec l’application, chacun dans son dossier sous plugins/ :
| Plugin | Ce qu’il ajoute |
|---|---|
| create | la création d’un nouveau torrent à partir d’un fichier ou d’un dossier du serveur |
| RSS | la lecture de flux RSS et des filtres d’ajout automatique |
| autotools | l’étiquetage et le déplacement automatiques des torrents terminés |
| datadir | le changement du dossier de données d’un torrent |
| ratio | des limites de ratio par groupe de torrents |
| throttle, scheduler | des limites de vitesse par groupe, puis selon l’heure et le jour |
| diskspace, trafic | l’espace disque restant et le volume de trafic échangé |
| erasedata | la suppression d’un torrent avec ses données |
Le plugin httprpc remplace la passerelle de communication par une version plus économe en bande passante, utile quand l’interface est consultée depuis une connexion lente. D’autres extensions, écrites par des tiers, ajoutent un gestionnaire de fichiers ou des thèmes graphiques.
Utiliser ruTorrent au quotidien : flux RSS, étiquettes et documentation
Utiliser ruTorrent au quotidien revient surtout à gérer des étiquettes et des flux RSS. Le plugin RSS lit l’adresse d’un flux RSS, affiche ses entrées dans la colonne de gauche et applique des filtres : chaque filtre associe un motif de nom à un dossier et à une étiquette, de sorte qu’un nouveau fichier publié sur le flux, par exemple la nouvelle version d’une distribution Linux, est ajouté sans intervention. Les étiquettes, appelées labels dans la version anglaise de l’application, servent ensuite à trier les torrents et à leur appliquer une règle de ratio ou de vitesse.
Au-delà de l’interface, le wiki du projet sur GitHub sert de notice d’utilisation : il détaille l’installation, chaque plugin et les réglages de config.php, en anglais. La notice de rTorrent, elle aussi en ligne, décrit les commandes de .rtorrent.rc. Les forums d’Ubuntu et de Debian, ainsi que le guide de chaque hébergeur pour les seedbox gérées, répondent en français aux questions les plus courantes. Avant toute mise à jour, la page des versions du projet indique les changements qui obligent à modifier la configuration.
Comment utiliser les plugins avec ruTorrent ?
Les plugins de ruTorrent s’activent sans installation séparée dans la plupart des cas : ceux qui sont présents dans le dossier plugins/ se chargent au démarrage de l’interface, et la fenêtre Paramètres, onglet Plugins, permet de les activer ou de les désactiver pour l’utilisateur. Un plugin qui ne s’affiche pas indique presque toujours un outil manquant sur le serveur, signalé dans le journal en bas de page : le plugin create, par exemple, peut faire appel à un utilitaire externe déclaré dans son propre fichier conf.php.
Chaque plugin garde sa configuration dans son dossier, ce qui permet d’en retirer un en supprimant ce dossier. Sur une seedbox gérée par un hébergeur, la liste des plugins est souvent fixée par lui ; sur un serveur personnel, mieux vaut n’activer que ceux dont on se sert, chacun ajoutant des requêtes vers rTorrent.
Comment créer un fichier torrent avec ruTorrent ?
La création d’un fichier torrent avec ruTorrent passe par le plugin create, accessible par un bouton qu’il ajoute à la barre d’outils. La fenêtre demande le fichier ou le dossier source, choisi parmi les dossiers du serveur, puis une ou plusieurs adresses de tracker, un commentaire facultatif, la taille des morceaux et, si besoin, l’option qui rend le torrent privé.
Une fois le calcul terminé, ruTorrent propose de télécharger le fichier .torrent produit et, si la case correspondante est cochée, commence aussitôt à partager les données. Ce mode convient à la diffusion de contenus que l’on a le droit de distribuer : une image ISO d’un logiciel libre, un jeu de données ouvert, des photos ou des vidéos personnelles destinées à un groupe. Partager une œuvre protégée sans l’accord de ses ayants droit reste une contrefaçon, et la riposte graduée face aux seedbox en rappelle le cadre.
Comment déplacer les fichiers téléchargés avec ruTorrent ?
Déplacer les fichiers d’un torrent avec ruTorrent se fait par un clic droit sur le torrent, puis la commande de changement de dossier ajoutée par le plugin datadir : on choisit le nouvel emplacement, et la case de déplacement des données transfère les fichiers au lieu de simplement changer le chemin connu de rTorrent. Le torrent continue ensuite d’être partagé depuis ce nouvel emplacement.
Pour automatiser l’opération, le plugin autotools déplace chaque torrent terminé vers un dossier défini, éventuellement selon son étiquette. C’est la méthode employée pour séparer les téléchargements en cours des fichiers prêts à être rapatriés par SFTP, ou rendus visibles à un serveur multimédia comme Plex ou Jellyfin installé sur la même machine pour lire ses propres vidéos.
ruTorrent ou interface web de qBittorrent ?
ruTorrent n’est pas la seule interface web d’une seedbox. Le client libre qBittorrent et son interface web réunissent client et interface dans un seul logiciel, plus simple à installer et à mettre à jour ; ruTorrent, plus ancien, offre davantage de plugins et une gestion fine des groupes de torrents. Transmission et Deluge ont aussi leur interface web, plus dépouillée, et Flood propose une interface moderne capable de piloter rTorrent, qBittorrent ou Transmission.
Le choix entre ces outils tient surtout au nombre de torrents à gérer et au temps qu’on accepte de passer à la configuration : un serveur personnel modeste se contente d’un seul logiciel, une machine chargée de nombreux partages profite de la légèreté de rTorrent. Les autres critères techniques d’un serveur de partage sont réunis dans le guide pour choisir une seedbox selon ses usages.