6.4.3

新东西

• 为 FreeBSD 系统添加了 FreeBSD 包 @Gaojianli

更改

• BitComet 支持现在适配 v2.10 正式版预览 版本接口 @Ghost-chu
  • 现在 BitComet 所需的 BouncyCastle 依赖库将在运行时下载，以解决出现的一部分奇怪的签名问题
• 在出现 WebUI 端口监听失败的错误时，显示更加友好的提示信息 @Ghost-chu

错误修复

• 修复用户在城市过滤器中添加空白项时，PeerBanHelper 没有拒绝并接受了请求，导致用户可能意外添加空字符串规则，导致 PBH 封禁所有 Peer。 @Ghost-chu
• 修复在保存封禁列表时，使用 callBatchTasks 避免特殊情况下，用户丢失封禁列表的问题。 @Ghost-chu
• 对 PeerRecords 停止使用 ObjectCache，其优化并不明显，并增加了内存消耗。 @Ghost-chu
• 修复使用数据透视时，部分 IP 查询时错误的显示 “这个 IP 没有被观测到过，但你仍然可以在这里查看他的部分信息” 的问题 @Ghost-chu
• 修复使用数据透视时，可能无法查询到刚刚产生的记录。现在查询时将强制保存缓存的记录。 @Ghost-chu
• 缓解规则统计缓存导致内存溢出崩溃的问题（特别是在加入了 BTN 网络的用户上发生）。晚些时候将重构该模块。 @Ghost-chu
• 修复了 6.4.2 中初始化 BitComet 下载器时提前类加载导致的崩溃的问题

Docker 用户

DockerHub: ghostchu/peerbanhelper:v6.4.3
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v6.4.3

v6.4.1

错误修复

• 修复 6.4.0 版本中用户全新安装时启动失败的问题

Docker 用户

DockerHub: ghostchu/peerbanhelper:v6.4.1
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v6.4.1

v6.4.0

前言

大家好，各位期待已久的 BitComet 下载器支持终于到来了。
在彗星论坛、BitComet 开发者 wxhere 以及各位 PBH 用户们（排名不分先后）的三方共同的努力下，共同推动了相关 BitComet WebAPI 接口的从无到有，并顺利完成了适配。

在此，我需要向下面的朋友致以诚挚的谢意（排名不分先后）：

• wxhere：维护和开发 BitComet 软件，并添加了 PeerBanHelper 所需要的 WebAPI 接口
• @cxzlw ：从 JS 中完成了关键的 BitComet 新版 WebUI 登陆 AES 加密盐值等部分的计算逆向工程并创建了Python实现，帮助 PeerBanHelper 顺利接入到了 BitComet WebUI；完成了 BitComet 支持配套的前端工作
• @Oniicyan : 在 BitComet 的支持到来前，维护 BTNScriptBC 脚本，帮助 BitComet 用户渡过了一段困难时期，如果你还在使用旧版 BitComet，你也许可以看看这个项目；如果你使用的下载器不受支持，也还可以看看 Ta 的 BT_BAN。
• 小樱: 参与了 BitComet WebAPI 的测试，帮助我们少踩了许多坑，并提出了许多建设性的建议
• 以及其它所有为 BitComet WebAPI/PeerBanHelper BitComet 支持的推出提供过力量的朋友，谢谢你们！

新功能

• 添加了对 BitComet 下载器的实验性支持 需要手动设置，请查看文档 @cxzlw @Ghost-chu
  • 需要 v2.10 Beta6 [20240928] 或者更高版本，您可以从这里下载测试版本
• 添加 FreeBSD 包 @Gaojianli

错误修复

• 修复部分页面元素缩放异常的问题 @Gaojianli

已知问题

• 由于接口技术限制，BitComet 的流量数据暂时不会统计在 PeerBanHelper 的流量统计图表中
• BitComet 适配器有时可能出现接口请求超时，但不影响使用。这是 BitComet WebAPI 的一个问题引起的且无法稳定复现。如果你出现了请求超时或者请求消耗大量的时间，欢迎前往 Issue Tracker 提交报告，帮助我们一起检查这个问题

Docker 用户

DockerHub: ghostchu/peerbanhelper:v6.4.0
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v6.4.0

v6.4.0-beta1

Warning

这是一个测试版本，仅用于测试用途，普通用户请勿下载使用此版本。安装使用前，请做好数据备份。

前言

大家好，各位期待已久的 BitComet 下载器支持终于到来了。
在彗星论坛、BitComet 开发者 wxhere 以及各位 PBH 用户们（排名不分先后）的三方共同的努力下，共同推动了相关 BitComet WebAPI 接口的从无到有，并顺利完成了适配。

