Palworld服务器Docker容器更新后RCON配置异常问题解析与解决方案

问题背景

在使用thijsvanloef/palworld-server-docker项目部署Palworld游戏服务器时，用户报告在更新容器和服务器版本后出现了RCON功能异常。具体表现为执行rcon-cli命令时返回YAML解析错误："cli: config: parse file: yaml: line 1: did not find expected key"。

问题分析

通过日志分析和技术讨论，我们发现该问题主要源于RCON配置文件(rcon.yaml)的格式问题。在v0.24.1版本更新后，Docker环境变量中的引号处理方式发生了变化，导致生成的配置文件出现语法错误。

典型的问题配置表现为：

default:
  address: "127.0.0.1:25575"
  password: ""xxxxxx""

注意password字段中出现了双重引号，这是YAML语法不允许的。

根本原因

1. 引号嵌套问题：当在Docker compose文件中使用类似- ADMIN_PASSWORD="yourpassword"的配置时，系统会自动添加额外的引号层，导致最终配置文件出现语法错误。

2. 版本变更影响：v0.24.1版本对配置文件的生成逻辑进行了调整，使得之前可用的配置方式在新版本中不再适用。

解决方案

方案一：修正RCON配置文件

1. 进入容器内部：

docker exec -it palworld-server bash

2. 编辑rcon.yaml文件：

nano /home/steam/server/rcon.yaml

3. 确保配置格式正确，移除多余的引号：

default:
  address: "127.0.0.1:25575"
  password: "yourpassword"

4. 保存文件并退出容器。

方案二：调整Docker Compose配置

在docker-compose.yml中，避免在环境变量值中使用引号：

environment:
  - ADMIN_PASSWORD=yourpassword
  - RCON_ENABLED=true

方案三：设置配置文件为只读

为防止容器重启后配置文件被覆盖，可以将PalWorldSettings.ini设置为只读：

docker exec -it palworld-server chmod 444 /home/steam/server/PalWorldSettings.ini

预防措施

1. 在升级容器版本前，备份重要配置文件
2. 检查更新日志，了解配置格式的变化
3. 使用简单的密码字符串，避免特殊字符带来的解析问题
4. 考虑使用配置卷(volume)来持久化配置文件

技术要点

1. YAML语法规范：YAML文件对引号使用有严格要求，多余的引号会导致解析失败
2. Docker环境变量处理：Docker会对环境变量值进行特定处理，需要注意特殊字符的转义
3. 配置持久化：游戏服务器配置需要适当持久化，防止容器重启导致配置丢失

通过以上解决方案，用户可以恢复RCON功能并确保服务器配置的稳定性。建议在修改配置后重启容器以使更改生效。