Configurer rtGui pour rTorrent

Avant de commencer

Définitions rapides:

• rTorrent: client BitTorrent en ligne de commande.
• rtGui: interface web graphique pour contrôler rTorrent via XML-RPC.
• XML-RPC / SCGI: protocoles permettant la communication entre serveur web et rTorrent.

Important: suivez les étapes en tant que superutilisateur quand la commande le demande (sudo ou root).

Exigences

• rTorrent 0.8.0 / libtorrent 0.12.0 compilés avec le support de la bibliothèque XML-RPC — voir http://libtorrent.rakshasa.no/
• Bibliothèque XML-RPC — voir http://xmlrpc-c.sourceforge.net/
• Serveur Apache configuré pour SCGI/XML-RPC — voir http://libtorrent.rakshasa.no/wiki/RTorrentXMLRPCGuide
• PHP 5 avec le module XML-RPC — voir http://www.php.net/
• Un navigateur web récent — par exemple http://www.mozilla.com/

Notes:

• Pour les systèmes 64 bits, privilégiez xmlrpc-c 1.07+ pour un meilleur support des entiers 64 bits.

Installation

I. Installation des composants de base

1. Télécharger et installer rTorrent et libtorrent

Référez-vous à la documentation d’installation: http://libtorrent.rakshasa.no/wiki/Install

Exemples de commande de compilation:

./configure
make
make install (as superuser)

2. Télécharger XML-RPC et installer

Page de téléchargement: http://xmlrpc-c.sourceforge.net/downloading.php

Exemple:

tar xvzf xmlrpc-XXXXXXXXX.tgz
./configure

Si ./configure échoue, essayez:

./configure --disable-cplusplus
make
make install (as superuser)

3. Installer Apache et PHP (avec modules requis)

Sites: http://www.php.net/ http://www.apache.org/

Assurez-vous que le module SCGI (ou équivalent) et le module XML-RPC pour PHP sont activés.

II. Configurer XML-RPC / SCGI avec rTorrent et installer rtGui

1. Utiliser XML-RPC avec rTorrent

Ce dont vous avez besoin:

• SCGI pour Apache — http://python.ca/scgi/
• xmlrpc-c 1.00 ou ultérieure (1.07+ recommandé pour 64 bits)
• rtorrent 0.7.5 ou ultérieur

Configurez rTorrent avec l’option –with-xmlrpc-c et ajoutez ceci dans httpd.conf ou apache2.conf:

SCGIMount /RPC2 127.0.0.1:5000
rtorrent.rc: scgi_port = localhost:5000

Notes: adaptez les ports/host si vous utilisez une configuration non locale. Vérifiez que le pare-feu autorise la boucle locale si nécessaire.

2. Installer rtGui

• Aller dans le répertoire racine du serveur web, par exemple:

cd /var/www/htdocs

• Extraire l’archive téléchargée:

tar xvzf rtgui-0.1.tgz

• Modifier la configuration si besoin:

vi rtgui/config.php

• Pointer votre navigateur sur le répertoire, par exemple: http://localhost/rtgui

Checklist rapide avant de tester

1. rTorrent démarré avec support XML-RPC.
2. SCGI configuré dans Apache et montée (/RPC2).
3. xmlrpc-c installé et accessible au moment du lien.
4. PHP avec extension XML-RPC activée.
5. Permissions des fichiers web correctes pour rtgui.

Dépannage courant

• Erreur de connexion au RPC: vérifiez que rTorrent écoute bien sur localhost:5000 et que SCGIMount correspond.
• Erreur PHP/XML-RPC: confirmez que l’extension xmlrpc de PHP est activée (phpinfo()).
• Problèmes d’autorisation: assurez-vous que l’utilisateur Apache peut lire rtgui et que rTorrent est lancé par l’utilisateur attendu.

Conseil: consultez les logs Apache (error.log) et les logs d’rTorrent pour plus d’informations.

Alternatives à rtGui

Si rtGui ne convient pas, considérez:

• nTorrent
• wTorrent
• n2hell
• rTWi
• rtorstat

Chaque interface a ses propres dépendances; installez d’abord les composants de base (chapitre I) puis l’interface choisie.

Bonnes pratiques de sécurité

• Restreignez l’accès HTTP à rtGui via authentification ou IP filtering si vous exposez la console au réseau.
• Ne laissez pas l’interface de contrôle accessible publiquement sans TLS et authentification forte.
• Exécutez rTorrent sous un utilisateur non privilégié.

Critères d’acceptation (test rapide)

• L’interface rtGui s’affiche dans le navigateur.
• Les torrents ajoutés via rtGui apparaissent dans rTorrent.
• Les actions (pause, reprendre, supprimer) via rtGui sont reflétées dans rTorrent.

Quand cela peut échouer

• Configurations Apache non compatibles avec SCGI.
• mauvaise version de xmlrpc-c sur systèmes 64 bits.
• conflits de ports ou d’utilisateurs entre Apache et rTorrent.

Petit guide de vérification (commandes utiles)

• Vérifier que rTorrent écoute le port SCGI:

netstat -plnt | grep 5000

• Tester l’accès local à l’URL RPC via curl (contrôle basique):

curl http://127.0.0.1/RPC2

Résumé

Ce guide montre comment installer rtGui pour rTorrent en configurant xmlrpc-c et SCGI, en installant Apache et PHP, puis en déployant rtGui dans le répertoire web. Vérifiez les logs et la configuration SCGI si vous rencontrez des erreurs.

Notes finales: Bon téléchargement !

Source et remerciements: http://petik.uw.hu

PeTIK Team