IT

Server di gioco

Come diagnosticare crash e rallentamenti di un server FiveM

Trova la causa di un crash o di un rallentamento sul tuo server FiveM Linux: log, memoria, hitch warning, resmon, profiler e isolamento della risorsa responsabile.

9 min di lettura, aggiornato il 18 novembre 2026

In questa pagina

I tuoi valori

Inseriscili una volta: i comandi della guida si aggiornano.

Un server FiveM che si blocca o rallenta ha spesso una causa precisa: una risorsa, una mancanza di memoria o una macchina satura. Questa guida ti dà un metodo per trovare quale: qualificare il sintomo, leggere i log giusti, misurare, poi isolare la risorsa responsabile.

Prerequisiti

  • Un server installato con la guida Creare un server FiveM: utente fivem, servizio fivem.service, console in /home/fivem/fxserver.log
  • Un accesso SSH con sudo e un accesso a txAdmin
  • Un backup recente, da fare con sudo /usr/local/sbin/backup-fivem.sh prima di modificare qualsiasi cosa

Qualificare il sintomo

Cosa osservi Pista principale Sezione da consultare
Il server si riavvia da solo, tutti i giocatori vengono disconnessi Arresto del processo o blocco Passi da 1 a 3
Il server non si avvia più o si ferma durante il caricamento Risorsa o configurazione Passo 4
I giocatori vedono scatti, veicoli che si teletrasportano Server sovraccarico Passi 5 e 6
Un solo giocatore ha pochi fotogrammi al secondo Lato client Passo 7
Il problema è iniziato dopo un'aggiunta o un aggiornamento Modifica recente Passo 8

Passo 1: conservare i log

Il file /home/fivem/fxserver.log viene svuotato a ogni avvio del servizio. Copialo prima di riavviare qualsiasi cosa:

Terminale
sudo install -o fivem -g fivem -m 640 /home/fivem/fxserver.log "/home/fivem/fxserver-incident-$(date +%F_%H-%M).log"

txAdmin conserva anche i propri log, con rotazione, in /home/fivem/txData/default/logs/:

File Contenuto
fxserver.log Console del server. I vecchi file hanno la data nel nome
admin.log Azioni degli amministratori e riavvii automatici
server.log Eventi in gioco: connessioni, morti, messaggi, comandi

Questi file contengono dati dei giocatori. Non pubblicarli così come sono.

Passo 2: capire perché il server si è riavviato

Cerca le decisioni prese da txAdmin:

Terminale
sudo grep -a 'Restarting server' /home/fivem/txData/default/logs/admin.log | tail -n 20
Motivo mostrato Significato Cosa fare
Server process close detected Il processo FXServer si è arrestato Guarda la fine della console e la memoria (passo 3)
Server is not responding FXServer è in esecuzione ma non risponde più Cerca un blocco: passi 5 e 6
Server is taking too long to start L'avvio supera il tempo consentito Passa al passo 4
Resource "nome" failed to start within the ... time limit Questa risorsa blocca l'avvio Prova senza di lei (passo 8)

Leggi poi le ultime righe della console prima dell'incidente, nella copia fatta al passo 1:

Terminale
sudo bash -c 'ls -t /home/fivem/fxserver-incident-*.log | head -n 1 | xargs tail -n 80'

Guarda anche la cronologia del servizio:

Terminale
sudo systemctl status fivem.service --no-pager
sudo journalctl -u fivem.service --since "2 days ago" --no-pager | tail -n 40

Passo 3: verificare la memoria e il disco

Quando manca la memoria, il kernel Linux uccide un processo. Cerca la sua traccia:

Terminale
sudo journalctl -k --since "2 days ago" --no-pager | grep -iE 'out of memory|oom-kill|killed process'
free -h
df -h /home /var/lib/mysql
  • Compare una riga Out of memory: Killed process: il server ha poca memoria. Cerca una risorsa il cui consumo aumenta, poi riduci il carico o aumenta la memoria della macchina.
  • Un disco è pieno al 100 %: libera dello spazio. MariaDB e i log non possono più scrivere.

Per seguire la memoria di FXServer nel tempo, rileva questo comando in più momenti. txAdmin e il server di gioco compaiono come due processi, e il più grande è in genere il server di gioco:

