Anime-Sanctuary

Une seedbox avec rTorrent et ruTorrent

Comment installer une seedbox rTorrent et ruTorrent sur Debian ? Nous montons un programme qui télécharge des fichiers libres en continu, et une page web protégée pour le piloter.

Parcours
Tutoriel 29 sur 35
Durée
45 min de lecture
Vérifié avec
Debian 13.7, rTorrent 0.9.8, ruTorrent 5.3.21, Apache 2.4.69, PHP 8.4
Ce que vous saurez faire
  • Faire tourner rTorrent en service, sous un compte réservé.
  • Brancher ruTorrent dessus par un socket, sans port exposé.
  • Protéger la page par mot de passe et HTTPS.
  • Récupérer ses fichiers par un accès SFTP enfermé dans leur dossier.

Avant de commencer : Premier site avec Apache, Utilisateurs, sudo et droits, Pare-feu avec ufw, Reverse proxy, HTTPS avec Let's Encrypt.

Sommaire
  1. Les pièces du montage
  2. Ce que propose une seedbox du commerce
  3. Un compte dédié et ses dossiers
  4. Installer et régler rTorrent
  5. Lancer rTorrent en service
  6. Installer ruTorrent et le brancher
  7. Mot de passe et HTTPS avec Apache
  8. Un premier fichier libre et les plugins
  9. Récupérer ses fichiers en SFTP
  10. Sauvegarder la session
  11. Si ça échoue
  12. La suite
  13. Sources

Comment installer une seedbox rTorrent et ruTorrent sur Debian ? Une seedbox est un serveur qui télécharge et partage des fichiers en continu, sans que votre ordinateur reste allumé. Ici, elle servira pour des fichiers libres, comme l'image d'installation de Debian, publiée pour être redistribuée. Nous la montons en deux pièces : un programme qui travaille en coulisses, et une page web pour lui donner des ordres. Au bout, vous ouvrez une adresse protégée par mot de passe, vous voyez le téléchargement avancer, et vous récupérez le fichier par un accès limité à son dossier.

Les pièces du montage

Le pair à pair (BitTorrent) est un échange sans serveur central : chaque personne qui télécharge un fichier en renvoie aussitôt des morceaux aux autres. Un petit fichier .torrent décrit ce qu'on veut et comment joindre les autres. Debian en publie un pour chacune de ses images d'installation, et c'est notre fichier d'essai.

Deux programmes se partagent le travail. rTorrent est le client : il parle aux autres machines et écrit les fichiers sur le disque, sans écran. ruTorrent est une page web écrite en PHP : elle affiche la liste des téléchargements et transmet vos ordres à rTorrent.

Reste à les faire se parler. Ils emploient le protocole SCGI, une façon simple de transmettre une requête, et nous le faisons passer par un socket Unix : un fichier spécial qui sert de tuyau entre deux programmes d'une même machine. Un fichier n'a pas de numéro de port, donc rien ne s'ouvre sur Internet.

Le chemin d'un ordre, du navigateur à rTorrent Le navigateur arrive en HTTPS sur Apache, qui héberge ruTorrent. ruTorrent parle à rTorrent par un fichier-socket. rTorrent écrit dans un dossier. Internet joint rTorrent par le port 50000, et bob lit le dossier en SFTP. Navigateur HTTPS, mot de passe Apache + PHP page ruTorrent socket SCGI (fichier) rTorrent compte rtorrent écrit les fichiers /srv/seedbox Internet port 50000 bob SFTP
Texte équivalent : votre navigateur joint Apache en HTTPS avec un mot de passe. Apache sert la page ruTorrent, qui parle à rTorrent par un fichier-socket. rTorrent écrit dans /srv/seedbox. Les autres machines atteignent rTorrent par le port 50000, et le compte bob lit le dossier en SFTP.

Lisez-le de haut en bas : seuls le port 50000 et SSH restent ouverts en plus de la page web, et le socket, tracé d'une autre couleur, ne sort jamais de la machine. Avant de construire, regardons ce que propose une seedbox du commerce, pour savoir ce que nous reproduisons.

