cyrale/project-zomboid

Project Zomboid服务器 - Docker镜像

这是Project Zomboid Steam服务器的Docker版本，基于LinuxGSM工具简化服务器的部署与管理。

如何使用该镜像

启动前准备

在运行服务器的目录下创建两个文件夹：

• server-data：必需，用于保存配置数据（重启后保留）
• server-files：可选，包含应用程序的所有文件

调整文件夹权限：

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

1000:1000是镜像中运行服务器的LinuxGSM用户和组ID。

Docker命令部署

bash
docker run -d -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 \
              --name project-zomboid \
              docker.xuanyuan.run/cyrale/project-zomboid

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: "3.0"
services:
    project-zomboid:
        image: docker.xuanyuan.run/cyrale/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启动服务器。

启动后配置

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

环境变量

继承自https://github.com/cyrale/linuxgsm#variables%E7%9A%84%E5%8F%98%E9%87%8F%EF%BC%9A

• 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名玩家）

部分变量可通过配置文件覆盖，具体参考LinuxGSM文档。

卷

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

暴露端口

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