redditopenttd/openttd

OpenTTD Docker镜像

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

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

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

使用容器

基本启动命令

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

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

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

其中：

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

数据持久化

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

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

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

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

bash
-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设置生效。

服务器启动示例命令

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

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

可用环境变量

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

外部封禁列表定义

部分场景下（如多服务器共享封禁列表、K8s环境中配置只读但封禁列表需持久化），可使用https://github.com/ropenttd/docker_openttd-bans-sidecar%E5%B7%A5%E5%85%B7%E3%80%82%E6%8C%89%E5%85%B6%E6%96%87%E6%A1%A3%E9%85%8D%E7%BD%AESidecar%EF%BC%88%E7%A1%AE%E4%BF%9D%E4%B8%8E%E6%9C%AC%E5%AE%B9%E5%99%A8%E6%8C%82%E8%BD%BD%E7%9B%B8%E5%90%8C%E7%9A%84%60/config%60%E7%9B%AE%E5%BD%95%EF%BC%89%EF%BC%8C%E7%84%B6%E5%90%8E%E8%AE%BE%E7%BD%AE%60BAN_LIST%60%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E4%B8%BA%60bans.txt%60%E3%80%82

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

标签说明

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

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