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.
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.
- VPS Performance - Risorse dedicate e processori veloci, ideale per FiveM
- 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 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
sudo apt update && sudo apt upgrade -yInstallazione delle dipendenze
La documentazione di txAdmin avvia il server in screen, e xz-utils permette di estrarre l'archivio:
sudo apt install -y curl tar xz-utils screen ca-certificatesCreazione di un utente dedicato
Il server non deve mai girare come root. Crea un utente dedicato:
sudo adduser --disabled-password --gecos "" fivemPorte 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.
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw allow from TUO_IP to any port 40120 proto tcp
sudo ufw reloadCon iptables
L'ultima regola blocca txAdmin per tutti gli altri indirizzi, lasciando funzionare il tunnel SSH locale:
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.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 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.confCreazione della chiave di licenza Cfx.re
Ogni server ha bisogno di una chiave di licenza gratuita, che inizia con cfxk_.
- Accedi al portale Cfx.re con il tuo account.
- Apri la pagina delle chiavi di registrazione del server.
- Clicca sul pulsante +, inserisci le informazioni richieste (nome, slogan, descrizione e lingua del server), poi clicca su Generate Key.
- 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:
sudo -iu fivem
mkdir -p ~/txDataCrea uno script che scarica la versione consigliata di FXServer. Servirà anche per gli aggiornamenti:
nano ~/update-fxserver.sh#!/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:
chmod +x ~/update-fxserver.sh
~/update-fxserver.sh
ls ~/server
exitLa 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
sudo nano /etc/systemd/system/fivem.serviceContenuto del file:
[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.targetNon 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
sudo systemctl daemon-reload
sudo systemctl enable fivem.service
sudo systemctl start fivem.serviceComandi di gestione
# 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.logConfigurazione 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:
ssh -L 40120:127.0.0.1:40120 TUO_USER@IP_DEL_SERVERTieni 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:
sudo grep -a -A2 'PIN below' /home/fivem/fxserver.logProcedura guidata di configurazione
- Inserisci il codice PIN, poi clicca su Link Account e accedi con il tuo account Cfx.re.
- Scegli la password di amministratore di txAdmin.
- Dai un nome al tuo server.
- 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).
- Mantieni la cartella di destinazione proposta, poi passa al Recipe Deployer.
- Incolla la tua chiave
cfxk_, inserisci i dati del database se il modello ne richiede uno, poi clicca su Run Recipe. - 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:
sudo apt install -y mariadb-server
sudo systemctl enable --now mariadbGenera una password senza caratteri speciali, perché verrà inserita in un indirizzo di connessione:
openssl rand -hex 16Crea il database e il relativo utente, sostituendo PASSWORD_GENERATA con questa password:
sudo mariadbCREATE 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:
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:
sudo ss -tulpn | grep -E ':(30120|40120)\b'Dal tuo computer, questo indirizzo deve restituire le informazioni del server in formato JSON:
http://IP_DEL_SERVER:30120/info.jsonVerifica anche, da una connessione diversa da TUO_IP, che http://IP_DEL_SERVER:40120 non risponda.
Connessione al server
- Avvia FiveM.
- Apri la console con il tasto
F8. - 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:
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:
sudo systemctl stop fivem.service
sudo -iu fivem /home/fivem/update-fxserver.sh
sudo systemctl start fivem.serviceFai 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
sudo nano /usr/local/sbin/backup-fivem.shLascia DB_NAME vuoto se non usi MariaDB:
#!/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 -deletesudo chmod 750 /usr/local/sbin/backup-fivem.sh
sudo /usr/local/sbin/backup-fivem.sh
sudo ls -lh /home/fivem/backupsPianificare il backup
sudo nano /etc/cron.d/fivem-backup# Backup ogni notte alle 5:30
30 5 * * * root /usr/local/sbin/backup-fivem.shCopia regolarmente questi archivi fuori dal server.
Ripristinare un backup
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.serviceSostituisci 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:
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.jsonrisponda - Verifica che la porta 30120 sia aperta in TCP e in UDP
- Verifica che la riga
sv_master1 ""diserver.cfgsia 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 consudo systemctl status mariadb, e usa127.0.0.1come hostAccess 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