Ce que propose une seedbox du commerce

Les seedbox vendues clé en main regroupent des fonctions presque identiques d'une offre à l'autre. Le tableau relie chacune à ce que vous construisez ici, et dit ce qui attend un autre jour.

FonctionComment l'obtenir soi-mêmeDans cet article ?
Interface webruTorrent derrière ApacheOui, étapes 4 et 5
HTTPS et mot de passecertbot et htpasswdOui, étape 5
Accès aux fichiers (FTP, SFTP)SFTP d'OpenSSH, enfermé dans un dossierOui, étape 7
Accès SSHCelui de votre serveur, déjà en placeDéjà acquis
Téléchargement automatique (RSS)Plugin rss de ruTorrentOui, étape 6
Limite de vitesse selon l'heurePlugin schedulerOui, étape 6
Rangement automatiquePlugin autotoolsOui, étape 6
Quota de disqueSeuil d'espace libre de rTorrentOui, étape 2
Sauvegardersync de la sessionOui, étape 8
Lire ses fichiers en streamingUn serveur de médias, comme JellyfinPlus tard
Un dossier et un quota par personneUne instance rTorrent par personne, ou des quotas du système de fichiersPlus tard
NotificationsUn script qui envoie un message à la fin d'un téléchargementPlus tard
VPNWireGuardDéjà vu
API pour d'autres programmesLe point d'accès /RPC2 de ruTorrentPlus tard

Le cœur du montage tient donc en huit étapes. La première donne à rTorrent un compte à lui.

1Un compte dédié et ses dossiers

rTorrent ne doit tourner ni avec votre compte alice, ni avec root : en cas de faille, l'intrus hériterait de tous leurs droits. On lui crée donc un utilisateur système, un compte sans mot de passe ni connexion, réservé à un programme (les comptes et les droits sont dans Utilisateurs, sudo et droits). Il aura trois dossiers : les fichiers terminés, son état (la session) et un dossier surveillé où l'on dépose des .torrent.

Sur le serveur
sudo adduser --system --group --home /var/lib/rtorrent rtorrent

Créons les dossiers avec leurs droits.

Sur le serveur
sudo install -d -o rtorrent -g rtorrent -m 0770 /var/lib/rtorrent/session /var/lib/rtorrent/watch
sudo install -d -o root -g root -m 0755 /srv/seedbox
sudo install -d -o rtorrent -g rtorrent -m 2770 /srv/seedbox/download

Vérifions les droits du dossier des fichiers terminés.

Sur le serveur
ls -ld /srv/seedbox/download
Résultat attendu
drwxrws--- 2 rtorrent rtorrent 4096 Nov  5 07:29 /srv/seedbox/download

La date sera la vôtre. Le s de rws fait garder le groupe rtorrent à tout ce qu'on y crée, et personne d'autre n'y entre. Le dossier /srv/seedbox appartient à root exprès : l'étape 7 en fait une cage, et SSH exige ce propriétaire. Les dossiers sont prêts, reste à dire à rTorrent de s'en servir.

2Installer et régler rTorrent

rTorrent est dans les paquets de Debian, l'installation tient en une commande.

Sur le serveur
sudo apt install -y rtorrent

rTorrent lit ses réglages dans un fichier où chaque ligne est un ordre de la forme nom = valeur. Voici le nôtre, que nous rangeons dans /etc/rtorrent.rc.

Sur le serveur
sudo tee /etc/rtorrent.rc > /dev/null <<'EOF'
# Dossiers : fichiers termines, etat de rTorrent, dossier surveille
directory.default.set = /srv/seedbox/download
session.path.set = /var/lib/rtorrent/session
schedule2 = watch_directory,5,5,"load.start=/var/lib/rtorrent/watch/*.torrent"

# Port d'ecoute pour les autres machines (a ouvrir dans ufw)
network.port_range.set = 50000-50000
network.port_random.set = no
dht.mode.set = disable
protocol.pex.set = no

# Canal SCGI : un fichier-socket, jamais un port reseau
network.scgi.open_local = /run/rtorrent/rpc.sock

