Настройка 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/

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

1. Установить rTorrent и libtorrent.
2. Установить библиотеку XML-RPC.
3. Установить Apache и PHP с нужными модулями.
4. Настроить SCGI/XML-RPC для взаимодействия Apache с rTorrent.
5. Установить 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 ориентированы на мобильные клиенты, другие — на расширенную статистику.

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

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

1. Убедитесь, что rTorrent запущен и слушает scgi_port (localhost:5000).
2. Проверьте, отвечает ли SCGI-порт: curl или telnet к 127.0.0.1:5000 не даст понятного вывода, но в логах rTorrent можно увидеть успешные соединения.
3. Убедитесь, что Apache проксирует /RPC2 на 127.0.0.1:5000.
4. Проверьте логи Apache (error.log) и логи rTorrent для ошибок XML-RPC.
5. В браузере откройте 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