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

rTorrent démarré avec support XML-RPC.
SCGI configuré dans Apache et montée (/RPC2).
xmlrpc-c installé et accessible au moment du lien.
PHP avec extension XML-RPC activée.
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