# Ferme les telechargements quand il reste moins de 5 Go
schedule2 = low_diskspace,5,60,close_low_diskspace=5G

# Mode service : pas d'ecran, pas de terminal
system.daemon.set = true
EOF

Les lignes qui comptent :

  • directory.default.set et session.path.set : où vont les fichiers terminés et l'état de rTorrent.
  • watch_directory : toutes les 5 secondes, rTorrent démarre tout .torrent déposé dans le dossier surveillé.
  • network.port_range.set : un seul port d'écoute, le 50000, fixe pour pouvoir l'ouvrir dans le pare-feu. Nous coupons aussi DHT et PEX, deux moyens de trouver d'autres machines sans l'annonce du .torrent.
  • network.scgi.open_local : crée le socket. La variante open_port ouvrirait un port réseau, et nous n'en voulons pas.
  • close_low_diskspace : notre quota simple. Sous 5 Go libres, rTorrent ferme les téléchargements au lieu de remplir le disque.

Le fichier est prêt. Il reste à lancer rTorrent d'une façon qui survive à un redémarrage.

3Lancer rTorrent en service

Un service systemd est un programme que le système démarre au boot et relance s'il plante, comme Apache. Son fichier de description dit qui l'exécute et comment. Voici celui de rTorrent.

Sur le serveur
sudo tee /etc/systemd/system/rtorrent.service > /dev/null <<'EOF'
[Unit]
Description=rTorrent
After=network-online.target
Wants=network-online.target

[Service]
User=rtorrent
Group=rtorrent
UMask=0007
RuntimeDirectory=rtorrent
RuntimeDirectoryMode=0750
ExecStart=/usr/bin/rtorrent -n -o import=/etc/rtorrent.rc
Restart=on-failure
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target
EOF
  • User et Group : le programme tourne sous le compte rtorrent.
  • UMask=0007 : tout ce qu'il crée reste fermé aux autres comptes. Le socket sera donc lisible par le groupe rtorrent seulement.
  • RuntimeDirectory : systemd recrée /run/rtorrent, au bon propriétaire, à chaque démarrage.
  • ExecStart : lance rTorrent sans écran, avec notre fichier de réglages.
  • Restart et LimitNOFILE : relance après un plantage, et autorise beaucoup de fichiers ouverts à la fois.

Activons-le : enable le fera démarrer à chaque boot, et --now le lance tout de suite.

Sur le serveur
sudo systemctl daemon-reload
sudo systemctl enable --now rtorrent

Deux contrôles disent si tout est en place : le socket existe, et le port d'écoute aussi.

Sur le serveur
ls -l /run/rtorrent/
ss -ltn 'sport = :50000'
Résultat attendu
total 0
srwxrwx--- 1 rtorrent rtorrent 0 Nov  5 07:29 rpc.sock
State  Recv-Q Send-Q Local Address:Port  Peer Address:Port
LISTEN 0      4096               *:50000            *:*

Le s au début de la première ligne annonce un socket, et la date sera la vôtre. Le port 50000 doit maintenant être ouvert au pare-feu, pour que les autres machines joignent rTorrent (voir Pare-feu avec ufw).

Sur le serveur
sudo ufw allow 50000/tcp
Résultat attendu
Rules updated
Rules updated (v6)

rTorrent travaille. Il manque la page web, et il faut qu'elle ait le droit d'ouvrir le socket.

4Installer ruTorrent et le brancher

ruTorrent n'est pas dans les paquets de Debian 13 : on prend la version publiée par ses auteurs, rangée dans /var/www/rutorrent. Apache la servira, avec PHP et ses extensions. Ces extensions lisent le XML et les noms de fichiers, et font des requêtes web pour les plugins.

Sur le serveur
sudo apt install -y apache2 apache2-utils libapache2-mod-php php-curl php-xml php-mbstring

Téléchargeons ensuite l'archive de la version 5.3.21, puis déballons-la dans son dossier.

Sur le serveur
cd /tmp
curl -fsSLO https://github.com/Novik/ruTorrent/archive/refs/tags/v5.3.21.tar.gz
sudo mkdir /var/www/rutorrent
sudo tar xzf v5.3.21.tar.gz --strip-components=1 -C /var/www/rutorrent
sudo chown -R www-data:www-data /var/www/rutorrent/share

