如何创建 7 Days to Die 服务器
在 VPS 或专用 Linux 服务器上安装 7 Days to Die 专用服务器的完整指南:SteamCMD、serverconfig.xml、systemd 服务、服务器管理、模组和备份。
本页内容
您的参数
只需填写一次,指南中的命令会自动更新。
本指南介绍如何在您的 VPS 或专用 Linux 服务器上安装 7 Days to Die 专用服务器,使用 serverconfig.xml 进行配置,以专用用户将其作为 systemd 服务运行,并对其进行管理和备份。
该服务器提供原生 Linux 版本,由 Steam 免费分发,应用程序 ID 为 294420。
订购服务器
要托管您的 7 Days to Die 服务器,HostMyServers 提供多种合适的方案:
- Performance VPS - 独享资源和高速处理器,适合大多数服务器
- NVMe VPS - 适合朋友间的小型服务器或测试服务器
- 经济型专用服务器 - 适合大型地图和玩家众多的服务器
- 性能专用服务器 - 最佳性能,适合安装了模组的服务器
前提条件
- 以 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 值:
<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 属性在原始文件中已被注释。请用下面这一行替换整行注释,以便将世界、存档和模组集中到同一个文件夹中:
<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 属性中。因此,即使在旧文件中看到这些旧属性,也不要添加。
获取代码的方法:
- 启动游戏,打开新游戏创建界面。
- 打开 Sandbox 选项并进行调整。
- 使用相应的按钮复制代码。
- 将其粘贴到文件中:
<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'连接到服务器
- 启动与服务器版本相同的 7 Days to Die。
- 打开 Join a Game(加入游戏)。
- 在列表中查找您的服务器,或使用 Connect to IP,输入地址
服务器IP和端口26900。 - 输入
ServerPassword中设置的密码。
界面文字可能因游戏语言和版本而略有不同。
服务器管理
打开控制台
通过 SSH 连接到服务器,然后打开本地控制台:
telnet 127.0.0.1 8081要退出 Telnet 而不停止服务器,请按 Ctrl+],然后输入 quit。
为自己授予管理员权限
serveradmin.xml 文件会在首次启动时创建于 /home/sevendays/7dtd-data/Saves/。最简单的方法是通过控制台操作,而不是手动编辑:
- 使用您的角色加入服务器。
- 在 Telnet 控制台中,显示已连接玩家的 ID:
lpi- 为自己授予最高权限级别
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=2000Error! 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 - 选择较小的世界
- 移除最消耗资源的模组
- 如果问题仍然存在,请升级到内存更大的方案