Ce guide a été testé avec les distributions suivantes :

• Debian 5.0 Lenny
• Debian 6.0 Squeeze

Pré-requis

Ce guide nécessite un serveur LigHTTPd avec support du PHP disposant du script suivant :

• Le script lighty-tools disponible dans mon guide Installer Lighttpd et PHP 5 sur Debian.

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.

Paramètres

Renseignez le nom de domaine ou sera disponible l'application :

DOMAIN="bt.domaine-exemple.fr"

Installation

Installation de libTorrent

Récupérez l'URL de téléchargement de la version stable de la bibliothèque, et obtenez le numéro de version à partir de cette URL :

SOURCE_URL="$(command wget --quiet --output-document=- 'http://libtorrent.rakshasa.no/' \
    | command grep --max-count=1 'libtorrent-.*.tar.gz' \
    | command sed -e 's/^.*href="\([^"]*\)".*$/\1/')"
VERSION="$(echo "${SOURCE_URL}" \
    | command sed -e 's/.*libtorrent-\(.*\)\.tar\.gz/\1/')"

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

command apt-get install build-essential libssl-dev libsigc++-2.0-dev autogen automake libtool

Téléchargez l'archive contenant les sources:

command wget "${SOURCE_URL}" \
    --output-document="/tmp/libtorrent-${VERSION}.tar.gz"

Décompressez l'archive ainsi obtenue:

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

Placez-vous dans le dossier ainsi créé:

command pushd "/tmp/libtorrent-${VERSION}"

Compilez la bibliothèque :

./autogen.sh
./configure
command make

Installez la bibliothèque :

command make install

Vous pouvez maintenant supprimer les fichiers téléchargés :

command popd
command rm -r "/tmp/libtorrent-${VERSION}"
command rm "/tmp/libtorrent-${VERSION}.tar.gz"

Installation de rTorrent

Récupérez l'URL de téléchargement de la version stable de la bibliothèque, et obtenez le numéro de version à partir de cette URL :

SOURCE_URL="$(command wget --quiet --output-document=- 'http://libtorrent.rakshasa.no/' \
    | command grep --max-count=1 'rtorrent-.*.tar.gz' \
    | command sed -e 's/^.*href="\([^"]*\)".*$/\1/')"
VERSION="$(echo "${SOURCE_URL}" \
    | command sed -e 's/.*rtorrent-\(.*\)\.tar\.gz/\1/')"

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

command apt-get install build-essential libxmlrpc-c3-dev \
                         libcurl4-openssl-dev libncurses5-dev

Téléchargez les sources du logiciel :

command wget "${SOURCE_URL}" \
    --output-document="/tmp/rtorrent-${VERSION}.tar.gz"

Décompressez l'archive ainsi obtenue:

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

Placez-vous dans le dossier ainsi créé:

command pushd "/tmp/rtorrent-${VERSION}"

Lancez la compilation:

./autogen.sh
./configure --with-xmlrpc-c
command make

Installez l'application :

command make install

Vous pouvez maintenant supprimer les fichiers téléchargés :

command popd
command rm -r "/tmp/rtorrent-${VERSION}"
command rm "/tmp/rtorrent-${VERSION}.tar.gz"

Installation de wTorrent

Installez les paquets nécessaires au bon fonctionnement de wTorrent

command apt-get install php5-sqlite unzip

Redémarrez le serveur HTTP pour prendre en compte ces nouveaux modules:

/etc/init.d/lighttpd force-reload

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

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

Décompressez l'archive ainsi obtenue:

command unzip -d "/tmp/" "/tmp/wtorrent.zip"

Déplacez les sources de wTorrent à l'emplacement adéquat:

command mv "/tmp/trunk/wtorrent" "/opt/${DOMAIN}"

Corrigez les permissions des fichiers:

command find "/opt/${DOMAIN}" -type f | command xargs chmod 644

Créez les dossiers destinés à contenir les fichiers créés par l'application:

command mkdir --parent "/var/lib/wtorrent/${DOMAIN}/data"
command mkdir --parent "/var/lib/wtorrent/${DOMAIN}/db"
command mv "/opt/${DOMAIN}/tpl_c" "/var/lib/wtorrent/${DOMAIN}/tpl_c"
command mv "/opt/${DOMAIN}/torrents" "/var/lib/wtorrent/${DOMAIN}/torrents"
command chown -R www-data:www-data "/var/lib/wtorrent/${DOMAIN}"

Créez les liens symboliques associés à ces dossiers:

command ln -s "/var/lib/wtorrent/${DOMAIN}/tpl_c" "/opt/${DOMAIN}/tpl_c"
command ln -s "/var/lib/wtorrent/${DOMAIN}/torrents" "/opt/${DOMAIN}/torrents"

Autorisez le serveur HTTP à ajouter des fichiers dans le dossier de configuration :

command chown www-data:www-data "/opt/${DOMAIN}/conf/"

Nous configurons wTorrent:

command sed -i -e "/\$defaults/,/\$user_options/s|^\(.*db_file.*=>\).*$|\1 '../../var/lib/wtorrent/${DOMAIN}/db/database.db',|" \
            -e "/\$defaults/,/\$user_options/s|^\(.*dir_torrents.*=>\).*$|\1 'torrents/',|" \
            -e "/\$defaults/,/\$user_options/s|^\(.*dir_exec.*=>\).*$|\1 '/opt/${DOMAIN}/',|" \
            -e "/\$defaults/,/\$user_options/s|^\(.*dir_download.*=>\).*$|\1 '/var/lib/wtorrent/${DOMAIN}/data/',|" \
    "/opt/${DOMAIN}/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.

command apt-get install dtach

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

command mkdir --parent /var/lib/rtorrent/sessions
command mkdir --parent /var/lib/rtorrent/torrents/doing
command mkdir --parent /var/lib/rtorrent/torrents/watch
command mkdir --parent /var/lib/rtorrent/torrents/done
command chown -R www-data:www-data /var/lib/rtorrent

Mettez en place le fichier de configuration de rTorrent:

command 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'

Mettez en place le script init.d:

command 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'
command chmod +x '/etc/init.d/rtorrent'

Initialisez le fichier journal du démon :

command touch "/var/log/rtorrent.log"
command chown www-data:adm "/var/log/rtorrent.log"

Démarrez le démon:

/etc/init.d/rtorrent start

Activez le démarrage automatique du démon :

command 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 :

command rm '/var/lib/rtorrent/sessions/rtorrent.lock'

Configuration du serveur SCGI

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

command apt-get install apache2-utils apg

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

SCGI_LOGIN="$(command apg -q -a  0 -n 1 -M NCL)"
SCGI_PASSWORD="$(command apg -q -a  0 -n 1 -M NCL)"

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

command htpasswd -cb "/etc/lighttpd/rtorrent.pwd" "${SCGI_LOGIN}" "${SCGI_PASSWORD}"

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

command 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/${DOMAIN}/cls/install.cls.php"

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

command 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"
    )
  )
' > '/etc/lighttpd/conf-available/10-rtorrent.conf'

Activez la configuration ainsi créée:

command lighty-enable-mod rtorrent

Rechargez la configuration du serveur Lighttpd:

/etc/init.d/lighttpd force-reload

Configuration de wTorrent

Créez un fichier de configuration utilisateur par défaut, et rendez-le modifiable par wtorrent :

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

Créez l'hôte virtuel pour wTorrent :

command lighty-tools add-virtual-host "${DOMAIN}" "/opt/${DOMAIN}/"

Enfin, AVANT TOUTE AUTRE CHOSE, accédez au script d'installation de wTorrent pour créer votre compte administrateur. Pour ce faire, utilisez l'URL obtenue par la commande :

command echo "http://${DOMAIN}/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:

command 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:

command rm "/opt/${DOMAIN}/install.php"
command chown -R root:root "/opt/${DOMAIN}/conf/"

Votre installation de wTorrent est maintenant accessible depuis l'URL fournie par la commande :

command echo "http://${DOMAIN}"

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.