Le compte www-data est celui d'Apache. Il doit pouvoir écrire dans share, où ruTorrent range ses réglages, et nulle part ailleurs. Dites maintenant à ruTorrent où trouver rTorrent. La commande sed remplace des lignes de son fichier de réglages :

  • $scgi_port = 0 : aucun port réseau.
  • $scgi_host : l'adresse du socket.
  • $topDirectory : la limite de ce que ruTorrent peut parcourir, ici /srv/seedbox/.
Sur le serveur
sudo sed -i 's|^\(\s*\)$scgi_port = .*|\1$scgi_port = 0;|; s|^\(\s*\)$scgi_host = .*|\1$scgi_host = "unix:///run/rtorrent/rpc.sock";|; s|^\(\s*\)$topDirectory = .*|\1$topDirectory = "/srv/seedbox/";|' /var/www/rutorrent/conf/config.php
grep -E '^\s*\$(scgi_port|scgi_host|topDirectory)' /var/www/rutorrent/conf/config.php
Résultat attendu
	$topDirectory = "/srv/seedbox/";
	$scgi_port = 0;
	$scgi_host = "unix:///run/rtorrent/rpc.sock";

Reste le droit d'ouvrir le socket, réservé au groupe rtorrent. Ajoutons www-data à ce groupe, puis vérifions avec le compte d'Apache lui-même.

Sur le serveur
sudo usermod -aG rtorrent www-data
sudo -u www-data php -r 'echo is_writable("/run/rtorrent/rpc.sock") ? "oui" : "non", PHP_EOL;'
Résultat attendu
oui

Apache ne lit ses groupes qu'à son démarrage, et nous le redémarrons à l'étape suivante. La page existe, mais personne ne la protège encore, et c'est l'objet de l'étape suivante.

5Mot de passe et HTTPS avec Apache

Sans protection, quiconque trouverait l'adresse piloterait vos téléchargements. Apache demandera donc un mot de passe avant de servir la moindre page : c'est l'authentification Basic. La commande htpasswd tient le fichier des mots de passe, et son option -c le crée. Elle demande le mot de passe deux fois.

Sur le serveur
sudo htpasswd -c /etc/apache2/rutorrent.htpasswd alice
sudo chgrp www-data /etc/apache2/rutorrent.htpasswd
sudo chmod 640 /etc/apache2/rutorrent.htpasswd
Résultat attendu
Adding password for user alice

Écrivons ensuite le site. Contrairement à Reverse proxy, Apache ne transmet rien : il sert la page lui-même, et c'est PHP qui parle à rTorrent. Le nom de domaine rutorrent.exemple.fr doit pointer vers votre serveur (voir Nom de domaine et DNS).

Sur le serveur
sudo tee /etc/apache2/sites-available/rutorrent.exemple.fr.conf > /dev/null <<'EOF'
<VirtualHost *:80>
    ServerName rutorrent.exemple.fr
    DocumentRoot /var/www/rutorrent
    ErrorLog ${APACHE_LOG_DIR}/rutorrent-error.log

    <Directory /var/www/rutorrent>
        Options -Indexes
        AllowOverride None
        AuthType Basic
        AuthName "ruTorrent"
        AuthUserFile /etc/apache2/rutorrent.htpasswd
        Require valid-user
    </Directory>

    # Donnees internes de ruTorrent : jamais servies
    <Directory /var/www/rutorrent/share>
        Require all denied
    </Directory>
</VirtualHost>
EOF
  • AuthType et Require valid-user : toute requête sans mot de passe valide reçoit un refus.
  • Options -Indexes : pas de liste de fichiers si on visite un dossier.
  • Le bloc share : les données internes de ruTorrent ne sont jamais servies, même à vous.

Activons le site, testons la syntaxe, puis redémarrons Apache : il prend ainsi le groupe ajouté plus tôt.

