Настройка rtGui для rTorrent

Введение

Это руководство объясняет, как установить и настроить графический веб-интерфейс rtGui для rTorrent, используя XML-RPC/SCGI. rtGui упрощает управление загрузками rTorrent через браузер.

rtGui доступен: http://code.google.com/p/rtgui/

Важно: данное руководство предполагает, что вы работаете под UNIX-подобной системой с правами суперпользователя для установки пакетов и настройки веб-сервера.

Требования

rTorrent 0.8.0 / libtorrent 0.12.0, собранные с поддержкой XML-RPC — см. http://libtorrent.rakshasa.no/
Библиотека XML-RPC — см. http://xmlrpc-c.sourceforge.net/
Веб-сервер Apache, настроенный для работы с XML-RPC/SCGI — см. http://libtorrent.rakshasa.no/wiki/RTorrentXMLRPCGuide
PHP 5 с модулем XML-RPC — см. http://www.php.net/
Веб-браузер (например, Firefox) — см. http://www.mozilla.com/

Быстрая структура установки

Установить rTorrent и libtorrent.
Установить библиотеку XML-RPC.
Установить Apache и PHP с нужными модулями.
Настроить SCGI/XML-RPC для взаимодействия Apache с rTorrent.
Установить rtGui в корень веб-сервера и настроить config.php.

I. Установка базовых компонентов

1. Скачать и установить rTorrent и libtorrent

Инструкция установки: http://libtorrent.rakshasa.no/wiki/Install

./configure
make
make install (as superuser)

2. Скачать и установить XML-RPC

Загрузка: http://xmlrpc-c.sourceforge.net/downloading.php

tar xvzf xmlrpc-XXXXXXXXX.tgz
./configure

Если при ./configure возникает ошибка, попробуйте:

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

3. Установить Apache и PHP с нужными модулями

Официальные сайты: http://www.php.net/ и http://www.apache.org/

Убедитесь, что PHP имеет модуль xmlrpc, и что Apache может запускать модуль SCGI/проксировать SCGI запросы.

II. Настройка XML-RPC/SCGI и rtGui

1. Использование XML-RPC/SCGI с rTorrent

Что нужно:

SCGI-модуль для Apache: http://python.ca/scgi/
XML-RPC C-библиотека (1.00+; для 64-битных целых желательно 1.07+): http://xmlrpc-c.sourceforge.net/
rtorrent 0.7.5 или новее.

Соберите rTorrent с флагом –with-xmlrpc-c и добавьте в httpd.conf или apache2.conf следующие строки:

SCGIMount /RPC2 127.0.0.1:5000

В конфигурации rTorrent (обычно ~/.rtorrent.rc или rtorrent.rc) добавьте:

scgi_port = localhost:5000

После этого перезапустите rTorrent и Apache.

Важно: если Apache и rTorrent находятся на разных хостах, используйте безопасный канал и ограничьте доступ к /RPC2.

2. Установка rtGui

Перейдите в корневую директорию веб-сервера, например:

cd /var/www/htdocs

Распакуйте архив rtGui:

tar xvzf rtgui-0.1.tgz

При необходимости отредактируйте конфигурацию:

vi rtgui/config.php

Откройте в браузере: http://localhost/rtgui

Если интерфейс не отображается — проверьте логи Apache и права доступа к файлам.

Альтернативные GUI для rTorrent

Если вы хотите использовать другой интерфейс, установите компоненты из раздела I и затем выбранный GUI:

nTorrent
wTorrent
n2hell
rTWi
rtorstat

Сравните возможности: некоторые GUI ориентированы на мобильные клиенты, другие — на расширенную статистику.

Проверка работоспособности и отладка

Шаги для проверки:

Убедитесь, что rTorrent запущен и слушает scgi_port (localhost:5000).
Проверьте, отвечает ли SCGI-порт: curl или telnet к 127.0.0.1:5000 не даст понятного вывода, но в логах rTorrent можно увидеть успешные соединения.
Убедитесь, что Apache проксирует /RPC2 на 127.0.0.1:5000.
Проверьте логи Apache (error.log) и логи rTorrent для ошибок XML-RPC.
В браузере откройте rtGui и проверьте консоль разработчика (Network) — запросы к /RPC2 должны возвращать 200.

Типичные проблемы и решения:

Проблема: 403/404 при обращении к /RPC2
- Решение: проверьте директивы SCGIMount в httpd.conf и права доступа.
Проблема: rtGui открывается, но список торрентов пуст
- Решение: проверьте scgi_port в rtorrent.rc и совпадение адресов/портов.
Проблема: ошибки XML-RPC типа “unsupported method”
- Решение: проверьте версии xmlrpc-c и rTorrent; пересоберите rTorrent с –with-xmlrpc-c.

Контрольный список перед запуском

rTorrent собран с XML-RPC
xmlrpc-c установлен и подходит для архитектуры
Apache с SCGI-модулем и директивой SCGIMount
PHP с xmlrpc-модулем (если требуется)
Файлы rtGui в корне веб-сервера
Правильно настроен rtgui/config.php

Безопасность и рекомендации

Ограничьте доступ к /RPC2 через настройки Apache (Allow/Deny, Require ip).
Если доступ к rtGui нужен извне, используйте HTTPS и аутентификацию на уровне веб-сервера.
Рассмотрите запуск rTorrent под отдельным пользователем без прав суперпользователя.

Критерии приёмки

rtGui открывается в браузере и отображает список торрентов.
Добавление/удаление торрентов из rtGui корректно инициирует действия в rTorrent.
Логи Apache и rTorrent не содержат критических ошибок при работе интерфейса.

1‑строчная глоссарий

rTorrent: консольный торрент-клиент на базе libtorrent.
libtorrent: библиотека, реализующая клиентскую логику BitTorrent для rTorrent.
XML-RPC/SCGI: протоколы удалённого вызова процедур, используемые для связи веб-интерфейса и rTorrent.

Короткое резюме

Установите rTorrent и xmlrpc-c, настройте scgi_port в rtorrent.rc.
Настройте Apache для проксирования /RPC2 на порт rTorrent.
Разверните rtGui в корне веб-сервера и проверьте config.php.
Обеспечьте безопасность доступа и проверьте работоспособность через логи.

Приятного использования и успехов в настройке!

Источник оригинала: http://petik.uw.hu

Спасибо!

PeTIK Team