Releases: PBH-BTN/PeerBanHelper
v9.2.5
错误修复
- 修复超小种子文件（整体体积小于 1 个 Piece 的大小）由于对齐导致下载器额外上传空字节数据，误触发超量下载检测的问题 @Ghost-chu @paulzzh
- 修复部分 Windows 设备上由于 EcoQos API 初始化失败导致启动失败的问题 @Ghost-chu
- 修复部分 Windows Server 或精简、企业版（LTSC） Windows 的设备上，由于 AMSI 组件缺失引发初始化失败、用户脚本加载失败的问题 @Ghost-chu
- [Demo Mode] 修复演示模式下，BTN KeepAlive 没有隐藏设备出口 IP 地址的问题 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.2.5
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.2.5
Contributors
Assets 21
- 300 KB
2026-01-15T05:10:43Z - 65.4 MB
2026-01-15T05:10:43Z - 65.4 MB
2026-01-15T05:10:48Z - 138 KB
2026-01-15T05:10:52Z - 67.7 MB
2026-01-15T05:09:31Z - 65.4 MB
2026-01-15T05:10:39Z - 1.71 GB
2026-01-15T05:10:55Z - 123 MB
2026-01-15T05:09:34Z - 124 MB
2026-01-15T05:09:39Z - 125 MB
2026-01-15T05:09:45Z -
2026-01-15T04:56:56Z -
2026-01-15T04:56:56Z - Loading
v9.2.4
下载器兼容性
- 新增对 BitComet v2.20 Beta2 [20260107] 新增字节级流量统计数据 API 的支持，现在支持在 BitComet v2.20 Beta2 [20260107] 或更高版本上进行流量统计 @Ghost-chu
- [实验性] 新增对 BitComet v2.20 Beta2 [20260107] 的种子列表翻页 API 的支持 @Ghost-chu
- PBH-BiglyBT-Adapter 扩展已更新至 v2.0.2 版本，以添加对 BiglyBT 的 Peer Flags 解析支持，可在连接统计模块中显示 BiglyBT 上的连接标志信息 @Ghost-chu @paulzzh
- 进一步改进对 Transmission 的实验性支持，解决当封禁列表为空时，发送给 Transmission 的响应被忽略的问题 @Ghost-chu
新功能
- [BTN 能力] 在 BTNv2 上实现曾包含在 BTNv1 的 Swarm 传输速率跟踪功能 @Ghost-chu
- Portable 包新增 nojava 版本 @WordlessEcho
- Portable 包支持 Java 版本检测 @WordlessEcho
- 在支持安全扫描的平台上，PeerBanHelper 会在加载或下载任何插件、脚本前，预先进行反病毒安全扫描以增强安全性 @Ghost-chu
- 在 Windows 平台上，使用 AMSI 调用安装的反病毒软件或 Windows Defender。对于无安全保护或不支持 AMSI 的计算机，将跳过扫描步骤
优化改进
- [WebUI] 对活动种子和封禁日志界面使用响应式设计 @whuangbh @Gaojianli
错误修复
- [WebUI] 修复因浏览器安全策略更改导致 AvaitorScript 编辑器无法再从 CDN 加载的问题 @Gaojianli
- [WebAPI] 修复 BTN 拒绝列表版本描述和悬浮显示信息不一致的问题 @paulzzh
- [WebUI] 修复通过 WebUI 保存 AvaitorScript 脚本时，每次点击确定按钮都会额外追加 .av 文件名后缀的问题 @Gaojianli
Docker
DockerHub: ghostchu/peerbanhelper:v9.2.4
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.2.4
Contributors
Assets 21
v9.2.3
下载器兼容性
- 适配 BiglyBT 4.0.0 和 PeerBanHelper-BiglyBT-Adapter 2.0.0。使用新版本 BiglyBT 的用户请注意更新 BiglyBT 兼容插件 @Ghost-chu
错误修复
- 修复 GUI 通知区域右键托盘图标无法打开右键菜单的问题 @Ghost-chu
- 修复 BTN Heartbeat 在 PBH 启用代理服务器的情况下，仅报告了代理服务器出口 IP 地址的问题 @Ghost-chu
- 修复 BTN IP 查询模块中部分文本可能存在歧义的问题 @paulzzh @Ghost-chu
- 修复进行数据清理时，可能报告 SQL 查询错误 [SQLITE_TOOBIG] String or BLOB exceeds size limit (statement too long) 的问题 @Ghost-chu
- 修复当 IP 输入框中 IP 地址变动时，BTN IP 查询模块会在不点击查询按钮的情况下更新内容的问题 @Gaojianli
更改
- 添加 Sukka IP 查询快捷按钮 @Gaojianli
- 更新 WebUI 英语本地化内容 @CreeperAWA
Docker
DockerHub: ghostchu/peerbanhelper:v9.2.3
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.2.3
Contributors
Assets 20
v9.2.2
优化
- 优化 BTN 查询模块中可能存在歧义的文本 @paulzzh
错误修复
- 当用户 DNS （或者链路上的路由对 DNS 查询结果做出修改时）不返回双栈 IP 结果时，报告 No matching IPv6/IPv4 addresses found for... 的警告信息的问题 @Ghost-chu
- 现在将静默忽略此类消息
Docker
DockerHub: ghostchu/peerbanhelper:v9.2.2
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.2.2
Contributors
Assets 20
v9.2.1
错误修复
- 修复部分情况下，BTN 提交数据因旧数据缺失必要字段而失败的问题 @Ghost-chu
- 修复 OOBE 的 BTN 设置不起作用的问题 @Gaojianli
Docker
DockerHub: ghostchu/peerbanhelper:v9.2.1
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.2.1
Contributors
Assets 20
v9.2.0
Note
此版本发布后，BTN 服务器协议版本将升级到 BTN v3.0。旧版本 PeerBanHelper 将无法再连接到 BTN 服务器同步、提交和获取数据。请注意及时更新 PeerBanHelper 版本。
新功能
OOBE 改进
对开箱即用体验进行了改进，现在将引导新用户更好的配置下载器和 BTN 功能。
自动寻找本机网络上的下载器 WebUI
改进了下载器配置流程，以便降低新手用户的初始配置难度。现在 PeerBanHelper 能够扫描本机网络上的可用下载器 WebUI 端口，并自动识别下载器类型、主机名、端口号，并自动填充相关信息到表单中。
目前支持下列类型的下载器识别：
- qBittorrent
- Transmission
- BitComet
- BiglyBT
受技术限制，只有 PeerBanHelper 和下载器在同设备相同网络下才能识别。如下载器创建于容器中且非 host 网络驱动，则可能无法识别。
使用此功能前，需要先启用下载器的 WebUI。
BTN 网络 3.0
本次更新包含了对 BTN 3.0 的协议支持。并新增了以下能力：
Sync Swarm
将 PeerBanHelper 所连接的下载器上的活动任务种群信息与 BTN 服务器同步。其它 BTN 用户可以查看指定 IP 地址上的 活动数据。
该能力将为 BTN 的过量下载，查询 IP 并发下载数、做种数、历史连接信息，总流量统计等功能提供数据支持。
IP Query
该能力为用户提供 IP 查询的 BTN 数据功能，支持查询 BTN 网络提供的 IP 标签、封禁计数和封禁的详细数据、种群跟踪数量及跟踪的详细数据、正在下载计数、正在做种计数、上传流量、下载流量、分享率和种子访问数量。
您可以使用此功能主动查询 IP 信息，以便检查目标 IP 是否可能是潜在的恶意 Peer。
后续该功能将跟随 BTN 的持续改进而提供更多查询能力。
IPDenyList
接替原先的云端规则（Rules）中的 IP 部分。以一种内存使用率更低、速度更快、更加灵活的方式传递大量 IP 黑名单数据，而无需担心内存耗尽的问题。
位于该名单中的 IP 将被自动封禁。
IPAllowList
解析原先的例外规则中的 IP 部分，以一种内存使用率更低、速度更快、更加灵活的方式传递大量 IP 白名单数据，而无需担心内存耗尽的问题。
位于此名单中的 IP 将不会被封禁，已处于封禁状态的 IP 将会解除封禁。
自动注册 UserApp
新增 UserApp 自动注册功能，在 BTN 服务器侧支持的情况下，PBH 会携带自己的唯一安装 ID 向服务器发起请求。服务器将自动使用此信息关联和创建 UserApp 以便处理数据。免去新手用户注册和关键 Github 账号的繁琐流程。
如果可能的情况下，仍然推荐前往 BTN 上手动注册，以便后续更方便的管理。
改进
- 现在 BTN 缓存数据将不以文件形式保存，而是存储在 PeerBanHelper 的 SQLite 数据库中 @Ghost-chu
错误修复
- 修复在 WebUI 上启停模块需要重新启动 PeerBanHelper 才会生效的问题 @Ghost-chu
- 修复部分模块配置调整后，有关 Scheduler 定时任务的配置需要重新启动 PeerBanHelper 才会生效的问题 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper-snapshot:v9.2.0
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.2.0
Contributors
Assets 20
v9.2.0-beta1
Warning
此版本为测试版本，可能并不稳定或者存在严重问题。此版本仅用于高阶用户尝鲜和测试用途，请勿用于生产环境。使用测试版本前，请做好数据备份，测试版本数据不保证可平滑升级到稳定版本。普通用户请下载最新正式版。
Warning
请做好数据备份，一旦升级到此版本，将无法降级到稳定版。如需降级则必须从备份中还原所有文件。
Note
这是 BTN 3.0 测试版本。目前主服务器运行的 BTN 版本为 2.0，要测试该版本的 BTN 3.0 相关内容，请使用 BTN3 测试服务器，配置地址为：https://btn3-test.pbh-btn.com/ping/config。请注意：测试服务器的数据将在测试完毕后删除，届时请注意切换回正式服。
新功能
OOBE 改进
对开箱即用体验进行了改进，现在将引导新用户更好的配置下载器和 BTN 功能。
自动寻找本机网络上的下载器 WebUI
改进了下载器配置流程，以便降低新手用户的初始配置难度。现在 PeerBanHelper 能够扫描本机网络上的可用下载器 WebUI 端口，并自动识别下载器类型、主机名、端口号，并自动填充相关信息到表单中。
目前支持下列类型的下载器识别：
- qBittorrent
- Transmission
- BitComet
- BiglyBT
受技术限制，只有 PeerBanHelper 和下载器在同设备相同网络下才能识别。如下载器创建于容器中且非 host 网络驱动，则可能无法识别。
使用此功能前，需要先启用下载器的 WebUI。
BTN 网络 3.0
本次更新包含了对 BTN 3.0 的协议支持。并新增了以下能力：
Sync Swarm
将 PeerBanHelper 所连接的下载器上的活动任务种群信息与 BTN 服务器同步。其它 BTN 用户可以查看指定 IP 地址上的 活动数据。
该能力将为 BTN 的过量下载，查询 IP 并发下载数、做种数、历史连接信息，总流量统计等功能提供数据支持。
IP Query
该能力为用户提供 IP 查询的 BTN 数据功能，支持查询 BTN 网络提供的 IP 标签、封禁计数和封禁的详细数据、种群跟踪数量及跟踪的详细数据、正在下载计数、正在做种计数、上传流量、下载流量、分享率和种子访问数量。
您可以使用此功能主动查询 IP 信息，以便检查目标 IP 是否可能是潜在的恶意 Peer。
Heartbeat (Multi-IF)
该能力允许 BTN 获取您的外部 IP 地址，以便为您的 IP 自动添加 “BTN 用户” 标签。并在计算威胁数据时修改权重。
IPDenyList
接替原先的云端规则（Rules）中的 IP 部分。以一种内存使用率更低、速度更快、更加灵活的方式传递大量 IP 黑名单数据，而无需担心内存耗尽的问题。
位于该名单中的 IP 将被自动封禁。
IPAllowList
解析原先的例外规则中的 IP 部分，以一种内存使用率更低、速度更快、更加灵活的方式传递大量 IP 白名单数据，而无需担心内存耗尽的问题。
位于此名单中的 IP 将不会被封禁，已处于封禁状态的 IP 将会解除封禁。
自动注册 UserApp
新增 UserApp 自动注册功能，在 BTN 服务器侧支持的情况下，PBH 会携带自己的唯一安装 ID 向服务器发起请求。服务器将自动使用此信息关联和创建 UserApp 以便处理数据。免去新手用户注册 Github 账号的繁琐流程。
如果可能的情况下，仍然推荐前往 BTN 上手动注册，以便后续更方便的管理。
改进
- 现在 BTN 缓存数据将不以文件形式保存，而是存储在 PeerBanHelper 的 SQLite 数据库中 @Ghost-chu
错误修复
- 修复在 WebUI 上启停模块需要重新启动 PeerBanHelper 才会生效的问题 @Ghost-chu
- 修复部分模块配置调整后，有关 Scheduler 定时任务的配置需要重新启动 PeerBanHelper 才会生效的问题 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper-snapshot:v9.2.0-beta1
阿里云国内镜像加速: 测试版本不提供国内镜像加速源
Contributors
Assets 20
v9.1.5
重要性能改进
- 为会话统计与分析服务、Peer Swarm 记录服务、Peer 跟踪记录服务的添加和改善内存缓存机制，以大幅减少磁盘写入量和磁盘 I/O @Ghost-chu
- 此更改约能减少 >80% 的磁盘写入和 >50% 的磁盘读取，强烈建议 SSD 和 EMMC/SD 卡用户和重度用户更新，以便减少长期运行时对闪存寿命的影响
变更
- 连接下载器时现在允许通过
pbh.downloader.bypassproxy=false参数取消强制直连，允许访问下载器 API 时通过代理服务器 @Ghost-chu - 由于一直持续有用户反馈在史前版本(v4.1.x, v3.x)的 qBittorrent 上无法使用 PeerBanHelper 的问题（特别是在更新后出现无法使用），请注意：PeerBanHelper 自 v1.0 起就要求 qBittorrent 版本必须大于等于 4.5.0。使用老旧版本 qBittorrent 一直不受支持，一旦新版本 PBH 使用了新版 QB 的 API ，则功能可能会被破坏。此版本起为 qBittorrent 下载器添加了版本检查，您需要更新到最低 4.5.0 版本的 qBittorrent。 @Ghost-chu
错误修复
- 演示模式下游客可以更新 IP 地址规则订阅 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.1.5
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.1.5
Contributors
Assets 20
v9.1.4
错误修复
- 修复使用 Transmission 下载器时可能报告空指针错误的问题 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.1.4
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.1.4
Contributors
Assets 20
v9.1.3
错误修复
- 修复 qBittorrent 下载器可能报告 pieces 为 null 值的空指针错误 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.1.3
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.1.3