PeerBanHelper: baixar versions anteriors

修复安全漏洞
- Orderable 查询可能传入 SQL 注入语句的问题 GHSA-vpxv-cm55-rwf7 @Ghost-chu 鸣谢：@tonghuaroot
新功能
- NAT64 地址支持 @Ghost-chu
- 目前默认支持 WKP 的 NAT64 地址。由于无法可靠探测某个网络是否为 NAT64 网络，因此如果您正在使用 NSP 的 NAT64 地址，请手动编辑配置文件。
- 新的 webhook 通知渠道 @gongfuture
错误修复
- 封禁列表重映射未正确处理 Teredo 地址 @Ghost-chu
- 修复在较新的 DSM 上，安装 PeerBanHelper 可能出现错误的问题 @Ghost-chu
开发者更改
- PeerAddress 现在包含新的 teredoClientIp 和 teredoClientUdpPort 字段，指示 Teredo 有关的 IP 元数据
- PeerAddress 的 nattedIp 和 nattedPort 除原 AutoSTUN 地址转换使用外，现在 NAT64 地址转换也将会更新这些字段。
- 现在规则检查模块无需为了转换 ::ffff: 地址进行刻意的 isIPv4Convertible 检查，PeerBanHelper 现在统一处理这些转换。这包括：Well-Knowned NAT64 地址(RFC-6146, RFC-6052)、Teredo 地址(RFC-4380, RFC-5991)、IPv4-mapped IPv6 地址(RFC-4291, RFC-4038)
Docker
DockerHub: ghostchu/peerbanhelper:v9.5.1
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.5.1

部署教程 | 常见问题 | 如何设置下载器 | PBH-BTN 论坛

新增功能
【实验性】Aria2Next 支持
@Ghost-chu @Gaojianli
本次更新添加了对 Aria2Next 下载器和 Motrix2Next 下载器（其使用 Aria2Next 内核）的实验性支持。
作为 Aria2 官方版本的分支，此版本继承了 Aria2 的许多优点。占用小，开销低，支持 HTTP 任务和 BitTorrent 混合下载。
然而，Aria2 (以及 Aria2Next) 并非专业 BitTorrent 下载器，仍然缺失了许多重要功能，且有一些 BitTorrent 协议规范仍未得到实现。如果您的主要目的是进行 BT 下载，使用传统的 qBittorrent、BitComet 等下载器仍是最佳方案。
本次添加的支持为实验性的，由于 Aria2 的灵活性，我们的测试难以覆盖到方方面面。因此在使用过程中请尽量避免一些非常规用法和配置（例如 listen-port 范围段等），这些设置明确不受支持。同时也请在使用过程中关注程序运行情况，我们对实验性质的功能稳定性不做保证。
对 Aria2Next 的兼容不代表已支持 Aria2 官方版或者其它 Aria2 分支，PeerBanHelper 对 Aria2Next 的支持是建立于大量 Aria2Next 专有 RPC 调用之上的。
要使用 Aria2Next，只需要将原版 Aria2 的二进制文件替换为 Aria2Next 的二进制文件即可，目前测试 AriaNg 等 WebUI/GUI 外壳仍然与 Aria2Next 兼容，无需做特别调整。
在此，感谢 @AnInsomniacy, @SnowCutieOwO 和 @dawn-lc，在共同合作下使得此下载器的兼容成为了可能。
与其他下载器相同，您可以通过 “添加下载器” 按钮，直接添加 Aria2Next 下载器。
暂不支持的功能
由于当前版本的技术限制，以下功能对 Aria2Next 类型的下载器暂不可用：
- 流量统计图表
- 主动监控
以下功能在未来也不会添加支持：
- ED2K/eMule 网络的反吸血支持（PeerBanHelper 专注于 BitTorrent 网络）
Teredo 支持
@Ghost-chu
本次更新新增对 IPV6 Teredo 隧道的支持，该功能默认关闭。使用此功能需要手动在配置文件中开启对应配置项，此配置不提供 WebUI 界面修改支持。
请注意：通过 Teredo 隧道传输 BitTorrent 流量是不道德的，PBH-BTN 不鼓励任何用户将 Teredo 隧道用于 BitTorrent 用途。
优化
- 减少 ProgressCheatBlocker 定时保存时的 I/O 数据量 @Ghost-chu
- 取消对非主流平台(仅保留 x86_64 和 arm64)的 epoll/kqueue/iouring 本地平台二进制文件的打包，缩减程序体积 @Ghost-chu
- 这些平台将回退普通的 select() 连接模型，预期性能不会出现非常明显的下降
错误修复
- 修复 MySQL/MariaDB/PostgreSQL/H2 用户遇到的 Flyway 迁移失败的问题 @paulzzh
- 修复发布文件中 .torrent 文件在 BitComet 上出现解析失败的问题 @paulzzh
- 修复当某个 IP 地址不在 GeoLite2/GeoCN 数据库其中之一时，整个查询返回失败空结果的问题 @Ghost-chu
- 修复 ProgressCheatBlocker 的首次出现日志记录数据在某些情况下可能因竟态条件导致后期被错误更新 @Ghost-chu
- 修复某些情况下 ProgressCheatBlocker 数据可能无法报错报告唯一键冲突的问题 @Ghost-chu @paulzzh
- 修复部分 Windows 设备上报告 oshi-ffm 错误，程序无法启动的问题 @paulzzh
其它更改
- 升级了依赖项版本，增强了整体安全性与稳定性 @paulzzh
-【BTN 网络】大幅改善 API 查询性能，恢复 IP 查询-BTN 数据的功能可用性 @Ghost-chu
-【BTN 网络】大幅改善 IP 信息聚合查询的性能 @Ghost-chu
-【BTN 网络】支持基于 GeoIP 的动态路由，改善中国移动运营商及福建省、江苏省、浙江省、四川省、重庆省、河南省、湖北省的用户 BTN 连通性 @Ghost-chu
-【基础设施】对基础设施进行例行维护，提升安全性稳定性和整体性能
-【BTN 规范】BTN 标准规范已得到更新，有关内容请参见：https://github.com/PBH-BTN/BTN-Spec
Docker
DockerHub: ghostchu/peerbanhelper:v9.5.0
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.5.0

部署教程 | 常见问题 | 如何设置下载器 | PBH-BTN 论坛

错误修复
- 修复使用非 SQLite 数据库类型时，升级到 v9.4.x 出现 Flyway 错误无法启动的问题 @paulzzh
- 修复 Windows 部分用户出现 oshi 异常无法启动 PBH 的问题 @paulzzh
Docker
DockerHub: ghostchu/peerbanhelper:v9.4.3
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.4.3

部署教程 | 常见问题 | 如何设置下载器 | PBH-BTN 论坛

更改
- [webui] 日志从 websocket 更换为 服务器发送事件 (SSE) @Ghost-chu @Gaojianli @paulzzh
- [webui] 禁止 OOBE 时选择高级数据库 @Ghost-chu
- 禁用了插件管理模块 @Ghost-chu
- 现在 pbh 的 bt 构建改为使用 torrenttools 以支持分块对齐 @paulzzh
- 更新了 flyway 和 install4j
错误修复
- 为数据库添加测试 修复了多个外部数据库问题 @paulzzh
- 调整调度器线程数量 避免在 cpu 核心较多时产生性能浪费 @Ghost-chu
- 修复多个 pcb 相关的唯一键并发冲突问题 @Ghost-chu
- autostun 默认禁用 io_uring 以避免问题 @paulzzh @Ghost-chu
- 更新 oshi 依赖以解决 windows 上的 ffm 调用失败回归 @paulzzh
Docker
DockerHub: ghostchu/peerbanhelper:v9.4.2
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.4.2