Terminale
ps -u fivem -o pid,pcpu,pmem,rss,etime,args --sort=-rss | cut -c1-110

Una colonna RSS che sale senza mai scendere, mentre il numero di giocatori resta stabile, orienta verso una perdita di memoria in una risorsa.

Passo 4: analizzare un avvio che fallisce

Mostra gli ultimi eventi di caricamento:

Terminale
sudo grep -a -E "Started resource|Could not (find|start) dependency|Couldn't (find|start) resource|can't run|Failed to load script|SCRIPT ERROR" /home/fivem/fxserver.log | tail -n 30
Messaggio Causa Soluzione
Couldn't find resource nome. La cartella non esiste, o il nome è diverso dalla riga ensure Correggi server.cfg o la cartella, poi digita refresh
Couldn't start resource nome. L'avvio è fallito Leggi le righe subito sopra
Could not find dependency x for resource y. Manca la risorsa x Installala
Could not start dependency x for resource y. La risorsa x esiste ma non si avvia Risolvi prima x
Resource 'nome' can't run: Una condizione non è soddisfatta, ad esempio server needs to be 12913 or higher Segui Aggiornare gli artifact di FXServer
Failed to load script file. File assente o non valido Reinstalla la risorsa
SCRIPT ERROR: Errore nel codice di uno script Il messaggio indica il file e la riga: aggiorna o segnala al suo autore

Per un errore del database, consulta Installare e configurare oxmysql su FiveM.

Passo 5: individuare i rallentamenti del server

FXServer segnala i ritardi dei suoi cicli interni con gli hitch warning:

Terminale
sudo grep -a -c 'hitch warning' /home/fivem/fxserver.log
sudo grep -a 'hitch warning' /home/fivem/fxserver.log | tail -n 20
Messaggio Attivato a partire da Riguarda
server thread hitch warning 150 ms Ciclo principale, dove vengono eseguiti gli script server
network thread hitch warning 150 ms Rete
sync thread hitch warning 100 ms Sincronizzazione OneSync

Un avviso isolato all'avvio o al riavvio di una risorsa non è preoccupante. Avvisi regolari in gioco lo sono. Cfx.re li attribuisce più spesso a una risorsa poco performante, ad esempio un ciclo troppo costoso o una query SQL lenta.

Prima di accusare una risorsa, verifica che la macchina non sia satura:

Terminale
uptime
vmstat 1 10

In vmstat, guarda tre colonne:

Colonna Valore elevato
id Basso: il processore è quasi completamente occupato
wa Il processore attende il disco
st Parte del tempo del processore viene presa dall'hypervisor

Guarda poi il dettaglio dei thread di esecuzione, sostituendo PID con il numero del processo più grande rilevato al passo 3. Esci con q:

Terminale
top -H -p PID

Un solo thread vicino al 100 % indica che un ciclo del server è saturo, anche se la macchina ha altri core liberi. In questo caso, aggiungere core aiuta poco: conviene alleggerire gli script. Se wa o st restano elevati mentre il server è poco carico, contatta il supporto dalla tua area clienti, con le tue rilevazioni.

Verifica anche le query lente segnalate da oxmysql:

Terminale
sudo grep -a 'to execute a query' /home/fivem/fxserver.log | tail -n 20

Passo 6: registrare un profilo del server

Il profiler integrato mostra quale risorsa consuma tempo. Lancialo in Live Console mentre il problema si verifica, se possibile con dei giocatori connessi:

Testo
profiler record 500
profiler status

Attendi che profiler status indichi Recording: No, poi salva il risultato:

Testo
profiler saveJSON profilo-server.json

Il file viene creato nella cartella del server, il cui nome termina con .base. Sul server, copialo nella tua cartella personale, sostituendo NOME_CARTELLA:

Terminale
sudo find /home/fivem/txData -maxdepth 1 -type d -name '*.base'
sudo install -o "$USER" -m 600 /home/fivem/txData/NOME_CARTELLA.base/profilo-server.json "$HOME/profilo-server.json"
sudo rm /home/fivem/txData/NOME_CARTELLA.base/profilo-server.json

Recuperalo poi dal tuo computer:

Terminale
scp TUO_USER@IP_DEL_SERVER:profilo-server.json .

Apri Google Chrome, poi gli strumenti per sviluppatori con F12. Nella scheda Performance, carica il file con Load profile. Individua i picchi della curva di attività, ingrandiscili, poi leggi il nome delle risorse e delle funzioni più lunghe.

