PeerBanHelper BT 反吸血工具
PeerBanHelper 是一款开源的 BT 反吸血工具，通过连接 qBittorrent、Deluge、Transmission、BiglyBT、BitComet 等客户端的 Web API，自动识别并封禁吸血、异常和不受欢迎的 Peer，支持自定义规则与云端规则订阅。
爱鲜报评分
0 人评分
6.3k
星数
是
中文
Java
主语言
是
活跃
42
贡献者
人工分析
EDITORIAL推荐理由
对于长期做种、被吸血客户端拖慢上传效率的用户来说，PeerBanHelper 几乎是必备工具。它支持多种主流 BT 客户端，提供 PeerID、Client Name、IP/GeoIP、虚假进度等多维度封禁策略，并配有 WebUI 和活跃封禁统计。项目活跃度高、中文文档完善，社区维护的 BTN 规则库可进一步提升封禁效果。
适用场景
- 个人 NAS/家庭服务器上运行 qBittorrent 做种，防止吸血客户端占用上传带宽
- PT 站点用户维护分享率，自动封禁异常 Peer 与作弊客户端
- 多下载器（qBittorrent、Deluge、Transmission 等）统一管理与封禁
- 结合 GeoIP 与自定义规则，按地区、ASN、网络类型精细化封禁
- 通过 WebUI 查看封禁日志、统计图表与规则订阅状态
优点
- 支持 qBittorrent、Deluge、Transmission、BiglyBT、BitComet 等多种主流 BT 客户端
- 封禁维度丰富：PeerID、Client Name、IP/GeoIP、虚假进度、自动连锁封禁等
- 提供 WebUI，可查看活跃封禁名单、历史记录、Top 50 IP 与统计图表
- 支持自定义规则与云端规则订阅，可配合 BTN 规则库使用
- 中文文档与中文社区（QQ 群、Telegram）完善，对中文用户友好
缺点
- Docker 部署时下载器必须使用 host 网络模式，bridge 模式无法获取真实 Peer IP
- 部分客户端需额外安装插件（如 BiglyBT、Deluge），BitComet 不支持长效种子反吸血
- 仅支持传统 IPv4/IPv6，I2P 与 Tor 连接会被忽略
- 需要一定网络与 BT 客户端配置经验，规则调优不当可能误封
PeerBanHelper 是什么
PeerBanHelper 是一款开源的 BT 反吸血工具，可以把它理解成个人 BT 网络的「防火墙」。它通过连接下载器（如 qBittorrent、Deluge、Transmission、BiglyBT、BitComet）的 Web API 获取当前连接信息，识别其中可能存在吸血、作弊或异常行为的 Peer，并通知下载器主动断开这些连接。
项目使用 Java 编写，提供 WebUI 管理界面，并配有完善的中文文档与社区支持。
核心功能
- PeerID 黑名单：按客户端 PeerID 特征封禁
- Client Name 黑名单：按客户端名称封禁
- IP / GeoIP / IP 类型黑名单：按 IP、归属地、ASN、网络类型封禁
- 虚假进度检查器：启发式检测伪造进度的客户端
- 自动连锁封禁：对同一来源的多个 IP 自动扩大封禁范围
- 多拨追猎：识别并处理多拨 IP 的异常行为
- 伪装检查：借助 AviatorScript 引擎检测 Peer ID / Client Name 伪装
- 主动监测：本地数据分析，发现异常连接模式
- 网络 IP 集规则订阅：订阅云端规则，保持封禁策略更新
启动后 PeerBanHelper 会下载 GeoIP 库，从而支持查看 IP 归属地、AS 信息与网络类型，并可按国家/地区、城市、ASN 等条件封禁。
支持的客户端
| 客户端 | 版本要求 | 备注 |
|---|---|---|
| qBittorrent | 4.5.0+ | 不支持 XDown |
| BiglyBT | — | 需安装适配插件 |
| Deluge | — | 需安装适配插件 |
| Transmission | 4.1.0-beta2+ | — |
| BitComet | v2.18+ | 不支持 P2SP LTSeed 长效种子反吸血 |
Docker 中运行的下载器必须使用 host 网络模式，否则无法获取 Peer 的真实 IP。
使用建议
- 先阅读官方文档中的安装部署章节，按平台选择安装方式。
- 在 WebUI 中配置下载器连接信息，确认能正常获取 Peer 列表。
- 按需启用 PeerID、Client Name、IP 等封禁模块，并订阅规则集。
- 观察封禁日志与统计图表，逐步调整规则，避免误封正常用户。
配合社区维护的 BTN 规则库与 BTN 网络使用，可获得更好的反吸血效果，但这部分是可选的。
适用人群
- 长期做种、被吸血客户端拖慢上传的 BT 用户
- 使用 NAS 或家庭服务器运行下载器的用户
- 需要统一管理多个下载器封禁策略的进阶用户
注意事项
PeerBanHelper 只处理传统 IPv4/IPv6 连接，遇到 I2P 或 Tor 连接会主动忽略。使用前请确认下载器版本满足要求，并遵守项目声明中的使用条款。
评论
- 暂无评论，来写第一条吧。