部署教程 | 常见问题 | 如何设置下载器 | PBH-BTN 论坛

错误修复
- 修复 linux 上 AutoSTUN 无法保活的问题 @paulzzh
- 修复 webui 日志 无法实时更新的问题 @paulzzh @Ghost-chu
- 简化 webui 系统信息版本显示 @paulzzh @Gaojianli
- 解决 缓存逐出时的 PCB 表唯一约束冲突 @Ghost-chu
优化
- 优化 AutoSTUN 转发相关代码
Docker
DockerHub: ghostchu/peerbanhelper:v9.4.1
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.4.1

部署教程 | 常见问题 | 如何设置下载器 | PBH-BTN 论坛

新功能
- 通知推送渠道支持 Ntfy @gongfuture
- 对 Android 操作系统 Termux 运行环境的基础适配 @Ghost-chu
- 添加 FreeBSD 15.1 程序包打包 @Ghost-chu @paulzzh @copilot
重构
- 重构 BanWave 核心底层代码，缓解之前版本中下载器请求卡住后所有逻辑都会阻塞的问题 @Ghost-chu
- 现在当封禁线程阻塞时，能够详细跟踪导致线程卡住的任务，并显示各模块和任务的状态
- 现在采用流水线替代分批处理，大幅提高处理性能
- BanWave 流水线现在充分利用平台线程池和虚拟线程处理任务
- 现在能够在封禁波次间复用线程池，避免线程池的反复创建
- 重构各封禁模块处理项传递逻辑和注册逻辑，允许封禁模块以最适合的最高效率的方式处理 @Ghost-chu
- 重构 PBH AutoStun UPnP 核心代码，减少依赖项并改善兼容性 @paulzzh
- [WebUI] 当功能模块未启用时，前端禁用对应选单 @Gaojianli
- 重构 JNI 相关代码，迁移到更安全更现代的 FFM 实现 @Ghost-chu @paulzzh
- 重构路由注册逻辑，仅在模块启用时注册路由，以缩减潜在攻击面 @Ghost-chu @paulzzh
- 重复规则的注释现在支持合并 @Ghost-chu
- PCBAddressEntity, PCBRangeEntity, TrackedSwarmEntity 现在支持按需写入，以缓解磁盘 IO 压力，减少写入量 @Ghost-chu
- 重构 PBH 内存缓存系统，现在支持延迟回写和合批回写，PeerConnectionMetricsTrackService, TrackedSwarmService, PeerRecordingService 和 ProgressCheatBlocker 现已支持新的内存缓存系统，以缓解磁盘 IO 压力，减少写入量 @Ghost-chu
- 重构缓存系统，统一缓存处理工具 @Ghost-chu
- 所有调度器转为虚拟线程专用调度器以减少平台线程数量 @Ghost-chu
- [Security] 对于未授权登录的请求，现在不再显示已激活的封禁模块，以改善安全性 @Ghost-chu
- 重构系统颜色检测器，现在能够检测主流 OS 和 DE 的系统颜色，并减少对 native 层的依赖 @Ghost-chu
- 重构封禁统计信息内存计数器，减轻 CPU 压力 @Ghost-chu
- 重构 WatchDog 机制，减少看门狗运行时的 CPU 使用 @Ghost-chu
- 桌面安装器 UI 换新 @Ghost-chu
- 开发人员与社区贡献者关于页面视觉换新 @Ghost-chu
移除
- 移除了一些未使用的依赖项以缩减程序体积 @Ghost-chu
错误修复
- 修复订阅规则提示 @paulzzh
- 修复多个与 PostgreSQL 有关的错误 @Ghost-chu
- 修复 BTN 模块状态显示与实际模块状态显示不一致的问题 @Ghost-chu
- [WebUI] 修复 PBH 运行于 macOS 26 上时，运行状态页面可能崩溃的问题 @Gaojianli
默认值更改
- 由于目前中国大陆主流 ISP 的 QOS 策略导致大量连接出现与拒绝服务攻击保护类似的行为，此版本开始拒绝服务攻击保护模块默认处于禁用状态。 @Ghost-chu
依赖项
- 以下各项依赖项已更新到发布时的最新稳定版本，已解决现有问题或改善安全性：
- beecp, oshi-core, javalin, ntfy, xz, vue, sentry, intl-durationformat, lombok, spring-context, sqlite-jdbc, flatlaf-extras, ipaddress, kotlin, swt-win32.x86_64, copy-to-clipboard, uuid, postgresql, gson, mysql-connector-j, formatjs, oshi-core-ffm, geoip2, fastcsv, markdown-it, okhttp, install4j-runtime, commonmark, jackson, install4j, echarts
- 捆绑 JRE 版本已升级
本地化
- 修正 zh_tw 语言代码的文本 @david082321
Docker
DockerHub: ghostchu/peerbanhelper:v9.4.0
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.4.0

部署教程 | 常见问题 | 如何设置下载器 | PBH-BTN BBS

下载器兼容
- 更新适配器以兼容 BitComet v2.21 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.3.16
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.3.16

部署教程 | 常见问题 | 如何设置下载器 | PBH-BTN 论坛

更改
- 将恶意客户端 Gopeed bt-exp 添加到默认封禁列表。升级到此版本后此规则将自动更新至配置文件 @paulzzh
- 考虑到截至发版时，Gopeed 仍有新样本出现，建议连接到 BTN 网络，以便发现新的样本时通过 BTN 规则下发新的规则库
修复
- 修复 SQL 注入安全漏洞 (GHSA-pc89-mfwm-hj9x) 由 @imlonghao 报告 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.3.15
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.3.15

部署教程 | 常见问题 | 如何设置下载器 | PBH-BTN 论坛

调整
自 2026 年 7 月起，我们将逐步停止原 2024-2025 期间使用的临时域名 *.ghostchu-services.top，并迁移相关服务至 pbh-btn.com 正式域名下。原有域名将在 2027 年 2 月停止续费，并永久终止服务。
通过升级到此修补版本，PeerBanHelper 将为您自动更新截至上一版本中仍在使用旧 API 域的配置项到最新的正式域名，无需任何其它额外操作。
- 原 ghostchu-services.top 域开始启动废弃程序，替换至新服务域 pbh-btn.com。升级到此版本将自动完成配置文件升级。@Ghost-chu
新的映射关系更改如下：
- BTN 规则订阅更新地址
- 原地址：https://bcr.pbh-btn.ghorg.ghostchu-services.top/*
- 新地址：https://bcr.pbh-btn.com/*
- BTN Bootstrap 配置启动地址
- 原地址（2024-2025上半年）：https://btn-prod.ghostchu-services.top/ping/config, https://sparkle.ghostchu-services.top/ping/config
- 新地址：https://sparkle.ghostchu.com/ping/config (中国大陆中继节点), https://sparkle.pbh-btn.com/ping/config (全球节点)
错误修复
- 尝试修复 PostgreSQL 驱动出现有关 percent 的字段报错问题 @Ghost-chu
- (dev 向前移植) 修复虚拟线程调度器使用不当，导致虚拟线程被意外池化的问题 @Ghost-chu
- (dev 向前移植) 修复 PBH Plus 许可证吊销系统从未工作的问题 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.3.14
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.3.14
部署教程 | 常见问题 | 如何设置下载器 | PBH-BTN 论坛

