切换主题
故障排查
排查问题时先记录时间、页面错误、服务器状态和日志，不要立即删除配置或存档。
面板无法访问或显示 502
- 确认面板 systemd 服务正在运行。
- 确认服务器正在监听面板端口。
- 直接在服务器上访问
http://127.0.0.1:8090/。 - 检查 Nginx 上游端口和协议是否正确。
- 检查云安全组和系统防火墙。
如果面板只监听 127.0.0.1，公网直接访问 IP:8090 不会成功，但 Nginx 本机反向代理可以访问。
服务器状态暂不可用
常见原因是面板用户无法调用授权的 systemd 命令，或服务名不匹配。
日志出现 no new privileges 时，说明面板 systemd 单元的安全限制阻止了 sudo。不要只修改 sudoers；同时检查服务的 NoNewPrivileges 最终生效值和 drop-in 配置。
无法读取配置文件
错误内容类似：
text
找不到配置节 [/Script/Pal.PalGameWorldSettings]处理顺序：
- 确认面板读取的是当前实例实际使用的
PalWorldSettings.ini。 - 确认 PalServer 至少成功启动过一次。
- 检查文件中是否存在正确的配置节。
- 检查文件是否为空、被截断或写入了错误编码。
- 从模板或最近备份恢复后重新加载。
不要直接删除整个 Saved 目录来修复配置读取问题。
存档目录没有写入权限
错误通常包含：
text
面板没有写入存档目录的权限需要让面板服务用户对实际 SaveGames 目录和导入临时目录具有所需权限，同时保持其他系统目录不可写。修复后先上传一个小型测试 ZIP，不要直接重试客户唯一的存档包。
导入存档后要求创建人物
这通常是玩家 GUID 或平台身份映射不一致，不代表世界文件一定损坏。停止继续创建测试人物，保留导入前备份，并使用与当前游戏版本兼容的迁移工具处理玩家映射。
安装 MOD 后无法启动
- 删除最后安装的 MOD。
- 检查是否缺少
.ucas、.utoc或加载器。 - 确认 MOD 支持 Linux Dedicated Server。
- 检查 MOD 是否支持当前游戏版本。
- 查看日志中的第一个插件加载错误，而不是只看最后一行。
RCON 不可用
确认游戏服务运行、RCONEnabled 已开启、管理员密码已设置并且端口有效。保存配置后需要重启 PalServer。
RCON 只在本机使用时，不需要向公网开放端口。
RCON 命令超时
- 等待 10 秒后只重试一次。
- 检查服务器是否正在保存世界或高负载。
- 停止其他 RCON 客户端的高频轮询。
- 查看 PalServer 是否仍正常响应。
更新后玩家无法连接
- 核对客户端和服务端游戏版本。
- 确认服务端更新任务已经结束。
- 检查游戏端口监听状态和防火墙。
- 暂时移除不兼容的 MOD 或插件。
- 查看启动日志是否出现端口占用。
出现 bind couldn't find an open port 时，检查是否存在旧 PalServer 进程或其他服务占用同一端口。
安装时 apt 锁被占用
错误类似：
text
Could not get lock /var/lib/dpkg/lock-frontend
It is held by process unattended-upgr这是系统自动更新正在使用 apt/dpkg，不是 SteamCMD 本身损坏。等待自动更新完成后重试。不要在进程仍运行时手工删除 lock 文件，否则可能破坏软件包数据库。
更新长时间没有进度
先确认日志中的下载字节数是否仍变化。大型资源以每秒数 MB 下载时，耗时十几到几十分钟属于网络吞吐限制。只有进度长时间完全不变化且进程不占用网络时，才按失败处理。