Sur le serveur
sudo a2ensite rutorrent.exemple.fr.conf
sudo apache2ctl configtest
sudo systemctl restart apache2
Résultat attendu
Enabling site rutorrent.exemple.fr.
Syntax OK

La commande a2ensite rappelle aussi de recharger Apache, ce que notre redémarrage fait déjà. Vérifions depuis votre ordinateur que la porte est fermée : sans mot de passe, la réponse doit être un refus.

Sur votre ordinateur
curl -sI http://rutorrent.exemple.fr/ | head -n 1
Résultat attendu
HTTP/1.1 401 Unauthorized

Le mot de passe Basic voyage en clair sur une connexion HTTP. Chiffrons donc la connexion avant de le saisir, avec la commande de HTTPS avec Let's Encrypt.

Sur le serveur
sudo certbot --apache --redirect -d rutorrent.exemple.fr

Reste à constater que la page s'ouvre, cette fois avec le mot de passe. La commande le demande, et la réponse attendue est un succès.

Sur votre ordinateur
curl -sI -u alice https://rutorrent.exemple.fr/ | head -n 1
Résultat attendu
HTTP/1.1 200 OK

Le montage est complet et protégé. Il lui faut maintenant quelque chose à télécharger.

6Un premier fichier libre et les plugins

Notre fichier d'essai est l'image d'installation légère de Debian, d'environ 0,8 Go. Pour le télécharger, déposons son .torrent dans le dossier surveillé, avec le compte rtorrent pour qu'il en reste propriétaire.

Sur le serveur
sudo -u rtorrent curl -fsSL -o /var/lib/rtorrent/watch/debian-netinst.torrent https://cdimage.debian.org/debian-cd/current/amd64/bt-cd/debian-13.7.0-amd64-netinst.iso.torrent

Au bout de quelques secondes, rTorrent a démarré le téléchargement dans le dossier des fichiers terminés.

Sur le serveur
ls -lh /srv/seedbox/download
Résultat attendu
total 757M
-rw-rw---- 1 rtorrent rtorrent 756M Nov  5 07:29 debian-13.7.0-amd64-netinst.iso

Les chiffres dépendent de l'avancement, de la date et de la version. Ouvrez https://rutorrent.exemple.fr/ dans votre navigateur : après le mot de passe, la ligne de cette image apparaît dans la liste, avec sa progression.

ruTorrent embarque des plugins, de petites extensions que la page charge d'elle-même. Quatre répondent à des fonctions du tableau.

  • rss : suit des flux d'annonces et démarre ce qui correspond à vos filtres.
  • scheduler : limite la vitesse selon l'heure, par exemple moins la journée.
  • autotools : range ou étiquette les fichiers terminés, sans que vous y touchiez.
  • diskspace : montre l'espace libre, en complément du garde-fou de l'étape 2.

Vérifions que la page les charge bien.

Sur votre ordinateur
curl -s -u alice https://rutorrent.exemple.fr/php/getplugins.php | grep -o 'plugins/\(rss\|scheduler\|autotools\|diskspace\)/' | sort -u
Résultat attendu
plugins/autotools/
plugins/diskspace/
plugins/rss/
plugins/scheduler/

Le fichier est là, côté serveur. Reste à le rapatrier sur votre ordinateur.

7Récupérer ses fichiers en SFTP

Le SFTP transfère des fichiers dans le tuyau chiffré de SSH, celui de C'est quoi SSH ?. Il n'ajoute ni port ni programme serveur : le port 22 suffit. Nous créons un compte bob et l'enfermons (« chroot ») : son dossier racine devient /srv/seedbox, et il ne voit rien d'autre sur le serveur. Il peut ainsi lire et supprimer les fichiers, sans obtenir de terminal.

Sur le serveur
sudo addgroup --system sftponly
sudo adduser --disabled-password --gecos "" --shell /usr/sbin/nologin bob
sudo usermod -aG sftponly,rtorrent bob

Le groupe sftponly désigne ceux qu'on enferme, et rtorrent donne accès aux fichiers. Une règle SSH enferme le premier groupe.