[!NOTE]
有关近期卡巴斯基安全软件(Kaspersky)报告 VHO:Trojan.Win32.Convagent.gen 类型威胁的说明：
经调查，此类报毒均来自 “启发式分析”，PBH-BTN 经过检查后已确认为误报，并反馈至 Kaspersky OpenTIP。在此版发布前，开发组已收到来自 Kaspersky AntiVirus Lab 的邮件回复，相关误报已经修复并解除。如果您遇到了类似情况，请您更新 Kaspersky 病毒库至最新版本即可解决。
由于已被删除的文件负责 PBH 的版本自动更新部分，且即使更新病毒库文件也不会自动还原。因此需要您手动恢复从隔离区相关文件 (updater.exe) 才能恢复版本自动升级能力。覆盖安装/手动升级不会修复被删除的 updater.exe 文件。对于非卡巴斯基安全软件用户，不受此公告影响。
错误修复
- 修复 PostgreSQL 数据库驱动中在添加旧数据渐进数据删除时引入的 SQL 语法错误 @Ghost-chu
- 修复 PostgreSQL 数据库驱动中 InetAddress 没有转换为 inet 类型而是 varchar 类型，导致出现 SQL 数据转换错误的问题 @Ghost-chu
- 修复 RuleSubLog 特定情况下报告 SQL 异常的问题 @Ghost-chu
- 修复 FreeBSD 软件包要求 JAVA_VERSION = 21 但实际需要 JAVA_VERSION = 25 的问题 @Ghost-chu
默认值更改
- 对于新安装的 PeerBanHelper 用户，拒绝服务攻击保护模块现在默认处于禁用状态 @Ghost-chu
杂项
- pnpm 升级 @Gaojianli @paulzzh
- pnpm 构建错误修复 @paulzzh
Docker
DockerHub: ghostchu/peerbanhelper:v9.3.13
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.3.13

部署教程 | 常见问题 | 如何设置下载器 | PBH-BTN 论坛

[!NOTE]
这是一次计划外更新，用以解决 2604 版本的 GeoCN 数据库读取的问题。由于目前有相当数量的模块依赖 GeoCN 数据，建议您进行更新，以免 GeoCN 本地缓存更新后地理位置信息功能失效，导致反吸血能力和数据统计受到影响。
错误修复
- 修复 2026 年 04 月 GeoCN 版本 IPDB 无法解析和读取的问题 @Ghost-chu
- 注意：2604 版本的 GeoCN 数据库格式产生了重大更改，对于 IPv4 数据类型不再有 “网络类型” 分类，这意味着 2604 版本开始 IPV4 的 “网络类型” 封禁功能将失效。
- 我们正在寻找替代，但考虑到大部分此类数据产品都是售价高昂的商业产品，可能不会有优秀替代。如果您知道其它高精度 IP 数据库可用，请与我们联系。
- 自 2604 版本开始的 GeoCN 库使用行政区划代码映射地理位置信息，该映射表内置于 PeerBanHelper JAR 中，精确到区级，当行政区划发生更改后，请您注意新发布的 PeerBanHelper，以便更新区划信息。
- 行政区划代码映射表数据来自 xiangyuecn/AreaCity-JsSpider-StatsGov。
- 当前同时支持 GeoCN 第一版格式和 GeoCN 第二版格式。
- 再次感谢 ljxi/GeoCN 项目多年以来的持续维护❤。
- 修复 AutoRangeBan 连锁封禁日志消息显示异常的问题 @paulzzh
优化
- 自动清除历史运行日志压缩包，避免日志撑爆硬盘 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.3.12
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.3.12

部署教程 | 常见问题 | 如何设置下载器 | PBH-BTN 论坛

错误修复
- 修复在支持 IP Range Ban 能力的下载器上，处理 IPV4-Mapped-IPV6 地址 (如 ::ffff:223.5.5.5) 存在的多个问题，导致此类地址封禁失效的问题 @paulzzh @Ghost-chu
- 修复 BTN 封禁提交和 Peers 提交能力出现异常时，无法恢复模块状态的问题 @paulzzh
改进
- 使用压缩 IPV6 地址进行存储，以节约占用的空间 @paulzzh @Ghost-chu
- 默认禁用 Sentry SDK 的性能分析快照捕获，节约 CPU 和磁盘空间资源 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.3.11
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.3.11

部署教程 | 常见问题 | 如何设置下载器 | PBH-BTN 论坛

[!TIP]
我们正在尝试推进新的 BitTorrent 协议提案(BEP) "DHT 打孔扩展协议" 进入 bittorrent.org 列表，如果您是 BitTorrent 相关的开发者和专家，欢迎对新的提案提出建设性的意见：https://github.com/bittorrent/bittorrent.org/issues/178
优化
- 支持对 Unknown 客户端名称进行封禁 @paulzzh
错误修复
- 修复 qBittorrent 的部分流量统计问题 @paulzzh
- 修复移动端响应式问题 @Gaojianli
Docker
DockerHub: ghostchu/peerbanhelper:v9.3.10
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.3.10

部署教程 | 常见问题 | 如何设置下载器 | PBH-BTN 论坛

[!TIP]
【Synology DSM】群晖用户请注意，由于原合作套件源矿神-SPK7 软件源计划停止服务，版本更新速度可能受影响且将在未来将关闭站点。请您添加 PBH-BTN SPK 源，以接替原矿神 SPK 源并继续通过套件中心获取更新：https://spk-repo.pbh-btn.com/nas 谢谢！
[!TIP]
PBH-BTN BBS 现已正式上线！https://bbs.pbh-btn.com/ 希望这里可以成为新的中文 BitTorrent 社区，欢迎参与其中！
[!TIP]
我们正在尝试推进新的 BitTorrent 协议提案(BEP) "DHT 打孔扩展协议" 进入 bittorrent.org 列表，如果您是 BitTorrent 相关的开发者和专家，欢迎对新的提案提出建设性的意见：https://github.com/bittorrent/bittorrent.org/issues/178
下载器兼容性
- 支持 BitComet 的长效种子反吸血 @Ghost-chu
优化
- 优化 ProgressCheatBlocker 的进度回退检测算法，改善因网络不稳定，BIT_FIELD 包未来得及同步导致的误封禁问题。现在观察期设置也应用到进度回退功能上 @Ghost-chu
错误修复
- 从 v9.2 及更早版本迁移时可能遇到 SQL 主键冲突的问题导致表迁移失败 @Ghost-chu
- 当请求的模块被禁用时，不要注册其路由；当请求的路由不存在或不可用时，返回标准错误响应，避免前端报错 @Ghost-chu
- 优化了网络类型页面的文案，避免理解偏差导致用户误操作将所有网络类型全部封禁 @Gaojianli
- 优化了 WebUI 被禁用的模块交互逻辑，现在被禁用的模块按钮将置灰 @Gaojianli
- 修复已读单条警报发生的 SQL 查询错误 @paulzzh
- 修复规则订阅的提示信息 @paulzzh
其它
- 整理翻译键 @paulzzh
Docker
DockerHub: ghostchu/peerbanhelper:v9.3.9
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.3.9

部署教程 | 常见问题 | 如何设置下载器 | PBH-BTN 论坛

