Installare Transmission su Debian GNU/Linux, aggiungendo un’interfaccia web per il controllo remoto

Author: Emanuele Cipolla

29 set

Aggiornamento del 27 Dicembre 2007: Ho sostituito i link ai sorgenti e alla patch con delle mie copie, dal momento che gli originali sono stati rimossi. Ho fatto questo perchè ho riscontrato l’impossibilità di compilare, su Debian stable, qualsiasi release di Transmission successiva alla 0.82 da me testata. Poichè non ho, al momento, il tempo di investigare quale sia il motivo esatto, preferisco fornirvi una versione “fidata” del programma da usare, piuttosto che invogliarvi a scaricare i sorgenti dell’ultima versione (0.96 ad oggi) dai repository di Debian unstable alias sid.

Aggiornamento del 29 Dicembre 2007: Il pacchetto dpkg-buildpackage non esiste. Un visitatore che si firma Alessandro mi ha segnalato privatamente l’errore, ed ho così potuto provvedere a referenziare i pacchetti corretti: a me aveva funzionato tutto ugualmente soltanto perchè, in qualche modo, mi ero tirato giù in passato quei pacchetti. Se avete avuto problemi strani, riprovate adesso. Sentiti ringraziamenti ad Alessandro da parte mia ed, immagino, anche da parte vostra.

Transmission è un client BitTorrent molto leggero e performante, e supporta la maggior parte delle features che servono all’utente medio (ad esempio, la possibilità di controllare la banda assegnata a ciascun torrent) e include anche un daemon che ne permette l’esecuzione in background. Purtroppo, tale daemon non è fornito con il pacchetto presente nei repository di Debian etch: dal momento che, quindi, dovremmo comunque partire dai sorgenti per ottenere un pacchetto che faccia per noi, ne approfittiamo per usarne una versione più aggiornata che è presente in Debian unstable.

Inoltre, a questo indirizzo è disponibile un’interfaccia web (che richiede PHP 5) che, sebbene sia ai primi stadi di sviluppo, dovrebbe essere sufficiente per chiunque (almeno, per me lo è). Con qualche accorgimento potremo costruire una stazione per i download di torrent gestibile via web e ragionevolmente sicura basata su Transmission 0.82 (la versione presente nei repository di Debian unstable al momento della scrittura di questo articolo). Ricordo che i comandi di installazione dei pacchetti e di cambiamento dei permessi vanno eseguiti dall’utente root.

Attenzione: Per qualche motivo che non mi è chiaro, non è possibile avviare transmission-daemon con privilegi utente, e il daemon non si occupa di passare ad un account non privilegiato dopo l’avvio. Se questo costituisce un problema vitale per voi, non seguite questa procedura. Grazie.

