中文

游戏服务器

如何创建 S&box 服务器

在 VPS 或专用 Linux 服务器上安装 S&box 专用服务器的完整指南:SteamCMD、专用用户、systemd 服务、控制台、更新、备份和故障排除。

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

本页内容

本指南介绍如何在您的 VPS 或专用 Linux 服务器上安装 S&box 专用服务器,使用专用用户和 systemd 服务运行它,并对其进行管理和保持更新。

订购服务器

要托管您的 S&box 服务器,HostMyServers 提供多种选择:

前提条件

  • 以 root 或具有 sudo 权限的用户进行 SSH 访问
  • 64 位 x86-64 Linux 系统:Debian 13 或 Ubuntu 24.04
  • 已启用防火墙:nftables(推荐)、iptables 或 ufw(一次只使用一种防火墙工具)
  • 可出站访问 Steam 的互联网连接,这是启动所必需的
  • 端口 27015 UDP 和 27016 UDP 可访问
  • 每位玩家的电脑上需安装 Steam 版 S&box 游戏

配置要求

Facepunch 没有公布专用服务器的最低配置。下表中的数值只是起步时的大致参考:实际消耗主要取决于所加载的游戏和玩家数量。

组件 起步 推荐
内存 4 GB 8 GB 及以上
CPU 2 核 x86-64 4 核或更多,高主频
存储 20 GB SSD 40 GB NVMe SSD

服务器文件约占 4.5 GB。此外还需要为启动时下载的游戏和地图预留空间。

系统更新

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

然后检查系统版本:

终端
grep PRETTY_NAME /etc/os-release

安装依赖项

服务器自带 .NET 运行环境,您无需另行安装。但它需要一些系统库,并且 SteamCMD 需要 lib32gcc-s1。

Debian 13 系统:

终端
sudo apt install -y ca-certificates curl tar screen cron lib32gcc-s1 libfontconfig1 libuuid1 libssl3t64 libicu76

Ubuntu 24.04 系统:

终端
sudo apt install -y ca-certificates curl tar screen cron lib32gcc-s1 libfontconfig1 libuuid1 libssl3t64 libicu74

创建专用用户

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

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

使用的端口

端口 协议 用途 参数
27015 UDP 游戏 +port
27016 UDP 查询(玩家数量、当前地图) +net_query_port

这些是引擎的默认值。默认情况下,玩家通过 Steam 的中继连接:服务器的 IP 地址不会告知玩家。Facepunch 的文档没有说明使用中继时是否仍需要这些端口,因此为保险起见请将其开放。

S&box 没有需要开放的管理端口:服务器控制台只能通过您的 SSH 会话访问。

防火墙配置

使用 UFW

终端
sudo ufw allow 27015/udp
sudo ufw allow 27016/udp
sudo ufw reload

使用 iptables

终端
sudo iptables -A INPUT -p udp --dport 27015 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 27016 -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 27015 accept
sudo nft add rule inet filter input udp dport 27016 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf

安装 SteamCMD

以 sbox 用户身份登录,然后创建目录并下载 SteamCMD:

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

下载 S&box 服务器

仍以 sbox 用户身份启动服务器安装(应用程序 ID 1892930):

终端
./steamcmd.sh +force_install_dir /home/sbox/sbox-server +login anonymous +app_update 1892930 validate +quit

完成后,将显示消息 Success! App '1892930' fully installed.。如果命令因错误而中断,请重新运行:SteamCMD 会从中断处继续。

链接 Steam 客户端

服务器必须找到 steamclient.so 才能初始化 Steamworks。请创建指向 SteamCMD 所提供文件的链接:

终端
ln -sf /home/sbox/steamcmd/linux64/steamclient.so /home/sbox/.steam/sdk64/steamclient.so
ls -lL /home/sbox/.steam/sdk64/steamclient.so

启动脚本

创建启动脚本:

终端
nano ~/start.sh
终端
#!/bin/bash
cd /home/sbox/sbox-server || exit 1

exec ./sbox-server \
    +game facepunch.sandbox facepunch.flatgrass \
    +hostname "我的 S&box 服务器" \
    +port 27015 \
    +net_query_port 27016

使其可执行:

终端
chmod 700 ~/start.sh

主要参数

参数 描述
+game <游戏> [地图] 要加载的游戏,以及可选的地图。这些标识符来自 sbox.game 上发布的软件包
+hostname <名称> 向玩家显示的服务器名称
+port <端口> 服务器端口
+net_query_port <端口> 信息查询端口
+net_game_server_token <令牌> 可选:Steam 服务器令牌,可使服务器在每次启动时保持相同的 Steam 标识符

保持相同的 Steam 标识符(可选)

没有令牌时,服务器每次启动都会获得新的 Steam 标识符。要保持不变:

  1. 打开 Steam 游戏服务器管理页面。
  2. 为应用程序 590830(S&box)创建一个令牌。
  3. 将下面这一行添加到 start.sh 中,并在上一行末尾加上 \:
终端
    +net_game_server_token 您的令牌

首次启动

仍以 sbox 用户身份手动启动服务器,以确认其能够正常运行:

终端
~/start.sh

首次启动会下载游戏和地图,可能需要几分钟。游戏加载完成后,在控制台中输入 status 以显示服务器状态和大厅(lobby)标识符。然后输入 quit 将其停止,再退出 sbox 用户的会话:

终端
exit

配置为 systemd 服务

服务器控制台需要终端来接收您的命令。因此该服务在 screen 会话中启动服务器,这样既能保持控制台可访问,又能将其输出记录到文件中。

创建服务文件

终端
sudo nano /etc/systemd/system/sbox.service

文件内容:

配置
[Unit]
Description=S&box Dedicated Server
Wants=network-online.target
After=network-online.target

