中文

游戏服务器

如何创建 7 Days to Die 服务器

在 VPS 或专用 Linux 服务器上安装 7 Days to Die 专用服务器的完整指南:SteamCMD、serverconfig.xml、systemd 服务、服务器管理、模组和备份。

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

本页内容

您的参数

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

本指南介绍如何在您的 VPS 或专用 Linux 服务器上安装 7 Days to Die 专用服务器,使用 serverconfig.xml 进行配置,以专用用户将其作为 systemd 服务运行,并对其进行管理和备份。

该服务器提供原生 Linux 版本,由 Steam 免费分发,应用程序 ID 为 294420。

订购服务器

要托管您的 7 Days to Die 服务器,HostMyServers 提供多种合适的方案:

前提条件

  • 以 root 或具有 sudo 权限的用户进行 SSH 访问
  • 64 位 Linux 系统:Debian 12/13 或 Ubuntu 22.04/24.04
  • 已启用防火墙:nftables、iptables 或 ufw(一次只使用一种工具)
  • 一个拥有该游戏的 Steam 账户,用于连接服务器(下载服务器本身不需要账户)

配置要求

组件 最低 推荐
内存 8 GB 16 GB 及以上
CPU 2 个高速核心 4 核或更多,高主频
存储 40 GB SSD 80 GB NVMe SSD

服务器文件本身约占 18 GB。其余空间用于生成的世界、备份和模组。

使用的端口

端口 协议 用途 开放范围
26900 TCP 游戏 公开
26900 至 26903 UDP 游戏 公开
8081 TCP Telnet(管理控制台) 仅限本地
8080 TCP Web 仪表板,默认禁用 关闭,或仅限您的 IP

如果更改 ServerPort,游戏端口会相应偏移。

系统更新

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

安装依赖项

SteamCMD 需要 32 位库。其他软件包用于下载、检查配置、Telnet 控制台和计划备份:

终端
sudo apt install -y lib32gcc-s1 curl tar ca-certificates nano cron telnet libxml2-utils

创建专用用户

服务器绝不能以 root 身份运行。请创建一个专供其使用的用户:

终端
sudo useradd --create-home --shell /bin/bash sevendays

防火墙配置

仅开放游戏端口。Telnet 端口 8081 保持关闭:控制台只能从服务器本机访问。

使用 UFW

终端
sudo ufw allow 26900/tcp
sudo ufw allow 26900:26903/udp
sudo ufw reload

使用 iptables

终端
sudo apt install -y iptables-persistent
sudo iptables -A INPUT -p tcp --dport 26900 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 26900:26903 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4

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

使用 nftables

这些命令会先启用 nftables,然后使用软件包自带的 /etc/nftables.conf 文件中的 inet filter 表和 input 链,适用于 Debian 和 Ubuntu。

终端
sudo apt install -y nftables
sudo systemctl enable --now nftables
sudo nft add rule inet filter input tcp dport 26900 accept
sudo nft add rule inet filter input udp dport 26900-26903 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf

安装 SteamCMD

以专用用户身份打开会话,然后下载 SteamCMD:

终端
sudo -iu sevendays
mkdir -p ~/steamcmd ~/7dtd-server ~/7dtd-data
cd ~/steamcmd
curl -fsSL https://steamcdn-a.akamaihd.net/client/installer/steamcmd_linux.tar.gz | tar -xzf -

下载服务器

仍使用 sevendays 用户:

终端
~/steamcmd/steamcmd.sh +force_install_dir /home/sevendays/7dtd-server +login anonymous +app_update 294420 validate +quit

完成后,将显示消息 Success! App '294420' fully installed.。如果下载中断,请重新运行同一命令:SteamCMD 会从中断处继续。

服务器配置

创建您的配置文件

更新可能会覆盖 serverconfig.xml。因此请在 Steam 不会改动的副本上进行修改:

终端
cd ~/7dtd-server
cp serverconfig.xml serverconfig.custom.xml
nano serverconfig.custom.xml

需要修改的参数

在文件中找到每个属性,仅修改其 value 值:

