服务器存档同步
帕鲁服务器存档同步
使用 palbeacon-cli 将自建 Palworld 私人服务器的世界存档连接到 PalBeacon。客户端在服务器主机上只读检查源文件，在安全副本上解析，并把控制台所需的脱敏库存数据主动同步到云端。
登录并创建同步设备为什么控制台需要存档同步
PalBeacon 不从游戏服务器开放的控制接口读取库存。同步设备把当前世界的玩家、公会和帕鲁事实带入控制台，让库存、数据状态和配种路线使用同一份快照。
- 先在账户页创建同步设备，再复制一次性配对码。
- 设备状态会分别显示最近检测时间、上次上传时间和授权是否仍然有效。
- 首次同步完成后，玩家可以按游戏昵称认领自己的角色。
安装并初始化 palbeacon-cli
当前 npm 包支持 Linux x64 与 Windows x64，需要 Node.js 22 或更高版本。两个平台使用相同的安装命令，包内会自动选择对应的自包含解析器。
npm install -g palbeacon-clipalbeacon init- palbeacon init 只验证平台和路径、完成设备配对并保存当前用户配置，不执行首次同步。
- 运行时不下载或编译解析器，也不要求 Python、编译器或额外运行库。
选择正确的世界目录
输入包含 Level.sav 与 Players/ 的目标世界目录，或只包含一个世界的上层目录。客户端会在受控深度内查找唯一的 Level.sav，并拒绝符号链接和过于宽泛的路径。
- 路径可以包含空格或 Unicode；Windows 也支持盘符路径。
- 如果发现多个世界，客户端会要求把路径缩小到目标世界，而不会自行猜测。
- 当前不提供浏览器直接上传，也不支持 macOS、其他架构或单人本地存档。
启动同步并查看状态
palbeacon run 是持续运行的前台命令。启动后会立即同步一次，之后默认每 300 秒检查存档变化；保持进程运行即可持续更新。
palbeacon run- 存档没有变化时只发送设备心跳，不重复解析和上传库存。
- 临时网络或解析失败只影响当前轮次；设备授权失效时会停止并提示重新配对。
- 库存发布后可在控制台核对同步状态，并从未认领角色中选择自己的昵称。
源存档、临时副本与上传边界
每轮同步先重复检查源文件是否稳定，再复制 Level.sav 和 Players/ 中的角色存档到当前用户的临时目录。解析器只接收这个副本，结束后清理临时文件。
- 客户端不会修改真实存档，也不会执行保存、重启或其他服务器控制命令。
- 完整存档不会上传到 PalBeacon；解析始终发生在服务器主机上的安全副本中。
- 上传内容限于库存和配种所需的玩家、公会、帕鲁、被动、性别、所有者与位置事实。
- 世界、玩家、公会、帕鲁实例和位置标识会在上传前哈希脱敏，原始解析 metadata 不进入上传载荷。
常见问题
存档同步常见问题
应该在什么设备上运行同步客户端？
在能够读取目标服务器世界存档的 Linux x64 或 Windows x64 主机上运行，并安装 Node.js 22 或更高版本。
palbeacon init 会立刻上传存档吗？
不会。init 只完成平台与目录验证、设备配对和配置保存；运行 palbeacon run 后才会立即执行首次同步。
一个目录里有多个世界怎么办？
把路径改为只包含目标 Level.sav 与 Players/ 的世界目录。客户端检测到多个世界时会停止，不会替你选择。
PalBeacon 会上传完整的 Level.sav 吗？
不会。Level.sav 与角色存档只会复制到本机临时目录解析，云端只接收库存和配种功能需要的脱敏数据。
同步失败会修改或修复游戏存档吗？
不会。失败只影响当前同步轮次；客户端不写回、修复或控制游戏服务器。
继续了解