中文

游戏服务器

如何创建 Project Zomboid 服务器

在 VPS 或专用 Linux 服务器上创建 Project Zomboid 专用服务器的完整指南:使用 SteamCMD 安装、内存、管理员账户、创意工坊模组、systemd 服务和备份。

阅读约 9 分钟, 更新于 2026年11月18日

本页内容

您的参数

只需填写一次,指南中的命令会自动更新。

本指南介绍如何在您的 VPS 或专用 Linux 服务器上安装 Project Zomboid 专用服务器,调整其内存,管理玩家,并添加 Steam 创意工坊的模组。游戏工作室 The Indie Stone 提供原生 Linux 版服务器,并自带 Java 运行环境。

订购服务器

要托管您的 Project Zomboid 服务器,HostMyServers 提供多种合适的选择:

前提条件

  • 以 root 或具有 sudo 权限的用户进行 SSH 访问
  • 64 位 x86_64 Linux 系统(Debian 12/13 或 Ubuntu 22.04/24.04)
  • 已启用防火墙:nftables、iptables 或 ufw(一次只使用一种防火墙工具)
  • 约 20 GB 可用磁盘空间(推荐 NVMe SSD)
  • 端口 16261 和 16262 UDP 可访问
  • Steam 上的 Project Zomboid 游戏,且版本与服务器相同

配置要求

The Indie Stone 未公布服务器的最低配置。下列数值是无模组游戏的参考值:模组、已探索的地图范围和僵尸数量都会增加资源消耗。

玩家数 CPU -Xmx 值 服务器内存
1 至 4 2 核,高主频 4g 8 GB
5 至 10 4 核,高主频 6g 12 GB
11 至 20 4 核,高主频 8g 16 GB
21 至 32 6 核或更多 12g 24 GB

服务器占用约 7 GB 磁盘空间,不含模组和备份。

系统更新

终端
sudo apt update && sudo apt upgrade -y

安装依赖项

Java 已随服务器提供,无需安装。SteamCMD 需要 lib32gcc-s1:

终端
sudo apt install -y curl tar ca-certificates lib32gcc-s1 libstdc++6

创建专用用户

服务器绝不能以 root 身份运行。请创建专用用户:

终端
sudo adduser --disabled-password --gecos "" zomboid

使用的端口

端口 协议 参数 用途 访问范围
16261 UDP DefaultPort 游戏 公开
16262 UDP UDPPort 游戏 公开
27015 TCP RCONPort RCON,默认禁用 如启用,仅限您的 IP 地址

只有设置了 RCONPassword,RCON 才会启动。如果不需要 RCON,请将其留空,且不要开放端口 27015。

防火墙配置

使用 UFW

终端
sudo ufw allow 16261/udp
sudo ufw allow 16262/udp
sudo ufw reload

使用 iptables

终端
sudo iptables -A INPUT -p udp --dport 16261 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 16262 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4

重启后保留规则需要安装 iptables-persistent 软件包。

使用 nftables

这些命令使用 inet filter 表和 input 链,二者在 Debian 的 /etc/nftables.conf 中默认存在。

终端
sudo nft add rule inet filter input udp dport 16261 accept
sudo nft add rule inet filter input udp dport 16262 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf

安装 SteamCMD

以 zomboid 用户身份登录并准备所需文件夹:

终端
sudo -iu zomboid
mkdir -p ~/steamcmd ~/pz-server
cd ~/steamcmd
curl -sqL "https://steamcdn-a.akamaihd.net/client/installer/steamcmd_linux.tar.gz" | tar -xzf -

下载服务器

更新可能会替换包含内存设置的文件。此脚本会安装服务器(应用程序 ID 380870),并在每次运行时重新应用您设置的值:

终端
nano ~/update-server.sh
终端
#!/bin/bash
set -euo pipefail

# Java 最大内存:请根据需要调整此值
XMX="6g"

"$HOME/steamcmd/steamcmd.sh" +force_install_dir /home/zomboid/pz-server +login anonymous +app_update 380870 validate +quit
sed -i "s/-Xmx[0-9]*[gGmM]/-Xmx$XMX/" /home/zomboid/pz-server/ProjectZomboid64.json
grep -- '-Xmx' /home/zomboid/pz-server/ProjectZomboid64.json
终端
chmod +x ~/update-server.sh
~/update-server.sh

