Configurare rtGui per rTorrent

TL;DR

Installare rtGui per rTorrent richiede rTorrent compilato con supporto XML‑RPC, un server Apache configurato per SCGI e PHP con modulo XML‑RPC. Questa guida passo passo copre i prerequisiti, la compilazione, la configurazione SCGI/Apache e l’installazione della GUI.

Requisiti

rTorrent 0.8.0 / libtorrent 0.12.0 compilati con supporto alla libreria XML‑RPC - vedi http://libtorrent.rakshasa.no/
Libreria XML‑RPC - vedi http://xmlrpc-c.sourceforge.net/
Server web Apache con supporto SCGI/XML‑RPC - vedi http://libtorrent.rakshasa.no/wiki/RTorrentXMLRPCGuide
PHP 5 con modulo XML‑RPC - vedi http://www.php.net/
Un browser web moderno - vedi http://www.mozilla.com/

Importante: rTorrent deve essere compilato con l’opzione per XML‑RPC e il demone SCGI deve essere raggiungibile dal server Apache (tipicamente su localhost:5000). Verifica le versioni richieste se usi sistemi a 64 bit.

Panoramica della procedura

Compilare e installare libtorrent/rTorrent con supporto XML‑RPC.
Installare e configurare la libreria XML‑RPC (xmlrpc-c).
Configurare Apache per inoltrare SCGI a rTorrent.
Installare PHP (con modulo XML‑RPC) e rtGui nella root del server web.
Testare l’accesso a rtGui via browser.

I. Installazione delle dipendenze e compilazione

1. Scaricare e installare rTorrent e libtorrent

Guida e sorgenti: http://libtorrent.rakshasa.no/wiki/Install

Esempio di comandi di compilazione:

./configure
make
make install (as superuser)

Nota: esegui i comandi di installazione come utente root o con sudo. Se usi percorsi personalizzati, aggiorna le variabili PATH/LD_LIBRARY_PATH.

2. Scaricare e installare xmlrpc-c

Download e documentazione: http://xmlrpc-c.sourceforge.net/downloading.php

Esempio:

tar xvzf xmlrpc-XXXXXXXXX.tgz
./configure

Se ottieni errori con ./configure, prova:

./configure --disable-cplusplus
make
make install (as superuser)

Motivazione: alcune distribuzioni non forniscono supporto C++ o possono avere conflitti con i linker. L’opzione –disable-cplusplus compila solo la parte C.

3. Installare Apache e PHP con moduli necessari

Apache: http://www.apache.org/
PHP: http://www.php.net/

Assicurati che PHP includa il modulo XML‑RPC (php-xmlrpc) e che il server Apache possa eseguire script PHP.

II. Configurazione XML‑RPC e SCGI per rTorrent

1. Usare XMLRPC con rTorrent

Requisiti aggiuntivi:

SCGI per Apache: http://python.ca/scgi/
xmlrpc-c versione 1.00 o successiva (1.07+ consigliata per il supporto integer a 64 bit)
rTorrent 0.7.5 o successiva

Compila rTorrent con l’opzione –with-xmlrpc-c. Aggiungi la seguente configurazione al file di Apache (httpd.conf o apache2.conf) e al file di configurazione di rTorrent (rtorrent.rc):

SCGIMount /RPC2 127.0.0.1:5000
rtorrent.rc: scgi_port = localhost:5000

Spiegazione rapida: SCGIMount istruisce Apache a inoltrare le richieste dirette a /RPC2 al demone SCGI in ascolto su localhost:5000, dove rTorrent risponde tramite XML‑RPC.

2. Suggerimenti di configurazione

Verifica che non ci siano firewall locali che bloccano la porta 5000.
Se Apache e rTorrent girano su macchine diverse, usa un canale sicuro (VPN/SSH) perché SCGI non cifra il traffico.
Per installazioni multi‑utente, valuta i permessi della cartella dei torrent e dell’utente che esegue rTorrent.

III. Installazione di rtGui

Spostati nella root del server web, per esempio:

cd /var/www/htdocs

Estrai l’archivio scaricato di rtGui:

tar xvzf rtgui-0.1.tgz

Modifica il file di configurazione se necessario:

vi rtgui/config.php

Punta il browser alla directory, ad esempio: http://localhost/rtgui

Se tutto è configurato correttamente, l’interfaccia web di rtGui dovrebbe mostrarti lo stato di rTorrent e consentirti le operazioni di base.

Alternative alle GUI

Se preferisci un’altra interfaccia grafica per rTorrent, procedi fino al capitolo I per le dipendenze e poi installa la GUI scelta. Esempi:

nTorrent
wTorrent
n2hell
rTWi
rtorstat

Valuta la compatibilità della GUI con la versione di rTorrent e con il metodo di comunicazione (SCGI/XML‑RPC).

Checklist per l’amministratore prima del test

rTorrent compilato con –with-xmlrpc-c
xmlrpc-c installato e funzionante
Apache configurato con SCGIMount /RPC2 127.0.0.1:5000
rtorrent.rc contiene scgi_port = localhost:5000
PHP con modulo XML‑RPC attivo
rtGui estratto nella root del webserver e config.php verificato
Nessun firewall locale che blocchi la porta 5000

Risoluzione problemi comuni

Errore di connessione alla GUI: verifica che rTorrent stia ascoltando sulla porta configurata e che Apache possa raggiungerla.
Errore ./configure per xmlrpc-c: prova con –disable-cplusplus e ricompila.
Permessi file: assicurati che l’utente che esegue Apache possa leggere i file di rtGui.
Comandi non trovati dopo installazione: aggiorna PATH o verifica dove sono stati installati i binari.

Suggerimenti di sicurezza

Non esporre l’endpoint SCGI (porta 5000) su interfacce pubbliche senza tunnel sicuro.
Se devi controllare rTorrent da remoto, usa un reverse proxy HTTPS o un tunnel SSH.
Limita l’accesso alla directory web di rtGui con autenticazione se contenente funzionalità di controllo.

Mini‑metodologia per aggiornamenti futuri

Effettua backup del file rtorrent.rc e di rtgui/config.php.
Aggiorna libtorrent/rTorrent localmente e testa in un ambiente di staging.
Verifica la compatibilità della nuova versione con xmlrpc-c.
Aggiorna rtGui solo dopo che rTorrent risponde correttamente ai comandi XML‑RPC.

Sommario

Questa guida descrive i passi necessari per installare e configurare rtGui con rTorrent: compilazione di rTorrent con supporto XML‑RPC, installazione di xmlrpc-c, configurazione di Apache/SCGI e installazione di rtGui nella root web. Controlla i permessi, la porta SCGI e proteggi l’accesso remoto.

Grazie!

PeTIK Team — http://petik.uw.hu

Buon lavoro e attenzione alla sicurezza della porta SCGI.