renegademaster/zomboid-dedicated-server

Project Zomboid 专用服务器

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

如遇到问题，请在https://github.com/Renegade-Master/zomboid-dedicated-server/issues/new/choose%E6%8F%90%E4%BA%A4%E6%8A%A5%E5%91%8A%E3%80%82

徽章

https://github.com/Renegade-Master/zomboid-dedicated-server/actions/workflows/docker-build.yml/badge.svg?branch=main](https://github.com/Renegade-Master/zomboid-dedicated-server/actions/workflows/docker-build.yml) https://quay.io/repository/renegade_master/zomboid-dedicated-server/status "Docker Repository on Quay"](https://quay.io/repository/renegade_master/zomboid-dedicated-server)

!https://img.shields.io/docker/v/renegademaster/zomboid-dedicated-server?label=%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC !https://img.shields.io/docker/image-size/renegademaster/zomboid-dedicated-server?label=%E9%95%9C%E5%83%8F%E5%A4%A7%E5%B0%8F !https://img.shields.io/docker/pulls/renegademaster/zomboid-dedicated-server?label=DockerHub%E6%8B%89%E5%8F%96%E6%AC%A1%E6%95%B0

描述

使用Docker（可选Docker-Compose）部署的Project Zomboid专用服务器。几乎从零构建，旨在成为体积最小的Project Zomboid专用服务器！注意： 此镜像为“无root权限”（rootless），因此不应以root用户运行。尝试以root用户运行将导致服务器无法启动（参见https://github.com/Renegade-Master/zomboid-dedicated-server/issues/8%E3%80%81https://github.com/Renegade-Master/zomboid-dedicated-server/issues/14%EF%BC%89%E3%80%82

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

shell
# 拉取最新镜像：
docker pull docker.xuanyuan.run/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 16261:16261/udp --publish 16262:16262/udp \
    --name zomboid-server \
    docker.xuanyuan.run/renegademaster/zomboid-dedicated-server:latest

容器的默认行为是在崩溃后不会自动重启，以便用户有时间调查问题原因。但您可能希望更改https://docs.docker.com/engine/reference/run/#restart-policies---restart%E4%BB%A5%E8%87%AA%E5%8A%A8%E4%BB%8E%E6%84%8F%E5%A4%96%E6%95%85%E9%9A%9C%E4%B8%AD%E6%81%A2%E5%A4%8D%E3%80%82%E4%BB%A5%E4%B8%8B%E9%80%89%E9%A1%B9%E6%9C%89%E5%8A%A9%E4%BA%8E%E5%BA%94%E5%AF%B9%E6%AD%A4%E7%B1%BB%E6%83%85%E5%86%B5%EF%BC%9A

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

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

质量保证/测试

每次提交都会通过GitHub Actions构建服务器并短暂启动，以确保服务器始终可正常运行，降低发布无法运行版本的可能性。启动服务器后会更改并检查主要配置，以验证用户可以配置其实例。验证过程中还会使用自定义端口和远程RCON命令，确保用户可以使用任何端口组合托管服务器。您可以在https://github.com/Renegade-Master/zomboid-dedicated-server/actions/workflows/docker-build.yml%E6%9F%A5%E7%9C%8B%E4%B9%8B%E5%89%8D%E7%9A%84Action%E8%BF%90%E8%A1%8C%E8%AE%B0%E5%BD%95%E3%80%82

链接

源码：

• https://github.com/Renegade-Master/zomboid-dedicated-server

镜像：

外部资源：

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

前提条件

目录

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

这些文件夹必须在您打算运行Docker镜像的目录中创建。可以是您在某种“服务器目录”中创建的文件夹，也可以是克隆仓库后的仓库根目录。如果Docker镜像启动时这些文件夹不存在，将出现权限错误（参见https://github.com/Renegade-Master/zomboid-dedicated-server/issues/8%E3%80%81https://github.com/Renegade-Master/zomboid-dedicated-server/issues/14%E3%80%81https://github.com/Renegade-Master/zomboid-dedicated-server/issues/17%EF%BC%89%EF%BC%8C%E5%9B%A0%E4%B8%BADocker%E5%BC%95%E6%93%8E%E4%BC%9A%E5%9C%A8%E5%AE%B9%E5%99%A8%E8%BF%90%E8%A1%8C%E6%97%B6%E5%88%9B%E5%BB%BA%E8%BF%99%E4%BA%9B%E6%96%87%E4%BB%B6%E5%A4%B9%EF%BC%8C%E5%AF%BC%E8%87%B4%E5%AE%83%E4%BB%AC%E5%9C%A8%E4%B8%BB%E6%9C%BA%E4%B8%8A%E5%B1%9E%E4%BA%8E%60root%60%E7%94%A8%E6%88%B7%EF%BC%8C%E4%BB%8E%E8%80%8C%E5%BC%95%E5%8F%91%E6%9D%83%E9%99%90%E5%86%B2%E7%AA%81%E3%80%82

“配置数据”文件夹存储服务器配置和存档文件。此文件夹可像非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 docker.xuanyuan.run/renegademaster/zomboid-dedicated-server:<标签名>
     

   • 或构建镜像：

     shell
     git clone https://github.com/Renegade-Master/zomboid-dedicated-server.git \
         && 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 16261:16261/udp --publish 16262:16262/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 https://github.com/Renegade-Master/zomboid-dedicated-server.git \
       && 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]时，玩家即可开始加入服务器。