幻兽帕鲁服务器管理工具

简体中文 | English | 日本語

通过可视化界面及 REST 接口管理幻兽帕鲁专用服务器，基于 SAV 存档解析、官方 REST API 与 RCON 实现。

        

功能

• 玩家、公会、帕鲁和背包数据查看
• 服务器信息、指标和在线玩家列表
• 踢出、封禁、广播和平滑关闭服务器
• 可视化地图与白名单管理
• 自定义及定时 RCON 命令
• 存档定时同步、自动备份与备份管理
• 桌面端和移动端自适应界面
• 管理模式中的可视化 PST 配置

业务数据保存在 pst.db，PST 配置和管理员凭据单独保存在 config.db。清理或重置配置不会影响玩家、公会、RCON 和备份记录。

功能截图

桌面端

移动端

开启 REST API 与 RCON

PST 需要游戏服务器开启官方 REST API；自定义 RCON 功能还需要开启 RCON。RCON 命令参考

关闭游戏服务器后，可通过 Pal-Conf 修改 PalWorldSettings.ini 或 WorldOption.sav，先设置游戏服务器的管理员密码，再启用 RCON 和 REST API。

安装部署

解析 Level.sav 会在短时间内使用约 1GB～3GB 内存，请确保运行环境有足够资源。

文件部署

1. 从 GitHub Releases 下载对应系统和架构的压缩包并解压。
2. Linux/macOS 给 pst 和 sav_cli 增加执行权限并运行 ./pst；Windows 双击 start.bat，或在 PowerShell 中运行 .\pst.exe。
3. 浏览器访问 http://127.0.0.1:8080 或 http://{服务器 IP}:8080，创建管理员并在 Web 弹窗中完成配置。

首次启动使用端口 8080。如果该端口已被占用，可以通过命令行参数或环境变量覆盖监听端口：

# Linux/macOS：命令行参数
./pst --port 18080

# Linux/macOS：环境变量
PST_PORT=18080 ./pst

Windows 可以在 PowerShell 中临时指定端口：

.\pst.exe --port 18080

需要固定双击启动时的默认端口，可以用文本编辑器打开解压目录中的 start.bat，将启动命令修改为：

start cmd /k .\pst.exe --port 18080

端口优先级为 --port > PST_PORT > config.db > 默认值 8080。使用命令行参数或环境变量启动时，最终端口和 port_source 覆盖来源会同步写入 config.db，确保 sav_cli 等内部服务读取到的端口与实际监听端口一致。覆盖存在期间，配置中心会显示实际端口和覆盖来源，并禁用端口输入框；配置接口也会拒绝修改端口。每次启动都会重新计算来源；移除覆盖后，config.db 会保留最后一次覆盖的端口并将 port_source 置空，此时可以再从 Web 修改。

如在 Web 中修改端口、TLS 或其他启动设置，保存后重启 PST。

Docker 单体部署

先创建需要持久化的数据库文件：

touch pst.db config.db

运行容器，并把游戏存档目录映射到容器内：

docker run -d --name pst \
  -p 8080:8080 \
  -v /path/to/your/Pal/Saved:/game \
  -v ./backups:/app/backups \
  -v ./pst.db:/app/pst.db \
  -v ./config.db:/app/config.db \
  jokerwho/palworld-server-tool:latest

需要覆盖容器内的 PST 监听端口时，同时调整端口映射并传入 PST_PORT，例如：

docker run -d --name pst \
  -p 18080:18080 \
  -e PST_PORT=18080 \
  -v /path/to/your/Pal/Saved:/game \
  -v ./backups:/app/backups \
  -v ./pst.db:/app/pst.db \
  -v ./config.db:/app/config.db \
  jokerwho/palworld-server-tool:latest

进入 Web 配置后选择“本机目录”，填写或浏览选择容器内的 /game。RCON 和 REST API 地址必须是容器能够访问的游戏服务器地址。

pst.db 保存业务数据，config.db 只保存配置和管理员凭据，两者应分别持久化。需要重置管理员和全部配置时，停止 PST、删除 config.db 后重新启动即可。

Agent 部署

游戏服务器与 PST 不在同一主机时，先在游戏服务器侧启动 pst-agent：

docker run -d --name pst-agent \
  -p 8081:8081 \
  -v /path/to/your/Pal/Saved:/game \
  -e SAVED_DIR="/game" \
  jokerwho/palworld-server-tool-agent:latest

再按上面的方式启动 PST，不需要为 PST 容器传入配置环境变量。进入 Web 配置，选择“pst-agent”，填写 http://游戏服务器IP:8081/sync，并配置 RCON 与 REST API 地址。

pst-agent 自身仍使用命令行参数或 SAVED_DIR 指定存档目录，详细操作见 pst-agent 部署教程。

首次进入与配置

1. 访问 PST Web 页面。首次访问必须创建管理模式密码，此操作只允许成功一次。该密码只保护 PST Web 面板，不是游戏服务器的 AdminPassword。
2. 首位访问者会成为管理员。如果被他人抢先设置，停止 PST，删除 config.db 后重新启动；pst.db 不受影响。
3. 创建管理员后会自动打开配置弹窗。选择“本机目录”时，可以直接浏览 PST 所在主机的文件系统；跨主机请选择“pst-agent”并填写同步 URL。
4. 存档和 RCON 配置组会显示“未配置 / 报错 / 正常”状态；RCON 可通过官方只读 Info 命令测试连接，不会修改游戏服务器状态。
5. 填写 RCON、REST API、同步、备份和自动化选项并保存。存档来源、RCON、REST、消息、管理选项和管理员密码等立即生效；只有 Web 监听/TLS 与定时任务周期变化需要重启，页面会列出具体项目。
6. 后续从管理模式的“PST 配置”入口修改。管理员密码更换后，旧登录令牌立即失效。

所有持久化配置均写入当前工作目录的 config.db。启动时通过 --port 或 PST_PORT 得到的最终端口及其覆盖来源也会同步写入该数据库。以下旧配置入口已经删除，不提供兼容读取路径：

• config.yaml
• -config 命令行参数
• WEB__*、RCON__*、REST__*、SAVE__*、TASK__*、MANAGE__* 等 PST 环境变量

开发与接口文档

• APIFox 在线接口文档
• 本地 Swagger：http://127.0.0.1:8080/swagger/index.html

感谢

• palworld-save-tools 提供存档解析工具实现
• palworld-server-toolkit 提供存档高性能解析部分实现
• pal-conf 提供游戏服务器配置生成器
• PalEdit 提供最初的数据化思路及逻辑
• gorcon 提供 RCON 请求/接收基础能力

许可证

根据 Apache 2.0 许可证 授权，任何转载请在 README 和文件部分标明；任何商用行为请务必告知。