Configurar rtGui para rTorrent

Instale rTorrent + libtorrent com suporte XML-RPC, configure o Apache para SCGI e coloque os ficheiros do rtGui no root do servidor web. Teste apontando o navegador para http://localhost/rtgui e verifique permissões e portas. Este guia descreve requisitos, passos de instalação, solução de problemas e alternativas.

Requisitos

rTorrent 0.8.0 / libtorrent 0.12.0 compilados com suporte à biblioteca XML-RPC — veja http://libtorrent.rakshasa.no/
Biblioteca XML-RPC — veja http://xmlrpc-c.sourceforge.net/
Servidor Apache configurado com suporte a XML-RPC/SCGI — veja http://libtorrent.rakshasa.no/wiki/RTorrentXMLRPCGuide
PHP 5 com módulo XML-RPC — veja http://www.php.net/
Um navegador web — veja http://www.mozilla.com/

Instalação

I. Preparação e compilação

1. Baixar e instalar rTorrent e libtorrent

Guia de instalação: http://libtorrent.rakshasa.no/wiki/Install

./configure
make
make install (como superusuário)

2. Baixar e instalar XML-RPC

Página de downloads: http://xmlrpc-c.sourceforge.net/downloading.php

tar xvzf xmlrpc-XXXXXXXXX.tgz
./configure

Se ocorrer erro em ./configure, experimente:

./configure --disable-cplusplus
make
make install (como superusuário)

3. Instalar Apache e PHP com módulos

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

Instale os pacotes do seu gestor (apt, yum, pacman) ou compile conforme necessário.

II. Configurar comunicação XML-RPC/SCGI

1. Usando XML-RPC com rTorrent

O que precisa:

SCGI para Apache: http://python.ca/scgi/
xmlrpc-c versão 1.00 ou posterior (1.07+ para suporte a inteiros 64-bit): http://xmlrpc-c.sourceforge.net/
rTorrent 0.7.5 ou posterior.

Configure o rTorrent com a flag –with-xmlrpc-c e adicione ao httpd.conf ou apache2.conf:

SCGIMount /RPC2 127.0.0.1:5000

No arquivo de configuração do rTorrent (rtorrent.rc):

scgi_port = localhost:5000

Isso encaminha pedidos SCGI do Apache para o rTorrent.

2. Instalar o rtGUI

Entre no diretório raiz do servidor web, por exemplo:

cd /var/www/htdocs

Extraia os ficheiros do ficheiro obtido:

tar xvzf rtgui-0.1.tgz

Se necessário, modifique a configuração:

vi rtgui/config.php

Aponte o navegador para o diretório, por exemplo: http://localhost/rtgui

Verificações importantes

Importante: execute make/install como superusuário quando solicitado. Verifique também as permissões do diretório web (www-data/apache) para que o servidor leia os ficheiros do rtGui.
Nota: portas e firewall. Assegure que a porta 5000 (ou a porta configurada) esteja acessível localmente entre Apache e rTorrent.

Quando isso falha (sugestões de solução de problemas)

Se o rtGui não abre: verifique os logs do Apache (error_log) e o log do rTorrent.
Erros XML-RPC: confirme que o xmlrpc-c está instalado e que rTorrent foi compilado com –with-xmlrpc-c.
Erros SCGI: verifique se o módulo SCGI está carregado no Apache e se SCGIMount está correto.
Erro de permissões: ajuste proprietários e permissões (chown/chmod) do diretório rtgui para o usuário do Apache.

Alternativas e quando usar cada uma

nTorrent — interface simples, útil em sistemas com poucos recursos.
wTorrent — opção leve e rápida.
n2hell — alternativa com funcionalidades diferentes na UI.
rTWi — foco em monitoramento/estatísticas.
rtorstat — bom para painéis de estatísticas.

Escolha outra GUI se precisar de recursos específicos (ex.: dashboards, autenticação integrada ou suporte a múltiplos usuários).

Checklist por função

Sysadmin:
- Compilar rTorrent/libtorrent com –with-xmlrpc-c.
- Instalar xmlrpc-c e SCGI para Apache.
- Configurar SCGIMount e testar conectividade local.
- Configurar firewall e permissões.
Desenvolvedor:
- Verificar config.php do rtGui.
- Testar endpoints XML-RPC com um cliente de teste.
Usuário final:
- Aceder via navegador: http://localhost/rtgui
- Reportar erros ao administrador com logs anexos.

Mini-metodologia (passos rápidos)

Instale dependências: xmlrpc-c, Apache, PHP.
Compile e instale libtorrent/rTorrent com suporte XML-RPC.
Configure Apache SCGI (SCGIMount) e rTorrent scgi_port.
Descompacte rtGui no root do servidor web e ajuste config.php.
Teste no navegador e verifique logs se necessário.

Fluxo de decisão (ajuda a escolher abordagem)

flowchart TD
  A[Precisa de GUI para rTorrent?] -->|Sim| B{Servidor tem recursos?}
  B -->|Sim| C[Instalar rtGui]
  B -->|Não| D[Escolher GUI leve 'nTorrent/wTorrent']
  C --> E{Necessita de autenticação multiusuário?}
  E -->|Sim| F[Considerar integração com autenticação externa]
  E -->|Não| G[Deploy padrão]

Glossário (uma linha cada)

rTorrent: cliente bittorrent baseado em texto, eficiente para servidores.
libtorrent: biblioteca C++ usada por rTorrent para operações de torrent.
XML-RPC: protocolo remote procedure call sobre XML/HTTP.
SCGI: protocolo simples para comunicação entre servidores web e aplicações.

Observações de segurança

Evite expor a porta SCGI/TCP do rTorrent para redes públicas. Encaminhe SCGI apenas via localhost e controle o acesso no Apache.
Mantenha PHP e Apache atualizados para reduzir riscos de execução remota.

Resumo final

Este guia mostra os passos essenciais para instalar e configurar o rtGui com rTorrent: prepare dependências, compile com suporte XML-RPC, configure SCGI no Apache e instale o rtGui no diretório web. Teste localmente e use os checklists e o fluxo acima para diagnosticar problemas.

Divirtam-se e boa configuração!

Obrigado!

PeTIK Team

http://petik.uw.hu

Como configurar o rtGui para o rTorrent