Pré-requis

Serveur HTTP

En premier lieu, vous devez installer un serveur HTTP 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.

Base de données MySQL

Vous devez ensuite créer une base de donnée TORRENTFLUXB4RT pour votre installation. Pour ce faire, vous pouvez suivre mon guide MySQL sur Debian 4.0 Etch et 5.0 Lenny.

Logiciels supplémentaires

Vous devez ensuite installer les extensions PHP et autres logiciels nécessaires:

/usr/bin/apt-get install bzip2 php5-mysql php5-gd php5-cli unrar grep python \
    net-tools mawk wget unzip vlc-nox uudeview apg python-crypto \
    libxml-simple-perl libxml-dom-perl libdbd-mysql-perl libdigest-sha1-perl \
    bittorrent bittornado sudo

Nous installons maintenant les paquets qui ne sont présents que sur Debian 4.0 Etch :

if [ "$(/bin/cat /etc/debian_version)" = "4.0" ]; then
  /usr/bin/apt-get install cksfv python-psyco
fi

La commande cksfv étant nécessaire au bon fonctionnement de Torrenflux-B4rt, il est nécessaire de le récupérer directement dans les dépôts de Debian 4.0 Etch

if [ "$(/bin/cat /etc/debian_version)" = "5.0" ]; then
  /bin/echo "deb ftp://ftp.debian.org/debian/ etch main" \
      | /usr/bin/tee /etc/apt/sources.list.d/etch-main.list
  /usr/bin/apt-get update
  /usr/bin/apt-get install -y cksfv
  /bin/rm /etc/apt/sources.list.d/etch-main.list
  /usr/bin/apt-get update
fi

N'oubliez pas de redémarrer votre serveur HTTP pour prendre en compte les nouveaux modules PHP. Par exemple, si vous utilisez Lighttpd, exécutez:

/etc/init.d/lighttpd force-reload

Installation

En premier lieu, sélectionnez la version de Torrentflux-b4rt a installer. Nous choisissons pour l'instant une version Bêta (qui n'est Bêta que parceque l'interface Html n'est pas encore parfaite :D) :

VERSION=1.0-beta2

Et nous téléchargeons les sources:

/usr/bin/wget http://download.berlios.de/tf-b4rt/torrentflux-b4rt_$VERSION.tar.bz2  \
    --output-document=/tmp/torrentflux-b4rt_$VERSION.tar.bz2

Ensuite, nous décompressons l'archive:

/bin/tar --directory /tmp -xjf /tmp/torrentflux-b4rt_$VERSION.tar.bz2

Et nous déplaçons le dossier ainsi créé vers son emplacement définitif:

/bin/mv /tmp/torrentflux-b4rt_$VERSION /opt/torrentflux

Nous créons un lien symbolique de la partie Web de Torrentflux vers un emplacement accessible à l'aide du serveur HTTP :

/bin/ln -s /opt/torrentflux/html /var/www/torrentflux

Et nous rendons inscriptible par le serveur le dossier de configuration:

/bin/chown -R www-data:www-data /opt/torrentflux/html/inc/config/

Créez maintenant le dossier destiné à recevoir vos téléchargements de Torrentflux:

/bin/mkdir --parent /var/lib/torrentflux

Et rendez-le inscriptible par le serveur HTTP :

/bin/chown -R www-data:www-data /var/lib/torrentflux

Afin de pouvoir détecter les ports utilisés, TorrentFlux-B4rt utilise la commande netstat. Pour que cette commande fonctionne correctement, elle doit être lancée avec le compte root. Pour permettre cela, nous allons configurer sudo pour que www-data puisse lancer cette commande sans avoir à saisir un mot de passe :

/bin/sed -i -e '/Cmnd alias/a\
Cmnd_Alias TFB4RT_NETSTAT = /bin/netstat' \
       -e '/User privilege/a\
www-data ALL = NOPASSWD: TFB4RT_NETSTAT' \
    /etc/sudoers

Nous créons maintenant le script shell qui permet à TorrentFlux-B4rt d'utiliser cette configuration :