xml
<property name="ServerName" value="我的 7 Days to Die 服务器"/>
<property name="ServerDescription" value="欢迎来到我的服务器"/>
<property name="ServerPassword" value="PlayerPassword"/>
<property name="ServerPort" value="26900"/>
<property name="ServerVisibility" value="2"/>
<property name="ServerMaxPlayerCount" value="8"/>
<property name="GameWorld" value="Navezgane"/>
<property name="GameName" value="MyGame"/>
<property name="WebDashboardEnabled" value="false"/>
<property name="TelnetEnabled" value="true"/>
<property name="TelnetPort" value="8081"/>
<property name="TelnetPassword" value=""/>
<property name="EACEnabled" value="true"/>

UserDataFolder 属性在原始文件中已被注释。请用下面这一行替换整行注释,以便将世界、存档和模组集中到同一个文件夹中:

xml
<property name="UserDataFolder" value="/home/sevendays/7dtd-data"/>
参数 描述
ServerName 在服务器列表中显示的名称
ServerPassword 加入服务器的密码(留空 = 任何人都可加入)
ServerPort 游戏端口
ServerVisibility 2 = 公开,1 = 仅限好友,0 = 不列出
ServerMaxPlayerCount 最大同时在线玩家数
GameWorld Navezgane、自带世界(如 Pregen06k01),或使用 RWG 生成世界
WorldGenSeed GameWorld 为 RWG 时的世界种子
WorldGenSize RWG 世界的大小:6144、8192 或 10240
GameName 游戏名称,用于存档文件夹
SandboxCode 汇总难度和游戏设置的代码
TelnetPassword 留空时,Telnet 仅在本地接口上监听
EACEnabled 启用 EasyAntiCheat
UserDataFolder 服务器数据文件夹

使用 SandboxCode 设置难度

自 3.0 版本起,许多设置已从 serverconfig.xml 中移出:GameDifficulty、XPMultiplier、DayNightLength、BloodMoonFrequency、LootAbundance 等。它们现已合并到 SandboxCode 属性中。因此,即使在旧文件中看到这些旧属性,也不要添加。

获取代码的方法:

  1. 启动游戏,打开新游戏创建界面。
  2. 打开 Sandbox 选项并进行调整。
  3. 使用相应的按钮复制代码。
  4. 将其粘贴到文件中:
xml
<property name="SandboxCode" value="AAAJABJACJADJARFBNC"/>

上面的值是默认代码,对应 Adventurer 难度。

检查文件

标签未正确闭合会导致服务器无法读取配置。请检查文件:

终端
xmllint --noout ~/7dtd-server/serverconfig.custom.xml && echo "配置有效"

安全停止脚本

为了在每次停止时保存世界,服务会向本地控制台依次发送 saveworld 和 shutdown 命令。仍使用 sevendays 用户,创建脚本:

终端
nano ~/stop.sh
终端
#!/bin/bash
# 通过本地 Telnet 控制台保存世界并停止服务器。
(
  exec 3<>/dev/tcp/127.0.0.1/8081 || exit 1
  printf 'saveworld\r\n' >&3
  sleep 10
  printf 'shutdown\r\n' >&3
  sleep 2
) 2>/dev/null || exit 0

# 等待服务器真正退出后,再将控制权交还给 systemd。
while kill -0 "$1" 2>/dev/null; do
  sleep 2
done

赋予其执行权限并退出会话:

终端
chmod +x ~/stop.sh
exit

配置为 systemd 服务

创建服务文件

终端
sudo nano /etc/systemd/system/7dtd.service
配置
[Unit]
Description=7 Days to Die Dedicated Server
Wants=network-online.target
After=network-online.target

[Service]
Type=simple
User=sevendays
Group=sevendays
WorkingDirectory=/home/sevendays/7dtd-server
ExecStart=/bin/sh /home/sevendays/7dtd-server/startserver.sh -configfile=serverconfig.custom.xml
ExecStop=/home/sevendays/stop.sh $MAINPID
TimeoutStopSec=180
Restart=on-failure
RestartSec=30
LimitNOFILE=100000

[Install]
WantedBy=multi-user.target

启用并启动服务

终端
sudo systemctl daemon-reload
sudo systemctl enable --now 7dtd.service

管理命令

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

# 安全停止服务器
sudo systemctl stop 7dtd.service

# 重启服务器
sudo systemctl restart 7dtd.service

跟踪启动过程

启动脚本每次启动都会写入一个带时间戳的日志。要跟踪最新的日志:

