devidian/project-zomboid-ds

Project Zomboid专用服务器Docker镜像文档

镜像概述

本镜像为Project Zomboid专用服务器提供Docker化解决方案，旨在解决默认游戏中Java参数配置错误导致的运行问题。作为另一种Project Zomboid服务器部署方案，它支持便捷部署、数据持久化及自定义配置，适合需要搭建稳定游戏服务器的用户。

核心功能与特性

• 修复Java参数问题：解决默认游戏中Java参数配置错误导致的运行异常
• 便捷部署：支持通过docker-compose快速部署，配置简单
• 数据持久化：通过卷挂载实现服务器数据和配置的持久化存储
• 自动恢复：支持容器自动重启策略（unless-stopped），保障服务稳定性
• 自定义配置：允许通过挂载配置目录自定义服务器参数

使用场景与适用范围

适用于需要搭建Project Zomboid专用服务器的玩家或管理员，尤其适合以下场景：

• 希望快速部署游戏服务器，减少手动配置步骤
• 需要服务器数据持久化，避免重启后数据丢失
• 需自定义服务器名称、管理员密码、端口及资源分配的场景

使用方法

部署示例（docker-compose）

推荐使用docker-compose进行部署，以下为配置示例：

yaml
version: "3.8"

services:
  project-zomboid-ds-docker:
    image: devidian/project-zomboid-ds:latest
    container_name: project-zomboid-ds-docker
    restart: unless-stopped
    volumes:
      # 左侧：宿主机路径（可自定义）；右侧：容器内路径（不可修改）
      - /appdata/project-zomboid/dedicated:/home/steam/project-zomboid-dedicated  # 服务器程序目录
      - /appdata/project-zomboid/data:/home/steam/Zomboid  # 游戏数据目录
      # 用于覆盖默认配置（如需自定义配置，取消下方注释并调整宿主机路径）
      # - ./Server:/home/steam/Server
    ports:
      - "8766:8766/udp"   # Steam端口A
      - "8767:8767/udp"   # Steam端口B
      - "16261:16261/udp" # 游戏通信端口
      - "27015:27015/tcp" # 服务器查询端口
      - "16262-16272:16262-16272/tcp" # 客户端连接端口范围
    environment:
      - SERVER_NAME=ZomboidDocker  # 服务器名称
      - ADMIN_PASSWORD=ZomboidDockerAdmin22  # 管理员密码
      - STEAM_PORT_A=8766  # Steam端口A（需与ports映射一致）
      - STEAM_PORT_B=8767  # Steam端口B（需与ports映射一致）
      - CONFIG_XMX=8  # JRE内存分配（GB），默认8

启动命令

将上述配置保存为docker-compose.yml后，执行以下命令启动服务：

bash
docker-compose up -d

配置说明

自定义配置步骤

1. 获取默认配置：从GitHub下载包含默认配置的Server目录
2. 修改配置文件：将Server目录放置在docker-compose.yml同级目录，编辑其中的配置文件（不可重命名）
3. 挂载配置目录：在docker-compose.yml中取消- ./Server:/home/steam/Server的注释，使自定义配置生效
4. 重启容器：通过docker-compose restart重启服务，配置将在启动时自动应用

配置参数说明（环境变量）

注意：容器内路径（volumes右侧）不可修改，确保宿主机路径有足够权限；端口映射需与环境变量中的端口保持一致。