pepecitron/projectzomboid-server

Project Zomboid Server Docker镜像

镜像概述和主要用途

Project Zomboid Server Docker镜像是Project Zomboid游戏服务器的容器化部署方案，旨在简化服务器搭建与管理流程。该镜像支持通过环境变量配置服务器参数、持久化存储服务器数据与配置、安装Workshop Mods、远程RCON管理及多服务器并行部署，适用于个人、小型团队或社区快速部署稳定的Project Zomboid游戏服务器。

核心功能和特性

• 数据持久化：通过卷挂载实现服务器文件与配置数据的持久化存储
• 灵活配置：支持通过环境变量设置服务器名称、密码、端口、玩家数量等核心参数
• Mod支持：可通过环境变量指定Workshop Mod名称与ID，自动安装和更新Mods
• RCON管理：内置RCON支持，可远程管理服务器
• 自动更新：重启容器自动应用游戏服务器更新
• 多实例部署：支持多服务器并行部署，独立配置与端口隔离

使用场景和适用范围

• 个人或小型团队搭建Project Zomboid私人游戏服务器
• 社区服务器部署与日常管理
• 需要频繁调整服务器配置或测试不同Mod组合的场景
• 多版本、多地图或多规则服务器的并行部署与测试

详细使用方法和配置说明

卷（Volumes）

环境变量（Environment variables）

Project Zomboid Server

Mods

RCON

系统用户（System User）

暴露端口（Expose）

Docker部署示例

Docker Compose配置

以下是基础部署示例，包含核心配置：

yaml
services:
  project-zomboid:
    container_name: pzserver  # 容器名称
    image: docker.xuanyuan.run/pepecitron/projectzomboid-server  # 使用的镜像
    restart: unless-stopped  # 除非手动停止，否则自动重启
    environment:
      SERVER_ADMIN_PASSWORD: "pzadmin"  # 管理员密码
      SERVER_PASSWORD: "secretpassword"  # 服务器连接密码
    ports:
      - "16261:16261/udp"  # 游戏服务器主端口映射
      - "16262:16262/udp"  # 游戏服务器UDP端口映射
    volumes:
      - ./data/server-file:/data/server-file  # 服务器文件卷挂载
      - ./data/config:/data/config  # 配置文件卷挂载

Docker Run命令

基础部署命令：

bash
docker run -d \
  --name pzserver \
  --restart unless-stopped \
  -e SERVER_ADMIN_PASSWORD="pzadmin" \
  -e SERVER_PASSWORD="secretpassword" \
  -p 16261:16261/udp \
  -p 16262:16262/udp \
  -v ./data/server-file:/data/server-file \
  -v ./data/config:/data/config \
  docker.xuanyuan.run/pepecitron/projectzomboid-server

暴露端口（Expose）

容器默认暴露以下端口：

• 27015 (TCP)：RCON管理端口
• 16261 (UDP)：游戏服务器主端口
• 16262 (UDP)：游戏服务器UDP端口

高级配置指南

服务器配置（Server Configuration）

服务器核心配置文件位于挂载的/data/config卷中，文件名为<SERVER_NAME>.ini（基础配置）和<SERVER_NAME>_SandboxVars.lua（沙盒规则配置）。修改配置后需重启容器使生效。游戏服务器更新会在容器重启时自动应用。

Mod管理（Mods）

通过设置MOD_NAMES和MOD_WORKSHOP_IDS环境变量安装Mods，格式为分号分隔的Mod名称和对应Workshop ID：

yaml
environment:
  MOD_NAMES: "RainWash;EasyConfigChucked;ExpandedHelicopterEvents"  # Mod名称列表
  MOD_WORKSHOP_IDS: "2657661246;2529746725;2458631365"  # 对应Mod的Workshop ID列表

新增或更新Mod后，重启容器即可自动应用。

多服务器部署（Multiple Servers）

多服务器部署需注意：

1. 为每个服务器实例挂载独立的/data/server-file卷，避免更新冲突
2. 为每个服务器配置独立端口映射
3. 通过SERVER_NAME区分不同服务器实例

示例配置：

yaml
version: "3.8"

services:
  server-1:
    container_name: pzserver-server-1
    image: docker.xuanyuan.run/pepecitron/projectzomboid-server
    restart: unless-stopped
    environment:
      SERVER_NAME: "server-1"  # 服务器1名称
    ports:
      - "16261:16261/udp"  # 服务器1主端口
      - "16262:16262/udp"  # 服务器1UDP端口
    volumes:
      - ./data/server-file-server-1:/data/server-file  # 服务器1独立卷
      - ./data/config:/data/config  # 共享配置卷（或使用独立配置卷）

  server-2:
    container_name: pzserver-server-2
    image: docker.xuanyuan.run/pepecitron/projectzomboid-server
    restart: unless-stopped
    environment:
      SERVER_NAME: "server-2"  # 服务器2名称
    ports:
      - "16263:16261/udp"  # 服务器2主端口（主机端口16263映射容器16261）
      - "16264:16262/udp"  # 服务器2UDP端口（主机端口16264映射容器16262）
    volumes:
      - ./data/server-file-server-2:/data/server-file  # 服务器2独立卷
      - ./data/config:/data/config  # 共享配置卷（或使用独立配置卷）

客户端需通过对应主机端口（如***、***）连接不同服务器。