Palworld服务器Docker容器中RCON认证失败问题分析与解决方案

问题背景

在使用thijsvanloef/palworld-server-docker项目部署Palworld专用服务器时，许多用户遇到了RCON认证失败的问题。具体表现为：当设置了ADMIN_PASSWORD环境变量后，通过docker exec执行的rcon-cli命令始终返回"authentication failed"错误，而将密码设为空字符串时却能正常工作。

问题现象

用户在docker-compose.yml中配置了如下环境变量：

environment:
  - RCON_ENABLED=true
  - RCON_PORT=25575
  - ADMIN_PASSWORD="test1234"

但执行docker exec -it <containerID> rcon-cli --password <ADMIN_PASSWORD> info命令时，服务器返回认证失败信息。

根本原因分析

经过深入调查，发现该问题主要有两个潜在原因：

1. 配置文件生成问题：早期版本的Docker镜像在生成PalWorldSettings.ini文件时存在格式问题，导致密码设置未被正确应用。

2. 世界存档冲突：对于从单人/合作模式存档迁移而来的服务器，WorldOption.sav文件中保存的旧配置会覆盖PalWorldSettings.ini中的新设置，导致密码认证失效。

解决方案

方法一：更新镜像并重建配置文件

1. 确保使用最新版本的thijsvanloef/palworld-server-docker镜像(0.19.1及以上)
2. 删除现有的PalWorldSettings.ini文件

   rm ./game/Pal/Saved/Config/LinuxServer/PalWorldSettings.ini
   

3. 重启Docker容器

方法二：处理迁移存档的特殊情况

对于从单人/合作模式迁移而来的服务器存档，需要额外执行以下步骤：

1. 定位并备份WorldOption.sav文件

   cp ./game/Pal/Saved/SaveGames/0/<world_id>/WorldOption.sav ./WorldOption.sav.bak
   

2. 删除原WorldOption.sav文件

   rm ./game/Pal/Saved/SaveGames/0/<world_id>/WorldOption.sav
   

3. 重启服务器容器

注意：删除WorldOption.sav后，玩家首次连接服务器时需要重新选择出生点，但所有建筑、生产进度和Pal都会保留。

技术细节

Palworld服务器的配置优先级如下：

1. WorldOption.sav (存档特定的配置)
2. PalWorldSettings.ini (服务器全局配置)
3. 环境变量 (Docker容器运行时配置)

当WorldOption.sav存在时，它会覆盖其他配置源中的设置。这就是为什么迁移的存档可能导致RCON密码设置失效。

最佳实践建议

1. 对于新服务器，建议直接使用专用服务器模式创建，而非迁移单人存档
2. 定期备份服务器配置和存档文件
3. 在修改服务器配置后，总是检查PalWorldSettings.ini文件内容是否按预期更新
4. 考虑使用版本控制系统管理服务器配置文件

总结

Palworld服务器Docker容器中的RCON认证问题通常源于配置文件的生成问题或存档冲突。通过更新镜像、重建配置文件或处理迁移存档的特殊文件，可以有效地解决这一问题。理解Palworld服务器的配置加载机制有助于更好地管理和维护游戏服务器。