IT

Server di gioco

Come creare un server FiveM con txAdmin

Guida completa per installare un server FiveM su un VPS o server dedicato Linux con txAdmin: chiave di licenza Cfx.re, servizio systemd, firewall, database MariaDB, aggiornamenti 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 FiveM (FXServer) sul tuo VPS o server dedicato Linux, configurarlo con txAdmin, la sua interfaccia di amministrazione web, e farlo girare come servizio con un utente dedicato.

Ordina un Server

Per ospitare il tuo server FiveM, HostMyServers offre diverse soluzioni. Un server con un framework di tipo roleplay e molte risorse richiede un processore veloce e memoria adeguata.

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), i processori ARM non sono supportati
  • Firewall attivo: nftables, iptables o ufw (usa un solo strumento alla volta)
  • Un account Cfx.re per creare la chiave di licenza del server
  • Una copia legittima di GTA V per ogni giocatore
  • Porte 30120 TCP e UDP accessibili, e porta 40120 TCP (txAdmin) limitata al tuo indirizzo IP

Configurazione richiesta

Cfx.re non pubblica una configurazione minima per il server. I valori qui sotto sono indicativi, da adattare in base alle tue risorse e al numero di giocatori.

Utilizzo CPU RAM Archiviazione
Server base o di test 2 core veloci 4 GB 20 GB SSD
Framework roleplay, fino a 48 giocatori 4 core veloci 8 GB 40 GB SSD NVMe
Server molto carico, molte risorse 6 core o più 16 GB e oltre 80 GB SSD NVMe

Aggiornamento del sistema

Terminale
sudo apt update && sudo apt upgrade -y

Installazione delle dipendenze

La documentazione di txAdmin avvia il server in screen, e xz-utils permette di estrarre l'archivio:

Terminale
sudo apt install -y curl tar xz-utils screen ca-certificates

Creazione di un utente dedicato

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

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

Porte utilizzate

Porta Protocollo Utilizzo Accesso
30120 TCP e UDP Gioco (connessione dei giocatori e informazioni del server) Pubblico
40120 TCP Interfaccia web di txAdmin Solo il tuo indirizzo IP
3306 TCP MariaDB, se lo installi Solo locale, non aprirla

Configurazione del firewall

Apri la porta del gioco e limita txAdmin al tuo indirizzo IP fisso: sostituisci TUO_IP. Se non hai un indirizzo fisso, non creare la regola che autorizza TUO_IP e passa dal tunnel SSH descritto più avanti.

Con UFW

Una volta attivato, UFW rifiuta per impostazione predefinita le connessioni in entrata. Verifica che sia attivo con sudo ufw status.

Terminale
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw allow from TUO_IP to any port 40120 proto tcp
sudo ufw reload

Con iptables

L'ultima regola blocca txAdmin per tutti gli altri indirizzi, lasciando funzionare il tunnel SSH locale:

Terminale
sudo iptables -A INPUT -p tcp --dport 30120 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 30120 -j ACCEPT
sudo iptables -A INPUT -p tcp -s TUO_IP --dport 40120 -j ACCEPT
sudo iptables -A INPUT ! -i lo -p tcp --dport 40120 -j DROP
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 tcp dport 30120 accept
sudo nft add rule inet filter input udp dport 30120 accept
sudo nft add rule inet filter input ip saddr TUO_IP tcp dport 40120 accept
sudo nft add rule inet filter input iifname != "lo" tcp dport 40120 drop
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf

Creazione della chiave di licenza Cfx.re

Ogni server ha bisogno di una chiave di licenza gratuita, che inizia con cfxk_.

  1. Accedi al portale Cfx.re con il tuo account.
  2. Apri la pagina delle chiavi di registrazione del server.
  3. Clicca sul pulsante +, inserisci le informazioni richieste (nome, slogan, descrizione e lingua del server), poi clicca su Generate Key.
  4. Copia la chiave con Copy Key e conservala per la fase di configurazione.

Installazione di FXServer

Connettiti come utente fivem e crea la cartella dei dati di txAdmin:

Terminale
sudo -iu fivem
mkdir -p ~/txData

