Palworld服务器Docker容器中PUBLIC_PORT环境变量失效问题分析

问题概述

在使用thijsvanloef/palworld-server-docker项目部署Palworld游戏服务器时，发现通过docker-compose.yml配置的PUBLIC_PORT环境变量未能正确应用到PalWorldSettings.ini配置文件中。这个问题会导致服务器在社区服务器列表中显示错误的端口号，影响玩家通过服务器列表直接连接。

技术背景

Palworld服务器使用两个关键端口配置：

1. 游戏端口：默认8211，用于实际游戏数据传输
2. 公共端口：用于服务器列表展示和查询

在Docker部署方案中，这些端口通常通过环境变量配置，然后由启动脚本生成最终的服务器配置文件。

问题根源分析

经过代码审查发现，在项目的compile-settings.sh脚本中存在一个环境变量处理缺陷。具体表现为：

1. 脚本中虽然定义了PUBLIC_PORT环境变量的处理逻辑
2. 但缺少对PUBLIC_PORT变量的默认值设置
3. 当PUBLIC_PORT未设置时，脚本没有使用预期的回退机制

正确的实现应该包含类似以下的默认值设置：

export PUBLIC_PORT=${PUBLIC_PORT:-8211}

影响范围

此问题影响所有使用Docker部署并希望通过PUBLIC_PORT环境变量自定义公共端口的用户。典型表现为：

1. 无论docker-compose.yml中如何设置PUBLIC_PORT
2. 生成的PalWorldSettings.ini中PublicPort始终为默认值8211
3. 服务器在社区列表中显示错误的端口信息

解决方案

项目维护者已在后续版本中修复此问题。用户可以通过以下方式解决：

1. 更新到最新版本的Docker镜像
2. 或者手动修改compile-settings.sh脚本，添加PUBLIC_PORT的默认值处理

最佳实践建议

对于类似的多端口服务配置，建议：

1. 明确区分内部端口和外部映射端口
2. 确保所有环境变量都有合理的默认值
3. 在容器启动时验证端口配置的合理性
4. 考虑添加配置验证逻辑，防止端口冲突

总结

这个案例展示了环境变量处理在容器化应用中的重要性。即使是简单的默认值缺失，也可能导致配置无法按预期工作。对于游戏服务器这类需要精确网络配置的应用，确保所有网络相关参数都能正确传递至关重要。