在此，我需要向下面的朋友致以诚挚的谢意（排名不分先后）：

• wxhere：维护和开发 BitComet 软件，并添加了 PeerBanHelper 所需要的 WebAPI 接口
• @cxzlw ：从 JS 中完成了关键的 BitComet 新版 WebUI 登陆 AES 加密盐值等部分的计算逆向工程并创建了Python实现，帮助 PeerBanHelper 顺利接入到了 BitComet WebUI；完成了 BitComet 支持配套的前端工作
• @Oniicyan : 在 BitComet 的支持到来前，维护 BTNScriptBC 脚本，帮助 BitComet 用户渡过了一段困难时期，如果你还在使用旧版 BitComet，你也许可以看看这个项目；如果你使用的下载器不受支持，也还可以看看 Ta 的 BT_BAN。
• 小樱: 参与了 BitComet WebAPI 的测试，帮助我们少踩了许多坑，并提出了许多建设性的建议
• 以及其它所有为 BitComet WebAPI/PeerBanHelper BitComet 支持的推出提供过力量的朋友，谢谢你们！

新功能

• 添加了对 BitComet 下载器的实验性支持 需要手动设置，请查看文档
  • 需要 v2.10 Beta6 [20240928] 或者更高版本，您可以从这里下载测试版本

已知问题

• 由于接口技术限制，BitComet 的流量数据暂时不会统计在 PeerBanHelper 的流量统计图表中
• 有时可能出现接口请求超时，这是 BitComet WebAPI 的一个问题引起的且无法稳定复现。如果你出现了请求超时或者请求消耗大量的时间，欢迎前往 Issue Tracker 提交报告，帮助我们一起检查这个问题

Docker 用户

DockerHub: ghostchu/peerbanhelper:v6.4.0-beta1
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v6.4.0-beta1

本版为测试版，暂不提供 Windows Portable 包。

v6.3.0

从 6.0 咕咕到现在的 种子/IP地址数据透视 大饼终于画完了！让我们对 FE 团队献上掌声，感谢他们的出色工作，让这个功能得以实现👏。

新功能

[实验性] 种子/IP地址数据透视

注意：PeerBanHelper 默认情况下会删除过旧的且不活动的数据记录以节省磁盘空间和提升查询性能，您可以从配置文件更改删除条件

术语表：

• 访问历史：指 Peer 连接到您的下载器后的产生会话记录，包括流量快照、种子名称、PeerID/ClientName 等数据
• 封禁历史：指 PBH 封禁 Peer 时在数据库中记录的数据，包括流量快照、种子名称、PeerID/ClientName，封禁理由，命中规则等数据

通过上述数据，您可以检查特定种子或者 IP 地址在您下载器上的行为活动，判定是否异常（如随机变换 PeerID、下载多个毫不关联的种子文件等）。

种子数据透视

在种子数据页面，可查看 PeerBanHelper 运行过程中记录的与种子有关的数据，如：

• 种子 Info Hash（用于区分不同种子，在下载器爆炸时，还可以用来拯救丢失的种子）
• 封禁数据（需要有效的PBH Plus许可证）
• 访问数据（需要有效的PBH Plus许可证）

点击访问记录按钮，可以查看所有连接到此种子上上传/下载的历史用户数据，包括客户端基本信息，会话时间区间和会话流量快照。

点击封禁记录，可以查看此种子的封禁历史记录。

如果对某个 IP 地址有疑问，可以点击 IP 地址，进入 IP 数据透视页面。

IP地址数据透视

通过点击 IP 地址/数据透视菜单可进入 “IP 地址数据透视” 功能菜单。

输入 IP 地址，点击查询按钮，将开始检索 PeerBanHelper 记录数据库，并列出与此 IP 地址有关的数据，如访问历史和封禁历史。

如果是 PBH Plus 用户，可展开手风琴折叠菜单，查看 IP 关联的封禁记录和访问记录。

如果对 IP 有任何疑问，可通过 ping0 进行 “IP 定位和风险评估”，并通过 “Censys” 查看 IP 上正在（或曾经）开放的端口和服务的信息。
对于第三方网站的结果，PBH-BTN不对其负任何责任。

ping0 风险评估	Censys 服务扫描

Contributor: @Gaojianli @Ghost-chu

体验优化

• 延长 IPDB 过期的时间，IPDB 有时没那么频繁的更新
• 改进 ActiveMonitoring 和 ProgressCheatBlocker 在写盘保存数据时，在 256MB 的 Heap 下运行的 PBH 进行集合复制时可能引发 OOM 的问题

错误修复