/bin/mkdir /opt/torrentflux/bin
/bin/echo '#!/bin/bash
# Call netstat using sudo.
/usr/bin/sudo /bin/netstat $@' | /usr/bin/tee /opt/torrentflux/bin/netstat
/bin/chmod +x /opt/torrentflux/bin/netstat

Vous pouvez maintenant vous lancer dans la configuration de Torrentflux en visitant l'URL:

• http://localhost/torrentflux/setup.php

Suivez alors les différentes étapes de configuration :

1. Base de données : Désactivez la création de la base de données (en décochant la case "Create Database").
2. Configuration du serveur : Entrez /var/lib/torrentflux comme emplacement du User Download Path
3. Vérification des dépendances logicielles : Normalement, tout devrait bien se passer.
   
4. Suppression du fichier setup.php : Attention, cette étape déclanche une erreur. C'est tout à fait normal, ne vous en inquiétez pas.
   

Une fois arrivé à l'étape de la suppression du fichier setup.php, votre configuration est terminée, revenez à la ligne de commande, et supprimez le fichier setup.php:

/bin/rm /opt/torrentflux/html/setup.php

Et rendez non modifiable par le serveur la configuration de Torrentflux:

/bin/chown -R root:root /opt/torrentflux/html/inc/config/

Une fois ceci fait, préparez-vous un couple identifiant / mot de passe pour votre compte administrateur. Cela peut être fait par la commande:

TORRENTFLUX_PWD=`apg -q -a  0 -n 1 -M NCL`
echo "Votre mot de passe pour le compte 'admin' est '$TORRENTFLUX_PWD'."

Notez bien ce mot de passe, et allez à la page d'identification de Torrentflux. Le premier couple identifiant / mot de passe saisi devient votre identifiant d'administration. Vous pouvez saisir vos identifiants habituels, ou ceux proposés par la commande ci-dessus :

• http://localhost/torrentflux/

Configuration

Une fois votre identifiant saisi, vous vous voyez présenter une page de configuration.

Server

• netstat : /opt/torrentflux/bin/netstat : Cela permet à Torrentflux-B4rt d'obtenir des informations complètes à l'aide de netstat.

Transfer

Dans cette page, vous paramètrez les transferts de fichiers. Personnellement, j'utilise les réglages suivants:

• Default BitTorrent Client : BitTornado : Ce client supporte l'encryption.
• Torrent Metainfo Client : btshowmetainfo.py
• Port Range (B+T+M) : Réglez ici les ports de connection à BitTorrent. N'oubliez pas de les ouvrir dans votre configuration de pare-feu ou routeur.
• Default Percentage When Seeding Should Stop (B+T+M+A) : 150 % : Soyez gentil, ne mettez pas une valeur sous les 100 %.
• Wget : Enable Passive FTP : True : Obligatoire si vous utilisez un pare-feu ou un routeur.
  
• Enable Nzbperl : All users : Autorisez tous les utilisateurs a effectuer des téléchargements depuis Usenet.
  
• Use Subdirectories : Use Usenet group name.
  

Webapp

Dans cette page, vous paramètrez l'interface. Je modifie les valeurs suivantes:

• Select Authentication Type: Form-Auth + Cookie : C'est une valeur qui simplifie la vie :D.
  
• Default language: French
• Enable template cache: False : L'activer semble causer quelques légers problèmes.
  

Index

Dans cette page, vous paramètrez la mise à jour automatique de l'affichage. Voici ceux que j'utilise:

• AJAX update: True : Mise à jour en AJAX de la page.
• Default Torrent Search Engine: mininova : TorrentSpy n'est pas vraiment une bonne idée :D
  
• Default Sort Order: Name - Ascending : Tri des torrents par nom (c'est le plus facile pour s'y retrouver).

Dir

• Public Write : True : Très pratique pour effacer vos torrents depuis le shell.

Users

Dans cette page, vous pouvez créer vos utilisateur normaux. N'utilisez l'administrateur que pour l'administration, pas pour le téléchargement.

Utilisation de Transmission comme client BitTorrent