Sur le serveur
sudo tee /etc/ssh/sshd_config.d/sftp-seedbox.conf > /dev/null <<'EOF'
# Les membres du groupe sftponly ne font que du SFTP, enfermes dans /srv/seedbox
Match Group sftponly
    ChrootDirectory /srv/seedbox
    ForceCommand internal-sftp
    AllowTcpForwarding no
    X11Forwarding no
EOF
sudo sshd -t

Pas de mot de passe pour bob : il se connecte avec une clé, comme dans Sécuriser SSH : couper les mots de passe. Il fabrique sa clé sur son ordinateur et vous envoie la partie publique. Posez-la dans son fichier, puis rechargez SSH.

Sur le serveur
sudo install -d -m 0700 -o bob -g bob /home/bob/.ssh
sudo install -m 0600 -o bob -g bob /dev/null /home/bob/.ssh/authorized_keys
sudo nano /home/bob/.ssh/authorized_keys
sudo systemctl reload ssh

Dans nano, collez la clé publique de bob sur une ligne, puis enregistrez avec Ctrl+O et quittez avec Ctrl+X. Essayons depuis l'ordinateur de bob.

Sur votre ordinateur
printf 'pwd\nls\ncd ..\npwd\nbye\n' | sftp -b - bob@203.0.113.10
Résultat attendu
sftp> pwd
Remote working directory: /
sftp> ls
download
sftp> cd ..
sftp> pwd
Remote working directory: /
sftp> bye

La racine de bob ne contient que download, et cd .. ne mène nulle part : la cage tient. Pour rapatrier le fichier, la commande sftp prend un chemin à la suite de l'adresse.

Sur votre ordinateur
sftp bob@203.0.113.10:/download/debian-13.7.0-amd64-netinst.iso .

Le fichier arrive dans le dossier courant. Tout le reste est refusé : ssh bob@203.0.113.10 répond This service allows sftp connections only. Vous, alice, gardez votre accès complet. Reste à protéger ce qui permet à rTorrent de reprendre son travail : sa session.

8Sauvegarder la session

La session garde les .torrent et l'avancement de chacun. Sans elle, rTorrent oublie ce qu'il partage et doit revérifier chaque fichier, ce qui est long. Arrêtons-le un instant pour que la copie soit cohérente, copions avec rsync (voir Première sauvegarde avec rsync), puis relançons-le.

Sur le serveur
sudo systemctl stop rtorrent
sudo install -d -m 0750 /var/backups/rtorrent-session
sudo rsync -a /var/lib/rtorrent/session/ /var/backups/rtorrent-session/
sudo systemctl start rtorrent

Ajoutez la copie à votre sauvegarde habituelle, hors du serveur. Pour restaurer, arrêtez rTorrent et recopiez le dossier dans l'autre sens. Les fichiers eux-mêmes se sauvegardent avec le même rsync, appliqué à /srv/seedbox/download.

Si ça échoue

Trois situations reviennent le plus souvent.

  • ruTorrent affiche Could not reach rTorrent over XMLRPC. Is rTorrent running? Le service est arrêté, ou Apache n'a pas le droit d'ouvrir le socket. Vérifiez avec ls -l /run/rtorrent/ et id www-data : le groupe rtorrent doit apparaître. Si vous venez de l'ajouter, lancez sudo systemctl restart apache2.
  • rTorrent s'arrête avec Could not open/bind port for listening: Address already in use. Un autre rTorrent tient déjà le port 50000, souvent un lancement à la main resté ouvert. Cherchez-le avec ss -ltnp 'sport = :50000', arrêtez-le, puis relancez le service.
  • Le SFTP coupe : Connection closed. Le journal de SSH dit bad ownership or modes for chroot directory "/srv/seedbox" (voir Lire les journaux). Le dossier de la cage doit appartenir à root et n'être modifiable que par lui : sudo chown root:root /srv/seedbox.

La suite

Votre serveur travaille maintenant seul, la nuit comme le jour, et ne montre au monde que ce que vous avez choisi. Il reste une autre sorte de travail à lui confier : réfléchir. L'article suivant, Assistant IA sur son serveur, installe un assistant qui tourne chez vous.