OpenTTD Docker镜像

由/r/openttd社区提供的镜像

![构建状态]([***]

基于OpenTTD源码构建，提供精简高效的容器化镜像，用于部署OpenTTD游戏服务器。

使用容器

基本启动命令

docker run -d -p 3979:3979/tcp -p 3979:3979/udp redditopenttd/openttd:latest

容器默认每次重启时启动新游戏。可通过loadgame环境变量修改此行为：

-e "loadgame={false|last-autosave|exit|(存档名称)}"

其中：

• false：默认行为，启动新游戏
• last-autosave：加载最新的自动存档
• exit：尝试加载autosave/exit.sav，失败则启动新游戏
• (存档名称)：加载config/saves目录中指定名称的存档文件

数据持久化

为确保容器重建后数据不丢失，可挂载/config卷：

-v /home/{用户名}/.openttd:/config:rw

注意：若在/config目录中未找到openttd.cfg，容器将尝试创建新的配置目录。强烈建议首次使用时，停止容器并参考***wiki配置openttd.cfg。

如需仅挂载特定文件/目录而非整个.openttd目录，可使用：

-v /home/{用户名}/.openttd/openttd.cfg:/config/openttd.cfg:ro
-v /home/{用户名}/.openttd/save/:/config/save:rw

NewGRF配置

若需使用NewGRF，建议先在本地GUI环境下载并配置，然后将本地content_downloaded文件夹复制到服务器的/config目录，并更新本地的openttd.cfg文件至服务器，确保新建服务器时NewGRF设置生效。

服务器启动示例命令

docker run -it -p 3979:3979/tcp -p 3979:3979/udp -v /home/{用户名}/.openttd:/config:rw -e "loadgame=game.sav" redditopenttd/openttd:latest

上述命令通过-it参数提供控制台访问；若需后台运行，使用-d参数。

可用环境变量

在docker run命令中添加-e VARIABLE=值来使用以下环境变量：

外部封禁列表定义

部分场景下（如多服务器共享封禁列表、K8s环境中配置只读但封禁列表需持久化），可使用Bans Sidecar工具。按其文档配置Sidecar（确保与本容器挂载相同的/config目录），然后设置BAN_LIST环境变量为bans.txt。

配置完成后，Sidecar会定期备份OpenTTD写入配置文件的封禁列表；容器重启时，会自动合并openttd.cfg与bans.txt中的封禁列表，写入openttd.cfg后启动。

标签说明

每次OpenTTD发布beta或候选版本时，会自动构建新标签。如需 nightly 构建，可联系维护者更新构建脚本。

• stable 和 latest：跟踪OpenTTD最新稳定版本
• testing：跟踪OpenTTD最新不稳定版本（含beta和候选版本）
• rc 和 beta 已弃用，建议使用 testing
• nightly：保留用于nightly构建（目前暂不可用）