Configurar rtGui para rTorrent

Resumen rápido

rtGui es una interfaz web para rTorrent que utiliza XML-RPC/SCGI.
Necesitas rTorrent compilado con soporte XML-RPC, la librería XML-RPC, Apache con soporte SCGI y PHP con el módulo XML-RPC.
El procedimiento cubre la compilación/instalación y la configuración mínima de Apache y rtGui.

Requisitos

rTorrent 0.8.0 / libtorrent 0.12.0 compilados con soporte para la librería XML-RPC — más información: http://libtorrent.rakshasa.no/
Librería XML-RPC — http://xmlrpc-c.sourceforge.net/
Servidor web Apache configurado para SCGI/XML-RPC — guía: http://libtorrent.rakshasa.no/wiki/RTorrentXMLRPCGuide
PHP 5 con módulo XML-RPC — http://www.php.net/
Un navegador web reciente — por ejemplo: http://www.mozilla.com/

Nota: define “compilado con soporte XML-RPC” como la compilación de rTorrent con la opción correspondiente (–with-xmlrpc-c) y la librería xmlrpc-c disponible en el sistema.

Instalación

I. Preparar e instalar dependencias

1. Descargar e instalar rTorrent y libtorrent

Guía de instalación: http://libtorrent.rakshasa.no/wiki/Install

./configure
make
sudo make install

2. Descargar e instalar XML-RPC (xmlrpc-c)

Descarga: http://xmlrpc-c.sourceforge.net/downloading.php

tar xvzf xmlrpc-XXXXXXXXX.tgz
./configure

Si ./configure falla, prueba:

./configure --disable-cplusplus
make
sudo make install

3. Instalar Apache y PHP con módulos necesarios

Documentación: http://www.php.net/ y http://www.apache.org/

Asegúrate de que Apache tenga soporte para SCGI (mod_scgi o un módulo equivalente) y que PHP tenga activado xmlrpc.

II. Configurar XML-RPC/SCGI con rTorrent y Apache

1. Configurar XML-RPC/SCGI para rTorrent

Requisitos adicionales:

Implementación SCGI para Apache: http://python.ca/scgi/
xmlrpc-c versión 1.00 o posterior (1.07+ recomendado para soporte de enteros de 64 bits)
rTorrent 0.7.5 o superior

Configura rTorrent con la opción –with-xmlrpc-c y añade la siguiente configuración en httpd.conf o apache2.conf:

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

Explicación breve: SCGIMount le dice a Apache que reenvíe /RPC2 a un socket SCGI local; rtorrent debe escuchar en ese puerto/sock para aceptar comandos XML-RPC.

2. Instalar rtGui

Cambia al directorio raíz de tu servidor web, por ejemplo:

cd /var/www/htdocs

Extrae el archivo de rtGui que descargaste:

tar xvzf rtgui-0.1.tgz

Modifica la configuración si es necesario:

vi rtgui/config.php

Abre en tu navegador: http://localhost/rtgui (o la ruta donde colocaste rtgui)

Archivos y configuración clave

rtorrent.rc: contiene scgi_port = localhost:5000 (u otro socket/puerto según tu configuración)
httpd.conf / apache2.conf: entrada SCGIMount /RPC2 127.0.0.1:5000
rtgui/config.php: URL del endpoint RPC y credenciales (si aplica)

Posibles alternativas a rtGui

nTorrent
wTorrent
n2hell
rTWi
rtorstat

Si eliges otra GUI, sigue el capítulo I (instalar rTorrent y dependencias) y luego instala la GUI elegida.

Lista de verificación por rol

Administrador:

rTorrent compilado con –with-xmlrpc-c
xmlrpc-c instalado y actualizado
Apache con SCGI activo y puerto/socket configurado
rtGui desplegado en carpeta pública con permisos adecuados
Firewall: puerto local/loopback permitido para SCGI

Usuario final:

[ ] Acceso web a http://host/rtgui
Credenciales correctas (si aplica)
Permisos de lectura/escritura en directorios de descarga

Mini-metodología para implementación segura

Instala y prueba rTorrent y libtorrent en un entorno de pruebas.
Añade xmlrpc-c y verifica que rTorrent expone el endpoint SCGI localmente.
Configura Apache/SCGI y revisa logs de Apache y rTorrent.
Despliega rtGui, configura config.php y prueba funcionalidades básicas (listar torrents, añadir, pausar).
Mueve a producción y monitoriza por 48–72 horas.

Solución de problemas (runbook rápido)

Problema: rtGui no muestra torrents

Verifica que rTorrent esté corriendo.
Comprueba que rtorrent.rc tenga scgi_port apuntando al mismo host/puerto que SCGIMount.
Revisa logs de Apache (error.log) y logs de rTorrent.

Problema: ./configure falla para xmlrpc-c

Intenta ./configure –disable-cplusplus
Asegúrate de tener build-essential/compiladores y dependencias de desarrollo instaladas

Problema: errores de permisos al escribir en carpetas de descarga

Verifica usuario bajo el que corre rTorrent y ajusta permisos/propiedad (chown/chmod) con cuidado.

Criterios de aceptación

El endpoint RPC responde: una llamada listará los torrents activos.
rtGui muestra la lista de torrents y permite controles básicos (pausa, reanudar, añadir).
No hay errores relevantes en los logs tras interacciones básicas.

Glosario de una línea

SCGI: protocolo ligero para pasar solicitudes entre servidor web y aplicación.
XML-RPC: protocolo remoto para llamadas a métodos usando XML sobre HTTP.
rtGui: interfaz web para controlar rTorrent.

Seguridad y privacidad (notas rápidas)

No expongas el endpoint SCGI directamente a Internet; limita el acceso a localhost o utiliza un proxy seguro.
Si necesitas acceso remoto, protege la interfaz con autenticación y TLS (HTTPS) en Apache.
Revisa permisos en directorios de descarga para evitar acceso no autorizado a archivos.

Resumen final

Instalar rtGui para rTorrent requiere preparar rTorrent con soporte XML-RPC, instalar xmlrpc-c, configurar Apache/SCGI y desplegar rtGui en el directorio web. Prueba siempre en un entorno de desarrollo antes de pasar a producción y aplica controles de seguridad para no exponer el endpoint SCGI públicamente.

¡Buen trabajo! Luego, ¡disfruta!

http://petik.uw.hu

Gracias!

PeTIK Team

Cómo configurar rtGui para rTorrent