RuTorrent установка и настройка под Gentoo
ruTorrent - это графическая оболочка для работы с торрент клиентом rTorrent, работающая под управлением веб сервера. С версии 0.7.5, rtorrent можно собрать вместе с поддержкой протокола XML-RPC. Это позволяет в удобной для форме общаться с клиентом, управлять им, используя что-то своё (как правило веб обёртку), а не только консоль с ncurses.
Одним из наиболее интересных приложений, основанных на веб-технологии на мой взгляд оказался проект ruTorrent. Я уже давно пользовался rTorrent, но как-то настал тот момент, когда я устал от консоли и мне захотелось иметь красивый и наглядный вывод информации в браузер о текущем положении дел. Это пожалуй единственное что мне было интересно, т.к. управлять программой мне удобнее используя горячие клавиши, а так же конфигурационный файл. Рассмотрим как можно прикрутить себе веб-морду, очень сильно напоминающую неплохой Win torrent clietn - uTorrent =).
Приготовления и системные требования
Посмотрим, что надо иметь на сервере, для установки ruTorrent.
Системные требования
- rTorrent версии не менее 0.8.2, скомпилированный с поддержкой XML-RPC.
- Веб-сервер с поддержкой php 5.0.
- Браузер, как локальный клиент (IE 7.0, Firefox 2.x, Firefox 3.x, Opera 9.x)
Теперь я напишу, с что стояло у меня, перед тем как я приступил к работе:
Основу я указал, теперь приступим к приготовлениям.
Подготовка системы к ruTorrent
Выполним некоторые предварителные действия для подготовки инструментария и среды под ruTorrent.
Собираем rTorrent с опцией XML-RPC
Для начала надо пересобрать rTorrent с необходимой опципей, т.е. поддержкой XML-RPC.
Для этого в файл /etc/portage/package.use добавляем строку.
net-p2p/rtorrent daemon xmlrpc
Пересобираем rTorrent:
Установка модуля mod_scgi для Apache
Далее надо собрать к Apache модуль www-apache/mod_scgi. Для этого выполняем следующие действия.
Сперва добавим в файл /etc/portage/package.keywords строки
www-apache/mod_scgi ~amd64 www-apps/scgi ~amd64
Это размаскирует эти пакеты для систем amd64 (64 битная ОС).
Причём пакет www-apache/mod_scgi и есть сам mod_scgi, а www-apps/scgi дополнительно устанавливаемый пакет при компиляции mod_scgi.
Собираем для Apache нужный модуль:
Теперь надо сконфигурировать данный модуль.
Конфигурация mod_scgi
Открываем на правку конфигурационный файл XX_mod_scgi.conf (у меня он называется 20_mod_scgi.conf).
<IfDefine SCGI> LoadModule scgi_module modules/mod_scgi.so # Apache2 example <Location "/RPC2"> SetHandler scgi-handler SCGIServer localhost:5000 SCGIHandler On Options -Multiviews AuthName "RPC2 Restricted Area" AuthType Basic AuthBasicProvider file AuthUserFile /var/www/tool/htpasswd/.rutorrent Require valid-user </Location> </IfDefine>
Соответственно мы тут добавили точку монтирования (Location "/RPC2"), адрес и порт (SCGIServer localhost:5000), а так же прикрыли доступ из вне, поставив пароль, используя обычную веб-аунтификацию апача. Последнее позволит защитить обращения к нашему веб серверу к RPC (http://address/RPC2), а ведь именно туда обращается ruTorrent, посылая запросу не напряму к rTorrent, а через веб сервер (более подробно можно глянуть тут).
Так же нам надо создать файл с паролем и логином для веб-аутентификации /var/www/tool/htpasswd/.rutorrent, куда вносятся данные, полученные от утилиты htpasswd (можно сгенерировать их и on-line, например тут).
<IfDefine SCGI> эта директива проверяет, был ли запущен апач с ключом SCGI и только потом подгружает модуль mod_scgi. Для того, чтобы запустить апач с этим ключом необходимо поправить следующий файл:
APACHE2_OPTS="-D SCGI ...... "
То есть мы добавили ключ запуска апача -D SCGI, важно не удалить случайно те ключи, которые там ранее уже были у вас. Просто вставьте своё значение вначало.
После проделанных выше операций перезапускаем наш Apache:
Установка ruTorrent
Для установки самой свежей версии необходимов выполнить чекаут из системы контроля версий SubVersion.
Для этого переходим в папку веб сервера апаче, куда мы хотим установить наш ruTorrent и выполняем:
Более подробно об обновлении через svn читайте вот тут.
Важно чтобы пользователь веб сервера (apache в моей системе) имел права на запись в некоторые папки (если не изменяет память это DOCUMENT_ROOT/settings и DOCUMENT_ROOT/torrents). Если этого не будет, то при первом же запуске ruTorrent укажет сам, на какие папки у него нет прав на запись.
Теперь надо немного отредактировать конфигурационный файл rTorrent'а - .rtorrent.rc, добавив в него сделующие строки:
#SCGI PORT for XML-RPC Connections scgi_port = 127.0.0.1:5000 encoding_list = UTF-8
Это укажет адрес и порт SCGI и жёстко пропишет кодировку (протокол XML-RPC работает только с UTF-8 как я понял, что нельзя кстати названь минусом, т.к. очень уж она хороша).
Добавляем защиту доступа к ruTorrent
Т.к. rTorrent не имеет встроеного механизма аутентификации и к нему может из вне подключиться кто угодно и выполнить там любые действия, то есть смыл защитить его хотябы обычным встроенным в веб сервер способом (по аналогии с mod_scgi).
Для этого в корень папки на веб сервере, где лежат скрипты ruTorrent кидаме файл .htaccess со следующим содержимым:
AuthName "ruTorrent Restricted Area" AuthType Basic AuthUserFile /var/www/tool/htpasswd/.rutorrent Require valid-user
Это прикрутит ранее созданный файл с паролем и логином (смотри секцию выше о настройке mod_scgi).
Теперь у нас есть рабочий ruTorrent по адресу http://адрес_сервера:порт_сервера/rtorrent