Crea uno script che scarica la versione consigliata di FXServer. Servirà anche per gli aggiornamenti:

Terminale
nano ~/update-fxserver.sh
Terminale
#!/bin/bash
set -euo pipefail

API="https://changelogs-live.fivem.net/api/changelog/versions/linux/server"
URL=$(curl -fsSL "$API" | grep -o '"recommended_download":"[^"]*"' | cut -d'"' -f4)
[ -n "$URL" ] || { echo "Indirizzo di download non trovato" >&2; exit 1; }

TMP=$(mktemp -d "$HOME/fxserver.XXXXXX")
trap 'rm -rf "$TMP"' EXIT

curl -fL -o "$TMP/fx.tar.xz" "$URL"
tar -xJf "$TMP/fx.tar.xz" -C "$TMP"
rm -f "$TMP/fx.tar.xz"

rm -rf "$HOME/server"
mkdir -p "$HOME/server"
mv "$TMP"/* "$HOME/server/"

echo "Versione installata: $URL"

Avvialo, poi esci dalla sessione dell'utente fivem:

Terminale
chmod +x ~/update-fxserver.sh
~/update-fxserver.sh
ls ~/server
exit

La cartella ~/server deve contenere run.sh e alpine. Se preferisci scegliere tu la versione, gli archivi sono elencati nella pagina di download ufficiale.

Configurazione come servizio systemd

Creare il file di servizio

Terminale
sudo nano /etc/systemd/system/fivem.service

Contenuto del file:

Configurazione
[Unit]
Description=FiveM Server (FXServer + txAdmin)
After=network-online.target mariadb.service
Wants=network-online.target

[Service]
Type=simple
User=fivem
Group=fivem
WorkingDirectory=/home/fivem/txData
Environment=TERM=xterm
Environment=TXHOST_DATA_PATH=/home/fivem/txData
Environment=TXHOST_TXA_PORT=40120
Environment=TXHOST_GAME_NAME=fivem
ExecStartPre=/usr/bin/truncate -s 0 /home/fivem/fxserver.log
ExecStart=/usr/bin/screen -L -Logfile /home/fivem/fxserver.log -DmS fivem /home/fivem/server/run.sh
Restart=always
RestartSec=15
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target

Non passare l'argomento +exec a run.sh: impedirebbe l'avvio di txAdmin.

Variabile Ruolo
TXHOST_DATA_PATH Cartella dei dati di txAdmin, separata dai file di FXServer per sopravvivere agli aggiornamenti
TXHOST_TXA_PORT Porta dell'interfaccia web (40120 per impostazione predefinita)
TXHOST_GAME_NAME Limita txAdmin ai modelli FiveM

Attivare e avviare il servizio

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

Comandi di gestione

Terminale
# Verificare lo stato
sudo systemctl status fivem.service

# Fermare il server
sudo systemctl stop fivem.service

# Riavviare il server
sudo systemctl restart fivem.service

# Seguire la console
sudo tail -f /home/fivem/fxserver.log

Configurazione con txAdmin

Accedere all'interfaccia

Il metodo più sicuro è un tunnel SSH, perché il traffico resta cifrato e non serve aprire alcuna porta di amministrazione. Dal tuo computer:

Terminale
ssh -L 40120:127.0.0.1:40120 TUO_USER@IP_DEL_SERVER

Tieni aperta questa sessione, poi apri http://127.0.0.1:40120 nel browser. Se hai autorizzato TUO_IP nel firewall, puoi usare anche http://IP_DEL_SERVER:40120.

Recuperare il codice PIN

Al primo avvio, txAdmin mostra un codice PIN a 4 cifre. Attendi una quindicina di secondi, poi visualizzalo sul server:

Terminale
sudo grep -a -A2 'PIN below' /home/fivem/fxserver.log

Procedura guidata di configurazione

  1. Inserisci il codice PIN, poi clicca su Link Account e accedi con il tuo account Cfx.re.
  2. Scegli la password di amministratore di txAdmin.
  3. Dai un nome al tuo server.
  4. Seleziona Popular Recipes, poi un modello. Per un server semplice, scegli il modello base di Cfx.re (FiveM Basic Server, a volte visualizzato come CFX Default FiveM).
  5. Mantieni la cartella di destinazione proposta, poi passa al Recipe Deployer.
  6. Incolla la tua chiave cfxk_, inserisci i dati del database se il modello ne richiede uno, poi clicca su Run Recipe.
  7. Al termine del deployment, clicca su Save & Run Server.

I file del server vengono creati in una sottocartella di /home/fivem/txData, il cui nome termina con .base. Il percorso esatto è indicato da txAdmin.

Database MariaDB (se necessario)

Il modello base non ha bisogno di un database. I framework come ESX Legacy o Qbox ne richiedono uno, e oxmysql, la risorsa che usano per connettersi, consiglia MariaDB. Installalo prima di lanciare il deployment:

Terminale
sudo apt install -y mariadb-server
sudo systemctl enable --now mariadb

Genera una password senza caratteri speciali, perché verrà inserita in un indirizzo di connessione:

Terminale
openssl rand -hex 16

Crea il database e il relativo utente, sostituendo PASSWORD_GENERATA con questa password:

Terminale
sudo mariadb
SQL
CREATE DATABASE fivem CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'fivem'@'localhost' IDENTIFIED BY 'PASSWORD_GENERATA';
GRANT ALL PRIVILEGES ON fivem.* TO 'fivem'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Nel deployment di txAdmin, indica poi:

Campo Valore
Host 127.0.0.1
Porta 3306
Utente fivem
Password La password generata
Database fivem

txAdmin scrive la connessione in server.cfg, in questa forma:

Testo
set mysql_connection_string "mysql://fivem:PASSWORD_GENERATA@127.0.0.1/fivem?charset=utf8mb4"

Verificare il server

Verifica che le porte siano in ascolto:

Terminale
sudo ss -tulpn | grep -E ':(30120|40120)\b'

Dal tuo computer, questo indirizzo deve restituire le informazioni del server in formato JSON:

Testo
http://IP_DEL_SERVER:30120/info.json

Verifica anche, da una connessione diversa da TUO_IP, che http://IP_DEL_SERVER:40120 non risponda.

Connessione al server

  1. Avvia FiveM.
  2. Apri la console con il tasto F8.
  3. Digita: connect IP_DEL_SERVER:30120

Un nuovo server può impiegare fino a 8 minuti per comparire nella lista pubblica.

Amministrazione

La maggior parte delle operazioni si gestisce da txAdmin:

Menu Utilizzo
Live Console Console del server in tempo reale
CFG Editor Modifica di server.cfg
Resources Elenco e gestione delle risorse
Players Giocatori, avvertimenti e ban
Admins Account amministratore e permessi
Settings Impostazioni, tra cui la pianificazione dei riavvii (Restart Schedule)
Master Actions Azioni riservate all'account principale

In gioco, apri la console con F8 e digita tx per mostrare il menu di txAdmin.

Alcune impostazioni utili di server.cfg, da modificare in CFG Editor:

Testo
sv_maxclients 48
sv_endpointPrivacy true
Parametro Descrizione
sv_maxclients Numero massimo di giocatori, in base al tuo abbonamento
sv_endpointPrivacy Nasconde gli indirizzi IP dei giocatori nelle informazioni pubbliche

Cfx.re indica che il nome e la descrizione del server si gestiscono ormai dal portale. Lascia rcon_password non definito: in questo modo l'RCON resta disattivato, e Live Console lo sostituisce.

Aggiornamento del server

Lo script installa l'ultima versione consigliata, senza toccare txData:

Terminale
sudo systemctl stop fivem.service
sudo -iu fivem /home/fivem/update-fxserver.sh
sudo systemctl start fivem.service

Fai un backup prima di ogni aggiornamento.

Backup automatico

txData contiene le tue risorse, server.cfg e gli account txAdmin. I backup contengono quindi dati segreti: mantienili privati.

Script di backup

Terminale
sudo nano /usr/local/sbin/backup-fivem.sh

Lascia DB_NAME vuoto se non usi MariaDB:

Terminale
#!/bin/bash
set -euo pipefail
umask 027

BACKUP_DIR="/home/fivem/backups"
DB_NAME="fivem"
DATE=$(date +%Y-%m-%d_%H-%M-%S)

install -d -o fivem -g fivem -m 750 "$BACKUP_DIR"

# File del server e di txAdmin, senza le cache
tar --exclude='*/cache' -czf "$BACKUP_DIR/fivem_$DATE.tar.gz" -C /home/fivem txData