[Service]
Type=simple
User=sbox
Group=sbox
WorkingDirectory=/home/sbox
Environment=TERM=xterm
ExecStart=/usr/bin/screen -DmS sbox -L -Logfile /home/sbox/logs/console.log /home/sbox/start.sh
ExecStop=/bin/sh -c '/usr/bin/screen -S sbox -p 0 -X stuff "quit^M"; while kill -0 $MAINPID 2>/dev/null; do sleep 1; done'
Restart=always
RestartSec=20
TimeoutStopSec=60
LimitNOFILE=100000

[Install]
WantedBy=multi-user.target

启用并启动服务

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

管理命令

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

# 停止服务器
sudo systemctl stop sbox.service

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

# 实时查看控制台输出
sudo tail -f /home/sbox/logs/console.log

使用服务器控制台

要在不打开控制台的情况下发送命令并查看结果:

终端
sudo -u sbox screen -S sbox -p 0 -X stuff "status^M"
sleep 12
sudo tail -n 30 /home/sbox/logs/console.log

输出文件大约每十秒写入一次,因此需要暂停等待。

要实时打开控制台:

终端
sudo -u sbox script -qc "screen -r sbox" /dev/null

要在不停止服务器的情况下退出:Ctrl+A 然后 D。

连接到服务器

  1. 在服务器控制台中使用 status 命令获取大厅标识符。
  2. 启动 S&box 并打开游戏控制台。
  3. 输入以下命令,将数字替换为您的标识符,不要带 steamid: 前缀:
文本
connect 1234567890

管理

这些命令在服务器控制台中输入:

命令 描述
status 显示服务器状态和大厅标识符
game <游戏> [地图] 加载游戏,可选择指定地图
hostname <名称> 更改服务器名称
kick <id> 踢出玩家,可按名称或 Steam 标识符
find <文本> 搜索命令或变量
quit 停止服务器

服务器更新

客户端和服务器必须保持兼容:S&box 一旦发布新版本,请立即更新服务器。

终端
sudo systemctl stop sbox.service
sudo -iu sbox /home/sbox/steamcmd/steamcmd.sh +force_install_dir /home/sbox/sbox-server +login anonymous +app_update 1892930 validate +quit
sudo systemctl start sbox.service

自动备份

服务器文件夹可随时通过 SteamCMD 重新安装。只需保留启动脚本以及 config 和 data 文件夹(如果存在)。

备份脚本

终端
sudo nano /home/sbox/backup.sh
终端
#!/bin/bash
BACKUP_DIR="/home/sbox/backups"
SERVER_DIR="/home/sbox/sbox-server"
DATE=$(date +%Y-%m-%d_%H-%M-%S)

mkdir -p "$BACKUP_DIR"
chmod 700 "$BACKUP_DIR"

# 要保留的文件夹(如果存在)
ITEMS=()
for DIR in config data; do
    [ -e "$SERVER_DIR/$DIR" ] && ITEMS+=("$DIR")
done

tar -czf "$BACKUP_DIR/sbox_$DATE.tar.gz" -C /home/sbox start.sh -C "$SERVER_DIR" "${ITEMS[@]}"

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

echo "备份完成:sbox_$DATE.tar.gz"
终端
sudo chown sbox:sbox /home/sbox/backup.sh
sudo chmod 700 /home/sbox/backup.sh

计划备份

终端
sudo crontab -u sbox -e

添加:

文本
# 每天凌晨5点备份
0 5 * * * /home/sbox/backup.sh

请定期将这些归档文件复制到服务器之外:保存在同一台机器上的备份无法防范该机器本身的故障。

故障排除

错误 GLIBC_2.38 not found 或 GLIBCXX_3.4.31 not found

您的系统太旧。该消息也可能以下面的形式出现:

文本
Failed to load native library 'libengine2.so'. Error Code: 0/126

请在 Debian 13 或 Ubuntu 24.04 上重新安装该机器。仅在 Debian 12 或 Ubuntu 22.04 上替换这些库可能会破坏系统。

错误 libfontconfig.so.1 或 Couldn't find a valid ICU package

缺少依赖项:请重新执行与您的系统对应的安装命令,参见“安装依赖项”一节。

steamclient.so 错误

检查链接是否存在并指向真实文件:

终端
sudo -u sbox ls -lL /home/sbox/.steam/sdk64/steamclient.so

如果不存在,请按照“链接 Steam 客户端”中的说明重新创建。

Unable to log on to Steam in a reasonable time!

服务器未能及时连接到 Steam,随后游戏加载会因 Unable to download package 而失败。请检查机器的出站互联网访问,然后重启服务:服务器不会自行重试此加载。

终端
sudo systemctl restart sbox.service

系统兼容但启动时崩溃

例如,libengine2.so 上出现 X509_INFO_free 错误。请先更新服务器,然后查看项目的问题报告。如果问题出在公开版本上,您可以在单独的文件夹中尝试 staging 分支,但请注意并非所有玩家都能加入:

终端
sudo systemctl stop sbox.service
sudo -iu sbox /home/sbox/steamcmd/steamcmd.sh +force_install_dir /home/sbox/sbox-staging +login anonymous +app_update 1892930 -beta staging validate +quit

然后在 start.sh 中将 /home/sbox/sbox-server 替换为 /home/sbox/sbox-staging,再重启服务。

玩家端出现 Not Connected 消息

尚未创建任何大厅。请使用 status 检查游戏是否已加载。如果您正在开发自己的游戏,其代码必须创建大厅。

SteamCMD 中出现错误 state is 0x202

磁盘空间不足。请使用 df -h 检查,释放空间后重新运行该命令。

console.log 文件变得过大

在不停止服务器的情况下清空它:

终端
sudo truncate -s 0 /home/sbox/logs/console.log