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
- Les pièces du montage
- Ce que propose une seedbox du commerce
- Un compte dédié et ses dossiers
- Installer et régler rTorrent
- Lancer rTorrent en service
- Installer ruTorrent et le brancher
- Mot de passe et HTTPS avec Apache
- Un premier fichier libre et les plugins
- Récupérer ses fichiers en SFTP
- Sauvegarder la session
- Si ça échoue
- La suite
- 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.
/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.
| Fonction | Comment l'obtenir soi-même | Dans cet article ? |
|---|---|---|
| Interface web | ruTorrent derrière Apache | Oui, étapes 4 et 5 |
| HTTPS et mot de passe | certbot et htpasswd | Oui, étape 5 |
| Accès aux fichiers (FTP, SFTP) | SFTP d'OpenSSH, enfermé dans un dossier | Oui, étape 7 |
| Accès SSH | Celui de votre serveur, déjà en place | Déjà acquis |
| Téléchargement automatique (RSS) | Plugin rss de ruTorrent | Oui, étape 6 |
| Limite de vitesse selon l'heure | Plugin scheduler | Oui, étape 6 |
| Rangement automatique | Plugin autotools | Oui, étape 6 |
| Quota de disque | Seuil d'espace libre de rTorrent | Oui, étape 2 |
| Sauvegarde | rsync de la session | Oui, étape 8 |
| Lire ses fichiers en streaming | Un serveur de médias, comme Jellyfin | Plus tard |
| Un dossier et un quota par personne | Une instance rTorrent par personne, ou des quotas du système de fichiers | Plus tard |
| Notifications | Un script qui envoie un message à la fin d'un téléchargement | Plus tard |
| VPN | WireGuard | Déjà vu |
| API pour d'autres programmes | Le point d'accès /RPC2 de ruTorrent | Plus 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.
sudo adduser --system --group --home /var/lib/rtorrent rtorrentCréons les dossiers avec leurs droits.
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/downloadVérifions les droits du dossier des fichiers terminés.
ls -ld /srv/seedbox/downloaddrwxrws--- 2 rtorrent rtorrent 4096 Nov 5 07:29 /srv/seedbox/downloadLa 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.
sudo apt install -y rtorrentrTorrent 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.
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
EOFLes lignes qui comptent :
directory.default.setetsession.path.set: où vont les fichiers terminés et l'état de rTorrent.watch_directory: toutes les 5 secondes, rTorrent démarre tout.torrentdé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 varianteopen_portouvrirait 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.
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
EOFUseretGroup: le programme tourne sous le comptertorrent.UMask=0007: tout ce qu'il crée reste fermé aux autres comptes. Le socket sera donc lisible par le groupertorrentseulement.RuntimeDirectory: systemd recrée/run/rtorrent, au bon propriétaire, à chaque démarrage.ExecStart: lance rTorrent sans écran, avec notre fichier de réglages.RestartetLimitNOFILE: 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.
sudo systemctl daemon-reload
sudo systemctl enable --now rtorrentDeux contrôles disent si tout est en place : le socket existe, et le port d'écoute aussi.
ls -l /run/rtorrent/
ss -ltn 'sport = :50000'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).
sudo ufw allow 50000/tcpRules 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.
sudo apt install -y apache2 apache2-utils libapache2-mod-php php-curl php-xml php-mbstringTéléchargeons ensuite l'archive de la version 5.3.21, puis déballons-la dans son dossier.
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/shareLe 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/.
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 $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.
sudo usermod -aG rtorrent www-data
sudo -u www-data php -r 'echo is_writable("/run/rtorrent/rpc.sock") ? "oui" : "non", PHP_EOL;'ouiApache 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.
sudo htpasswd -c /etc/apache2/rutorrent.htpasswd alice
sudo chgrp www-data /etc/apache2/rutorrent.htpasswd
sudo chmod 640 /etc/apache2/rutorrent.htpasswdAdding 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).
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>
EOFAuthTypeetRequire 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.
sudo a2ensite rutorrent.exemple.fr.conf
sudo apache2ctl configtest
sudo systemctl restart apache2Enabling site rutorrent.exemple.fr.
Syntax OKLa 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.
curl -sI http://rutorrent.exemple.fr/ | head -n 1HTTP/1.1 401 UnauthorizedLe 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.
sudo certbot --apache --redirect -d rutorrent.exemple.frReste à 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.
curl -sI -u alice https://rutorrent.exemple.fr/ | head -n 1HTTP/1.1 200 OKLe 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.
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.torrentAu bout de quelques secondes, rTorrent a démarré le téléchargement dans le dossier des fichiers terminés.
ls -lh /srv/seedbox/downloadtotal 757M
-rw-rw---- 1 rtorrent rtorrent 756M Nov 5 07:29 debian-13.7.0-amd64-netinst.isoLes 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.
curl -s -u alice https://rutorrent.exemple.fr/php/getplugins.php | grep -o 'plugins/\(rss\|scheduler\|autotools\|diskspace\)/' | sort -uplugins/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.
sudo addgroup --system sftponly
sudo adduser --disabled-password --gecos "" --shell /usr/sbin/nologin bob
sudo usermod -aG sftponly,rtorrent bobLe groupe sftponly désigne ceux qu'on enferme, et rtorrent donne accès aux fichiers. Une règle SSH enferme le premier groupe.
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 -tPas 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.
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 sshDans 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.
printf 'pwd\nls\ncd ..\npwd\nbye\n' | sftp -b - bob@203.0.113.10sftp> pwd
Remote working directory: /
sftp> ls
download
sftp> cd ..
sftp> pwd
Remote working directory: /
sftp> byeLa 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.
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.
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 rtorrentAjoutez 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 avecls -l /run/rtorrent/etid www-data: le groupertorrentdoit apparaître. Si vous venez de l'ajouter, lancezsudo 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 avecss -ltnp 'sport = :50000', arrêtez-le, puis relancez le service. - Le SFTP coupe :
Connection closed. Le journal de SSH ditbad ownership or modes for chroot directory "/srv/seedbox"(voir Lire les journaux). Le dossier de la cage doit appartenir àrootet 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.