[!TIP]
【Synology DSM】群晖用户请注意，由于原合作套件源矿神-SPK7 软件源计划停止服务，版本更新速度可能受影响且将在未来将关闭站点。请您添加 PBH-BTN SPK 源，以接替原矿神 SPK 源并继续通过套件中心获取更新：https://spk-repo.pbh-btn.com/nas 谢谢！
在长达一个月的迭代后，我们很高兴的宣布 v9.3.x 版本分支将进入稳定版本阶段。在过去两周的时间内，我们的遥测服务没有发现新的重要错误或者性能问题。这也意味着 v9.3.x 系列将替代 v9.2.x 成为新的稳定版本分支。针对 v9.2.x 的支持将逐步停止。
错误修复
- 当 BTN IP 允许列表更新后，处于允许列表中的已被封禁 IP 地址没有正确解除封禁 @Ghost-chu
- 更换回常规 JDK，修复了 AutoSTUN 等等不能正常工作的问题 @Ghost-chu
- 修复 AutoSTUN 的 UPnP 端口映射与网关发现的相关问题 @Ghost-chu @paulzzh
非 PeerBanHelper 的其它更改
PBH-BTN BBS
国内针对 BitTorrent 的讨论大量分散在各视频网站评论区、PT 站私有论坛中。在 2024-2025 初期，反吸血的相关内容一度只能依靠腾讯文档在各个群组之间人力传播。各站点有关 BitTorrent 的信息时间跨度十年有余，许多信息均已过时，甚至带有误导性。因此 PBH-BTN 推出了 PBH-BTN BBS。这是一个以 BitTorrent 为主题的综合性讨论社区，全站支持全文 RSS 和邮件通知推送。
我们希望该社区能够成为中文 BitTorrent 交流的一个聚集地，减少信息摩擦，成为一个高效的 BT 主题讨论社区。
欢迎将地址收藏到您的收藏夹：https://bbs.pbh-btn.com
Sparkle BTN3
我们已完成对 BTN3 数据库系统的查询引擎改造，现在查询性能有明显提升。伴随春节高负载高峰的结束，在完成更多测试后，将逐渐回调 BTN 各项反吸血能力。
同时，我们还推出了针对固定 seedbox 和字幕组/压制组/发布组等资源发布组织的发种鸡的 “关联 IP 豁免” 能力。能够有效避免因误操作导致出现进度回退后，因大量封禁记录报告导致做种机 IP 地址遭到封禁的问题。
现在可以申请加入 IP 豁免，登记的 BTN 用户应用程序对应的关联 IP 地址将自动进入 BTN IP 允许列表中，不会被与 BTN 连接 PeerBanHelper 封禁，并忽略反吸血检查。
理论上，如果您的服务器运行很好没有崩溃导致文件丢失过，那么一般不需要申请此项。
PBH-BTN 种群加速计划 (SwarmAccelerator)
该项目在稍早前已经试运行了一个月。许多朋友可能已经见过 BiglyBT 4.0.0.0 (PBH-BTN Swarm Accelerator/1.0) 这个客户端名称了。
该计划为 PBH-BTN 充分利用现有服务器资源，对新 BT 资源（特别是热门资源）进行分流加速的企划。通过 RSS 订阅和特殊算法，通过 PBH-BTN 的数据中心服务器进行分流加速做种。
欢迎关注我们的项目仓库，并随时窥屏运行状态：https://github.com/PBH-BTN/SwarmAccelerator-Project
Docker
DockerHub: ghostchu/peerbanhelper:v9.3.8
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.3.8

部署教程 | 常见问题 | 如何设置下载器 | PBH-BTN BBS

操作系统平台支持
- 重新添加对 Windows 7 (64 位) 操作系统的支持 @Ghost-chu
- Windows 7 用户请下载带有 win7 字样的专用安装程序
错误修复
- 修复完成 OOBE 时可能错误提示 “OOBE 重复初始化”，且配置需要重启生效的问题 @Ghost-chu
- 修复 Portable 版 PeerBanHelper 启动脚本错误导致无法启动的问题 @0x391F
- 修复 GeoIP MMDB 因文件被占用下载失败的问题 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.3.7
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.3.7

部署教程 | 常见问题 | 如何设置下载器

改进
- 调整 BiglyBT 上的活跃种子判定条件，减少活动种子数，缩短检测耗时 @Ghost-chu
- 删除数据时，只选中必要的字段，加快删除速度，减少磁盘 I/O @Ghost-chu
错误修复
- 修复 Install4j 裁剪的 JVM 无法进行堆内存转储的问题 @Ghost-chu
- 撤销内存参数调整，还原旧版本内存回收行为，解决部分用户设备上内存占用虚高的问题 @Ghost-chu
- 修复 IPDB 数据库下载/初始化失败后，仍然进行查询产生空指针错误的问题 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.3.6
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.3.6

部署教程 | 常见问题 | 如何设置下载器

[!TIP]
新年快乐，阖家团圆！祝所有 BTer 农历马年新年快乐！
[!TIP]
【Synology DSM】群晖用户请注意，由于原合作套件源矿神-SPK7 软件源计划停止服务，版本更新速度可能受影响且将在未来将关闭站点。请您添加 PBH-BTN SPK 源，以接替原矿神 SPK 源并继续通过套件中心获取更新：https://spk-repo.pbh-btn.com/nas 谢谢！
下载器兼容性
- 添加 qBittorrent 的 IP 段封禁支持，以便增强对 IPV6 Freebind 行为（随机后缀）的封禁能力。需要 qBittorrent v5.3.0 或者更高版本，亦或者补丁版本 @Ghost-chu @KagurazakaNyaa
- 官方将在 v5.3.0 中包含此新功能；在此之前，带有补丁的特殊版本可以从下面的位置下载：
- Windows: https://github.com/qbittorrent/qBittorrent/actions/runs/22053061907
- Linux: https://github.com/qbittorrent/qBittorrent/actions/runs/22053061908
- MacOS: https://github.com/qbittorrent/qBittorrent/actions/runs/22053061910
- 使用支持 IP 段封禁的 qBittorrent 构建后，随机 IPV6 后缀的 Peer 不再需要使用防火墙进行额外处理
更改
- 为了更好匹配当前时间的反吸血情况，IPV6 封禁列表重映射范围已从 /60 提升到 /52 @Ghost-chu
错误修复
1. 禁用退出时 SQLite VACUUM。因为如果 VACUUM 未在指定时间内完成而导致进程被杀死，则可能导致数据库损坏 @Ghost-chu
2. 修正 Transmission 活动种子的判定条件 @Ghost-chu
3. 修正当 Transmission 报告 409 错误时，请求会直接失败而不是刷新 CORS Token 后重试 @Ghost-chu
4. 修正对下载失败的 MMDB 的错误处理，现在 MMDB 损坏时，将计划退出时删除，并在下次启动时重新下载 MMDB @Ghost-chu
5. 修正 PeerConnectionMetricsTrackMapper 有关的 SQL 查询唯一约束错误有关的问题 @Ghost-chu
6. 修正 TcpStunClient 在极特殊情况下退出行为不正确的问题 @paulzzh
7. 修复多个队列的线程安全问题 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.3.5
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.3.5

部署教程 | 常见问题 | 如何设置下载器

