如何创建 S&box 服务器
在 VPS 或专用 Linux 服务器上安装 S&box 专用服务器的完整指南:SteamCMD、专用用户、systemd 服务、控制台、更新、备份和故障排除。
本页内容
本指南介绍如何在您的 VPS 或专用 Linux 服务器上安装 S&box 专用服务器,使用专用用户和 systemd 服务运行它,并对其进行管理和保持更新。
订购服务器
要托管您的 S&box 服务器,HostMyServers 提供多种选择:
- Performance VPS - 独享资源和高速处理器,非常适合 S&box
- NVMe VPS - 适合小型服务器或测试服务器
- 经济型专用服务器 - 适合玩家较多的服务器
- 性能专用服务器 - 最佳性能
前提条件
- 以 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 libicu76Ubuntu 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 标识符。要保持不变:
- 打开 Steam 游戏服务器管理页面。
- 为应用程序 590830(S&box)创建一个令牌。
- 将下面这一行添加到
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。
连接到服务器
- 在服务器控制台中使用
status命令获取大厅标识符。 - 启动 S&box 并打开游戏控制台。
- 输入以下命令,将数字替换为您的标识符,不要带
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