终端
sudo -u sevendays bash -c 'tail -f "$(ls -t /home/sevendays/7dtd-server/7DaysToDieServer_Data/output_log__*.txt | head -1)"'

启动需要几分钟。然后检查服务器是否正在监听其端口:

终端
sudo ss -tulpn | grep -E ':(26900|26901|26902|26903|8081)\b'

连接到服务器

  1. 启动与服务器版本相同的 7 Days to Die。
  2. 打开 Join a Game(加入游戏)。
  3. 在列表中查找您的服务器,或使用 Connect to IP,输入地址 服务器IP 和端口 26900。
  4. 输入 ServerPassword 中设置的密码。

界面文字可能因游戏语言和版本而略有不同。

服务器管理

打开控制台

通过 SSH 连接到服务器,然后打开本地控制台:

终端
telnet 127.0.0.1 8081

要退出 Telnet 而不停止服务器,请按 Ctrl+],然后输入 quit。

为自己授予管理员权限

serveradmin.xml 文件会在首次启动时创建于 /home/sevendays/7dtd-data/Saves/。最简单的方法是通过控制台操作,而不是手动编辑:

  1. 使用您的角色加入服务器。
  2. 在 Telnet 控制台中,显示已连接玩家的 ID:
文本
lpi
  1. 为自己授予最高权限级别 0:
文本
admin add PlayerName 0

权限级别从 0(全部权限)到 1000(无权限)。成为管理员后,您可以按 F1 打开游戏内控制台。

常用命令

命令 描述
help 列出您的版本可用的命令
listplayers 或 lp 显示已连接的玩家
listplayerids 或 lpi 显示玩家及其 ID
say "消息" 向所有玩家发送消息
kick PlayerName "原因" 踢出玩家
ban add PlayerName 1 days "原因" 在指定时长内封禁玩家
ban remove <id> 解除封禁
whitelist add PlayerName 将玩家加入白名单
admin add PlayerName 0 任命管理员
admin remove PlayerName 移除管理员
saveworld 或 sa 保存世界
shutdown 保存世界并停止服务器

Web 仪表板

仪表板默认禁用,这也是最安全的设置。如果您通过 WebDashboardEnabled 启用它,请勿向所有人开放端口 8080。建议从您的计算机通过 SSH 隧道访问:

终端
ssh -L 8080:127.0.0.1:8080 您的用户名@服务器IP

然后可通过 http://127.0.0.1:8080 访问仪表板。如果您有固定 IP 地址,也可以改为将该端口限制为仅允许此地址访问:

终端
# UFW
sudo ufw allow from 您的IP to any port 8080 proto tcp

# iptables
sudo iptables -A INPUT -p tcp -s 您的IP --dport 8080 -j ACCEPT

# nftables
sudo nft add rule inet filter input ip saddr 您的IP tcp dport 8080 accept

安装模组

设置 UserDataFolder 后,模组应放在 /home/sevendays/7dtd-data/Mods/ 中。每个模组占用单独的文件夹,其中包含 ModInfo.xml 文件。

终端
sudo systemctl stop 7dtd.service
sudo -iu sevendays
mkdir -p ~/7dtd-data/Mods
# 将模组文件夹复制到此处,例如使用 scp 或 unzip
exit
sudo systemctl start 7dtd.service

然后在控制台中使用 version 命令确认模组已列出。

自 3.0 版本起,部分为旧版本编写的模组已无法使用。每次更新前请检查兼容性。

服务器更新

玩家和服务器必须使用相同的游戏版本。每次更新前请先备份,因为大版本变更可能导致存档不兼容。backup.sh 脚本将在下一节介绍。

终端
sudo systemctl stop 7dtd.service
sudo -u sevendays /home/sevendays/backup.sh
sudo -iu sevendays
~/steamcmd/steamcmd.sh +force_install_dir /home/sevendays/7dtd-server +login anonymous +app_update 294420 validate +quit

然后将您的配置与新提供的文件进行比较,找出新增或移除的属性:

终端
diff ~/7dtd-server/serverconfig.xml ~/7dtd-server/serverconfig.custom.xml
exit
sudo systemctl start 7dtd.service

自动备份

备份脚本

