Como configurar o rtGui para o 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)

1. Instale dependências: xmlrpc-c, Apache, PHP.
2. Compile e instale libtorrent/rTorrent com suporte XML-RPC.
3. Configure Apache SCGI (SCGIMount) e rTorrent scgi_port.
4. Descompacte rtGui no root do servidor web e ajuste config.php.
5. 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