[!NOTE]
我们正在更新隐私政策，您可以点击此处了解有关隐私政策的新更改。
[!NOTE]
由于数据库基础设施的重大更改，请在升级时保留充足的磁盘空间，以便进行数据库升级。升级过程不可中断。
[!TIP]
【Synology DSM】群晖用户请注意，由于原合作套件源矿神-SPK7 软件源计划停止服务，版本更新速度可能受影响且将在未来将关闭站点。请您添加 PBH-BTN SPK 源，以接替原矿神 SPK 源并继续通过套件中心获取更新：https://spk-repo.pbh-btn.com/nas 谢谢！
重要修复
- 修复在 Transmission 高版本（支持 PeerID 信息）上，Peer ID 值读取不正确的问题。这会影响反吸血模块的正常运行 @Ghost-chu
- 修复了 v9.3.2 v9.3.1 上不同程度的数据库问题
新功能
您可以点击这里查看 v9.3.0 的详细更新内容
- 对 H2、MySQL、PostgreSQL（预览版）数据源支持 @Ghost-chu @Gaojianli @paulzzh @guohu7777
- 针对信创和国产处理器架构设备，若 SQLite 无法在您的设备上运行，请考虑切换到 H2 或者 MySQL/PostgreSQL
- Postgres 的支持暂不可用
-【Synology DSM】新增 DSM 套件中心套件源，以接替正在关闭的矿神 SPK 源，以便继续通过套件中心提供更新 @Ghost-chu
-【Linux/Debian】新增 Debian apt 软件包管理器源，以提供更简单的 deb 软件包安装方式 @Ghost-chu
- 为 PeerBanHelper 启动添加预启动页面，WebUI 端口在启动过程中将显示日志信息以便确认启动情况，并在启动结束后自动跳转 WebUI @Ghost-chu
错误修复
- 修复 debian 配置文件滞后 @paulzzh
- 修复 pbh 无法正常退出 @paulzzh
- 修复 sqlite 的各类 BanWave 触发 Watchdog / SQLITE_BUSY / database is locked 等等问题 @paulzzh
- (v9.3.2) 修复 BTN 错误信息占位符故障 @XiaoBu39
- (v9.3.1) 修复安全漏洞 @Ghost-chu
- (v9.3.1) 拆分了长/频繁写操作为更短更快的小查询 @Ghost-chu
- (v9.3.1) 修复 GeoCN 数据库执行查询操作时，如果 MMDB 提供了部分字段的空值数据，则可能引发空指针异常的问题 @Ghost-chu
- (v9.3.1) 修复了正式版报告测试版警告的问题 @Ghost-chu
改进
- 提升了 OOBE 的安全性 @Ghost-chu
- 未启用 AutoSTUN 时不进行网关扫描 @paulzzh
- 改善 PeerRecording 查询 @paulzzh
- 引入 p6spy 监测慢查询 @Ghost-chu
- (v9.3.2) 更换数据库连接池为 BeeCP @Ghost-chu
- (v9.3.2) 将 PeerRecording 删除任务切分为小段，并在后台执行清理工作，避免长查询导致封禁操作卡死 @Ghost-chu
- (v9.3.1) 进度反作弊模块现在在单 IP 解除封禁时，不再同时重置网段统计数据，以优化反吸血效果 @Ghost-chu
BTN 网络
近期 BTN 网络处于高负载状态，由于服务器已超过最大承载能力，当前 BTN 服务可能不稳定或不可用。我们正在着手解决该问题，但可能需要一段时间。
Docker
DockerHub: ghostchu/peerbanhelper:v9.3.3
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.3.3

部署教程 | 常见问题 | 如何设置下载器

[!TIP]
【Synology DSM】群晖用户请注意，由于原合作套件源矿神-SPK7 软件源计划停止服务，版本更新速度可能受影响且将在未来将关闭站点。请您添加 PBH-BTN SPK 源，以接替原矿神 SPK 源并继续通过套件中心获取更新：https://spk-repo.pbh-btn.com/nas 谢谢！
[!TIP]
v9.3.1 / v9.3.2 是 v9.3.0 的补丁版本，请您先阅读 v9.3.0 更新日志。该版本包含较大变更。
错误修复
- 修复 Druid 连接池引发的 H2/MySQL 兼容问题 @Ghost-chu
- 修复 BTN 错误信息占位符故障 @XiaoBu39
改进
- 将 PeerRecording 删除任务切分为小段，并在后台执行清理工作，避免长查询导致封禁操作卡死 @Ghost-chu
BTN 网络
近期 BTN 网络处于高负载状态，由于服务器已超过最大承载能力，当前 BTN 服务可能不稳定或不可用。我们正在着手解决该问题，但可能需要一段时间。
Docker
DockerHub: ghostchu/peerbanhelper:v9.3.2
阿里云镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.3.2
部署教程 | 常见问题 | 如何设置下载器

[!CAUTION]
本版本包含对 v9.3.0 的重要安全漏洞修复，请您及时更新，并互相转告！
受影响版本：v9.3.0 正式版及其测试版本
[!TIP]
【Synology DSM】群晖用户请注意，由于原合作套件源矿神-SPK7 软件源计划停止服务，版本更新速度可能受影响且将在未来将关闭站点。请您添加 PBH-BTN SPK 源，以接替原矿神 SPK 源并继续通过套件中心获取更新：https://spk-repo.pbh-btn.com/nas 谢谢！
[!TIP]
v9.3.1 是 v9.3.0 的补丁版本，请您先阅读 v9.3.0 更新日志。该版本包含较大变更。
【重要！】安全漏洞修补
- 修复因新增的 WebAPI 接口缺少必要的鉴权，恶意攻击者可构造 API 请求发送至 PeerBanHelper OOBE API 接口，执行恶意攻击
- 攻击者可通过安全性弱点，在没有鉴权和速率限制的情况下，使用 PeerBanHelper 向任意地址发起 TCP 连接，或尝试登录目标设备的 PostgreSQL/MySQL 数据库。通过设计的恶意负载，可通过 JDBC 数据库驱动程序执行权限提升、远程代码执行，或者通过此弱点发起拒绝服务攻击
- 攻击者可通过安全性弱点，在没有鉴权和速率限制的情况下，请求 PeerBanHelper 强制配置文件重载。引起 CPU 高占用并对 PeerBanHelper 发起拒绝服务攻击，使速度变慢或停止响应
由于我们的疏忽带来的问题，向所有受影响的用户致以诚挚歉意。
如果您的 PeerBanHelper 已连接 SparkleBTN 网络且处于受到影响的范围内，系统将自动向您发送通知邮件。
优化
- SQLite 现在支持读写池分离，以提高性能 @Ghost-chu
- 进度反作弊模块现在在单 IP 解除封禁时，不再同时重置网段统计数据，以优化反吸血效果 @Ghost-chu
修复
- 修复了执行长/频繁写操作时，因 LIFO 下的线程争用，导致排队的其它线程无法获取 SQLite 数据库连接引发错误的问题 @Ghost-chu
- 拆分了长/频繁写操作为更短更快的小查询 @Ghost-chu
- 修复 GeoCN 数据库执行查询操作时，如果 MMDB 提供了部分字段的空值数据，则可能引发空指针异常的问题 @Ghost-chu
- 修复了正式版报告测试版警告的问题 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.3.1
阿里云镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.3.1
部署教程 | 常见问题 | 如何设置下载器

