Skip to content

Commit

Permalink
Merge branch 'master' into master
Browse files Browse the repository at this point in the history
  • Loading branch information
Ghost-chu authored Dec 6, 2024
2 parents c0f62aa + 8ec2282 commit 2b4b879
Show file tree
Hide file tree
Showing 27 changed files with 426 additions and 1,025 deletions.
6 changes: 3 additions & 3 deletions docs/intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ sidebar_position: 1

## PeerBanHelper:开源共享的力量

PeerBanHelper 是一款开源软件,您可以自由传播并免费下载
PeerBanHelper 是一个开源软件,您可以自由的传播和免费下载 PeerBanHelper

但请注意,PeerBanHelper 的部分高级功能可能需要您输入许可证。您可以通过[爱发电平台](https://afdian.com/a/Ghost_chu)赞助获取许可证,或者向已拥有许可证的朋友借用(不用担心,这是被允许的,您完全可以这么做😎)
所有许可证收入将用于维护 PBH-BTN 的基础设施,并奖励我们辛勤付出的社区维护者
如果 PeerBanHelper 对你有所帮助,考虑在[爱发电](https://afdian.com/a/Ghost_chu)捐赠支持我们
所有的捐赠收入都将用于维护 PBH-BTN 的基础设施以及奖励我们辛勤的社区维护者们
1 change: 0 additions & 1 deletion docs/module/progress-cheat-blocker.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,5 +90,4 @@ PBH 持续追踪 Peer 的下载进度,并计算其上传量和上传增量。
## 缺陷
* 如果对方使用 “超级做种”,那么这可能会导致意外封禁。
* 如果没有关闭下载器的 “允许来自同一 IP 地址的多个连接”,则可能导致统计数据出错,成倍增加快速增长。这个选项默认是关闭的。
Original file line number Diff line number Diff line change
Expand Up @@ -6,80 +6,81 @@ sidebar_position: 2

:::tip

PeerBanHelper BiglyBT 完全兼容,支持最佳。
PeerBanHelper is fully compatible with BiglyBT and provides optimal support.

:::

PeerBanHelper 将借助 BiglyBT 的插件系统连接到 BiglyBT
PeerBanHelper connects to BiglyBT using BiglyBT's plugin system.

请注意你的 BiglyBT 运行的 Java 版本必须是 Java 11+ 版本。如果是 Java 8 或者更低版本,则无法使用,必须[切换 Java 版本](https://github.com/BiglySoftware/BiglyBT/wiki/Java-Versions)
Please note that your BiglyBT must be running Java version 11 or higher. If you're using Java 8 or an older version, it won't work, and you'll need to [switch your Java version](https://github.com/BiglySoftware/BiglyBT/wiki/Java-Versions).

## 确认 BiglyBTJava 版本
## Verify BiglyBT's Java Version

1. 点击 BiglyBT/Vuze/Azureus 的 “帮助” 菜单,并点击 “关于 BiglyBT/Vuze/Azureus
2. 查看右侧的 “系统信息” 窗口,查看 `Java ` 后面的版本号,如果是 `8` 或者 `1.8` 则不受支持。你需要升级 Java 版本。
1. Click the "Help" menu in BiglyBT/Vuze/Azureus and select "About BiglyBT/Vuze/Azureus."
2. Check the "System Information" window on the right-hand side for the version number after `Java`. If it shows `8` or `1.8`, it is not supported, and you will need to upgrade your Java version.

![step1](assets/BiglyBT-step1.png)
![step2](assets/BiglyBT-step2.png)

## 升级 Java 版本(按需)
## Upgrade Java Version (if needed)

如果很不幸,你是 Java 8 版本的受害者,则需要升级 Java 版本。
If you're unfortunate enough to be stuck with Java 8, you will need to upgrade your Java version.

升级的方式很简单,首先从 [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts&os=windows&architecture=x86-64-bit&package=jdk#zulu) 下载 Java 21 的 JDK。通过这个链接打开时,页面会自动为您筛选适合的 JDK,直接下载安装即可。
Upgrading is simple. First, download Java 21 JDK from [Azul Zulu](https://www.azul.com/downloads/?version=java-21-lts&os=windows&architecture=x86-64-bit&package=jdk#zulu). This link will automatically filter the appropriate JDK for your system. Download and install it.

## 安装 PBH-BiglyBT/PBH-Azureus 适配器
## Install PBH-BiglyBT/PBH-Azureus Adapter

下载 BiglyBT 适配器:[PBH-BTN/PBH-Adapter-BiglyBT](https://github.com/PBH-BTN/PBH-Adapter-BiglyBT/releases),下载时请选择以 .jar 结尾的 JAR 包
下载 Azureus/Vuze 适配器:[PBH-BTN/PBH-Adapter-Azureus](https://github.com/PBH-BTN/PBH-Adapter-Azureus/releases)
Download the BiglyBT adapter: [PBH-BTN/PBH-Adapter-BiglyBT](https://github.com/PBH-BTN/PBH-Adapter-BiglyBT/releases). Choose the JAR file ending in `.jar` when downloading.
Download the Azureus/Vuze adapter: [PBH-BTN/PBH-Adapter-Azureus](https://github.com/PBH-BTN/PBH-Adapter-Azureus/releases).

接下来的过程大同小异。
The installation process is similar for both.

选择 “工具 -> 插件 -> 从文件安装……”
Go to "Tools -> Plugins -> Install from File..."

![step3](assets/BiglyBT-step3.png)

选中刚刚下载的 JAR 包下一步安装。
Select the downloaded JAR file and proceed with the installation.

![step4](assets/BiglyBT-step4.png)

如果 BiglyBT 询问您为谁安装,请根据自己的需要选择。如无特殊要求,请选择默认的选项。
If BiglyBT asks who to install the plugin for, choose based on your preference. If unsure, select the default option.

![step5](assets/BiglyBT-step5.png)

弹出插件安装对话框后,请点击 “安装” 按钮。
When the plugin installation dialog appears, click the "Install" button.

![step6](assets/BiglyBT-step6.png)

如果弹出安全警告,请您允许继续安装。
If a security warning pops up, allow the installation to continue.

![step7](assets/BiglyBT-step7.png)

直到提示安装成功,此时 PeerBanHelper BiglyBT Adapter 适配器的安装过程就完成了。请根据下面的教程继续配置。
Once the installation is complete, the PeerBanHelper BiglyBT Adapter is ready. Follow the steps below to configure it.

![step8](assets/BiglyBT-step8.png)

## 配置 PBH-BiglyBT/PBH-Azureus 适配器
## Configure PBH-BiglyBT/PBH-Azureus Adapter

为了安全起见,PBH-Adapter-BiglyBT 将会生成一个随机 Token,你需要获取这个随机 Token 才能在 PeerBanHelper 中连接到您的 BiglyBT 下载器。
点击 “工具->选项” 打开选项窗口。点击 “插件” 左侧的倒三角标志,展开插件配置菜单。
For security purposes, PBH-Adapter-BiglyBT generates a random token. You will need this token to connect PeerBanHelper to your BiglyBT client.

Click "Tools -> Options" to open the options window. Expand the plugin configuration menu by clicking the triangle icon next to "Plugins."

![step9](assets/BiglyBT-step9.png)

找到 “PeerBanHelper 适配器 - 配置界面”,点击进入配置页面。
Find "PeerBanHelper Adapter - Configuration Interface" and click to enter the configuration page.

![step10](assets/BiglyBT-step10.png)

配置 API 端口号,并记下 Token。**随后点击保存按钮,请务必点击一次,否则重启后 Token 将重新生成。**
Set the API port number and note the token. **Make sure to click the save button; otherwise, the token will regenerate after restarting.**

![step11](assets/BiglyBT-step11.png)

## 连接到 PeerBanHelper
## Connect to PeerBanHelper

在添加下载器的页面,选择 BiglyBTAzureus/Vuze 用户也请选择这个)
When adding a downloader, select BiglyBT (Azureus/Vuze users should also choose this option).

选择 “BiglyBT”,并填写刚刚设置的端口号和记下的 Token:
Choose "BiglyBT" and enter the port number and token you noted earlier:

![step12](assets/BiglyBT-step12.png)

确定保存即添加完成。
Click save to complete the setup.
Original file line number Diff line number Diff line change
Expand Up @@ -4,65 +4,66 @@ sidebar_position: 5

# BitComet

PeerBanHelper 使用 BitComet WebAPI 与 BitComet 交互。本章将介绍如何为 BitComet 启用 WebAPI 并将 PeerBanHelper BitComet 连接。
PeerBanHelper interacts with BitComet using the BitComet WebAPI. This chapter will guide you on enabling the WebAPI for BitComet and connecting PeerBanHelper to BitComet.

## 提示
## Notice

:::danger

特别提示:BitComet 的支持目前处于高度实验性的状态,对封禁效果和运行稳定性不做任何保证。
Special Note: Support for BitComet is currently highly experimental, and there are no guarantees regarding ban effectiveness or stability.

:::

BitComet 用户可能频繁遇到 “正在封禁的 Peer 已处于封禁列表中”,此问题是由于 BitComet 的封禁操作是异步处理的,您可以安全的忽略这个警告(除非它连续不停地一直在提示)。
如果您遇到封禁线程未响应或 "Unable to retrieve peers" 的错误提示,这通常是由于 BitComet 的 WebAPI 超时未响应的问题。该问题已被汇报给 BitComet,但目前尚未得到修复。请您无需担心,PBH 会在下一次封禁流程中,重新获取。
BitComet users may frequently encounter the message "The peer being banned is already in the ban list." This issue arises because BitComet processes bans asynchronously. You can safely ignore this warning unless it appears continuously without stopping.
If you see errors like "Ban thread unresponsive" or "Unable to retrieve peers," these are typically caused by BitComet's WebAPI timeout issues. This problem has been reported to BitComet but remains unresolved. You don't need to worry, as PBH will retry in the next ban process.

## 确认版本
## Verify Version

PeerBanHelper 使用的 WebAPI 仅在 `v2.10 Beta6 [20240928]` 或者更高版本中可用。截至本文撰写时,v2.10 正式版还未发布。如果已发布正式版,请直接使用 v2.10 或者更高版本的正式版。
任何更低版本的 BitComet 均无法使用且不受支持。
The WebAPI required by PeerBanHelper is only available in `v2.10 Beta6 [20240928]` or later. As of this writing, the v2.10 stable version has not yet been released. Once it is, you should use v2.10 or a later stable release.
Any earlier versions of BitComet are unsupported and will not work.

## 开启 IP 过滤器
## Enable IP Filter

“工具->选项” 打开 BitComet 设置界面,在打开的设置窗口的左侧树形菜单中依次展开 “任务-> BT 下载 -> IP 过滤器”,在过滤器配置页面勾选 “按 IP 列表筛选 Peer”,并选择 “黑名单模式”。
Open the BitComet settings interface by selecting "Tools -> Options." In the settings window, expand the left-side menu tree under "Tasks -> BT Download -> IP Filter." On the filter configuration page, check "Filter peers using IP list" and select "Blacklist mode."

![step1](./assets/BitComet-step1.jpg)

## 配置禁止多重连接
## Configure Multi-Connection Ban

允许多重连接会扰乱 PBH 的反作弊代码,因此必须将其禁用。
Allowing multiple connections disrupts PBH's anti-cheating mechanism and must be disabled.

在打开的设置窗口的左侧树形菜单中选择 “高级设置”,找到 `bittorrent.multi_peers_same_ip`,将它的值设置为 “否”。
In the settings window, navigate to "Advanced Settings" in the left-side menu tree, find `bittorrent.multi_peers_same_ip`, and set its value to "No."

![step2](./assets/BitComet-step2.jpg)

## 禁用 WebUI 限速
## Disable WebUI Speed Limits

默认情况下,WebUI 会受到网络连接中的速度限制选项的限制,这会影响 PBH 访问 BitComet WebAPI 的性能,并导致封禁失败和延迟,因此需要将其禁用。
By default, the WebUI is affected by network speed limit settings, which can hinder PBH's performance when accessing the BitComet WebAPI, leading to failed bans and delays. This limitation must be disabled.

在打开的设置窗口的左侧树形菜单中选择 “高级设置”,找到 `network.ignore_remote_access_in_speed_limit`,将它的值设置为 “是”。
In the settings window, navigate to "Advanced Settings" in the left-side menu tree, find `network.ignore_remote_access_in_speed_limit`, and set its value to "Yes."

![step3](./assets/BitComet-step3.png)

## 启用远程访问
## Enable Remote Access

PeerBanHelper 需要使用远程访问功能连接 BitComet,这个功能默认关闭,需要您手动将其开启。
PeerBanHelper requires the remote access feature to connect to BitComet. This feature is disabled by default and needs to be manually enabled.

在打开的设置窗口的左侧树形菜单中选择 “高级设置->远程访问”,勾选 “启用网页版远程访问”,并设置一个用户名和密码。
向下滚动,你还会看到端口号的设置,请记下上面显示的端口号设置。
In the settings window, navigate to "Advanced Settings -> Remote Access," check "Enable Web Remote Access," and set a username and password.
Scroll down to find the port number setting and note the displayed port number.

![step4](./assets/BitComet-step4.png)

全部填写完毕后,请记得保存。
After completing these configurations, remember to save them.

## 在 PeerBanHelper 中添加 BitComet
## Add BitComet in PeerBanHelper

PeerBanHelper 中打开添加下载器窗口,选择 BitComet 类型。
Open the downloader addition window in PeerBanHelper and select the BitComet type.

地址分为两种情况:
The address depends on your setup:

* 如果 BitComet PeerBanHelper 在同一台设备上,请使用 `http://127.0.0.1:端口号`,其中 `端口号` 替换为你在上面步骤中记下的端口
* 如果 BitComet PeerBanHelper 不在同一台设备上,请使用 BitComet 软件的 “高级设置->远程访问” 界面中,显示在用户名和密码框下面的地址
* If BitComet and PeerBanHelper are on the same device, use `http://127.0.0.1:port_number`, replacing `port_number` with the port you noted earlier.
* If BitComet and PeerBanHelper are on different devices, use the address shown in the "Advanced Settings -> Remote Access" interface of BitComet, below the username and password fields.

![step5](./assets/BitComet-step5.png)

最后确定保存,测试通过即可使用。
Finally, save the configuration. Once the connection test passes, you're all set to use it.
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,4 @@ sidebar_position: 4

# Deluge

还在施工
Work in progress.
Loading

0 comments on commit 2b4b879

Please sign in to comment.