Repolode
提交项目
PBH-BTN

PBH-BTN/PeerBanHelper

自托管的 BT 反吸血工具，通过下载器 Web API 自动封禁吸血和异常的 Peer 连接。

在 GitHub 查看
Star
6,350
Fork
155
未关闭 Issue
12
最近提交
3天前

这是什么？

PeerBanHelper 是一款面向 BT 用户的开源个人网络防火墙。它通过支持的下载器 Web API 读取当前所有 Peer 连接，识别疑似吸血或存在安全风险的连接，并通知下载器主动断开。

支持 qBittorrent 4.5.0 及以上、Transmission 4.1.0-beta2 及以上、BitComet v2.18 及以上，BiglyBT 和 Deluge 需安装对应插件。Docker 部署必须使用 host 网络模式，否则无法获取 Peer 真实 IP。I2P 和 Tor 连接会被忽略。

封禁能力由多个模块组成：按 Peer ID、客户端名称、IP、GeoIP 和 IP 类型的黑名单，虚假进度检查，自动连锁封禁，多拨追踪，基于表达式引擎的伪装检查，以及规则订阅。Web 界面可查看当前封禁列表、历史记录、封禁最频繁的 IP、统计图表和 Peer 列表。

核心功能

  • 01按 Peer ID、客户端名称、IP、GeoIP 位置或 IP 类型封禁
  • 02通过启发式检查识别虚假进度的客户端
  • 03自动连锁封禁 IP 段并追踪多拨 Peer
  • 04支持自定义表达式规则和云端规则订阅
  • 05提供封禁列表、历史记录、统计和图表的 Web 界面

适用场景

  • 为运行 qBittorrent 或 Transmission 的 seedbox 或家庭服务器屏蔽吸血客户端
  • 在私有 Tracker 上减少因吸血造成的上传浪费
  • 按国家、网络或数据中心类型封禁特定 Peer

快速上手

  1. 1

    打开 README 中链接的安装文档

使用前须知

  • 需要支持的 BT 客户端并开启其 Web API，例如 qBittorrent 4.5.0 或更高版本、Transmission 4.1.0-beta2 或更高版本、BitComet v2.18 或更高版本。
  • 安装在 Docker 中的下载器必须使用 host 网络驱动，不能使用 bridge 模式。
  • 仅支持 IPv4 和 IPv6 对等连接，I2P 和 Tor 连接会被忽略。
  • 采用 GPL-3.0 许可证，属于 Copyleft 许可证。

标签

#bittorrent#peer-blocking#firewall#qbittorrent#transmission#self-hosted#geoip#biglybt#bitcomet#deluge

常见问题

PeerBanHelper 是什么？
自托管的 BT 反吸血工具，通过下载器 Web API 自动封禁吸血和异常的 Peer 连接。 PeerBanHelper 是一款面向 BT 用户的开源个人网络防火墙。它通过支持的下载器 Web API 读取当前所有 Peer 连接，识别疑似吸血或存在安全风险的连接，并通知下载器主动断开。
PeerBanHelper 可以免费使用吗？用的什么许可证？
PeerBanHelper 以 GPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。
PeerBanHelper 还在维护吗？
活跃维护中。PeerBanHelper 最近一次提交是在 2026年10月18日。
PeerBanHelper 适合用来做什么？
为运行 qBittorrent 或 Transmission 的 seedbox 或家庭服务器屏蔽吸血客户端 在私有 Tracker 上减少因吸血造成的上传浪费 按国家、网络或数据中心类型封禁特定 Peer
PeerBanHelper 怎么安装和运行？
打开 README 中链接的安装文档
在哪里获取 PeerBanHelper？
源代码和安装说明在 GitHub 上：https://github.com/PBH-BTN/PeerBanHelper

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目