renegademaster/zomboid-dedicated-server Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Project Zomboid 专用服务器

免责声明注意： 此镜像不受Valve或The Indie Stone官方支持。

如遇到问题，请在GitHub仓库提交报告。

徽章

![构建和测试服务器镜像]([] ![Quay上的Docker仓库]([]

!Docker镜像版本（按日期最新） !Docker镜像大小（按日期最新） !DockerHub拉取次数

描述

使用Docker（可选Docker-Compose）部署的Project Zomboid专用服务器。几乎从零构建，旨在成为体积最小的Project Zomboid专用服务器！注意： 此镜像为“无root权限”（rootless），因此不应以root用户运行。尝试以root用户运行将导致服务器无法启动（参见#8、#14）。

启动服务器的最低要求说明：

shell
# 拉取最新镜像：
docker pull renegademaster/zomboid-dedicated-server:latest

# 创建两个文件夹
mkdir ZomboidConfig ZomboidDedicatedServer

# 运行服务器（使用最低选项）：
docker run --detach \
    --mount type=bind,source="$(pwd)/ZomboidDedicatedServer",target=/home/steam/ZomboidDedicatedServer \
    --mount type=bind,source="$(pwd)/ZomboidConfig",target=/home/steam/Zomboid \
    --publish ***:***/udp --publish ***:***/udp \
    --name zomboid-server \
    docker.io/renegademaster/zomboid-dedicated-server:latest

容器的默认行为是在崩溃后不会自动重启，以便用户有时间调查问题原因。但您可能希望更改重启策略以自动从意外故障中恢复。以下选项有助于应对此类情况：

• --restart=unless-stopped：除非使用Docker/Podman API停止容器，否则每次容器退出时都会重启。
• --restart=on-failure[:max-retries]：仅当容器以非零退出代码退出时才重启。可选地，可配置仅重启固定次数以防止崩溃循环。

这些选项也可在docker-compose.yaml文件中设置。

质量保证/测试

每次提交都会通过GitHub Actions构建服务器并短暂启动，以确保服务器始终可正常运行，降低发布无法运行版本的可能性。启动服务器后会更改并检查主要配置，以验证用户可以配置其实例。验证过程中还会使用自定义端口和远程RCON命令，确保用户可以使用任何端口组合托管服务器。您可以在此处查看之前的Action运行记录。

链接

源码：

• GitHub仓库

镜像：

外部资源：

• 专用服务器维基
• 专用服务器配置
• Steam DB页面

前提条件

目录

主机上需要存在两个目录：

这些文件夹必须在您打算运行Docker镜像的目录中创建。可以是您在某种“服务器目录”中创建的文件夹，也可以是克隆仓库后的仓库根目录。如果Docker镜像启动时这些文件夹不存在，将出现权限错误（参见#8、#14、#17），因为Docker引擎会在容器运行时创建这些文件夹，导致它们在主机上属于root用户，从而引发权限冲突。

“配置数据”文件夹存储服务器配置和存档文件。此文件夹可像非Docker方式运行服务器一样打开和编辑，您可以备份存档文件或编辑服务器配置文件。建议在尝试编辑“配置数据”文件夹中的文件前，先成功启动服务器一次。文件生成后，即可安全编辑。大多数配置选项更改需要重启服务器才能生效，也可通过游戏内管理菜单配置大部分设置。

“安装数据”文件夹存储服务器游戏数据。此文件夹可打开和编辑，但服务器完全重启时可能会在文件验证过程中重置其中的更改。因此，建议通过Docker镜像提供的“可选参数”表中的环境变量来更改此文件夹中的文件。

端口

服务器总共可使用三个端口，但只有两个是严格必需的：

所有端口均可配置为不同的端口号，但需注意，若在游戏配置文件中更改端口，必须在Docker运行命令的--publish ...中或Docker-Compose文件的services.zomboid-server.ports配置项中暴露更改后的（或默认）端口。此外，这些端口必须不被防火墙阻止。如果您位于路由器和/或防火墙后，几乎肯定需要开放这些端口，以便网络外部的用户连接到服务器。端口转发和在托管服务器中开放端口不在本项目范围内，具体操作需咨询ISP、服务器提供商或参考第三方路由器说明。

严格必需的端口（DEFAULT_PORT和UDP_PORT）用于服务器监听连接和与已连接客户端通信，必须分配值且可从互联网访问（即“转发”）。

若打算使用RCON与服务器交互，则RCON_PORT也必须开放连接。若不打算使用RCON，则无需在Docker运行命令或Docker-Compose文件中包含此端口，关闭此端口可增强服务器安全性。

使用说明

服务器可使用纯Docker或Docker-Compose运行。最终结果相同，但推荐使用Docker-Compose以简化配置。

可选环境变量

配置文件环境变量

以下环境变量将自动覆盖服务器config.ini文件（位于/home/steam/Zomboid/Server/[name].ini）中的值。直接编辑.ini文件中的这些值将导致它们被默认值或配置的环境变量覆盖。

其他值可以且应该直接在.ini文件中编辑。

Docker

以下是使用Docker镜像运行服务器的说明。

1. 本地获取镜像：

   • 从DockerHub拉取镜像：

     shell
     docker pull renegademaster/zomboid-dedicated-server:<标签名>
     

   • 或构建镜像：

     shell
     git clone [***] \
         && cd zomboid-dedicated-server
     
     docker build -t docker.io/renegademaster/zomboid-dedicated-server:<标签> -f docker/zomboid-dedicated-server.Dockerfile .
     

2. 运行容器：

   注意：方括号中的参数为可选。若要覆盖默认端口，还需更改下方的published端口。

   shell
   mkdir ZomboidConfig ZomboidDedicatedServer
   
   docker run --detach \
       --mount type=bind,source="$(pwd)/ZomboidDedicatedServer",target=/home/steam/ZomboidDedicatedServer \
       --mount type=bind,source="$(pwd)/ZomboidConfig",target=/home/steam/Zomboid \
       --publish ***:***/udp --publish ***:***/udp [--publish 27015:27015/tcp] \
       --name zomboid-server \
       [--restart=no] \
       [--env=ADMIN_PASSWORD=<值>] \
       [--env=ADMIN_USERNAME=<值>] \
       [--env=AUTOSAVE_INTERVAL=<值>] \
       [--env=BIND_IP=<值>] \
       [--env=DEFAULT_PORT=<值>] \
       [--env=GAME_VERSION=<值>] \
       [--env=GC_CONFIG=<值>] \
       [--env=MAP_NAMES=<值>] \
       [--env=MAX_PLAYERS=<值>] \
       [--env=MAX_RAM=<值>] \
       [--env=MOD_NAMES=<值>] \
       [--env=MOD_WORKSHOP_IDS=<值>] \
       [--env=PAUSE_ON_EMPTY=<值>] \
       [--env=PUBLIC_SERVER=<值>] \
       [--env=RCON_PASSWORD=<值>] \
       [--env=RCON_PORT=<值>] \
       [--env=SERVER_NAME=<值>] \
       [--env=SERVER_PASSWORD=<值>] \
       [--env=STEAM_VAC=<值>] \
       [--env=TZ=<值>] \
       [--env=USE_STEAM=<值>] \
       docker.io/renegademaster/zomboid-dedicated-server[:<标签名>]
   

3. （可选）将终端重新附加到日志输出（注意：这不是交互式终端）

   shell
   docker logs --follow zomboid-server
   

4. 当控制台中出现LuaNet: Initialization [DONE]时，玩家即可开始加入服务器。

Docker-Compose

以下是使用Docker-Compose运行服务器的说明。

1. 下载仓库：

   shell
   git clone [***] \
       && cd zomboid-dedicated-server
   

2. 在docker-compose.yaml文件中进行所需的配置更改。在services.zomboid-server.environment部分，可修改服务器配置值。

   注意：若要覆盖默认端口，还需更改published端口。

3. 运行以下命令：

   • 创建数据和配置目录：

     shell
     mkdir ZomboidConfig ZomboidDedicatedServer
     

   • 从DockerHub拉取镜像：

     shell
     docker-compose up --detach
     

   • 或构建镜像：

     shell
     docker-compose up --build --detach
     

4. （可选）将终端重新附加到日志输出（注意：这不是交互式终端）

   shell
   docker-compose logs --follow
   

5. 当控制台中出现LuaNet: Initialization [DONE]时，玩家即可开始加入服务器。