arguser/project-zomboid

Project Zomboid服务器 - Docker镜像

这是Project Zomboid Steam服务器的Docker版本，基于LinuxGSM工具构建，支持b41多人游戏分支，便于快速搭建和管理Project Zomboid多人联机服务器。

镜像概述

本镜像提供了Project Zomboid服务器的容器化部署方案，支持桥接网络和主机网络两种模式，通过环境变量可自定义服务器名称、管理员密码等核心配置，同时支持数据持久化存储，确保服务器配置和数据在重启后不丢失。

核心功能

1. 支持b41多人游戏分支，兼容Project Zomboid最新多人玩法
2. 提供桥接/主机两种网络模式，适配不同部署场景
3. 通过环境变量灵活配置服务器参数（名称、密码、端口等）
4. 数据持久化存储，服务器配置与游戏数据可通过卷映射保存
5. 继承自arguser/linuxgsm镜像的变量体系，支持高级配置覆盖

使用场景

• 游戏社区搭建专属的Project Zomboid多人服务器
• 玩家群体自建服务器进行联机生存游戏
• 开发/测试环境快速部署Project Zomboid服务器

配置说明

前置准备

在运行服务器前，需创建两个目录用于数据持久化：

• server-data：必选，保存服务器配置和数据
• server-files：可选，保存应用程序文件

若目录权限存在问题，可执行以下命令调整：

bash
chown 1000:1000 server-data
chown 1000:1000 server-files

注：1000:1000为镜像内运行服务器的LinuxGSM用户和组ID。

桥接网络部署

Docker命令

bash
docker run -d --name project-zomboid \
              -e SERVER_NAME="pzserver" \
              -e ADMIN_PASSWORD="pzserver-password" \
              -v $(pwd)/server-data:/server-data \
              -p 8766:8766/udp \
              -p 8767:8767/udp \
              -p 16261:16261/udp \
              -p 16262-16272:16262-16272 \
              -p 27015:27015 \
              docker.xuanyuan.run/arguser/project-zomboid

Docker Compose

创建docker-compose.yml文件：

yaml
version: "3.7"

services:
  project-zomboid:
    image: docker.xuanyuan.run/arguser/project-zomboid
    restart: unless-stopped
    environment:
      SERVER_NAME: "pzserver"
      ADMIN_PASSWORD: "pzserver-password"
    ports:
      - "8766:8766/udp"
      - "8767:8767/udp"
      - "16261:16261/udp"
      - "16262-16272:16262-16272"
      - "27015:27015"
    volumes:
      - ./server-data:/server-data

执行docker-compose up启动服务器。

主机网络部署

Docker命令

bash
docker run -d --name project-zomboid \
              --network=host \
              -e SERVER_NAME="pzserver" \
              -e ADMIN_PASSWORD="pzserver-password" \
              -v $(pwd)/server-data:/server-data \
              docker.xuanyuan.run/arguser/project-zomboid

Docker Compose

创建docker-compose.yml文件：

yaml
version: "3.7"

services:
  project-zomboid:
    image: docker.xuanyuan.run/arguser/project-zomboid
    restart: unless-stopped
    environment:
      SERVER_NAME: "pzserver"
      ADMIN_PASSWORD: "pzserver-password"
    network_mode: host
    volumes:
      - ./server-data:/server-data

执行docker-compose up启动服务器。

指定IP地址

在主机网络模式下，可通过环境变量指定主机IP：

• 命令行添加：-e LGSM_SERVER_CONFIG='ip="xx.xx.xx.xx"'
• Compose文件添加：

yaml
LGSM_SERVER_CONFIG: |
  ip="xx.xx.xx.xx"

后续配置

首次运行后，可在映射目录/server-data/Server/$SERVER_NAME.ini中编辑服务器配置，修改后重启服务器生效。

环境变量

继承自arguser/linuxgsm的变量：

• STEAM_PORT_1：Steam端口1（默认8766）
• STEAM_PORT_2：Steam端口2（默认8767）
• RCON_PORT：RCON端口（默认27015）
• RCON_PASSWORD：RCON密码
• SERVER_NAME：服务器名称（用于数据库和配置文件，禁止特殊字符/空格）
• SERVER_PASSWORD：服务器连接密码
• SERVER_PUBLIC_NAME：服务器公开展示名称
• SERVER_PUBLIC_DESC：服务器公开展示描述
• SERVER_BRANCH：测试分支名称
• SERVER_BETA_PASSWORD：测试分支密码
• ADMIN_PASSWORD：服务器管理员密码
• SERVER_PORT：游戏服务器端口
• PLAYER_PORTS：玩家连接端口范围（默认***-***，支持10名玩家）

卷映射

• /server-data：服务器数据目录（包含配置、数据库等）
• /server-files：应用程序目录

端口暴露

• 8766/udp：Steam端口1
• 8767/udp：Steam端口2
• 27015：RCON端口
• ***/udp：游戏服务器端口
• -16XXX：玩家连接端口（根据玩家数量调整，如100名玩家需-***）

***

[***]