终端
sudo -u sevendays nano /home/sevendays/backup.sh
终端
#!/bin/bash
BACKUP_DIR="/home/sevendays/backups"
DATE=$(date +%Y-%m-%d_%H-%M-%S)
ARCHIVE="$BACKUP_DIR/7dtd_$DATE.tar.gz"

umask 077
mkdir -p "$BACKUP_DIR"

# 如果服务器正在运行,则在归档前保存世界
(
  exec 3<>/dev/tcp/127.0.0.1/8081 || exit 1
  printf 'saveworld\r\n' >&3
  sleep 15
) 2>/dev/null

tar -czf "$ARCHIVE" -C /home/sevendays 7dtd-data 7dtd-server/serverconfig.custom.xml
STATUS=$?

# 退出码 1 仅表示读取期间有文件被修改
if [ "$STATUS" -gt 1 ]; then
  rm -f "$ARCHIVE"
  echo "备份失败" >&2
  exit "$STATUS"
fi

# 删除超过7天的备份
find "$BACKUP_DIR" -name "7dtd_*.tar.gz" -mtime +7 -delete

echo "备份完成:$ARCHIVE"
终端
sudo chmod +x /home/sevendays/backup.sh

计划备份

终端
sudo crontab -u sevendays -e

添加:

文本
# 每6小时备份
0 */6 * * * /home/sevendays/backup.sh

同时请在另一台机器上保留一份副本:存放在同一磁盘上的备份无法在该磁盘发生故障时保护您的数据。

恢复备份

将归档文件名替换为您选择的备份名称:

终端
sudo systemctl stop 7dtd.service
sudo -iu sevendays
mv ~/7dtd-data ~/7dtd-data.old
tar -xzf ~/backups/7dtd_2026-01-01_12-00-00.tar.gz -C ~
exit
sudo systemctl start 7dtd.service

在游戏中确认结果无误后,即可删除 ~/7dtd-data.old。

故障排除

服务无法启动

  • 查看服务状态:sudo journalctl -u 7dtd.service -n 100
  • 查看 7DaysToDieServer_Data/ 中最新的 output_log__*.txt 文件
  • 验证配置:xmllint --noout /home/sevendays/7dtd-server/serverconfig.custom.xml
  • 检查磁盘空间和内存:df -h 和 free -h
  • 确认文件归该用户所有:sudo chown -R sevendays:sevendays /home/sevendays

Unable to determine CPU Frequency

如果 SteamCMD 显示 Unable to determine CPU Frequency. Try defining CPU_MHZ.,请在重新运行命令前设置该变量:

终端
export CPU_MHZ=2000

Error! App '294420' state is 0x202 after update job

此错误通常由磁盘空间不足或权限不正确引起。请检查 df -h,使用上面的 chown 命令修正文件所有者,然后重新运行 SteamCMD。

steamclient.so 错误

如果日志报告与 steamclient.so 相关的错误,请创建指向 SteamCMD 文件的链接:

终端
sudo -iu sevendays
mkdir -p ~/.steam/sdk64
ln -sf ~/steamcmd/linux64/steamclient.so ~/.steam/sdk64/steamclient.so
exit
sudo systemctl restart 7dtd.service

玩家无法连接

  • 等待启动完成,尤其是在生成世界时
  • 使用上文的 ss 命令检查服务器是否正在监听
  • 检查防火墙:TCP 26900 和 UDP 26900 至 26903
  • 确认玩家使用的游戏版本与服务器相同
  • 如果使用模组,请检查 EACEnabled 的值和模组说明

服务器未出现在列表中

  • 确认 ServerVisibility 的值为 2
  • 启动后请等待几分钟
  • 尝试使用 Connect to IP 直接连接,以区分是列表问题还是网络问题

Telnet 控制台拒绝连接

  • 服务器可能仍在启动中
  • 确认 TelnetEnabled 为 true 且 TelnetPort 为 8081
  • 请在服务器本机上运行 telnet,而不是在您的计算机上

服务器停止运行或变慢

  • 排查内存不足:sudo journalctl -k | grep -i "out of memory"
  • 减小 ServerMaxPlayerCount 和 MaxSpawnedZombies
  • 选择较小的世界
  • 移除最消耗资源的模组
  • 如果问题仍然存在,请升级到内存更大的方案