# Database
if [ -n "$DB_NAME" ]; then
    mariadb-dump --single-transaction "$DB_NAME" | gzip > "$BACKUP_DIR/fivem_db_$DATE.sql.gz"
fi

chown fivem:fivem "$BACKUP_DIR"/fivem_*"$DATE"*

# Eliminare i backup più vecchi di 7 giorni
find "$BACKUP_DIR" -name "fivem_*.gz" -mtime +7 -delete
Terminale
sudo chmod 750 /usr/local/sbin/backup-fivem.sh
sudo /usr/local/sbin/backup-fivem.sh
sudo ls -lh /home/fivem/backups

Pianificare il backup

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

Copia regolarmente questi archivi fuori dal server.

Ripristinare un backup

Terminale
sudo systemctl stop fivem.service
sudo mv /home/fivem/txData /home/fivem/txData.old
sudo -u fivem tar -xzf /home/fivem/backups/fivem_DATE.tar.gz -C /home/fivem
zcat /home/fivem/backups/fivem_db_DATE.sql.gz | sudo mariadb fivem
sudo systemctl start fivem.service

Sostituisci DATE con la data dell'archivio, e ignora la riga zcat se non usi un database.

In caso di problemi

Il servizio non si avvia

  • Controlla il servizio: sudo journalctl -u fivem.service -n 50
  • Controlla la console: sudo tail -n 100 /home/fivem/fxserver.log
  • Verifica che l'architettura sia x86_64: uname -m
  • Verifica i permessi: sudo chown -R fivem:fivem /home/fivem