Si vous souhaitez utiliser Transmission en lieu et place de BitTornado pour gérer vos transferts de fichiers, sachez que vous ne pouvez pas utiliser la version de transmission distribuée par Debian. Vous devez compiler par vous même une version modifiée de Transmission nécessaire au bon fonctionnement de Torrentflux.

Pour ce faire, commencez par renseigner la version de Transmission à télécharger:

VERSION=1.06

Et lancez le téléchargement:

/usr/bin/wget http://download.m0k.org/transmission/files/transmission-$VERSION.tar.bz2 \
    --output-document=/tmp/transmission-$VERSION.tar.bz2

Décompressez le fichier ainsi obtenu:

/bin/tar --directory /tmp -xjf /tmp/transmission-$VERSION.tar.bz2

Décompressez le patch nécessaire au bon fonctionnement avec TorrentFlux :

/bin/tar --directory /tmp -xjf /opt/torrentflux/clients/transmission/Transmission-1.06_tfCLI-svn3356.tar.bz2

Et mettez le en place :

/bin/cp /tmp/Transmission-1.06_tfCLI-svn3356/cli/transmissioncli.c /tmp/transmission-$VERSION/cli/transmissioncli.c

Installez les dépendances de compilation:

/usr/bin/apt-get install make gcc libc6-dev pkg-config libssl-dev

Placez-vous dans le dossier des sources:

cd /tmp/transmission-$VERSION

Et lancez la configuration:

./configure --disable-gtk

Puis, compilez:

/usr/bin/make

et installez:

/usr/bin/make install

Je vous conseille maintenant de désinstaller les logiciels nécessaires à la compilation:

/usr/bin/apt-get --purge remove make gcc libc6-dev libssl-dev pkg-config

Maintenant, connectez-vous en tant qu'administrateur de TorrentFlux, et modifiez vos paramètres afin d'utiliser la ligne de commande Transmission.

Remarque: Le chemin à spécifier dans l'onglet "server" pour la ligne de commande transmission est:

/usr/local/bin/transmissioncli

Pour aller plus loin

VLC

Vous avez pu tiquer en constatant que VLC (Video LAN Client) fait partie des dépendances de cet outil. Et bien, la raison est que Torrentflux utilise VLC pour "streamer" les contenus vidéo téléchargés. Pour que cette fonctionnalité marche, vous devez ouvrir le port 8080 de votre pare-feu ou routeur vers la machine hébergeant Torrentflux. (Vous pouvez changer ce port dans la page de configuration "Dir").

Remarque : Si votre serveur Torrentflux est derrière un reverse proxy Apache, il est nécessaire de modifier légèrement le code source de Torrentflux pour que le streaming fonctionne correctement. Pour ce faire, utilisez la commande suivante :

/bin/sed -i -e 's/return \$instanceVlc->addr;/return \$_SERVER["SERVER_NAME"];/g' \
         /opt/torrentflux/html/inc/classes/Vlc.php

Fluxd

Cet outil permet à Torrentflux d'effectuer des actions même lorsque vous n'êtes pas connectés. N'ayant pas trouvé de script init.d pour ce daemon, et n'en ayant pas l'utilité personnellement, je ne fait que le mentionner. Cependant, je vous conseille de lire la description de toutes les fonctions dans la page de configuration de cet outil. Certaines peuvent vous être utiles.

Alternatives

Au fil de mes surfs, je suis tombé sur des logiciels qui semblent faire à peu près la même chose que Torrentflux.

• BTG est un client BitTorrent qui fonctionne en tant que démon. Si vous souhaitez l'essayer, je vous encourrage à lire mon guide Installer BTG et son interface Web wwwBTG sur Debian 4.0 Etch.
  
• wTorrent est une interface Web en CGI pour rTorrent. C'est une plaie à installer, mais j'ai réussi à écrire un guide à ce sujet : Installer wTorrent sur Debian 5.0 Lenny.
  
• TorrentVolve est une interface Web, mais qui semble nécessiter Java. Je n'ai pas trop fouillé.
  

Remerciements

• Merci aux développeurs de Torrentflux-b4rt.