Installation

En premier lieu, installez un serveur Lighttpd avec le support du PHP. Pour ce faire, vous pouvez suivre mon guide Installer Lighttpd et PHP 5 sur Debian 4.0 Etch et 5.0 Lenny.

Attention: Ce guide est prévu pour fonctionner sur un serveur Lighttpd. Si vous utilisez Apache, il ne fonctionnera pas. Cela est du à la nécessité d'utiliser les capacités SCGI de Lighttpd.

libTorrent

En premier lieu, renseignez la version de libTorrent que vous souhaitez installer:

VERSION=0.12.6

Téléchargez les dépendances de compilation:

/usr/bin/apt-get install build-essential libssl-dev libsigc++-2.0-dev

Nous téléchargeons l'archive contenant les sources:

/usr/bin/wget http://libtorrent.rakshasa.no/downloads/libtorrent-${VERSION}.tar.gz \
    --output-document=/tmp/libtorrent-${VERSION}.tar.gz

Nous décompressons l'archive ainsi obtenue:

/bin/tar --directory /tmp -xzf /tmp/libtorrent-${VERSION}.tar.gz

Nous nous plaçons dans le dossier ainsi créé:

cd /tmp/libtorrent-${VERSION}

Et nous lançons la compilation:

./configure
/usr/bin/make

Enfin, nous intallons libTorrent:

/usr/bin/make install

rTorrent

En premier lieu, renseignez la version de rTorrent que vous souhaitez installer:

VERSION=0.8.6

Téléchargez les dépendances de compilation:

/usr/bin/apt-get install build-essential libxmlrpc-c3-dev \
                         libcurl4-openssl-dev libncurses5-dev

Nous téléchargeons l'archive contenant les sources:

/usr/bin/wget http://libtorrent.rakshasa.no/downloads/rtorrent-${VERSION}.tar.gz \
    --output-document=/tmp/rtorrent-${VERSION}.tar.gz

Nous décompressons l'archive ainsi obtenue:

/bin/tar --directory /tmp -xzf /tmp/rtorrent-${VERSION}.tar.gz

Nous nous plaçons dans le dossier ainsi créé:

cd /tmp/rtorrent-${VERSION}

Et nous lançons la compilation:

./configure --with-xmlrpc-c
/usr/bin/make

Enfin, nous intallons rTorrent:

/usr/bin/make install

wTorrent

Nous installons les paquets nécessaires au bon fonctionnement de wTorrent

/usr/bin/apt-get install php5-sqlite unzip

Et nous redémarrons le serveur HTTP pour prendre en compte ces nouveaux modules:

/etc/init.d/lighttpd force-reload

Nous téléchargeons l'archive contenant les sources disponible actuellement dans le SVN de wTorrent (il n'y a pas actuellement de version stable de wTorrent):

/usr/bin/wget "http://www.wtorrent-project.org/trac/changeset/latest/trunk/?old_path=%2F&format=zip" \
    --output-document=/tmp/wtorrent.zip

Nous décompressons l'archive ainsi obtenue:

/usr/bin/unzip -d /tmp/ /tmp/wtorrent.zip

Nous déplaçons les sources de wTorrent à l'emplacement adéquat:

/bin/mv /tmp/trunk/wtorrent /opt/wtorrent

Nous corrigeons les permissions des fichiers:

/usr/bin/find /opt/wtorrent -type f | /usr/bin/xargs /bin/chmod 644

Nous créons les dossiers destinés à contenir les fichiers créés par l'application:

/bin/mkdir --parent /var/lib/wtorrent/data
/bin/mkdir --parent /var/lib/wtorrent/db
/bin/mkdir --parent /var/lib/wtorrent/tpl_c
/bin/mv /opt/wtorrent/torrents /var/lib/wtorrent/torrents
/bin/chown -R www-data:www-data /var/lib/wtorrent
/bin/chown -R rtorrent:www-data /var/lib/wtorrent/data

Nous créons les liens symboliques associés à ces dossiers:

/bin/ln -s /var/lib/wtorrent/tpl_c /opt/wtorrent/tpl_c
/bin/ln -s /var/lib/wtorrent/torrents /opt/wtorrent/torrents

Nous faisons en sorte que wTorrent puisse ajouter des fichiers dans le dossier de configuration :

/bin/chown www-data:www-data /opt/wtorrent/conf/

Nous configurons wTorrent:

/bin/sed -i -e "/\$defaults/,/\$user_options/s|^\(.*db_file.*=>\).*$|\1 '../../var/lib/wtorrent/db/database.db',|" \
            -e "/\$defaults/,/\$user_options/s|^\(.*dir_torrents.*=>\).*$|\1 'torrents/',|" \
            -e "/\$defaults/,/\$user_options/s|^\(.*dir_exec.*=>\).*$|\1 '/opt/wtorrent/',|" \
            -e "/\$defaults/,/\$user_options/s|^\(.*dir_download.*=>\).*$|\1 '/var/lib/wtorrent/data/',|" \
    /opt/wtorrent/cls/install.cls.php

Mise en place du démon rTorrent

Nous installons les paquets nécessaires au fonctionnement de rTorrent en mode démon.

/usr/bin/apt-get install screen

Nous créons un utilisateur dédié à l'exécution de rTorrent en tâche de fond:

/usr/sbin/adduser --system --shell /bin/sh --home /var/lib/rtorrent rtorrent

Nous créons les dossiers qui seront utilisés par rTorrent:

