技术指南

反PCDN吸血工具

反PCDN吸血工具 - 自动封禁不受欢迎、吸血和异常的 BT 客户端

PeerBanHelper 文档：https://docs.pbh-btn.com Github：https://github.com/PBH-BTN/pbh-docs 自动封禁不受欢迎、吸血和异常的 BT 客户端，并支持自定义规则。PeerId黑名单/UserAgent黑名单/IP CIDR/假进度/超量下载/进度回退/多播追猎/连锁封禁/伪装检测支持 qBittorrent/Deluge/BiglyBT/Vuze(Azureus)/BitComet transmission-block Github：https://github.com/qianbinbin/transmission-block

安装及使用教程-PeerBanHelper

使用 Docker 部署

使用 Docker Compose 部署

services:
  peerbanhelper:
    image: ghostchu/peerbanhelper:latest
    restart: unless-stopped
    container_name: "peerbanhelper"
    volumes:
      - ./:/app/data #对应修改为存储目录 例如 - /volume1/Docker/peerbanhelper/:/app/data
    ports:
      - "9898:9898" #可自行修改所需端口号
    environment:
      - PUID=0
      - PGID=0
      - TZ=UTC

使用 Docker CLI 部署

docker run -d \
   --name PeerBanHelper \
   --restart unless-stopped \
   --stop-timeout 30 \
   -p 9898:9898 \
   -v ${PWD}/:/app/data/ \
   -e PUID=0 \
   -e PGID=0 \
   -e TZ=UTC \
   ghostchu/peerbanhelper:latest

其他方式可见 https://docs.pbh-btn.com/docs/intro

cleanshot_2025-05-04_at_21.41.05@2x.png

简单使用教程

详细教程见文档

下载器添加方式（qbittorrent）

1.预先准备：打开qbittorrent高级设置找到 “解析用户主机名”，取消勾选找到 “允许来自同一 IP 地址的多个连接”，取消勾选

在 v7.2.0 及以上版本，下载器连接到 PBH 时，PBH 会自动关闭“允许来自同一 IP 地址的多个连接”选项，如果你使用的版本正确，则无需手动配置此选项。

2.添加下载器：打开添加下载器窗口顶部下载器类型，选择 “qBittorrent” 名称可随意填写，唯一的要求是不要带有英文句号（.）地址部分，填写 7474 是你上面设置的端口号。填写地址时，特别注意不要以 / 结尾用户名为上面设置 “验证” 时，填写的用户名密码为上面设置 “验证” 时，填写的密码点击确定，提示成功即添加成功

连接BTN 威胁防护网络

Sparkle 是 PBH-BTN 的官方 BTN 服务器什么是BTN
1.注册账号，创建 UserApp
浏览器打开 https://btn-prod.ghostchu-services.top 并使用 GitHub 授权登录，就会自动创建一个账号。点击顶部菜单的 “用户应用程序” 链接来到管理页面。点击 “创建新用户应用程序”，输入一个备注，然后点击按钮创建。 2.在 PBH 上加入 BTN 网络转到设置 -> 基础设置选项。向下滑动找到 BTN 设置，打开 “启用 BTN 模块”，并填写刚刚在上面获取的 AppID 和 App Secret：滚动到底部，点击“保存”按钮，然后重启 PeerBanHelper 使其生效。

效果展示

cleanshot_2025-05-04_at_21.57.16@2x.png

安装及使用教程-transmission-block

tr设置

启用远程访问；设置用户名和密码（可选）。启用黑名单，并设置为 http://127.0.0.1:9098/blocklist.p2p.gz。

修改密码建议在 daemon 关闭状态下，因为密码会在启动后加盐哈希。如不使用默认 HTTP 监听地址（见配置文件中的 BL_SERVER），则 "blocklist-url" 要相应修改。如果 daemon 正在运行，使用 systemctl reload transmission-daemon.service 重新加载配置，直接重启不会生效。

安装教程-自动运行（systemd）

下载脚本及配置文件，以 root 权限运行：

chmod 700 /usr/local/etc/transmission-block
curl https://raw.githubusercontent.com/qianbinbin/transmission-block/master/transmission-block.sh \
  -o /usr/local/bin/transmission-block \
  https://raw.githubusercontent.com/qianbinbin/transmission-block/master/transmission-block.service \
  -o /usr/local/lib/systemd/system/transmission-block.service \
  https://raw.githubusercontent.com/qianbinbin/transmission-block/master/transmission-block.conf \
  -o /usr/local/etc/transmission-block/transmission-block.conf
chmod +x /usr/local/bin/transmission-block
systemctl daemon-reload

如果启用了用户验证，在 /usr/local/etc/transmission-block/transmission-block.conf 中设置 TR_AUTH 用户名和密码。其余均为可选参数，用法由注释给出。

使用Tips

更多可选参数详见Github项目

推荐启用 BTN-Collected-Rules 黑名单在/usr/local/etc/transmission-block/transmission-block.conf进行更改 cleanshot_2025-05-04_at_22.07.10@2x.png

EXTERNAL_BL=https://raw.githubusercontent.com/qianbinbin/transmission-block/blocklist/btn-all.p2p
## 更新较为频繁
RENEW_INTERVAL=1h

更新tracker

如何使用auto_feed辅助转种