Scarichiamo i sorgenti e la patch preparata dagli sviluppatori Debian, salvando entrambi i file nella medesima directory.
Decomprimiamo l’archivio compresso e applichiamo la patch: tar xfz transmission_0.82.dfsg.orig.tar.gz; cd transmission-0.82.dfsg.orig; gunzip ../transmission_0.82.dfsg-1.diff.gz; patch -p1 < ../transmission_0.82.dfsg-1.diff
Installiamo (se non sono già presenti) fakeroot~~, dpkg-buildpackage~~ e PHP 5, insieme alle dipendenze necessarie alla compilazione di Transmission - anche se ci basiamo su quelle necessarie a Transmission 0.6, la versione presente in etch, non dovrebbe comunque venirci a mancare nulla. L’installazione di PHP 5 si porterà dietro anche Apache 2, se non è già installato.apt-get install fakeroot dpkg-buildpackage php5 php5-gd; apt-get build-dep transmission
Compiliamo il programma e installiamo i tre pacchetti che si vengono a creare (transmission, transmission-daemon e transmission-cli): fakeroot dpkg-buildpackage debhelper; sudo dpkg -i transmission*
Scarichiamo transmission-web da qui, e decomprimiamolo nella directory /var/www con tar xfz transmission-web.tar.gz -C /var/www; chown -R www-data:www-data /var/www/bittorrent La directory bittorrent/ può, se lo volete, essere ridenominata: assicuratevi di “compensare” questa modifica modificando i passaggi che seguono.
Se Apache 2 non era già installato e configurato, sarà necessario creare una configurazione di default che sostituisca quella di esempio. Potreste volere usare un file come questo, derivato dalla configurazione d’esempio: per renderlo operativo, a meno che non gestiate dei server virtuali (cosa abbastanza rara), dovrete piazzare il file in /etc/apache2/sites-available e quindi fare ln -s /etc/apache2/sites-available/apache2-config /etc/apache2/sites-enabled/000-apache2-config; rm /etc/apache2/sites-enabled/000-default, e togliere di mezzo i file di test di Apache 2, per esempio con un mv /var/www/apache2-default /usr/share/doc/apache2-common.
Scaricate il mio script di init per transmission-daemon, piazzatelo in /etc/init.d e rendetelo eseguibile con chmod +x /etc/init.d/transmission-daemon, quindi fate in modo che transmission-daemon venga fatto partire all’avvio del sistema, e venga fatto chiudere allo spegnimento dello stesso, eseguendo update-rc.d transmission-daemon defaults 92 (la priorità 92 fa in modo che venga eseguito subito dopo e chiuso subito prima di Apache 2, che ha priorità 91 nella configurazione predefinita).

Modifichiamo il file /var/www/bittorrent/config.php per adattarlo alle nostre esigenze:


      /* Indica il percorso in cui si trova il socket utilizzato per
      comunicare con transmission-daemon. Se non avete
      modificato il mio script di init si trovera' in
      /tmp/transmission-socket */
      $config["socket_path"] = "/tmp/transmission-socket";
      /* download_folder e downloadDir impostano le directory
      dove salvare i file temporanei e i file completi.
      Scegliete il posto piu' appropriato. La stessa locazione
      puo' essere utilizzata per entrambe le variabili.*/
      $config["download_folder"] = "/home/emanuele/documenti/downloads/bittorrent";
      $config["downloadDir"] = "/home/emanuele/documenti/downloads/bittorrent";
      /* Indica la porta su cui Transmission e' in ascolto. */
      $config["port"] = 6882;

Impostiamo una password d’accesso all’interfaccia web. Supponendo di voler denominare amministratore l’utente che potrà accedere all’interfaccia web, eseguiamo htpasswd -c /var/www/bittorrent/.htpasswd admin ed inseriamo la password scelta come richiesto.
Riavviamo Apache, ed avviamo transmission-daemon: /etc/init.d/apache2 stop; /etc/init.d/apache2 start; /etc/init.d/transmission-daemon start
Visitiamo con un browser l’indirizzo http://localhost/bittorrent/ (se stiamo usando la macchina in cui è fisicamente installato Transmission) o http://indirizzoip/bittorrent/. Se ci viene richiesta una password, e quindi viene presentata una pagina simile alla seguente:

tutto sta funzionando bene.

Abbiamo terminato. Se vogliamo, possiamo decidere, oltre a lanciare tutti i nostri torrent, di trasformare la connessione HTTP in una HTTPS, per maggiore sicurezza. Non lo mostro soltanto perchè:

Ci sono diversi modi per fornire connettività HTTPS, modi che richiedono passaggi lievemente differenti, ma tali che mi costringerebbero a provare le configurazioni una per una - mentre l’autenticazione plaintext è identica dappertutto (anche concettualmente: non ha poi molta importanza quale server web si scelga di utilizzare);
Sul web sono disponibili tonnellate di manuali molto ben fatti (sicuramente meglio delle guide che scrivo) che sono letture praticamente obbligate e, in molti casi, risolutive.

Enjoy