如果 SteamCMD 因错误而中断,请重新运行该脚本。

内存设置

Java 的最大内存通过 ProjectZomboid64.json 中的 -Xmx 设置。自带的文件使用 -Xmx8g,上面的脚本会将其替换为 XMX 的值。

请至少为系统和 Java 的其余部分保留 2 GB 内存:在 8 GB 内存的机器上,不要超过 -Xmx6g;如果机器上还运行其他服务,请设置得更低。

要更改该值,请停止服务器,修改 /home/zomboid/update-server.sh 中的 XMX,使用 zomboid 用户重新运行此脚本,然后重启服务器。

首次启动

首次启动会创建 admin 账户和配置文件。由于服务器会要求设置密码,此操作必须在您的会话中进行。仍使用 zomboid 用户:

终端
~/pz-server/start-server.sh -servername servertest

出现以下消息时,请设置管理员密码:

文本
Enter new administrator password:
Confirm the password:

等待 *** SERVER STARTED **** 消息出现,然后在控制台中输入以下命令以保存并停止服务器:

文本
quit

然后退出 zomboid 用户的会话:

终端
exit

服务器配置

设置位于 /home/zomboid/Zomboid/Server/。文件名取决于 -servername,此处为 servertest:

文件 内容
servertest.ini 服务器设置
servertest_SandboxVars.lua 游戏规则(僵尸、战利品、每天的时长)
servertest_spawnregions.lua 出生区域

在服务器停止的状态下修改设置:

终端
sudo -u zomboid nano /home/zomboid/Zomboid/Server/servertest.ini
参数 描述 默认值
PublicName 服务器名称 My PZ Server
PublicDescription 服务器描述 空
Public 在游戏的服务器列表中显示 false
Password 加入时需要输入的密码 空
Open 允许没有已创建账户的玩家加入 true
MaxPlayers 最大玩家数 32
PauseEmpty 无人在线时暂停时间 true
DefaultPort 第一个游戏端口 16261
UDPPort 第二个游戏端口 16262
UPnP 尝试在路由器上开放端口,在服务器上无需使用 true
RCONPort RCON 端口 27015
RCONPassword RCON 密码,留空则禁用 空

以下是需要修改的值示例:

配置
PublicName=My Project Zomboid Server
Password=ChangeThisPassword
MaxPlayers=16
UPnP=false

配置为 systemd 服务

服务器通过发送到其标准输入的 quit 命令正常停止。命令通道 /run/zomboid.control 让 systemd 和您都能与服务器通信。

创建命令通道

终端
sudo nano /etc/systemd/system/zomboid.socket
配置
[Unit]
BindsTo=zomboid.service

[Socket]
ListenFIFO=/run/zomboid.control
FileDescriptorName=control
RemoveOnStop=true
SocketMode=0660
SocketUser=zomboid
SocketGroup=zomboid

创建服务文件

终端
sudo nano /etc/systemd/system/zomboid.service
配置
[Unit]
Description=Project Zomboid Dedicated Server
After=network-online.target zomboid.socket
Wants=network-online.target
Requires=zomboid.socket

[Service]
Type=simple
User=zomboid
Group=zomboid
WorkingDirectory=/home/zomboid/pz-server
ExecStart=/home/zomboid/pz-server/start-server.sh -servername servertest
Sockets=zomboid.socket
StandardInput=socket
StandardOutput=journal
StandardError=journal
ExecStop=/bin/sh -c 'echo quit > /run/zomboid.control; while kill -0 "$$MAINPID" 2>/dev/null; do sleep 1; done'
TimeoutStopSec=180
Restart=on-failure
RestartSec=20
LimitNOFILE=100000

[Install]
WantedBy=multi-user.target

启用并启动服务

终端
sudo systemctl daemon-reload
sudo systemctl enable zomboid.service
sudo systemctl start zomboid.service

管理命令

终端
# 检查状态
sudo systemctl status zomboid.service

# 停止服务器(会保存世界)
sudo systemctl stop zomboid.service

# 重启服务器
sudo systemctl restart zomboid.service

# 查看日志
sudo journalctl -u zomboid.service -f

检查服务器

等待启动消息出现,这可能需要几分钟:

终端
sudo journalctl -u zomboid.service | grep 'SERVER STARTED'

然后检查端口是否正在监听:

终端
sudo ss -ulpn | grep -E ':(16261|16262)\b'

连接到服务器

  1. 启动与服务器版本相同的 Project Zomboid。
  2. 在主菜单中打开 Join。
  3. 填写地址 服务器IP 和端口 16261。
  4. 如果服务器设有密码,请输入服务器密码,并填写您的用户名和账户密码。

要以管理员身份连接,请使用用户名 admin 和首次启动时设置的密码。

管理

向服务器发送命令

在服务器上,将命令写入通道,开头不加 /。结果会显示在日志中:

终端
echo 'players' | sudo tee /run/zomboid.control
sudo journalctl -u zomboid.service -n 20

在游戏中,请在聊天框中输入相同的命令,并在前面加上 /。

常用命令

命令 描述
players 列出在线玩家
save 保存世界
quit 保存并停止服务器
servermsg "message" 向所有玩家发送消息
setaccesslevel "username" "admin" 更改玩家的角色
adduser "username" "password" 创建账户
setpassword "username" "password" 更改账户密码
kickuser "username" -r "reason" 踢出玩家
banuser "username" -ip -r "reason" 封禁玩家及其 IP 地址
unbanuser "username" 解封玩家
reloadoptions 重新加载 servertest.ini
showoptions 显示当前生效的设置
checkModsNeedUpdate 如果有模组已更新,则写入日志
help 列出命令

可用角色有 admin、moderator、overseer、gm 和 observer。

RCON(可选)

要使用 RCON 工具,请将 RCONPassword 设置为足够长的密码,然后仅向您的 IP 地址开放端口 27015:请替换 您的IP。

UFW:

终端
sudo ufw allow from 您的IP to any port 27015 proto tcp
sudo ufw reload

iptables:

终端
sudo iptables -A INPUT -p tcp -s 您的IP --dport 27015 -j ACCEPT
sudo iptables -A INPUT ! -i lo -p tcp --dport 27015 -j DROP
sudo iptables-save | sudo tee /etc/iptables/rules.v4

nftables:

终端
sudo nft add rule inet filter input ip saddr 您的IP tcp dport 27015 accept
sudo nft add rule inet filter input iifname != "lo" tcp dport 27015 drop
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf

安装创意工坊模组

服务器会在启动时自行下载模组,玩家连接时游戏会提示其安装。每个模组需要两项信息,均可在其创意工坊页面上找到:

信息 查找位置 参数
创意工坊 ID 页面地址末尾的数字(?id=...) WorkshopItems
模组 ID 描述中的 Mod ID 行,或 mod.info 中的 id= Mods

停止服务器,然后修改 servertest.ini:

终端
sudo systemctl stop zomboid.service
sudo -u zomboid nano /home/zomboid/Zomboid/Server/servertest.ini

使用分号分隔各个值:

配置
WorkshopItems=1111111111;2222222222
Mods=FirstMod;SecondMod

一个创意工坊项目可能包含多个模组:只需在 Mods 中添加您想启用的模组。某些模组列表导出工具会写成 \FirstMod:服务器也接受这种形式。

对于地图模组,请在基础地图之前添加其地图文件夹的名称(位于 media/maps 中):

配置
Map=MyModMap;Muldraugh, KY

然后重启服务器,并在日志中跟踪下载进度:

终端
sudo systemctl start zomboid.service
sudo journalctl -u zomboid.service -f

服务器更新

终端
sudo systemctl stop zomboid.service
sudo -iu zomboid /home/zomboid/update-server.sh
sudo systemctl start zomboid.service

服务器和玩家必须使用相同的版本。每次重要更新前请先备份。

自动备份

内置备份

服务器会在 /home/zomboid/Zomboid/backups/ 中创建归档文件,相关设置位于 servertest.ini:

参数 描述 默认值
BackupsCount 保留的归档文件数量 5
BackupsOnStart 启动时备份 true
BackupsOnVersionChange 游戏版本变更时备份 true
BackupsPeriod 定期备份的间隔,0 表示禁用 0

备份脚本

此脚本会正常停止服务器,归档世界、账户和配置,然后重新启动服务器:

终端
sudo nano /usr/local/sbin/backup-zomboid.sh
终端
#!/bin/bash
set -euo pipefail
umask 027

BACKUP_DIR="/home/zomboid/backups"
DATE=$(date +%Y-%m-%d_%H-%M-%S)
ARCHIVE="$BACKUP_DIR/zomboid_$DATE.tar.gz"

install -d -o zomboid -g zomboid -m 750 "$BACKUP_DIR"

systemctl stop zomboid.service
trap 'systemctl start zomboid.service' EXIT

tar -czf "$ARCHIVE" -C /home/zomboid Zomboid/Server Zomboid/db Zomboid/Saves/Multiplayer
chown zomboid:zomboid "$ARCHIVE"

# 删除超过7天的备份
find "$BACKUP_DIR" -name "zomboid_*.tar.gz" -mtime +7 -delete
终端
sudo chmod 750 /usr/local/sbin/backup-zomboid.sh
sudo /usr/local/sbin/backup-zomboid.sh
sudo ls -lh /home/zomboid/backups

计划备份

终端
sudo nano /etc/cron.d/zomboid-backup
文本
# 每晚 5:30 备份
30 5 * * * root /usr/local/sbin/backup-zomboid.sh

请定期将这些归档文件复制到服务器之外。其中包含账户和配置中的密码:请妥善保管,不要公开。

恢复备份

终端
sudo systemctl stop zomboid.service
sudo -u zomboid mv /home/zomboid/Zomboid /home/zomboid/Zomboid.old
sudo -u zomboid mkdir /home/zomboid/Zomboid
sudo -u zomboid tar -xzf /home/zomboid/backups/zomboid_DATE.tar.gz -C /home/zomboid
sudo systemctl start zomboid.service

请将 DATE 替换为归档文件的日期。

故障排除

服务在启动时卡住

如果日志停留在 Enter new administrator password:,说明 admin 账户尚未创建。请停止服务,并手动执行首次启动:

终端
sudo systemctl stop zomboid.service
sudo -iu zomboid /home/zomboid/pz-server/start-server.sh -servername servertest

Only 64bit is supported

当自带的 Java 无法启动时会出现此消息:可能是安装不完整,或机器不是 x86_64 架构。请使用 uname -m 检查架构,然后使用 zomboid 用户重新运行 /home/zomboid/update-server.sh。

服务器因内存不足而停止

日志显示 java.lang.OutOfMemoryError,或系统已终止该进程:

终端
sudo journalctl -k | grep -iE 'out of memory|killed process'

如果 Java 内存不足,请增大 /home/zomboid/update-server.sh 中的 XMX。如果进程被系统终止,请减小该值或升级到内存更大的方案。无论哪种情况,之后都请在服务器停止时重新运行此脚本。

steamclient.so 错误

如果日志提示找不到 steamclient.so,请创建所需的链接:

终端
sudo -iu zomboid
mkdir -p ~/.steam/sdk64
ln -sf ~/pz-server/linux64/steamclient.so ~/.steam/sdk64/steamclient.so
exit

玩家无法连接

  • 等待日志中出现 *** SERVER STARTED ****
  • 检查 UDP 端口 16261 和 16262 是否已开放
  • 检查服务器是否正在监听:sudo ss -ulpn | grep -E ':(16261|16262)\b'

显示给玩家的消息

消息 原因和解决方法
Client version (...) does not match server version (...) 请将服务器和游戏更新到相同版本,并使用相同的 Steam 分支
Wrong server password given 服务器密码字段填写错误
Wrong username or password given 该账户已存在,但密码不同:请使用 setpassword 更改
Workshop item version is different than the server's 某个模组已更新:请重启服务器,然后重新启动游戏
Mod "..." is not installed 玩家未安装该模组,或 Mods 中的 ID 不正确
The server is full 如果机器性能允许,请增大 MaxPlayers

服务停止耗时较长

这是正常现象:服务器在停止前会保存世界。服务为其预留 3 分钟(TimeoutStopSec=180)。对于非常大的世界,请增大此值。