Comment créer un serveur S&box
Guide complet pour installer un serveur dédié S&box sur un VPS ou serveur dédié Linux : SteamCMD, utilisateur dédié, service systemd, console, mises à jour, sauvegarde et dépannage.
Sur cette page
Ce guide vous explique comment installer un serveur dédié S&box sur votre VPS ou serveur dédié Linux, le faire tourner avec un utilisateur dédié et un service systemd, puis l'administrer et le maintenir à jour.
Commander un serveur
Pour héberger votre serveur S&box, HostMyServers propose plusieurs offres :
- VPS Performance - Ressources dédiées et processeurs rapides, idéal pour S&box
- VPS NVMe - Pour un petit serveur ou un serveur de test
- Serveurs dédiés Eco - Pour les serveurs avec beaucoup de joueurs
- Serveurs dédiés Performance - Performance maximale
Prérequis
- Accès SSH root ou utilisateur avec sudo
- Système Linux 64 bits x86-64 : Debian 13 ou Ubuntu 24.04
- Pare-feu actif : nftables (recommandé), iptables ou ufw (n'utilisez qu'un seul outil de pare-feu à la fois)
- Accès Internet sortant vers Steam, indispensable au démarrage
- Ports 27015 UDP et 27016 UDP accessibles
- Le jeu S&box sur Steam, sur le poste de chaque joueur
Configuration requise
Facepunch ne publie pas de configuration minimale pour le serveur dédié. Les valeurs ci-dessous sont des ordres de grandeur pour démarrer : la consommation réelle dépend surtout du jeu chargé et du nombre de joueurs.
| Composant | Pour commencer | Conseillé |
|---|---|---|
| RAM | 4 Go | 8 Go et plus |
| CPU | 2 cœurs x86-64 | 4 cœurs ou plus, fréquence élevée |
| Stockage | 20 Go SSD | 40 Go SSD NVMe |
Les fichiers du serveur occupent environ 4,5 Go. Il faut y ajouter les jeux et cartes téléchargés au démarrage.
Mise à jour du système
sudo apt update && sudo apt upgrade -yVérifiez ensuite la version du système :
grep PRETTY_NAME /etc/os-releaseInstallation des dépendances
Le serveur embarque son propre environnement .NET : vous n'avez pas à l'installer. Il lui faut en revanche quelques bibliothèques système, et SteamCMD a besoin de lib32gcc-s1.
Sous Debian 13 :
sudo apt install -y ca-certificates curl tar screen cron lib32gcc-s1 libfontconfig1 libuuid1 libssl3t64 libicu76Sous Ubuntu 24.04 :
sudo apt install -y ca-certificates curl tar screen cron lib32gcc-s1 libfontconfig1 libuuid1 libssl3t64 libicu74Création d'un utilisateur dédié
Le serveur ne doit jamais tourner en root. Créez un utilisateur dédié :
sudo adduser --disabled-password --gecos "" sboxPorts utilisés
| Port | Protocole | Utilisation | Paramètre |
|---|---|---|---|
| 27015 | UDP | Jeu | +port |
| 27016 | UDP | Requêtes (nombre de joueurs, carte en cours) | +net_query_port |
Ce sont les valeurs par défaut du moteur. Par défaut, les joueurs passent par le relais de Steam : l'adresse IP du serveur ne leur est pas communiquée. La documentation de Facepunch ne précise pas si ces ports restent nécessaires avec le relais, ouvrez-les donc par précaution.
S&box n'a pas de port d'administration à ouvrir : la console du serveur n'est accessible que depuis votre session SSH.
Configuration du pare-feu
Avec UFW
sudo ufw allow 27015/udp
sudo ufw allow 27016/udp
sudo ufw reloadAvec 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.v4La sauvegarde des règles au redémarrage nécessite le paquet iptables-persistent.
Avec nftables
Ces commandes utilisent la table inet filter et la chaîne input, présentes par défaut dans /etc/nftables.conf sous Debian.
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.confInstallation de SteamCMD
Ouvrez une session avec l'utilisateur sbox, puis créez les dossiers et téléchargez 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 -Téléchargement du serveur S&box
Lancez l'installation du serveur (identifiant d'application 1892930), toujours avec l'utilisateur sbox :
./steamcmd.sh +force_install_dir /home/sbox/sbox-server +login anonymous +app_update 1892930 validate +quitÀ la fin, le message Success! App '1892930' fully installed. s'affiche. Si la commande s'arrête sur une erreur, relancez-la : SteamCMD reprend où il s'est arrêté.
Liaison du client Steam
Le serveur doit trouver steamclient.so pour initialiser Steamworks. Créez le lien vers le fichier fourni par SteamCMD :
ln -sf /home/sbox/steamcmd/linux64/steamclient.so /home/sbox/.steam/sdk64/steamclient.so
ls -lL /home/sbox/.steam/sdk64/steamclient.soScript de lancement
Créez le script de lancement :
nano ~/start.sh#!/bin/bash
cd /home/sbox/sbox-server || exit 1
exec ./sbox-server \
+game facepunch.sandbox facepunch.flatgrass \
+hostname "Mon serveur S&box" \
+port 27015 \
+net_query_port 27016Rendez-le exécutable :
chmod 700 ~/start.shParamètres principaux
| Paramètre | Description |
|---|---|
+game <jeu> [carte] |
Jeu à charger et, en option, carte. Ces identifiants sont ceux des paquets publiés sur sbox.game |
+hostname <nom> |
Nom du serveur affiché aux joueurs |
+port <port> |
Port du serveur |
+net_query_port <port> |
Port des requêtes d'informations |
+net_game_server_token <jeton> |
Optionnel : jeton de serveur Steam, qui conserve le même identifiant Steam d'un démarrage à l'autre |
Conserver le même identifiant Steam (optionnel)
Sans jeton, le serveur reçoit un nouvel identifiant Steam à chaque démarrage. Pour le conserver :
- Ouvrez la page de gestion des serveurs de jeu Steam.
- Créez un jeton pour l'application 590830 (S&box).
- Ajoutez cette ligne dans
start.sh, en terminant la ligne précédente par\:
+net_game_server_token VOTRE_JETONPremier lancement
Lancez le serveur à la main pour vérifier qu'il démarre, toujours avec l'utilisateur sbox :
~/start.shLe premier démarrage télécharge le jeu et la carte, ce qui peut prendre plusieurs minutes. Une fois le jeu chargé, tapez status dans la console pour afficher l'état du serveur et l'identifiant du lobby. Tapez ensuite quit pour l'arrêter, puis quittez la session de l'utilisateur sbox :
exitConfiguration en tant que service systemd
La console du serveur a besoin d'un terminal pour recevoir vos commandes. Le service lance donc le serveur dans une session screen, ce qui permet de garder la console accessible et d'enregistrer sa sortie dans un fichier.
Créer le fichier de service
sudo nano /etc/systemd/system/sbox.serviceContenu du fichier :
[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.targetActiver et démarrer le service
sudo systemctl daemon-reload
sudo systemctl enable sbox.service
sudo systemctl start sbox.serviceCommandes de gestion
# Vérifier le statut
sudo systemctl status sbox.service
# Arrêter le serveur
sudo systemctl stop sbox.service
# Redémarrer le serveur
sudo systemctl restart sbox.service
# Suivre la sortie de la console
sudo tail -f /home/sbox/logs/console.logUtiliser la console du serveur
Pour envoyer une commande sans ouvrir la console, puis lire le résultat :
sudo -u sbox screen -S sbox -p 0 -X stuff "status^M"
sleep 12
sudo tail -n 30 /home/sbox/logs/console.logLe fichier de sortie est écrit environ toutes les dix secondes, d'où la pause.
Pour ouvrir la console en direct :
sudo -u sbox script -qc "screen -r sbox" /dev/nullPour la quitter sans arrêter le serveur : Ctrl+A puis D.
Connexion au serveur
- Récupérez l'identifiant du lobby avec la commande
statusdans la console du serveur. - Lancez S&box et ouvrez la console du jeu.
- Tapez la commande suivante, en remplaçant le nombre par votre identifiant, sans préfixe
steamid::
connect 1234567890Administration
Ces commandes se tapent dans la console du serveur :
| Commande | Description |
|---|---|
status |
Affiche l'état du serveur et l'identifiant du lobby |
game <jeu> [carte] |
Charge un jeu, avec une carte en option |
hostname <nom> |
Change le nom du serveur |
kick <id> |
Expulse un joueur, par nom ou identifiant Steam |
find <texte> |
Recherche une commande ou une variable |
quit |
Arrête le serveur |
Mise à jour du serveur
Le client et le serveur doivent rester compatibles : mettez le serveur à jour dès qu'une nouvelle version de S&box sort.
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.serviceSauvegarde automatique
Le dossier du serveur se réinstalle à tout moment avec SteamCMD. Il suffit de conserver le script de lancement et les dossiers config et data, s'ils existent.
Script de sauvegarde
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"
# Dossiers à conserver, s'ils existent
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[@]}"
# Supprimer les sauvegardes de plus de 7 jours
find "$BACKUP_DIR" -name "sbox_*.tar.gz" -mtime +7 -delete
echo "Sauvegarde terminée : sbox_$DATE.tar.gz"sudo chown sbox:sbox /home/sbox/backup.sh
sudo chmod 700 /home/sbox/backup.shPlanifier la sauvegarde
sudo crontab -u sbox -eAjoutez :
# Sauvegarde tous les jours à 5 h
0 5 * * * /home/sbox/backup.shCopiez régulièrement ces archives hors du serveur : une sauvegarde conservée sur la même machine ne protège pas d'une panne de celle-ci.
En cas de problème
Erreur GLIBC_2.38 not found ou GLIBCXX_3.4.31 not found
Votre système est trop ancien. Le message peut aussi prendre cette forme :
Failed to load native library 'libengine2.so'. Error Code: 0/126Réinstallez la machine sous Debian 13 ou Ubuntu 24.04. Remplacer uniquement ces bibliothèques sur Debian 12 ou Ubuntu 22.04 risque de casser le système.
Erreur libfontconfig.so.1 ou Couldn't find a valid ICU package
Une dépendance manque : reprenez la commande d'installation correspondant à votre système, dans la section « Installation des dépendances ».
Erreur sur steamclient.so
Vérifiez que le lien existe et pointe vers un vrai fichier :
sudo -u sbox ls -lL /home/sbox/.steam/sdk64/steamclient.soS'il est absent, recréez-le comme indiqué dans « Liaison du client Steam ».
Unable to log on to Steam in a reasonable time!
Le serveur n'a pas pu se connecter à Steam à temps, et le chargement du jeu échoue ensuite avec Unable to download package. Vérifiez l'accès Internet sortant de la machine, puis redémarrez le service : le serveur ne retente pas seul ce chargement.
sudo systemctl restart sbox.servicePlantage au démarrage malgré un système compatible
Par exemple, une erreur X509_INFO_free sur libengine2.so. Mettez d'abord le serveur à jour, puis consultez les signalements du projet. Si le problème vient de la version publique, vous pouvez essayer la branche staging dans un dossier séparé, sachant que tous les joueurs ne pourront pas forcément la rejoindre :
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 +quitRemplacez ensuite /home/sbox/sbox-server par /home/sbox/sbox-staging dans start.sh, puis relancez le service.
Message Not Connected côté joueur
Aucun lobby n'a été créé. Vérifiez que le jeu est bien chargé avec status. Si vous développez votre propre jeu, son code doit créer le lobby.
Erreur state is 0x202 dans SteamCMD
L'espace disque est insuffisant. Vérifiez-le avec df -h, libérez de la place, puis relancez la commande.
Le fichier console.log devient trop gros
Videz-le sans arrêter le serveur :
sudo truncate -s 0 /home/sbox/logs/console.log