Come creare il tuo server S&box
Guida completa per installare un server dedicato S&box su un VPS o server dedicato Linux: SteamCMD, utente dedicato, servizio systemd, console, aggiornamenti, backup e risoluzione dei problemi.
In questa pagina
Questa guida spiega come installare un server dedicato S&box sul tuo VPS o server dedicato Linux, farlo girare con un utente dedicato e un servizio systemd, poi amministrarlo e mantenerlo aggiornato.
Ordina un Server
Per ospitare il tuo server S&box, HostMyServers offre diverse soluzioni:
- VPS Performance - Risorse dedicate e processori veloci, ideale per S&box
- VPS NVMe - Per un piccolo server o un server di test
- Server Dedicati Eco - Per server con molti giocatori
- Server Dedicati Performance - Prestazioni massime
Prerequisiti
- Accesso SSH come root o utente con sudo
- Sistema Linux a 64 bit x86-64: Debian 13 o Ubuntu 24.04
- Firewall attivo: nftables (consigliato), iptables o ufw (usa un solo strumento firewall alla volta)
- Accesso a Internet in uscita verso Steam, indispensabile all'avvio
- Porte 27015 UDP e 27016 UDP accessibili
- Il gioco S&box su Steam, sul PC di ogni giocatore
Configurazione richiesta
Facepunch non pubblica una configurazione minima per il server dedicato. I valori qui sotto sono ordini di grandezza per iniziare: il consumo reale dipende soprattutto dal gioco caricato e dal numero di giocatori.
| Componente | Per iniziare | Consigliato |
|---|---|---|
| RAM | 4 GB | 8 GB e oltre |
| CPU | 2 core x86-64 | 4 core o più, frequenza elevata |
| Archiviazione | 20 GB SSD | 40 GB SSD NVMe |
I file del server occupano circa 4,5 GB. A questi vanno aggiunti i giochi e le mappe scaricati all'avvio.
Aggiornamento del sistema
sudo apt update && sudo apt upgrade -yVerifica poi la versione del sistema:
grep PRETTY_NAME /etc/os-releaseInstallazione delle dipendenze
Il server include il proprio ambiente .NET: non devi installarlo. Servono invece alcune librerie di sistema, e SteamCMD ha bisogno di lib32gcc-s1.
Su Debian 13:
sudo apt install -y ca-certificates curl tar screen cron lib32gcc-s1 libfontconfig1 libuuid1 libssl3t64 libicu76Su Ubuntu 24.04:
sudo apt install -y ca-certificates curl tar screen cron lib32gcc-s1 libfontconfig1 libuuid1 libssl3t64 libicu74Creazione di un utente dedicato
Il server non deve mai girare come root. Crea un utente dedicato:
sudo adduser --disabled-password --gecos "" sboxPorte utilizzate
| Porta | Protocollo | Utilizzo | Parametro |
|---|---|---|---|
| 27015 | UDP | Gioco | +port |
| 27016 | UDP | Query (numero di giocatori, mappa in corso) | +net_query_port |
Sono i valori predefiniti del motore. Per impostazione predefinita, i giocatori passano dal relay di Steam: l'indirizzo IP del server non viene comunicato loro. La documentazione di Facepunch non specifica se queste porte restino necessarie con il relay, quindi aprile per precauzione.
S&box non ha nessuna porta di amministrazione da aprire: la console del server è accessibile solo dalla tua sessione SSH.
Configurazione del firewall
Con UFW
sudo ufw allow 27015/udp
sudo ufw allow 27016/udp
sudo ufw reloadCon 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.v4Il salvataggio delle regole al riavvio richiede il pacchetto iptables-persistent.
Con nftables
Questi comandi usano la tabella inet filter e la catena input, presenti per impostazione predefinita in /etc/nftables.conf su 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.confInstallazione di SteamCMD
Apri una sessione con l'utente sbox, poi crea le cartelle e scarica 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 -Download del server S&box
Avvia l'installazione del server (ID applicazione 1892930), sempre con l'utente sbox:
./steamcmd.sh +force_install_dir /home/sbox/sbox-server +login anonymous +app_update 1892930 validate +quitAl termine viene visualizzato il messaggio Success! App '1892930' fully installed. Se il comando si interrompe con un errore, rilancialo: SteamCMD riprende da dove si era fermato.
Collegamento del client Steam
Il server deve trovare steamclient.so per inizializzare Steamworks. Crea il collegamento al file fornito da SteamCMD:
ln -sf /home/sbox/steamcmd/linux64/steamclient.so /home/sbox/.steam/sdk64/steamclient.so
ls -lL /home/sbox/.steam/sdk64/steamclient.soScript di avvio
Crea lo script di avvio:
nano ~/start.sh#!/bin/bash
cd /home/sbox/sbox-server || exit 1
exec ./sbox-server \
+game facepunch.sandbox facepunch.flatgrass \
+hostname "Il mio server S&box" \
+port 27015 \
+net_query_port 27016Rendilo eseguibile:
chmod 700 ~/start.shParametri principali
| Parametro | Descrizione |
|---|---|
+game <gioco> [mappa] |
Gioco da caricare e, facoltativamente, mappa. Questi identificatori sono quelli dei pacchetti pubblicati su sbox.game |
+hostname <nome> |
Nome del server mostrato ai giocatori |
+port <porta> |
Porta del server |
+net_query_port <porta> |
Porta delle richieste di informazioni |
+net_game_server_token <token> |
Facoltativo: token di server Steam, che mantiene lo stesso ID Steam da un avvio all'altro |
Mantenere lo stesso ID Steam (facoltativo)
Senza token, il server riceve un nuovo ID Steam a ogni avvio. Per mantenerlo:
- Apri la pagina di gestione dei server di gioco Steam.
- Crea un token per l'applicazione 590830 (S&box).
- Aggiungi questa riga in
start.sh, terminando la riga precedente con\:
+net_game_server_token TUO_TOKENPrimo avvio
Avvia il server a mano per verificare che parta, sempre con l'utente sbox:
~/start.shIl primo avvio scarica il gioco e la mappa, e può richiedere diversi minuti. Una volta caricato il gioco, digita status nella console per mostrare lo stato del server e l'ID della lobby. Digita poi quit per arrestarlo, quindi esci dalla sessione dell'utente sbox:
exitConfigurazione come servizio systemd
La console del server ha bisogno di un terminale per ricevere i tuoi comandi. Il servizio avvia quindi il server in una sessione screen, così la console resta accessibile e il suo output viene registrato in un file.
Creare il file di servizio
sudo nano /etc/systemd/system/sbox.serviceContenuto del file:
[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.targetAttivare e avviare il servizio
sudo systemctl daemon-reload
sudo systemctl enable sbox.service
sudo systemctl start sbox.serviceComandi di gestione
# Verificare lo stato
sudo systemctl status sbox.service
# Fermare il server
sudo systemctl stop sbox.service
# Riavviare il server
sudo systemctl restart sbox.service
# Seguire l'output della console
sudo tail -f /home/sbox/logs/console.logUsare la console del server
Per inviare un comando senza aprire la console, e poi leggerne il risultato:
sudo -u sbox screen -S sbox -p 0 -X stuff "status^M"
sleep 12
sudo tail -n 30 /home/sbox/logs/console.logIl file di output viene scritto circa ogni dieci secondi, da qui la pausa.
Per aprire la console in tempo reale:
sudo -u sbox script -qc "screen -r sbox" /dev/nullPer uscirne senza arrestare il server: Ctrl+A poi D.
Connessione al server
- Recupera l'ID della lobby con il comando
statusnella console del server. - Avvia S&box e apri la console del gioco.
- Digita il comando seguente, sostituendo il numero con il tuo ID, senza il prefisso
steamid::
connect 1234567890Amministrazione
Questi comandi si digitano nella console del server:
| Comando | Descrizione |
|---|---|
status |
Mostra lo stato del server e l'ID della lobby |
game <gioco> [mappa] |
Carica un gioco, con una mappa facoltativa |
hostname <nome> |
Cambia il nome del server |
kick <id> |
Espelle un giocatore, per nome o ID Steam |
find <testo> |
Cerca un comando o una variabile |
quit |
Arresta il server |
Aggiornamento del server
Client e server devono restare compatibili: aggiorna il server non appena esce una nuova versione di 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.serviceBackup automatico
La cartella del server si può reinstallare in qualsiasi momento con SteamCMD. Basta conservare lo script di avvio e le cartelle config e data, se esistono.
Script di backup
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"
# Cartelle da conservare, se esistono
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[@]}"
# Eliminare i backup più vecchi di 7 giorni
find "$BACKUP_DIR" -name "sbox_*.tar.gz" -mtime +7 -delete
echo "Backup completato: sbox_$DATE.tar.gz"sudo chown sbox:sbox /home/sbox/backup.sh
sudo chmod 700 /home/sbox/backup.shPianificare il backup
sudo crontab -u sbox -eAggiungi:
# Backup ogni giorno alle 5
0 5 * * * /home/sbox/backup.shCopia regolarmente questi archivi fuori dal server: un backup conservato sulla stessa macchina non protegge da un guasto della macchina stessa.
In caso di problemi
Errore GLIBC_2.38 not found o GLIBCXX_3.4.31 not found
Il tuo sistema è troppo vecchio. Il messaggio può presentarsi anche in questa forma:
Failed to load native library 'libengine2.so'. Error Code: 0/126Reinstalla la macchina con Debian 13 o Ubuntu 24.04. Sostituire solo queste librerie su Debian 12 o Ubuntu 22.04 rischia di danneggiare il sistema.
Errore libfontconfig.so.1 o Couldn't find a valid ICU package
Manca una dipendenza: riprendi il comando di installazione corrispondente al tuo sistema, nella sezione "Installazione delle dipendenze".
Errore su steamclient.so
Verifica che il collegamento esista e punti a un file reale:
sudo -u sbox ls -lL /home/sbox/.steam/sdk64/steamclient.soSe è assente, ricrealo come indicato in "Collegamento del client Steam".
Unable to log on to Steam in a reasonable time!
Il server non è riuscito a connettersi a Steam in tempo, e il caricamento del gioco fallisce poi con Unable to download package. Verifica l'accesso a Internet in uscita della macchina, poi riavvia il servizio: il server non ritenta da solo questo caricamento.
sudo systemctl restart sbox.serviceCrash all'avvio nonostante un sistema compatibile
Ad esempio, un errore X509_INFO_free su libengine2.so. Aggiorna prima il server, poi consulta le segnalazioni del progetto. Se il problema deriva dalla versione pubblica, puoi provare il branch staging in una cartella separata, tenendo presente che non tutti i giocatori potrebbero riuscire a unirsi:
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 +quitSostituisci poi /home/sbox/sbox-server con /home/sbox/sbox-staging in start.sh, quindi rilancia il servizio.
Messaggio Not Connected lato giocatore
Non è stata creata nessuna lobby. Verifica con status che il gioco sia effettivamente caricato. Se sviluppi un tuo gioco, è il suo codice a dover creare la lobby.
Errore state is 0x202 in SteamCMD
Lo spazio disco è insufficiente. Verificalo con df -h, libera dello spazio, poi rilancia il comando.
Il file console.log diventa troppo grande
Svuotalo senza arrestare il server:
sudo truncate -s 0 /home/sbox/logs/console.log