[!TIP]
【Synology DSM】群晖用户请注意，由于原合作套件源矿神-SPK7 软件源计划停止服务，版本更新速度可能受影响且将在未来将关闭站点。请您添加 PBH-BTN SPK 源，以接替原矿神 SPK 源并继续通过套件中心获取更新：https://spk-repo.pbh-btn.com/nas 谢谢！
[!NOTE]
由于数据库基础设施的重大更改，请在升级时保留充足的磁盘空间，以便进行数据库升级。升级过程不可中断。
重要修复
- 修复在 Transmission 高版本（支持 PeerID 信息）上，Peer ID 值读取不正确的问题。这会影响反吸血模块的正常运行 @Ghost-chu
新功能
- 对 H2、MySQL、PostgreSQL（预览版）数据源支持 @Ghost-chu @Gaojianli @paulzzh @guohu7777
- 针对信创和国产处理器架构设备，若 SQLite 无法在您的设备上运行，请考虑切换到 H2 或者 MySQL/PostgreSQL
- Postgres 的支持是实验性的
-【Synology DSM】新增 DSM 套件中心套件源，以接替正在关闭的矿神 SPK 源，以便继续通过套件中心提供更新 @Ghost-chu
-【Linux/Debian】新增 Debian apt 软件包管理器源，以提供更简单的 deb 软件包安装方式 @Ghost-chu
- 为 PeerBanHelper 启动添加预启动页面，WebUI 端口在启动过程中将显示日志信息以便确认启动情况，并在启动结束后自动跳转 WebUI @Ghost-chu
更改与优化
- 移除了 ORMLite 并切换到 MyBatis-Plus 框架，引入 Flyway 代替原本的 SQL 升级脚本，并完全重构了数据库基础设施，以便提升性能并为复杂查询奠定基础 @Ghost-chu @Gaojianli @paulzzh @guohu7777
- 取消了 -XX:SoftMaxHeapSize=386M 参数以改善在部分重度用户的设备上的 CPU 高使用情况 @Ghost-chu
- 移除了部分不需要的 netty 组件以缩减安装包体积 @Ghost-chu
- 修复了当 GeoIP 查询结果中对应 IP 地址没有国家/地区代码时，发生空指针异常的问题 @Ghost-chu
- 优化了 BanWave 中因反复创建线程池引起的额外 CPU 占用问题 @Ghost-chu
- 修复了 TranslationComponent 为空时可能引发文本翻译空指针错误的问题 @Gaojianli
- 使用多线程加载功能模块，提高程序启动速度 @Ghost-chu
- 后台任务修改为异步运行，提高了运行速度 @Gaojianli
- 优化了 “数据透视->封禁日志” 页面数据的加载速度和 SQL 查询性能 @Ghost-chu
- 大幅优化了 “数据透视->种子” 页面数据的加载速度和 SQL 查询性能 @Ghost-chu
- 优化了 “数据透视->IP 查询”里访问日志和封禁日志选项卡数据的加载速度和 SQL 查询性能 @Ghost-chu
- 优化了种群跟踪、Peer 分析服务、进度反作弊模块等使用 TorrentService 的整体性能和缓存设计 @Ghost-chu
- 大幅优化了 “统计->图表” 中的图表及其数据加载速度和 SQL 查询性能，特别是在长时间运行或存在大量任务的安装上 @Ghost-chu
- PortMapper 现在使用虚拟线程以优化性能 @Ghost-chu
- 新增种子缓存功能，以大幅改善各封禁模块的整体性能，减少磁盘 I/O @Ghost-chu
- Docker 镜像包含 udev 软件包 @Gaojianli
错误修复
- 修复了当功能模块没有注册事件监听器时，在退出阶段报告 java.lang.IllegalArgumentException: missing event subscriber for a n annotated method. 的错误 @Ghost-chu
- 修复 Transmission 下载器出现 IO 错误时，被错误的捕获为内部错误并处理的问题 @Ghost-chu
- 修复内存不足的情况下 ProgressCheatBlocker 和其它模块的内存缓存可能在逐出条目的时候报告空指针错误 @Ghost-chu
- 实验性修复了当下载器流量统计数据回溯/清零时，PBH 的流量统计数据可能出现问题的错误 @paulzzh
- 移除了意外引入的 Install4j 的 output.log 重定向功能，该功能可能导致非预期的大量磁盘空间占用 @Ghost-chu
- 修复若升级时，用户拒绝了卸载程序的 UAC 权限请求，则可能导致安装损坏的问题 @Ghost-chu
- 修复了当 PeerBanHelper 启动时，大量长查询计划清理任务争夺连接，引发的急剧性能下降和 [SQLITE_BUSY] database is locked 错误 @Ghost-chu
隐私政策透明度
在本版本中新增了遥测功能，以便开发者收集产生的错误和崩溃日志。相关信息用于且仅用于改善软件质量，所有相关数据均在 PBH-BTN 的服务器上处理和保存，不会出售、转移给第三方。
您可以随时在 “设置-基本设置-启用遥测” 菜单禁用此功能。
有关信息收集范围和如何退出请 点击此处 以了解相关更改。
Docker
DockerHub: ghostchu/peerbanhelper:v9.3.0
阿里云镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.3.0
部署教程 | 常见问题 | 如何设置下载器

错误修复
- 修复超小种子文件（整体体积小于 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

部署教程 | 常见问题 | 如何设置下载器

下载器兼容性
- 新增对 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.1 版本，以添加对 BiglyBT 的 Peer Flags 解析支持，可在连接统计模块中显示 BiglyBT 上的连接标志信息 @Ghost-chu
- 进一步改进对 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

下载器兼容性
- 适配 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

部署教程 | 常见问题 | 如何设置下载器

优化
- 优化 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
部署教程 | 常见问题 | 如何设置下载器

错误修复
- 修复部分情况下，BTN 提交数据因旧数据缺失必要字段而失败的问题 @Ghost-chu
- 修复 OOBE 的 BTN 设置不起作用的问题 @Gaojianli
Docker
DockerHub: ghostchu/peerbanhelper:v9.2.1
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.2.1

部署教程 | 常见问题 | 如何设置下载器

[!NOTE]
此版本发布后，BTN 服务器协议版本将升级到 BTN v3.0。旧版本 PeerBanHelper 将无法再连接到 BTN 服务器同步、提交和获取数据。请注意及时更新 PeerBanHelper 版本。
新功能
OOBE 改进
@Gaojianli @Ghost-chu
对开箱即用体验进行了改进，现在将引导新用户更好的配置下载器和 BTN 功能。
自动寻找本机网络上的下载器 WebUI
改进了下载器配置流程，以便降低新手用户的初始配置难度。现在 PeerBanHelper 能够扫描本机网络上的可用下载器 WebUI 端口，并自动识别下载器类型、主机名、端口号，并自动填充相关信息到表单中。
目前支持下列类型的下载器识别：
- qBittorrent
- Transmission
- BitComet
- BiglyBT
受技术限制，只有 PeerBanHelper 和下载器在同设备相同网络下才能识别。如下载器创建于容器中且非 host 网络驱动，则可能无法识别。
使用此功能前，需要先启用下载器的 WebUI。
BTN 网络 3.0
@Gaojianli @Ghost-chu
本次更新包含了对 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

部署教程 | 常见问题 | 如何设置下载器

重要性能改进
- 为会话统计与分析服务、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

部署教程 | 常见问题 | 如何设置下载器

错误修复
- 修复使用 Transmission 下载器时可能报告空指针错误的问题 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.1.4
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.1.4

错误修复
- 修复 qBittorrent 下载器可能报告 pieces 为 null 值的空指针错误 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.1.3
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.1.3

