Come creare un server Project Zomboid
Guida completa per creare un server dedicato Project Zomboid su un VPS o server dedicato Linux: installazione con SteamCMD, memoria, account admin, mod del Workshop, servizio systemd e backup.
In questa pagina
I tuoi valori
Inseriscili una volta: i comandi della guida si aggiornano.
Questa guida spiega come installare un server dedicato Project Zomboid sul tuo VPS o server dedicato Linux, regolarne la memoria, amministrare i giocatori e aggiungere mod dallo Steam Workshop. The Indie Stone, lo studio del gioco, fornisce una versione Linux nativa del server, con il proprio ambiente Java.
Ordina un Server
Per ospitare il tuo server Project Zomboid, HostMyServers offre diverse soluzioni adatte:
- VPS Performance - Risorse dedicate e processori veloci, ideale per Project Zomboid
- VPS NVMe - Per un piccolo server tra amici
- Server Dedicati Eco - Per server con molti giocatori o mod
- Server Dedicati Performance - Prestazioni massime
Prerequisiti
- Accesso SSH come root o utente con privilegi sudo
- Sistema Linux a 64 bit x86_64 (Debian 12/13 o Ubuntu 22.04/24.04)
- Firewall attivo: nftables, iptables o ufw (usa un solo strumento alla volta)
- Circa 20 GB di spazio disco libero (SSD NVMe consigliato)
- Porte 16261 e 16262 UDP accessibili
- Il gioco Project Zomboid su Steam, nella stessa versione del server
Configurazione richiesta
The Indie Stone non pubblica una configurazione minima per il server. I valori qui sotto sono indicativi per una partita senza mod: i mod, le dimensioni della mappa esplorata e il numero di zombie aumentano il consumo.
| Giocatori | CPU | Valore -Xmx |
RAM del server |
|---|---|---|---|
| Da 1 a 4 | 2 core veloci | 4g |
8 GB |
| Da 5 a 10 | 4 core veloci | 6g |
12 GB |
| Da 11 a 20 | 4 core veloci | 8g |
16 GB |
| Da 21 a 32 | 6 core o più | 12g |
24 GB |
Il server occupa circa 7 GB su disco, senza contare i mod e i backup.
Aggiornamento del sistema
sudo apt update && sudo apt upgrade -yInstallazione delle dipendenze
Java è fornito con il server, non serve installarlo. lib32gcc-s1 è necessario a SteamCMD:
sudo apt install -y curl tar ca-certificates lib32gcc-s1 libstdc++6Creazione di un utente dedicato
Il server non deve mai girare come root. Crea un utente dedicato:
sudo adduser --disabled-password --gecos "" zomboidPorte utilizzate
| Porta | Protocollo | Parametro | Utilizzo | Accesso |
|---|---|---|---|---|
| 16261 | UDP | DefaultPort |
Gioco | Pubblico |
| 16262 | UDP | UDPPort |
Gioco | Pubblico |
| 27015 | TCP | RCONPort |
RCON, disattivato per impostazione predefinita | Solo il tuo indirizzo IP, se lo attivi |
L'RCON si avvia solo se RCONPassword è impostato. Se non ti serve, lascialo vuoto e non aprire la porta 27015.
Configurazione del firewall
Con UFW
sudo ufw allow 16261/udp
sudo ufw allow 16262/udp
sudo ufw reloadCon iptables
sudo iptables -A INPUT -p udp --dport 16261 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 16262 -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 16261 accept
sudo nft add rule inet filter input udp dport 16262 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.confInstallazione di SteamCMD
Connettiti come utente zomboid e prepara le cartelle:
sudo -iu zomboid
mkdir -p ~/steamcmd ~/pz-server
cd ~/steamcmd
curl -sqL "https://steamcdn-a.akamaihd.net/client/installer/steamcmd_linux.tar.gz" | tar -xzf -Download del server
Un aggiornamento può sostituire il file che contiene l'impostazione della memoria. Questo script installa il server (ID applicazione 380870) e riapplica ogni volta il tuo valore:
nano ~/update-server.sh#!/bin/bash
set -euo pipefail
# Memoria massima di Java: adatta questo valore
XMX="6g"
"$HOME/steamcmd/steamcmd.sh" +force_install_dir /home/zomboid/pz-server +login anonymous +app_update 380870 validate +quit
sed -i "s/-Xmx[0-9]*[gGmM]/-Xmx$XMX/" /home/zomboid/pz-server/ProjectZomboid64.json
grep -- '-Xmx' /home/zomboid/pz-server/ProjectZomboid64.jsonchmod +x ~/update-server.sh
~/update-server.shSe SteamCMD si interrompe con un errore, rilancia lo script.
Impostazione della memoria
La memoria massima di Java si imposta con -Xmx in ProjectZomboid64.json. Il file fornito usa -Xmx8g, e lo script qui sopra lo sostituisce con il valore di XMX.
Lascia almeno 2 GB di RAM al sistema e al resto di Java: su una macchina da 8 GB, non superare -Xmx6g, e prevedi meno se vi girano altri servizi.
Per cambiare il valore, arresta il server, modifica XMX in /home/zomboid/update-server.sh, rilancia questo script con l'utente zomboid, poi riavvia il server.
Primo avvio
Il primo avvio crea l'account admin e i file di configurazione. Deve avvenire nella tua sessione, perché il server chiede una password. Sempre con l'utente zomboid:
~/pz-server/start-server.sh -servername servertestScegli la password di amministratore quando compaiono questi messaggi:
Enter new administrator password:
Confirm the password:Attendi il messaggio *** SERVER STARTED ****, poi digita questo comando nella console per salvare e arrestare il server:
quitEsci poi dalla sessione dell'utente zomboid:
exitConfigurazione del server
Le impostazioni si trovano in /home/zomboid/Zomboid/Server/. Il nome dei file dipende da -servername, qui servertest:
| File | Contenuto |
|---|---|
servertest.ini |
Impostazioni del server |
servertest_SandboxVars.lua |
Regole della partita (zombie, loot, durata dei giorni) |
servertest_spawnregions.lua |
Zone di spawn |
A server arrestato, modifica le impostazioni:
sudo -u zomboid nano /home/zomboid/Zomboid/Server/servertest.ini| Parametro | Descrizione | Valore predefinito |
|---|---|---|
PublicName |
Nome del server | My PZ Server |
PublicDescription |
Descrizione del server | vuoto |
Public |
Mostra il server nella lista del gioco | false |
Password |
Password richiesta per entrare | vuoto |
Open |
Permette di entrare senza un account già creato | true |
MaxPlayers |
Numero massimo di giocatori | 32 |
PauseEmpty |
Ferma il tempo quando non c'è nessuno connesso | true |
DefaultPort |
Prima porta del gioco | 16261 |
UDPPort |
Seconda porta del gioco | 16262 |
UPnP |
Tenta di aprire le porte su un router domestico, inutile su un server | true |
RCONPort |
Porta dell'RCON | 27015 |
RCONPassword |
Password dell'RCON, vuota per disattivarlo | vuoto |
Ecco un esempio di valori da modificare:
PublicName=Il mio server Project Zomboid
Password=CambiaQuestaPassword
MaxPlayers=16
UPnP=falseConfigurazione come servizio systemd
Il server si arresta correttamente con il comando quit, inviato sul suo standard input. Un canale di comando, /run/zomboid.control, permette a systemd e a te di comunicare con lui.
Creare il canale di comando
sudo nano /etc/systemd/system/zomboid.socket[Unit]
BindsTo=zomboid.service
[Socket]
ListenFIFO=/run/zomboid.control
FileDescriptorName=control
RemoveOnStop=true
SocketMode=0660
SocketUser=zomboid
SocketGroup=zomboidCreare il file di servizio
sudo nano /etc/systemd/system/zomboid.service[Unit]
Description=Project Zomboid Dedicated Server
After=network-online.target zomboid.socket
Wants=network-online.target
Requires=zomboid.socket
[Service]
Type=simple
User=zomboid
Group=zomboid
WorkingDirectory=/home/zomboid/pz-server
ExecStart=/home/zomboid/pz-server/start-server.sh -servername servertest
Sockets=zomboid.socket
StandardInput=socket
StandardOutput=journal
StandardError=journal
ExecStop=/bin/sh -c 'echo quit > /run/zomboid.control; while kill -0 "$$MAINPID" 2>/dev/null; do sleep 1; done'
TimeoutStopSec=180
Restart=on-failure
RestartSec=20
LimitNOFILE=100000
[Install]
WantedBy=multi-user.targetAttivare e avviare il servizio
sudo systemctl daemon-reload
sudo systemctl enable zomboid.service
sudo systemctl start zomboid.serviceComandi di gestione
# Verificare lo stato
sudo systemctl status zomboid.service
# Fermare il server (salva il mondo)
sudo systemctl stop zomboid.service
# Riavviare il server
sudo systemctl restart zomboid.service
# Vedere i log
sudo journalctl -u zomboid.service -fVerificare il server
Attendi il messaggio di avvio, che può richiedere diversi minuti:
sudo journalctl -u zomboid.service | grep 'SERVER STARTED'Verifica poi che le porte siano in ascolto:
sudo ss -ulpn | grep -E ':(16261|16262)\b'Connessione al server
- Avvia Project Zomboid, nella stessa versione del server.
- Apri Join nel menu principale.
- Inserisci l'indirizzo
IP_DEL_SERVERe la porta16261. - Indica la password del server, se presente, oltre al tuo nome utente e alla password del tuo account.
Per connetterti come amministratore, usa il nome utente admin e la password scelta al primo avvio.
Amministrazione
Inviare un comando al server
Dal server, scrivi il comando nel canale, senza / iniziale. Il risultato compare nei log:
echo 'players' | sudo tee /run/zomboid.control
sudo journalctl -u zomboid.service -n 20In gioco, digita gli stessi comandi nella chat, preceduti da /.
Comandi utili
| Comando | Descrizione |
|---|---|
players |
Elencare i giocatori connessi |
save |
Salvare il mondo |
quit |
Salvare e arrestare il server |
servermsg "messaggio" |
Inviare un messaggio a tutti i giocatori |
setaccesslevel "nomeutente" "admin" |
Cambiare il ruolo di un giocatore |
adduser "nomeutente" "password" |
Creare un account |
setpassword "nomeutente" "password" |
Cambiare la password di un account |
kickuser "nomeutente" -r "motivo" |
Espellere un giocatore |
banuser "nomeutente" -ip -r "motivo" |
Bannare un giocatore e il suo indirizzo IP |
unbanuser "nomeutente" |
Sbannare un giocatore |
reloadoptions |
Ricaricare servertest.ini |
showoptions |
Mostrare le impostazioni attive |
checkModsNeedUpdate |
Scrivere nei log se un mod è stato aggiornato |
help |
Elencare i comandi |
I ruoli disponibili sono admin, moderator, overseer, gm e observer.
RCON (facoltativo)
Per usare uno strumento RCON, imposta RCONPassword con una password lunga, poi apri la porta 27015 al solo tuo indirizzo IP: sostituisci TUO_IP.
UFW:
sudo ufw allow from TUO_IP to any port 27015 proto tcp
sudo ufw reloadiptables:
sudo iptables -A INPUT -p tcp -s TUO_IP --dport 27015 -j ACCEPT
sudo iptables -A INPUT ! -i lo -p tcp --dport 27015 -j DROP
sudo iptables-save | sudo tee /etc/iptables/rules.v4nftables:
sudo nft add rule inet filter input ip saddr TUO_IP tcp dport 27015 accept
sudo nft add rule inet filter input iifname != "lo" tcp dport 27015 drop
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.confInstallare mod dal Workshop
Il server scarica autonomamente i mod all'avvio, e il gioco propone ai giocatori di installarli al momento della connessione. Servono due informazioni per ogni mod, disponibili sulla sua pagina del Workshop:
| Informazione | Dove trovarla | Parametro |
|---|---|---|
| Identificativo Workshop | Numero alla fine dell'indirizzo della pagina (?id=...) |
WorkshopItems |
| Identificativo del mod | Riga Mod ID della descrizione, oppure id= in mod.info |
Mods |
Arresta il server, poi modifica servertest.ini:
sudo systemctl stop zomboid.service
sudo -u zomboid nano /home/zomboid/Zomboid/Server/servertest.iniSepara i valori con punti e virgola:
WorkshopItems=1111111111;2222222222
Mods=PrimoMod;SecondoModUn elemento del Workshop può contenere più mod: aggiungi in Mods solo quelli che vuoi attivare. Alcune esportazioni di liste di mod scrivono \PrimoMod: il server accetta anche questa forma.
Per un mod di mappa, aggiungi il nome della sua cartella di mappa (in media/maps) prima della mappa base:
Map=MiaMappaMod;Muldraugh, KYRiavvia poi il server e segui il download nei log:
sudo systemctl start zomboid.service
sudo journalctl -u zomboid.service -fAggiornamento del server
sudo systemctl stop zomboid.service
sudo -iu zomboid /home/zomboid/update-server.sh
sudo systemctl start zomboid.serviceIl server e i giocatori devono avere la stessa versione. Fai un backup prima di ogni aggiornamento importante.
Backup automatico
Backup integrati
Il server crea degli archivi in /home/zomboid/Zomboid/backups/, configurati in servertest.ini:
| Parametro | Descrizione | Valore predefinito |
|---|---|---|
BackupsCount |
Numero di archivi conservati | 5 |
BackupsOnStart |
Backup all'avvio | true |
BackupsOnVersionChange |
Backup quando cambia la versione del gioco | true |
BackupsPeriod |
Intervallo dei backup periodici, 0 per disattivarli |
0 |
Script di backup
Questo script arresta correttamente il server, archivia il mondo, gli account e la configurazione, poi lo riavvia:
sudo nano /usr/local/sbin/backup-zomboid.sh#!/bin/bash
set -euo pipefail
umask 027
BACKUP_DIR="/home/zomboid/backups"
DATE=$(date +%Y-%m-%d_%H-%M-%S)
ARCHIVE="$BACKUP_DIR/zomboid_$DATE.tar.gz"
install -d -o zomboid -g zomboid -m 750 "$BACKUP_DIR"
systemctl stop zomboid.service
trap 'systemctl start zomboid.service' EXIT
tar -czf "$ARCHIVE" -C /home/zomboid Zomboid/Server Zomboid/db Zomboid/Saves/Multiplayer
chown zomboid:zomboid "$ARCHIVE"
# Eliminare i backup più vecchi di 7 giorni
find "$BACKUP_DIR" -name "zomboid_*.tar.gz" -mtime +7 -deletesudo chmod 750 /usr/local/sbin/backup-zomboid.sh
sudo /usr/local/sbin/backup-zomboid.sh
sudo ls -lh /home/zomboid/backupsPianificare il backup
sudo nano /etc/cron.d/zomboid-backup# Backup ogni notte alle 5:30
30 5 * * * root /usr/local/sbin/backup-zomboid.shCopia regolarmente questi archivi fuori dal server. Contengono gli account e le password di configurazione: mantienili privati.
Ripristinare un backup
sudo systemctl stop zomboid.service
sudo -u zomboid mv /home/zomboid/Zomboid /home/zomboid/Zomboid.old
sudo -u zomboid mkdir /home/zomboid/Zomboid
sudo -u zomboid tar -xzf /home/zomboid/backups/zomboid_DATE.tar.gz -C /home/zomboid
sudo systemctl start zomboid.serviceSostituisci DATE con la data dell'archivio.
In caso di problemi
Il servizio resta bloccato all'avvio
Se i log si fermano su Enter new administrator password:, l'account admin non è ancora stato creato. Arresta il servizio ed esegui il primo avvio manualmente:
sudo systemctl stop zomboid.service
sudo -iu zomboid /home/zomboid/pz-server/start-server.sh -servername servertestOnly 64bit is supported
Questo messaggio compare quando il Java fornito non riesce ad avviarsi: installazione incompleta o macchina non x86_64. Verifica l'architettura con uname -m, poi rilancia /home/zomboid/update-server.sh con l'utente zomboid.
Il server si arresta per mancanza di memoria
I log mostrano java.lang.OutOfMemoryError, oppure il sistema ha terminato il processo:
sudo journalctl -k | grep -iE 'out of memory|killed process'Se Java non ha abbastanza memoria, aumenta XMX in /home/zomboid/update-server.sh. Se il sistema ha terminato il processo, riduci questo valore o passa a un'offerta con più RAM. In entrambi i casi, rilancia poi questo script, a server arrestato.
Errore steamclient.so
Se i log segnalano che steamclient.so non viene trovato, crea il collegamento previsto:
sudo -iu zomboid
mkdir -p ~/.steam/sdk64
ln -sf ~/pz-server/linux64/steamclient.so ~/.steam/sdk64/steamclient.so
exitI giocatori non riescono a connettersi
- Attendi
*** SERVER STARTED ****nei log - Verifica che le porte 16261 e 16262 siano aperte in UDP
- Verifica che il server sia in ascolto:
sudo ss -ulpn | grep -E ':(16261|16262)\b'
Messaggi mostrati ai giocatori
| Messaggio | Causa e soluzione |
|---|---|
Client version (...) does not match server version (...) |
Porta il server e il gioco alla stessa versione, sullo stesso ramo Steam |
Wrong server password given |
Il campo della password del server è errato |
Wrong username or password given |
L'account esiste con un'altra password: cambiala con setpassword |
Workshop item version is different than the server's |
Un mod è stato aggiornato: riavvia il server, poi riavvia il gioco |
Mod "..." is not installed |
Il giocatore non ha il mod, oppure Mods contiene un identificativo errato |
The server is full |
Aumenta MaxPlayers se la tua macchina lo consente |
L'arresto del servizio è lungo
È normale: il server salva il mondo prima di arrestarsi. Il servizio gli concede 3 minuti (TimeoutStopSec=180). Su un mondo molto grande, aumenta questo valore.