跳到主要内容

手动部署指南

提示

虽然以下提供了手动部署的步骤，但我们更推荐使用 Docker部署方案 以确保更稳定和便捷的安装体验。

安装依赖项​

首先，您需要使用系统的包管理器来安装 OpenJDK 21 或更高版本的 Java 开发工具包（JDK）。以下示例以 apt 包管理器为例：

sudo apt-get update
sudo apt-get install openjdk-21-jdk-headless -y

安装完成后，您可以通过运行以下命令来验证 JDK 是否成功安装：

java -version

如果安装成功，终端将显示类似以下的版本号信息：

OpenJDK version "xx.xx.xxx" xxxx-xx-xx
OpenJDK Runtime Environment (build xxxxxxx)
OpenJDK 64-Bit Server VM (build xxxxxxx, mixed mode, sharing)

下载 JAR 文件及依赖库​

接下来，您需要访问 PBH最新版版本发布页 下载最新的 JAR 文件以及 libraries.tar.gz 压缩包。

下载完成后，请解压 libraries.tar.gz 压缩包，并将解压得到的 libraries 文件夹与 JAR 文件放置在同一目录下。

启动 PeerBanHelper​

使用以下命令来启动 PeerBanHelper（请将命令中的“替换这段文字为JAR文件的文件名”替换为您实际下载的 JAR 文件的名称）：

java -Xmx512M -XX:+UseG1GC -XX:+UseStringDeduplication -XX:+ShrinkHeapInSteps -jar 您的JAR文件名.jar

通常情况下，PeerBanHelper 会自动检测桌面环境，并在支持的情况下启用图形用户界面（GUI）。但在某些设备上，GUI 可能无法成功初始化。如果遇到此类情况，您可以通过在命令末尾添加 nogui 参数来手动禁用 GUI：

java -Xmx512M -XX:+UseG1GC -XX:+UseStringDeduplication -XX:+ShrinkHeapInSteps -jar 您的JAR文件名.jar nogui

这样即可启动 PeerBanHelper。如果您希望 PeerBanHelper 在后台运行或在系统启动时自动运行，请自行配置 systemd 系统服务 以实现这一功能。