bateau/openttd

OpenTTD 专用服务器 Docker 镜像文档

概述

本镜像提供 Open Transport Tycoon Deluxe（OpenTTD）专用服务器的容器化部署方案，支持快速搭建游戏服务器，可自定义配置、加载存档、映射用户权限及网络端口，适用于个人或多人游戏场景。

核心功能与特性

• 内置 openttd 用户，主目录为 /home/openttd，配置文件、存档等存储于 .openttd 目录
• 支持通过环境变量自定义服务器行为（如存档路径、加载模式、用户/组ID等）
• 灵活的网络端口映射，支持TCP/UDP协议
• 支持本地文件挂载，实现存档持久化与配置共享
• 提供Kubernetes部署示例配置

使用方法

文件位置

镜像包含用户名为 openttd 的用户，其主目录为 /home/openttd。OpenTTD服务器在Linux系统中使用用户主目录下的 .openttd 目录存储配置文件、存档及其他文件。

如需将本地文件暴露给容器内的OpenTTD服务器，需使用 -v 参数挂载本地目录至容器内（有关 -v 的更多详细信息，请参见Docker run命令文档）。

环境变量

可通过以下环境变量修改容器内应用的行为，使用 docker run 的 -e 参数设置（有关 -e 的更多详细信息，请参见Docker run命令文档）。

网络配置

Docker默认不暴露容器端口至主机网络，需使用 -p 参数手动映射（有关 -p 的更多详细信息，请参见Docker run命令文档）。

若OpenTTD配置监听3979端口，需通过 -p 3979:3979 映射端口（格式：<主机端口>:<容器端口>），同时支持TCP与UDP协议。

使用示例

基础运行（暴露默认端口）

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

随机端口分配

bash
docker run -d -P bateau/openttd:latest

挂载本地存档目录（持久化存档）

默认不挂载 .openttd 目录时，服务器以新游戏启动；如需保存/加载存档，需挂载本地目录：

bash
docker run -v /本地路径/.openttd:/home/openttd/.openttd -p 3979:3979/tcp -p 3979:3979/udp bateau/openttd:latest

映射本地用户权限

设置容器内用户/组ID与本地一致（替换 <your_userid> 和 <your_groupid> 为实际ID）：

bash
docker run -e PUID=<your_userid> -e PGID=<your_groupid> -v /本地路径/.openttd:/home/openttd/.openttd -p 3979:3979/tcp -p 3979:3979/udp bateau/openttd:latest

加载指定存档

启动服务器并加载名为 game.sav 的存档：

bash
docker run -d -p 3979:3979/tcp -p 3979:3979/udp -v /home/<your_username>/.openttd:/home/openttd/.openttd -e PUID=<your_userid> -e PGID=<your_groupid> -e "loadgame=true" -e "savename=game.sav" bateau/openttd:latest

Kubernetes部署

提供Kubernetes部署示例文件 k8s_openttd.yml，包含ConfigMap（openttd.cfg配置）、Deployment及Service（监听31979端口UDP/TCP）。部署命令：

bash
kubectl apply -f openttd.yaml

其他标签

更多镜像标签请参见Docker Hub：https://hub.docker.com/r/bateau/openttd