Repolode
PBH-BTN

PBH-BTN/PeerBanHelper

Самостоятельно размещаемый сетевой экран, который обнаруживает и блокирует нежелательных, скачивающих без отдачи и аномальных BitTorrent-пиров через Web API qBittorrent, Transmission, Deluge и других клиентов.

Звёзды
6,350
Форки
155
Открытые issues
12
Последний коммит
3 дня назад

Что это?

PeerBanHelper — сетевой экран с открытым исходным кодом для пользователей BitTorrent. Он подключается к Web API поддерживаемых клиентов, получает список текущих пиров, помечает тех, кто похож на скачивающих без отдачи или представляет угрозу безопасности, и просит клиент отключить их.

Поддерживаются qBittorrent (начиная с версии 4.5.0), Transmission (начиная с 4.1.0-beta2), BiglyBT и Deluge через плагины, а также BitComet версии 2.18 и новее. Для развёртывания в Docker необходимо использовать сетевой драйвер host, чтобы клиент видел настоящие IP-адреса пиров. Подключения через I2P и Tor игнорируются.

Обнаружение угроз организовано в виде модулей: чёрные списки по peer ID, имени клиента, IP-адресу, GeoIP и типу IP; детектор накрутки прогресса; автоматическая блокировка диапазонов; отслеживание множественных подключений; движок сценариев для проверки подмены имени клиента и peer ID; подписки на правила. Веб-интерфейс показывает активные блокировки, историю, IP-адреса нарушителей с наибольшим числом блокировок, графики и список пиров.

Ключевые возможности

  • 01Блокирует пиров по peer ID, имени клиента, IP-адресу, местоположению GeoIP или типу IP
  • 02Обнаруживает поддельный прогресс скачивания с помощью эвристического детектора накрутки
  • 03Автоматически блокирует связанные диапазоны IP и отслеживает пиров с множественными подключениями
  • 04Поддерживает пользовательские правила на основе выражений и облачные подписки на правила
  • 05Включает веб-интерфейс со списками блокировок, историей, статистикой и графиками

Сценарии использования

  • Защита seedbox или домашнего сервера с qBittorrent или Transmission от клиентов, которые скачивают без отдачи
  • Сокращение бесполезной отдачи на приватных трекерах со строгими правилами соотношения скачанного и отданного
  • Блокировка пиров из определённых стран, сетей или дата-центров

Быстрый старт

  1. 1

    Откройте документацию по установке, ссылка на которую приведена в README

Что важно знать

  • Требуется совместимый BitTorrent-клиент с включённым Web API, например qBittorrent 4.5.0 или новее, Transmission 4.1.0-beta2 или новее либо BitComet v2.18 или новее.
  • Клиенты, установленные в Docker, должны использовать сетевой драйвер host, а не режим bridge.
  • Обрабатываются только IPv4- и IPv6-пиры; подключения I2P и Tor игнорируются.
  • Лицензировано по GPL-3.0 — лицензии с авторским левом.

Темы

Частые вопросы

Что такое PeerBanHelper?
Самостоятельно размещаемый сетевой экран, который обнаруживает и блокирует нежелательных, скачивающих без отдачи и аномальных BitTorrent-пиров через Web API qBittorrent, Transmission, Deluge и других клиентов. PeerBanHelper — сетевой экран с открытым исходным кодом для пользователей BitTorrent. Он подключается к Web API поддерживаемых клиентов, получает список текущих пиров, помечает тех, кто похож на скачивающих без отдачи или представляет угрозу безопасности, и просит клиент отключить их.
PeerBanHelper можно использовать бесплатно? Какая у него лицензия?
PeerBanHelper распространяется с открытым исходным кодом под лицензией GPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
PeerBanHelper всё ещё поддерживается?
Активно поддерживается. Последний коммит в PeerBanHelper — 18 окт. 2026 г..
Для чего можно использовать PeerBanHelper?
Защита seedbox или домашнего сервера с qBittorrent или Transmission от клиентов, которые скачивают без отдачи Сокращение бесполезной отдачи на приватных трекерах со строгими правилами соотношения скачанного и отданного Блокировка пиров из определённых стран, сетей или дата-центров
Как установить PeerBanHelper?
Откройте документацию по установке, ссылка на которую приведена в README
Где скачать PeerBanHelper?
Исходный код и инструкции по установке — на GitHub: https://github.com/PBH-BTN/PeerBanHelper

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты