如何创建 Project Zomboid 服务器
在 VPS 或专用 Linux 服务器上创建 Project Zomboid 专用服务器的完整指南:使用 SteamCMD 安装、内存、管理员账户、创意工坊模组、systemd 服务和备份。
本页内容
您的参数
只需填写一次,指南中的命令会自动更新。
本指南介绍如何在您的 VPS 或专用 Linux 服务器上安装 Project Zomboid 专用服务器,调整其内存,管理玩家,并添加 Steam 创意工坊的模组。游戏工作室 The Indie Stone 提供原生 Linux 版服务器,并自带 Java 运行环境。
订购服务器
要托管您的 Project Zomboid 服务器,HostMyServers 提供多种合适的选择:
- Performance VPS - 独享资源和高速处理器,非常适合 Project Zomboid
- NVMe VPS - 适合与朋友一起游戏的小型服务器
- 经济型专用服务器 - 适合玩家或模组较多的服务器
- 性能专用服务器 - 最佳性能
前提条件
- 以 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.jsonchmod +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'连接到服务器
- 启动与服务器版本相同的 Project Zomboid。
- 在主菜单中打开 Join。
- 填写地址
服务器IP和端口16261。 - 如果服务器设有密码,请输入服务器密码,并填写您的用户名和账户密码。
要以管理员身份连接,请使用用户名 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 reloadiptables:
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.v4nftables:
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 -deletesudo 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 servertestOnly 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)。对于非常大的世界,请增大此值。