Linux 下部署 PeerBanHelper（Java 25 + systemd）

本文记录在 Linux 下部署独立的 Java 25 运行时与 PeerBanHelper 服务，对接 qBittorrent 自动阻断吸血 Peer。

1. 部署独立的 JDK 25 运行环境#

采用绿色免安装版将 JDK 部署在 /opt/java25，避免对系统的全局环境造成冲突。

1
# 新增隔离目录
2
sudo mkdir -p /opt/java25
3

4
# 获取最新的 JDK 25 Linux x64 二进制包并解压
5
wget -O jdk25.tar.gz "https://api.adoptium.net/v3/binary/latest/25/ga/linux/x64/jdk/hotspot/normal/eclipse"
6
sudo tar -xzf jdk25.tar.gz -C /opt/java25 --strip-components=1 && rm jdk25.tar.gz

确认安装状态：

1
/opt/java25/bin/java -version

2. 部署 PeerBanHelper#

下载并安装包到普通用户的家目录内，实现权限隔离：

1
mkdir -p ~/seedbox/config/pbh && cd ~/seedbox/config/pbh
2

3
# 下载指定发布包（以 v9.3.14 为例）
4
wget https://github.com/PBH-BTN/PeerBanHelper/releases/download/v9.3.14/PeerBanHelper_9.3.14.zip
5

6
# 安装解压工具并处理包
7
sudo apt update && sudo apt install unzip -y
8
unzip PeerBanHelper_9.3.14.zip && rm PeerBanHelper_9.3.14.zip

3. 配置 Systemd 守护服务#

新建配置 /etc/systemd/system/peerbanhelper.service：

1
[Unit]
2
Description=PeerBanHelper Daemon
3
After=network.target
4

5
[Service]
6
Type=simple
7
User=your_username
8
Group=your_username
9
WorkingDirectory=/home/your_username/seedbox/config/pbh/PeerBanHelper
10
ExecStart=/opt/java25/bin/java -jar /home/your_username/seedbox/config/pbh/PeerBanHelper/PeerBanHelper.jar
11
Restart=on-failure
12
LimitNOFILE=65536
13

14
[Install]
15
WantedBy=multi-user.target

注：请将配置中的 User、Group 及目录修改为实际的运行普通用户与对应绝对路径。

载入系统服务并启动运行：

1
sudo systemctl daemon-reload
2
sudo systemctl enable --now peerbanhelper

4. 仪表盘配置与客户端联动#

服务启动后默认监听本地 9898 端口。

4.1 提取初始化 Token#

1
sudo journalctl -u peerbanhelper | grep -i token

复制输出的临时 Token 登录后台面板。

4.2 关联 qBittorrent#

在控制台的“连接下载器”配置中填入：

类型：选择 qBittorrent 或 qBittorrentEE。
地址：如果为同机部署，输入 http://127.0.0.1:8080。
账号/密码：输入对应的 WebUI 登录凭据。

4.3 配置代理前缀#

如果使用反向代理域名（如 https://pbh.yourdomain.com）连接服务：前往设置 -> 基础设置 -> WebUI。将 反向代理前缀 (Prefix) 修正为实际域名，否则回传给下载器的封禁数据会使用本地环回地址导致同步失败。

5. 日志与屏蔽地区规则设置#

日志期限：建议在设置中调整封禁日志保留时长至 15天 或 30天 以节省磁盘空间。
CN 地区屏蔽：如遇极端流量占用，可在设置 -> 规则订阅 -> 地区中配置 CN 地区屏蔽规则。该规则可能会阻断部分正常的中文 Peer 连接，建议酌情选用。