/bin/mkdir --parent /var/lib/rtorrent/sessions
/bin/mkdir --parent /var/lib/rtorrent/torrents/doing
/bin/mkdir --parent /var/lib/rtorrent/torrents/watch
/bin/mkdir --parent /var/lib/rtorrent/torrents/done
/bin/chown -R rtorrent:nogroup /var/lib/rtorrent

Nous mettons en place le fichier de configuration de rTorrent:

/usr/bin/wget http://howto.landure.fr/gnu-linux/debian-4-0-etch/installer-wtorrent-sur-debian-5-0-lenny/rtorrent.rc \
    --output-document=/etc/rtorrent.rc

Et nous créons un lien symbolique vers ce fichier dans le répertoire de l'utilisateur système rtorrent:

/bin/ln -s /etc/rtorrent.rc /var/lib/rtorrent/.rtorrent.rc

De même, nous mettons en place le script init.d:

/usr/bin/wget http://howto.landure.fr/gnu-linux/debian-4-0-etch/installer-wtorrent-sur-debian-5-0-lenny/rtorrent \
    --output-document=/etc/init.d/rtorrent
/bin/chmod +x /etc/init.d/rtorrent

Et nous démarrons le démon:

/etc/init.d/rtorrent start

Nous faisons en sorte que le démon démarre automatiquement:

/usr/sbin/update-rc.d rtorrent defaults

Remarque : Si à la suite d'un plantage de votre serveur, ou d'un kill de rtorrent, rtorrent ne se lance plus, essayez d'effacer le fichier verrou :

/bin/rm /var/lib/rtorrent/sessions/rtorrent.lock

Configuration du serveur SCGI

Nous installons les utilitaires permettant de sécuriser un minimum notre serveur SCGI:

/usr/bin/apt-get install apache2-utils apg

Nous créons aléatoirement un identifiant et un mot de passer pour notre serveur SCGI:

SCGI_LOGIN=$(/usr/bin/apg -q -a  0 -n 1 -M NCL)
SCGI_PASSWORD=$(/usr/bin/apg -q -a  0 -n 1 -M NCL)

Et utilisons htpasswd pour les stocker dans un fichier utilisable par Lighttpd:

/usr/bin/htpasswd -cb /etc/lighttpd/rtorrent.pwd ${SCGI_LOGIN} ${SCGI_PASSWORD}

Nous configurons wTorrent pour utiliser ces paramètres d'autentification:

/bin/sed -i -e "/\$defaults/,/\$user_options/s|^\(.*rt_user.*=>\).*$|\1 '${SCGI_LOGIN}',|" \
            -e "/\$defaults/,/\$user_options/s|^\(.*rt_passwd.*=>\).*$|\1 '${SCGI_PASSWORD}',|" \
            -e "/\$defaults/,/\$user_options/s|^\(.*rt_auth.*=>\).*$|\1 true,|" \
    /opt/wtorrent/cls/install.cls.php

Nous configureons Lighttpd pour faire office de serveur SCGI pour rTorrent. Pour ce faire, créez la configuration nécessaire à l'aide de la commande suivante:

/bin/echo '# rTorrent SCGI configuration.

server.modules   += ( "mod_scgi", "mod_auth" )

scgi.server = (
  "/RPC2" => # RT_DIR
    ( "127.0.0.1" =>
      (
        "host" => "127.0.0.1", # Ip where rtorrent is listening
        "port" => 5000, # Port specified in .rtorrent.rc
        "check-local" => "disable"
      )
    )
  )

auth.backend = "htpasswd"
auth.backend.htpasswd.userfile = "/etc/lighttpd/rtorrent.pwd"
auth.require = (
  "/RPC2" =>
    (
      "method" => "basic",
      "realm" => "XML-RPC",
      "require" => "valid-user"
    )
  )
' | /usr/bin/tee /etc/lighttpd/conf-available/10-rtorrent.conf

Activez la configuration ainsi créée:

/usr/sbin/lighty-enable-mod rtorrent

Et nous rechargeons la configuration du serveur Lighttpd:

/etc/init.d/lighttpd force-reload

Configuration de wTorrent

Nous créons un fichier de configuration utilisateur par défaut, et nous le rendons inscriptible par wtorrent :

/bin/cp /opt/wtorrent/conf/sample.user.conf.php /opt/wtorrent/conf/user.conf.php
/bin/chown www-data:www-data /opt/wtorrent/conf/user.conf.php

Nous rendons wTorrent accessible depuis l'internet:

/bin/ln -s /opt/wtorrent /var/www/wtorrent

Enfin, AVANT TOUTE AUTRE CHOSE, accédez au script d'installation de wTorrent pour créer votre compte administrateur:

http://localhost/wtorrent/install.php

Remarque: Si cette page vous informe que la base de données est déjà créée, exécutez la commande suivante puis rechargez la:

/bin/rm /var/lib/wtorrent/db/database.db

Remarque bis : Le test de configuration ne fonctionne pas (il signale que la création de la base de données est impossible). Ignorez-le et enregistrez votre configuration.

Une fois votre configuration terminée, effacez le fichier d'installation et protégez la configuration:

/bin/rm /opt/wtorrent/install.php
/bin/chown root:root /opt/wtorrent/conf/user.conf.php

Votre installation de wTorrent est maintenant accessible depuis l'url:

http://localhost/wtorrent/

Remerciements

• Merci aux développeurs de libTorrent et rTorrent.
• Merci aux développeurs de wTorrent.
• Merci à Robert Penz pour son guide Howto install rtorrent and wtorrent within an Ubuntu Hardy VE.
• Merci à FlipsideReality pour son guide rtorrent with wtorrent on debian etch complete HOWTO.