• 当用户添加订阅规则时如果包含特殊符号，会导致无法删除的问题
• 修复解封 banForDisconnect 的 IP 时时也在控制台提示解封信息的问题
• 修复了一个 SQLite 竞态条件下引发的事务嵌套执行 SQL 出现 cannot start a transaction within a transaction 失败的问题
• 修复子网 tooltip 的 prefixLength 丢失的问题

Docker 用户

DockerHub: ghostchu/peerbanhelper:v6.3.0
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v6.3.0

v6.2.8

好好好，一发稳定版 BUG 就全都找到了是吧（

错误修复

• 修复用户设置 Token 时添加非 ASCII 字符时出现 Headers 请求错误
• 修复 qBittorrent 封禁列表全量修复失败的问题，导致封禁操作失败
• 修复 banWave 过程中出现错误时，异常被静默吞掉的问题

Docker 用户

DockerHub: ghostchu/peerbanhelper:v6.2.8
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v6.2.8

v6.2.7

【稳定版】经过一段时间的沉淀，我们终于迎来了自 5.1.0 以来的新的稳定版本。
请用上面的版本

改进

• 下载时支持使用 gzip 压缩的 IPDB 数据库文件，节约 CDN 流量并缩短下载所需时间

错误修复

• 本版没有发现需要修复的错误

Docker 用户

DockerHub: ghostchu/peerbanhelper:v6.2.7
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v6.2.7

v6.2.6

本版没有主程序更新，Windows、macOS、Linux、Docker 用户无需更新。

程序打包调整

• 更新群晖 SPK 套件 INFO 清单内容

v6.2.5

🥮本版本由青红丝五仁月饼赞助发布，豆沙月饼提供技术支持

我们在 6.2.2+ 的版本中重建了我们的构建-发布系统。显然，不幸的是，新的系统在 6.2.2-6.2.4 版本中崩塌了。我们在多次沟通调试后，于 6.2.5 中对新的系统完成了修复工作。对于今天早些时候因 Watch 仓库导致版本邮件轰炸的用户我们深表歉意。

新功能

• 新增对 macOS(.dmg)、Linux x64 通用(.sh)、Debian/Ubuntu(.deb)、RedHat/Fedora(.rpm)、Synology DSM 7.x(.spk) 的软件包打包（实验性） @Ghost-chu @Gaojianli
  • 其中，群晖 DSM 的软件包使用 Docker 实现，安装套件时，将自动配置和管理 Docker 容器和路径挂载
  • Deb 安装包需要 java-runtime(>=21)
• 添加对 qBittorrent 4.x 的 Private Torrent 私有种子跳过支持 @ccloli @paulzzh

中国大陆地区网络定向优化

• 新增 IPDB 中国大陆 CDN 备用源。当下载失败或未在 120 秒内完成下载时，将自动回退使用备用源。
• 新用户现在默认使用 sparkle.ghostchu.com/ping/config 连接 BTN 服务器获取配置（仍然需要手动启用）
  • 具体提交和后续获取规则使用的服务器，由 BTN 服务器根据您的 IP 地址动态下发配置

用户体验改进

• 当鼠标悬浮在 WebUI 的报错消息上时，消息不再自行消失 @MirrorCY
• 当暂无趋势数据时，显示空占位符 @Gaojianli
• 当用户计算机上已有合适版本的 Java 运行环境时，安装程序将跳过 Java 运行环境的安装

性能优化

• 封禁计数图表（按日）查询优化，提升约 80% 的查询速度 @Ghost-chu

错误修复

• 修复了解决依赖项的镜像服务器测试时可能无限期卡住的问题 @Ghost-chu
• 修复 WebUI 页脚的一个显示错误 @Gaojianli
• 修复程序使用的图标不是正方形，导致的显示问题 @Ghost-chu
• 修复本地即使有 IPDB 文件，但 IPDB 文件需要更新且更新失败时，IPDB 被错误禁用的问题 @Ghost-chu
• 修复 PeerRecord 保存失败时，会无限重试，导致内存缓存队列上涨耗尽堆内存的问题 @Ghost-chu
• 修复 IP 地址无效时，仍然会被处理的问题 @Ghost-chu
• 过滤 qBittorrent 上的 Tor 和 I2P 用户地址，避免处理出错 @Ghost-chu

适配器

Vuze/Azureus

• 合并 BiglyBT 适配器的更改

Docker 用户

DockerHub: ghostchu/peerbanhelper:v6.2.5
阿里云国内镜像加速: registry.cn-hangzhou.aliyuncs.com/ghostchu/peerbanhelper:v6.2.5

v6.2.4

由 6.2.5 取代。