IT

Server di gioco

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.

10 min di lettura, aggiornato il 18 novembre 2026

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:

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

Terminale
sudo apt update && sudo apt upgrade -y

Installazione delle dipendenze

Java è fornito con il server, non serve installarlo. lib32gcc-s1 è necessario a SteamCMD:

Terminale
sudo apt install -y curl tar ca-certificates lib32gcc-s1 libstdc++6

Creazione di un utente dedicato

Il server non deve mai girare come root. Crea un utente dedicato:

Terminale
sudo adduser --disabled-password --gecos "" zomboid

Porte 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

Terminale
sudo ufw allow 16261/udp
sudo ufw allow 16262/udp
sudo ufw reload

Con iptables

Terminale
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.v4

Il 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.

Terminale
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.conf

Installazione di SteamCMD

Connettiti come utente zomboid e prepara le cartelle:

Terminale
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:

Terminale
nano ~/update-server.sh
Terminale
#!/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.json
Terminale
chmod +x ~/update-server.sh
~/update-server.sh

Se 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:

Terminale
~/pz-server/start-server.sh -servername servertest

Scegli la password di amministratore quando compaiono questi messaggi:

Testo
Enter new administrator password:
Confirm the password:

Attendi il messaggio *** SERVER STARTED ****, poi digita questo comando nella console per salvare e arrestare il server:

Testo
quit

Esci poi dalla sessione dell'utente zomboid:

Terminale
exit

Configurazione 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:

Terminale
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:

Configurazione
PublicName=Il mio server Project Zomboid
Password=CambiaQuestaPassword
MaxPlayers=16
UPnP=false

Configurazione 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

Terminale
sudo nano /etc/systemd/system/zomboid.socket
Configurazione
[Unit]
BindsTo=zomboid.service

[Socket]
ListenFIFO=/run/zomboid.control
FileDescriptorName=control
RemoveOnStop=true
SocketMode=0660
SocketUser=zomboid
SocketGroup=zomboid

Creare il file di servizio

Terminale
sudo nano /etc/systemd/system/zomboid.service
Configurazione
[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.target

Attivare e avviare il servizio

Terminale
sudo systemctl daemon-reload
sudo systemctl enable zomboid.service
sudo systemctl start zomboid.service

Comandi di gestione

Terminale
# 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 -f

Verificare il server

Attendi il messaggio di avvio, che può richiedere diversi minuti:

Terminale
sudo journalctl -u zomboid.service | grep 'SERVER STARTED'

Verifica poi che le porte siano in ascolto:

Terminale
sudo ss -ulpn | grep -E ':(16261|16262)\b'

Connessione al server

  1. Avvia Project Zomboid, nella stessa versione del server.
  2. Apri Join nel menu principale.
  3. Inserisci l'indirizzo IP_DEL_SERVER e la porta 16261.
  4. 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:

Terminale
echo 'players' | sudo tee /run/zomboid.control
sudo journalctl -u zomboid.service -n 20

In 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:

Terminale
sudo ufw allow from TUO_IP to any port 27015 proto tcp
sudo ufw reload

iptables:

Terminale
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.v4

nftables:

Terminale
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.conf

Installare 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:

Terminale
sudo systemctl stop zomboid.service
sudo -u zomboid nano /home/zomboid/Zomboid/Server/servertest.ini

Separa i valori con punti e virgola:

Configurazione
WorkshopItems=1111111111;2222222222
Mods=PrimoMod;SecondoMod

Un 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:

Configurazione
Map=MiaMappaMod;Muldraugh, KY

Riavvia poi il server e segui il download nei log:

Terminale
sudo systemctl start zomboid.service
sudo journalctl -u zomboid.service -f

Aggiornamento del server

Terminale
sudo systemctl stop zomboid.service
sudo -iu zomboid /home/zomboid/update-server.sh
sudo systemctl start zomboid.service

Il 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:

Terminale
sudo nano /usr/local/sbin/backup-zomboid.sh
Terminale
#!/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 -delete
Terminale
sudo chmod 750 /usr/local/sbin/backup-zomboid.sh
sudo /usr/local/sbin/backup-zomboid.sh
sudo ls -lh /home/zomboid/backups

Pianificare il backup

Terminale
sudo nano /etc/cron.d/zomboid-backup
Testo
# Backup ogni notte alle 5:30
30 5 * * * root /usr/local/sbin/backup-zomboid.sh

Copia regolarmente questi archivi fuori dal server. Contengono gli account e le password di configurazione: mantienili privati.

Ripristinare un backup

Terminale
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.service

Sostituisci 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:

Terminale
sudo systemctl stop zomboid.service
sudo -iu zomboid /home/zomboid/pz-server/start-server.sh -servername servertest

Only 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:

Terminale
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:

Terminale
sudo -iu zomboid
mkdir -p ~/.steam/sdk64
ln -sf ~/pz-server/linux64/steamclient.so ~/.steam/sdk64/steamclient.so
exit

I 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.