Passo 7: misurare lato giocatore con resmon

resmon mostra il costo di ogni risorsa sul client. Aiuta per i cali di fotogrammi al secondo, non per i ritardi del server.

Nel gioco, apri la console con F8 e digita:

Testo
resmon true

Ordina per CPU msec o Time % per individuare le risorse costose, e guarda Memory per la memoria. Digita resmon false per chiudere.

Se la console risponde Access denied for command resmon, la modalità sviluppatore non è attiva sul tuo client. Avvia FiveM con l'argomento +set moo 31337. Con FiveM per GTA V Enhanced, questo argomento non esiste più e il server deve definire sv_devMode true.

La pagina Player Drops di txAdmin completa questa analisi: mostra se i giocatori lasciano il server a causa di crash del loro gioco, e da quando.

Passo 8: isolare la risorsa responsabile

Inizia da ciò che è cambiato di recente. Se non è cambiato nulla, procedi per metà.

Prova rapida sul server avviato

Per una risorsa secondaria, arrestala in Live Console, poi osserva gli avvisi per una decina di minuti:

Testo
stop nome_risorsa

Rilanciala poi con ensure nome_risorsa. Non arrestare in questo modo oxmysql, es_extended, qb-core o un'altra risorsa da cui dipendono molte altre: provocheresti errori estranei al problema.

Ricerca per metà

Fai prima una copia della configurazione, sostituendo NOME_CARTELLA:

Terminale
sudo -u fivem cp /home/fivem/txData/NOME_CARTELLA.base/server.cfg /home/fivem/txData/NOME_CARTELLA.base/server.cfg.prima-diagnostica

Poi, fuori dagli orari di punta:

  1. In CFG Editor, disattiva metà delle risorse opzionali aggiungendo # davanti alla loro riga ensure. Mantieni il framework e le sue dipendenze.
  2. Riavvia il server e prova a riprodurre il problema.
  3. Se il problema scompare, deriva dalla metà disattivata. Altrimenti, deriva da quella che resta attiva.
  4. Ricomincia sul gruppo sospetto, fino a tenere una sola risorsa.

Se più risorse vengono avviate da una cartella, come ensure [addons], sostituisci temporaneamente questa riga con una riga ensure per ciascuna di esse. Un errore Could not find dependency durante la prova significa semplicemente che hai disattivato una dipendenza: riattivala.

Una volta trovata la risorsa, aggiornala, correggi la sua configurazione o segnala il problema al suo autore, con il tuo profilo e i tuoi log. Rimetti poi la configurazione originale, quindi riavvia il server da txAdmin:

Terminale
sudo -u fivem cp /home/fivem/txData/NOME_CARTELLA.base/server.cfg.prima-diagnostica /home/fivem/txData/NOME_CARTELLA.base/server.cfg

Chiedere aiuto

Per un problema di una risorsa, rivolgiti al suo autore o al forum Cfx.re. Prepara:

  • la build di FXServer e la versione di txAdmin, rilevate come in Aggiornare gli artifact di FXServer
  • il momento dell'incidente e ciò che è cambiato subito prima
  • le righe di console interessate, il profilo e i risultati di free -h e vmstat

Cfx.re ricorda che la versione Linux di FXServer è un porting offerto per comodità: se un difetto deriva da FXServer stesso, ha più probabilità di essere corretto se viene riprodotto su Windows. Verifica anche che persista sull'ultima versione consigliata prima di segnalarlo.

In caso di problemi durante la diagnosi

profiler saveJSON restituisce Invalid path

Usa un semplice nome di file, senza cartelle, e verifica che l'utente fivem possa scrivere nella cartella del server.

A recording is already taking place

Una registrazione è già in corso. Attendi la sua fine con profiler status, oppure arrestala con profiler record stop.

Il file fxserver.log è vuoto

Il servizio è appena stato riavviato. Usa /home/fivem/txData/default/logs/fxserver.log, insieme ai file datati della stessa cartella.

Il server si riavvia in loop durante le prove

Arrestalo con sudo systemctl stop fivem.service, rimetti al suo posto server.cfg.prima-diagnostica con il comando qui sopra, poi riavvia il servizio con sudo systemctl start fivem.service.