[!NOTE]
v9.1.2 是 v9.1.0 大型更新 的补丁更新。建议您首先阅读 v9.1.0 的更新日志再行升级。
v9.1.1 更新内容如下：
错误修复
- 修复了一个仅在 2 CPU 核心或者 3 CPU 核心的设备上会出现死锁的 race condition BUG，该问题概率出现且提示 “线程强制终止，操作已被取消 java.lang.InterruptedException: null” @Ghost-chu
- 修复了一个罕见的 race condition BUG，该问题出现时会报告 SQLException，查询违反唯一约束 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.1.2
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.1.2

[!NOTE]
v9.1.1 是 v9.1.0 大型更新 的补丁更新。建议您首先阅读 v9.1.0 的更新日志再行升级。
v9.1.1 更新内容如下：
新功能
1. 实装 BTN StructuredData 字段，允许 BTN 在线分析使用结构化数据，而不是基于文本截取的字符串处理 @Ghost-chu
错误修复
1. BitComet 版本过低时没有正确提示版本过低，而是抛出错误 “java.lang.IllegalStateException: closed” @Ghost-chu
2. 流量图表有时仍然出现负值的情况，特别是下载器在统计区间内未上线过时 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.1.1
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.1.1
如在升级到 v9.1.0 后，Docker 容器出现无法启动的问题，请尝试从容器的环境变量中删除 JAVA_HOME 和 JAVA_OPTS 参数。

部署教程 | 常见问题 | 如何设置下载器

[!NOTE]
请做好数据备份，一旦升级到此版本，将无法降级到先前版本。如需降级则必须从备份中还原所有文件。
[!NOTE]
自此版本开始，PeerBanHelper 将使用 Java 25 版本。如果您在使用自己安装的 Java 运行时，请注意运行时版本。
下载器兼容性更新
以下下载器的兼容性支持有所变化，请您仔细阅读，并根据需要采取行动。
- BitComet 现在需要最低 2.18 正式版版本 @Ghost-chu
- BitComet 2.18 和更高版本现已支持流量统计功能 @Ghost-chu
- BiglyBT 的测试版本由于内部破坏性更改导致无法支持，在 BiglyBT 重构结束发布正式版本后，我们将更新支持插件。由于内部变更，新版本支持插件将不兼容旧版本 BiglyBT @Ghost-chu
- 预载适配 Transmission 未发布的 RPC API 更改，支持读取 peer_id, bytes_to_client 和 bytes_to_peer 字段，提供 Transmission 上的完整反吸血能力。请注意当前 Transmission 尚未发布带有此更新的测试版本，因此该功能尚未进行测试 @cdowen @Ghost-chu
新功能
仪表盘统计数据
@Ghost-chu
新增 “近 7 天会话唯一 IP 数量” 参考值，以便用户对比不同时间段 Peer 活动会话概览。
数据统计基于会话跟踪服务，实际值可能与参考值有所出入，数据仅供参考。
IP 统计
@Gaojianli @Ghost-chu
图表新增 IP 统计功能，基于会话跟踪服务统计数据，生成统计时段内的 Peer 连接情况概览。以便直观计算和统计和对比不同时段内的 Peer 活动情况。该视图可能不可见，您可以从右上角的 “视图选项” 中启用。
数据统计基于会话跟踪服务，实际值可能与参考值有所出入，数据仅供参考。
字段排序支持
@Gaojianli @Ghost-chu
封禁日志、访问记录、封禁记录等表格全面支持字段排序。现在你可以通过表格上的排序指示器进行多条件组合升序、降序排序。以便更加直观、直接、快速的整理数据。
数据统计基于 Peer 跟踪记录服务，可查询范围视设置的数据保留时长决定
封禁列表重映射
@KagurazakaNyaa @Ghost-chu
新的 “封禁列表重映射” 选项允许在向下载器更新 IP 封禁列表时，将单个 IP 地址映射到更广泛的范围，并生成 CIDR 表达式传入。该选项默认对 IPv6 地址开启，以改善随机 IPv6 地址的封禁效能。由于限制，目前暂时不支持 qBittorrent https://github.com/qbittorrent/qBittorrent/pull/23157 。
任务反吸血
@Ghost-chu
任务反吸血模块替代了原有的迅雷相关封禁的 PeerID/客户端名称 规则，现在 PeerBanHelper 将根据预设逻辑对已知默认设置存在不良行为的客户端进行管控。具体如下：
1. 如果是非 0019 版本的其他版本迅雷，则直接进行封禁。
2. 如果是 0019 版本的迅雷，由于迅雷官方添加了下载过程中向其它用户提供上传的功能，但由于仍然不会做种，因此 PBH 将仅拒绝其连接到做种任务
在未来我们计划添加对 BT 播放器等类似的管控规则。
其它新功能
1.【实验性】新增演示模式 （Demo Mode），以演示模式启动时，接口将积极拒绝所有写入和修改请求，并从响应中排除、替换敏感数据字段。@Ghost-chu
功能改进
进度反作弊
1. 现在支持来自同一 IP 地址不同端口的多重连接，现在能够正确单个连接计算传输量而不是按照回退进行叠加计算，避免出现错误的累积，改善了检测误封禁率 @Ghost-chu
2. 现在分离存储网段和单个 IP 的流量跟踪数据，pcb 数据表现已废弃，并可能在未来删除以回收存储空间 @Ghost-chu
3. 改善了进度反作弊的响应时间，现在在特定情况下能够更快的做出反应 @Ghost-chu
错误修复
1. 修复进度反作弊器针对解封事件的监听器未被正确注册以重置相关跟踪项数据的问题 @Ghost-chu
2. 修复 WebUI 部分页面当重新进行查询时，没有正确跳回第一页结果的问题 @Gaojianli
3. 修复特殊情况下表创建和表升级可能出现 SQLException 的问题 @Ghost-chu
4. 修复传递 orderBy 参数时，默认排序优先级比用户传递排序参数优先级更高的问题 @Ghost-chu
5. 修复 Java 运行时升级后，Docker 用户需要删除 JAVA_OPTS 和 JAVA_HOME 环境变量才能启动容器的问题 @Ghost-chu
6. 修复当下载器在任务上没有拥有任何完整 piece 时，PeerBanHelper 总是会额外请求一次 Properties API 的问题，这可能略微增加下载器的负载 @Ghost-chu
7. 修复当 Peer 被解除封禁时，其 ProgressCheatBlocker 数据没有被正确重置并可能导致被立刻再次封禁的问题 @Ghost-chu
8. 修复 “流量统计” 图表数据不准确、计算错误、数值溢出为负数、出现 NaN undefined 的问题 @Ghost-chu
删除的功能
1. PTRBlacklist （DNS 反向解析封禁）模块已在此版本中完全删除，因为其性能非常糟糕，且完全没有任何实质性作用 @Ghost-chu @Gaojianli
2. 实验室功能 “封禁列表批量写入” 已被删除，因为未能通过实验室稳定性测试 @Ghost-chu
其他更改
1. 改进了 Win32 平台工作集裁剪条件，并改善了 GC 后一段时间内的进程计算性能 @Ghost-chu
2. 调整汇总设置首选项有关 Peers 跟踪的选项到统一的模块下 @Ghost-chu
3. 允许使用 ExternalSwitch 关闭自动修改 qBittorrent 设置的逻辑 @Ghost-chu
4. Github API 检查更新时的 429 错误现在打印到控制台 @Ghost-chu
5. 改进了部分 WebAPI 的性能 @Ghost-chu
6. 项目从 Maven 迁移到 Gradle 以便改善构建灵活性和构建性能 @Gaojianli
7. Github 工作流和 Docker 构建改进 @Gaojianli
8. 预载 Client Analyse 统计服务、图表接口 @Ghost-chu
9. 调整部分数据表的索引 @Ghost-chu
10. 重构 Active Monitoring Module，拆分统计功能到单独模块，以更好的解耦合并降低维护难度 @Ghost-chu
11. 优化了 SQLite 数据库的性能表现 @Ghost-chu
12. 固定 Java 版本基准为 Java 25，调整更新 Docker 容器、install4j、软件包、Portable 包的启动命令 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.1.0
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.1.0
如在升级到 v9.1.0 后，Docker 容器出现无法启动的问题，请尝试从容器的环境变量中删除 JAVA_HOME 和 JAVA_OPTS 参数。

