Различия

Показаны различия между двумя версиями страницы.

--- dpi:dpi_components:mediaserver:btrt [2018/02/02 13:09] – создано lexx26
+++ dpi:dpi_components:mediaserver:btrt [2024/09/26 15:29] (текущий) – внешнее изменение 127.0.0.1
@@ Строка 1: / Строка 1: @@
 ====== Опция управления bittorent ======
+{{indexmenu_n>5}}
+====== BTRT - BitTorrent Proxy Tracker ======
+===== Описание =====
+BTRT является BitTorrent трекером, который позволяет оптимизировать распределение сетевого трафика в пользу уменьшения объемов трафика на внешние сети за счет увеличения объемов внутрисетевого трафика. Уменьшение объемов сетевого трафика на внешние сети осуществляется за счет приоритезации IP-адресов пиров в ответах на //announce//-запросы: в соответствии с [[#Основной файл конфигурации /etc/btrt/btrt.conf|конфигурацией]] в первую очередь в ответ попадают IP-адреса пиров сети оператора.
+BTRT отвечает на стандартные HTTP запросы BitTorrent клиентов //announce// и //scrape//, а также предназначен для обработки нестандартных //forwarded_announce//-запросов, более подробно об этом написано [[#Обработка запросов к сторонним трекерам|здесь]].
+===== Требования к аппаратному обеспечению =====
+Основное требование предъявляется к размеру оперативной памяти. BTRT держит в памяти всю информацию о всех torrent-файлах и пирах, а также пр. Для приблизительного расчета необходимого объема оперативной памяти можно взять за основу 512 байт на один пир.
+===== Требования к программному обеспечению =====
+BTRT работает в среде ОС CentOS 6. Для работы BTRT следующие пакеты должны быть установлены в системе:
+  * ''mysql-server'', версии не ниже 5.1.73
+  * ''mysql-connector-c++'', версии не ниже 1.1.5
+===== Варианты использования =====
+==== Локальный ретрекинг ====
+Самый простейший способ использования BTRT - это использование в качестве локального ретрекера. В torrent-файлах существует возможность указать несколько трекеров, к которым должен обращаться BitTorrent-клиент, посылая //announce//-запросы. Для организации локального ретрекинга принято использовать специальное имя ''retracker.local''. Перенаправляя запросы к ''retracker.local'' на BTRT обеспечивается локальный ретрекинг.
+==== Использование данных "соседних" ретрекеров ====
+Локальный ретрекинг позволяет перераспределить трафик только внутри сети оператора и обеспечивает уменьшения объемов трафика во внешние сети только за счет клиентов оператора. Часто у оператора существуют договорные отношения с партнерами, которые подразумевают пониженную стоимость трафика в сетях партнеров. Если в сети партнера запущен ретрекер, то использование пиров, зарегистрированных на этом ретрекере позволяет уменьшить объемы трафика во внешних сетях.
+BTRT при обработке //announce//-запросов обеспечивает возможность использовать не только данные о локальных пирах, но и запрашивать информацию с ретрекеров, работающих в сетях партнеров. В ответе на //announce//-запрос BitTorrent-клиенту в этом случае посылается IP-адреса пиров зарегистрированных как в сети оператора, так и в сетях партнеров, в результате происходит перераспределение трафика генерируемого BitTorrent-клиентами.
+==== Обработка запросов к сторонним трекерам ====
+BTRT обеспечивает обработку //forwarded_announce//-запросов, генерируемых DPI-платформой. Под //forwarded_announce//-запросами понимаются //announce//-запросы к сторонним BitTorrent-трекерам, которые перехватываются DPI-платформой и перенаправляются на BTRT.
+При обработке //forwarded_announce//-запроса BTRT при необходимости обращается к стороннему трекеру за списком пиров, но в ответе BitTorrent-клиенту формируется список пиров в соответствии с приоритетами пиров, заданными в конфигурации (локальные пиры, пиры партнеров, прочие). Таким образом при достаточном количестве пиров в сети оператора и его партнеров, возможно существенно ограничить пропускную способность при работе со сторонними пирами, тем самым перераспределить трафик в сторону увеличения внутрисетевого трафика.
+===== Установка =====
+Для первоначальной установки приложения необходимо выполнить установку пакета и зависимых модулей при помощи команды:
+<code bash>
+sudo yum install btrt
+</code>
+BTRT при работе использует БД MySQL. Для выполнения дальнейших действий по установке необходимо запустить сервис **mysqld**:
+<code bash>
+sudo service mysqld start
+</code>
+Перед первым запуском BTRT необходимо создать пользователя (или использовать существующего) и схему в БД MySQL.
+Рекомендуется создавать отдельного пользователя MySQL для работы BTRT. Чтобы сделать это, необходимо подключиться к серверу MySQL c правами суперпользователя:
+<code bash>
+mysql -hlocalhost -uroot -p
+</code>
+и выполнить команды создания пользователя и схемы, указав пароль пользователя:
+<code mysql>
+CREATE USER 'btrt'@'localhost' IDENTIFIED BY 'password_for_btrt_user';
+CREATE DATABASE btrt;
+GRANT ALL PRIVILEGES ON btrt.* TO 'btrt'@'localhost';
+</code>
+После того, как пользователь будет создан, необходимо завершить привилегированный сеанс MySQL, нажав сочетание клавиш **Ctrl-D**.
+Создать объекты в схеме данных для BTRT, указав имя и пароль ранее созданного пользователя MySQL:
+<code bash>
+mysql -hlocalhost -ubtrt -p < /etc/btrt/btrt.db_creation.sql
+</code>
+Перед первым запуском необходимо создать файл конфигурации //__/etc/btrt/btrt.conf__// на основе шаблон конфигурации //__/etc/btrt/btrt.conf.default__//. Более подробно о конфигурации написано [[#Конфигурация|здесь]].
+===== Обновление =====
+Для обновления ранее установленного приложения необходимо в первую очередь остановить сервис трекера:
+<code bash>
+sudo service btrt stop
+</code>
+установить обновленный пакет:
+<code bash>
+sudo yum update btrt
+</code>
+При обновлении с версии ниже 2.1 необходимо выполнить обновление структуры БД:
+<code bash>
+mysql -hlocalhost -ubtrt -p < /etc/btrt/btrt.db_upgrade_2.1.0.sql
+</code>
+Так как при переходе от версии к версии возможны изменения в [[#Конфигурация|конфигурации]] необходимо проверить ее корректность, а после запустить сервис трекера:
+<code bash>
+sudo service btrt start
+</code>
+===== Конфигурация =====
+Основным файлом конфигурации является файл //__/etc/btrt/btrt.conf__//. Конфигурация в этом файле задается в формате [[https://ru.wikipedia.org/wiki/YAML|YAML]].
+==== Формат YAML ====
+Базовыми элементами формата [[https://ru.wikipedia.org/wiki/YAML|YAML]] являются:
+  * пара "Ключ-Значение", например:\\ ''level: "info"''\\
+  * последовательность значений, например:\\ ''- "127.0.0.0/8"''\\ ''- "192.168.0.0/16"''
+На основе базовых элементов возможно создавать сложные структуры данных.
+Одним из принципов для описания сложных структур заложенных в формат [[https://ru.wikipedia.org/wiki/YAML|YAML]] является правило форматирования вложенных элементов при помощи отступов от начала строки. Элементы лежащие на одном уровне иерархии должны иметь одинаковое количество ведущих пробелов, например, следующий текст:
+<code bash>
+#
+# Logging parameters
+logging:
+    path:           "/var/log/btrt"     # Path to log files, default: /var/log/btrt
+    level:          "info"              # Possible levels are:
+                                        #   critical, error, warning, info, diagnostic, debug
+                                        # default logging level is "info"
+    switch_time:    "01:00:00"          # Log switching time in format "HH:MI:SS", default: "01:00:00"
+</code>
+можно трактовать как структуру данных ''logging'', у которой есть три поля - ''path'', ''level'', ''switch_time''.
+Учитывая выше сказанное, главным правилом при редактировании документов в формате [[https://ru.wikipedia.org/wiki/YAML|YAML]] является **__использование определенного количества пробельных символов для формирования отступов вместо символов табуляции__**.
+==== Основной файл конфигурации /etc/btrt/btrt.conf ====
+Основной файл конфигурации содержит описание большинства параметров используемых при работе BTRT. Первоначально при установке пакета создается файл шаблона конфигурации //__/etc/btrt/btrt.conf.default__//, который содержит описание всех параметров с комментариями и который может использоваться для создания реальной конфигурации.
+Для создания рабочей конфигурации минимально необходимо выполнить модификацию следующих параметров:
+Описание подключения к БД MySQL:
+<code bash>
+database:
+    url:        "tcp://127.0.0.1:3306"  # URL for connection to MySQL, default: "tcp://127.0.0.1:3306"
+    user:       "root"                  # User name, default: "root"
+    password:   "root"                  # Password
+    schema:     "btrt"                  # Schema name, default: "btrt"
+</code>
+Описание групп диапазонов IP адресов:
+<code bash>
+    peer_groups:
+        # It is useful to have definition for peers in local network.
+        # It can be used when peer from the local network is registered on non-local tracker (neighbor, forwarded tracker)
+        -   name:       "local peers"
+            priority:   0
+            cidr_file:  "/etc/btrt/local_cidrs.conf"
+            cidr_list:
+                -
+        # neighboring peers is used to identifying range of IP-addresses of peers connected to neighboring trackers
+        -   name:       "neighboring peers"
+            priority:   1
+            cidr_file:  "/etc/btrt/neighboring_cidrs.conf"
+            cidr_list:
+                -
+</code>
+Описание параметров "соседних" трекеров:
+<code bash>
+    neighbors:
+        -   name:                   "the nearest retracker"
+            refresh_interval:       1800
+            peers_expiry_interval:  7200
+            announce_request:       "http://retracker.mgts.by/announce?info_hash={info_hash}&peer_id=0123456789012345678A&port=6882&downloaded=0&uploaded=0&left=4194304&event=started&compact=1&numwant=1000"
+</code>
+===== Управление =====
+Основной исполняемый файл трекера - ''/usr/sbin/btrt''.\\ Для вывода встроенной подсказки необходимо выполнить следующую команду:
+<code bash>
+btrt help
+</code>
+Трекер разработан для работы в качестве сервиса. Для старта сервиса необходимо выполнить следующую команду:
+<code bash>
+sudo service btrt start
+</code>
+для остановки сервиса:
+<code bash>
+sudo service btrt stop
+</code>
+При работе трекера создаются журнальные файлы в соответствии с настройками в конфигурационном файле. По умолчанию журнальные файлы создаются в каталоге ''/var/log/btrt''.
+===== Вопросы и решения =====
+  * как часто обновляется hashlist.bin?\\
+crontab -l  - настроено обновление hashlist раз в 10 минут
+  * forwarded запросы скат генерит или он только hashlist.bin забирает и все?другими словами как заставить btrt сходить на соседний трекер за пирами.\\
+см.выше пункт - использование соседних ретрекеров\\
+в логе статистики скат появился раздел "Detailed statistics on BitTorrent"\\
+Первая цифра - сколько handshake обработано\\
+-я - сколько заблокировано в пользу локальных раздач

Аккаунт

Настройки

Различия