Failed to start HTTP server, port 40120 is already in use

Un'altra istanza di txAdmin sta già usando la porta. Individuala:

Terminale
sudo ss -ltnp | grep ':40120'

Se hai avviato run.sh manualmente, arresta questo processo prima di avviare il servizio.

Codice PIN non trovato

Il codice viene mostrato solo finché non esiste alcun amministratore. Riavvia il servizio, attendi qualche secondo, poi rilancia il comando grep. Se esiste già un account, accedi con quello.

Se hai perso la password dell'account principale, arresta il servizio, rinomina /home/fivem/txData/admins.json, poi riavvia: txAdmin propone di nuovo di creare un amministratore.

No license key was specified

La chiave è assente o errata. Verifica la riga sv_licenseKey in CFG Editor, oppure rigenera la chiave sul portale Cfx.re.

Il server non appare nella lista

  • Prova la connessione diretta con connect IP_DEL_SERVER:30120
  • Verifica che http://IP_DEL_SERVER:30120/info.json risponda
  • Verifica che la porta 30120 sia aperta in TCP e in UDP
  • Verifica che la riga sv_master1 "" di server.cfg sia commentata con #
  • Attendi fino a 8 minuti dopo l'avvio

Il server resta limitato a 48 giocatori

Servono un abbonamento Element Club Argentum o superiore, un server aggiornato, poi un valore sv_maxclients adeguato e un riavvio.

Errore di connessione al database

  • ECONNREFUSED: verifica che MariaDB sia in esecuzione con sudo systemctl status mariadb, e usa 127.0.0.1 come host
  • Access denied: verifica l'utente, la password e il nome del database
  • Se la password contiene caratteri speciali, sostituiscila con un valore generato con openssl rand -hex 16

Impossibile accedere a txAdmin

  • Verifica che il servizio sia in esecuzione e che la porta 40120 sia in ascolto
  • Verifica che il tuo indirizzo IP pubblico corrisponda ancora a TUO_IP
  • Usa il tunnel SSH, che non dipende dalla regola del firewall