部署教程 | 常见问题 | 如何设置下载器

错误修复
- 修复 MacOS 平台上 GUI 程序卡死的问题 @Ghost-chu
- 在位于 Proxmox 的 KVM 虚拟机中进行的测试，实际修复效果请以实机测试为准
- 修复 WebUI 视觉错误 @Gaojianli
其他事宜
针对近期更新的 BitTorrent Protocol Version 3 和 BitTorrent Protocol Version 3.1，即第三版 BT 协议，PeerBanHelper 和 BTN 服务端程序应该能在下载器更新其支持后，无缝兼容相关更改。因为我们并不收集实际的 info_hash，而是基于 info_hash 的二次匿名加盐哈希值。
请注意上面的新增协议由 Tixati 提起，但尚未成为标准或事实标准。相关兼容性信息仅供参考。
有关其在更广泛范围内的讨论，请参见：https://github.com/arvidn/libtorrent/issues/8047 和 https://github.com/qbittorrent/qBittorrent/issues/23421
Docker
DockerHub: ghostchu/peerbanhelper:v9.0.10
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.0.10

部署教程 | 常见问题 | 如何设置下载器

错误修复
- 修复 zh_cn 的语言文件内容被强制注册给 en_us 语言代码的问题 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.0.9
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.0.9
部署教程 | 常见问题 | 如何设置下载器
你知道吗：我们最近上线了测试版的国内文档镜像站，用于改善中国大陆用户的文档浏览体验，你可以点此访问镜像站点。新的镜像站点由 EdgeOne Pages 驱动。测试期间，站点可能随时发生更改或者关闭。

错误修复
- 修复 BiglyBT 下载器驱动程序没有添加 LIVE_UPDATE_BT_PROTOCOL_PORT 标志，导致 AutoSTUN 程序跳过所有 BiglyBT 隧道 @Ghost-chu
- 修复实验室模块默认配置文件没有放置 enabled 配置键导致回落默认禁用状态的问题 @Ghost-chu
- 本次更新后，实验室功能将自动启用
- IPDB 数据库下载超时时间延长到最多 3 分钟 @Ghost-chu
实验室
- IPDB 异步下载实验现在对所有用户默认启用 @Ghost-chu
- 修复了 TRANSACTION_BATCH_BAN_HISTORY_WRITE 实验和 WIN32_EMPTY_WORKING_SET 由于边界索引错误，导致实际灰度范围比预期小 50% 的问题 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.0.7
阿里云国内镜像加速：registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.0.7

部署教程 | 常见问题 | 如何设置下载器
你知道吗：我们最近上线了测试版的国内文档镜像站，用于改善中国大陆用户的文档浏览体验，你可以点此访问镜像站点。新的镜像站点由 EdgeOne Pages 驱动。测试期间，站点可能随时发生更改或者关闭。

用户体验改进
- 现在 WatchDog 能够区分封禁线程卡住时是否位于下载器通信部分。如果在与下载器通信的部分，则显示故障排除引导信息；反之保持现状
删除的功能
- 删除 “IP 地址反向解析域名” 模块
- 该模块在过去一段时间内带来了大量不必要的支持工作量。同时，没有任何已知的恶意 IP 地址样本可被此模块检测到，因此不再继续保留此模块
- 删除默认规则 “tor-exit-node”
- 由于此规则默认更新服务器无法被用户直接访问，同时，没有任何已知的恶意 IP 地址样本被此规则捕获过，故不再继续保留
- 此更改仅对新用户生效
- 移除 “DNSJava” 实验
- DNSJava 实验现已转正，成为 PeerBanHelper 主程序的一部分。
Docker
DockerHub: ghostchu/peerbanhelper:v9.0.5
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.0.5
部署教程 | 常见问题 | 如何设置下载器
你知道吗：我们最近上线了测试版的国内文档镜像站，用于改善中国大陆用户的文档浏览体验，你可以点此访问镜像站点。新的镜像站点由 EdgeOne Pages 驱动。测试期间，站点可能随时发生更改或者关闭。

错误修复
- 修复当 Microsoft Edge WebView2 不存在或被用户删除时，Swing UI 可能卡死无响应的问题 @paulzzh
- Microsoft Edge 是重要系统组件，不建议对其删除
- 如果确需删除 Edge 浏览器，请考虑保留 Edge WebView2 组件
- 如果确实需要删除 Edge WebView2，也请不要粉碎目录，而是正常卸载。残留的注册表键可能导致非预期问题
- 修复解析 IPAddress 时如果因各种原因传入非预期参数将可能导致执行中断的问题 @Ghost-chu
- 修复 Swarm Tracking 中 torrentSize 字段丢失的问题 @Ghost-chu
- 修复 PeerBanHelper PF4J 插件加载失败时，出现的错误会直接阻止 PeerBanHelper 初始化和启动的问题 @Ghost-chu
- 修复启动时部分情况下 BanList 出现死锁的问题 @Ghost-chu
Docker
DockerHub: ghostchu/peerbanhelper:v9.0.4
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.0.4
部署教程 | 常见问题 | 如何设置下载器
你知道吗：我们最近上线了测试版的国内文档镜像站，用于改善中国大陆用户的文档浏览体验，你可以点此访问镜像站点。新的镜像站点由 EdgeOne Pages 驱动。测试期间，站点可能随时发生更改或者关闭。

错误修复
- 修复 downloaderServer#load 会被调用两次的问题 #1378 @paulzzh
- 修复 GUI 未启用的情况下，WebUI 的日志会在一段时间后停止更新的问题，并可能伴随 CPU 使用率上升 @Ghost-chu
- 调整 qBittorrent 的默认并发请求数从 16 到 128 以缩短数据获取耗时 @Ghost-chu
- 修复因配置文件升级脚本错误，Swarm Tracking 模块没有正常工作的问题 @Ghost-chu
杂项更改
- qBittorrent 的 Torrent Properties 缓存的最大大小设置现已被取消，避免因频繁缓存逐出额外请求 API
- 使用较新版本的 qBittorrent 用户可忽略此更改，在较新版本上无需请求 Torrent Properties
Docker
DockerHub: ghostchu/peerbanhelper:v9.0.3
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v9.0.3
部署教程 | 常见问题 | 如何设置下载器
你知道吗：我们最近上线了测试版的国内文档镜像站，用于改善中国大陆用户的文档浏览体验，你可以点此访问镜像站点。新的镜像站点由 EdgeOne Pages 驱动。测试期间，站点可能随时发生更改或者关闭。