IT

Server di gioco

Come aggiornare gli artifact di FXServer

Aggiorna FXServer e txAdmin sul tuo server FiveM Linux: controllo della versione, backup, installazione di una build consigliata o specifica, verifica e ripristino.

5 min di lettura, aggiornato il 18 novembre 2026

In questa pagina

Gli artifact sono i file del server FiveM pubblicati da Cfx.re: FXServer e la versione di txAdmin che include. Questa guida ti spiega come aggiornarli correttamente, conservando la versione precedente per poter tornare indietro con pochi comandi.

Prerequisiti

  • Un server installato con la guida Creare un server FiveM, compresi lo script /home/fivem/update-fxserver.sh e lo script di backup /usr/local/sbin/backup-fivem.sh
  • Un accesso SSH con sudo
  • Un momento senza giocatori: il server resta fermo durante l'operazione

Questa guida riguarda FiveM per GTA V Legacy, come la guida all'installazione. FiveM per GTA V Enhanced usa un altro archivio del server.

Quando aggiornare

Cfx.re pubblica in particolare due canali:

Canale Utilizzo
recommended Versione consigliata per un server in produzione
latest Versione più recente, utile per provare una novità o una correzione

Secondo la politica di supporto di Cfx.re, una versione consigliata è supportata fino a sei settimane dopo la successiva, e una versione latest fino a due settimane dopo la successiva. Una versione vecchia continua a funzionare, ma non è più supportata. Le versioni non supportate da più di tre mesi non possono più essere raggiunte dall'elenco dei server.

Passo 1: rilevare le versioni

Con il server avviato, mostra la versione installata:

Terminale
curl -fsS http://127.0.0.1:30120/info.json | grep -oE '"server":"[^"]*"'
sudo grep -E "^version" /home/fivem/server/alpine/opt/cfx-server/citizen/system_resources/monitor/fxmanifest.lua

La prima riga mostra ad esempio FXServer-master v1.0.0.12345 linux: il numero di build è l'ultimo numero, qui 12345. La seconda dà la versione di txAdmin. Annota questi due valori.

Confronta con le versioni pubblicate:

Terminale
curl -fsSL https://changelogs-live.fivem.net/api/changelog/versions/linux/server | grep -oE '"(recommended|latest)":"[0-9]+"'

Se la tua build è uguale a recommended, non serve alcun aggiornamento.

Passo 2: fare il backup

Verifica lo spazio su disco, poi lancia il backup:

Terminale
df -h /home
sudo du -sh /home/fivem/server
sudo /usr/local/sbin/backup-fivem.sh
sudo ls -lh /home/fivem/backups

Serve spazio per una seconda copia di /home/fivem/server. Annota la data dell'ultimo archivio fivem_DATE.tar.gz.

Passo 3: installare la versione consigliata

Arresta il server, conserva una copia della versione attuale, poi lancia lo script di installazione:

Terminale
sudo systemctl stop fivem.service
sudo -u fivem rm -rf /home/fivem/server.previous
sudo -u fivem cp -a /home/fivem/server /home/fivem/server.previous
sudo -iu fivem /home/fivem/update-fxserver.sh
sudo systemctl start fivem.service

Lo script sostituisce solo /home/fivem/server. Le tue risorse, server.cfg e gli account txAdmin restano in /home/fivem/txData.

Installare una build specifica

Questo metodo serve a provare latest o a scegliere una build precisa. Crea un secondo script:

Terminale
sudo -iu fivem
nano ~/install-fxserver-build.sh
Terminale
#!/bin/bash
set -euo pipefail

URL="${1:?Indica come argomento il link a fx.tar.xz}"

case "$URL" in
  https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/*/fx.tar.xz) ;;
  *) echo "Indirizzo rifiutato: archivio Linux ufficiale richiesto" >&2; exit 1 ;;
esac

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"

[ -x "$TMP/run.sh" ] && [ -d "$TMP/alpine" ] || { echo "Archivio incompleto" >&2; exit 1; }

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

echo "Versione installata: $URL"
Terminale
chmod +x ~/install-fxserver-build.sh
exit

Recupera poi l'indirizzo desiderato. Per latest:

Terminale
curl -fsSL https://changelogs-live.fivem.net/api/changelog/versions/linux/server | grep -oE '"latest_download":"[^"]*"' | cut -d'"' -f4

Per un'altra build, copia l'indirizzo del suo file fx.tar.xz dall'elenco ufficiale delle build Linux. Dopo il backup del passo 2, installala sostituendo URL_FX_TAR_XZ:

Terminale
sudo systemctl stop fivem.service
sudo -u fivem rm -rf /home/fivem/server.previous
sudo -u fivem cp -a /home/fivem/server /home/fivem/server.previous
sudo -iu fivem /home/fivem/install-fxserver-build.sh 'URL_FX_TAR_XZ'
sudo systemctl start fivem.service

Passo 4: verificare il server

Attendi circa un minuto, poi controlla il servizio, le porte e la nuova versione:

Terminale
sudo systemctl is-active fivem.service
sudo ss -tulpn | grep -E ':(30120|40120)\b'
curl -fsS http://127.0.0.1:30120/info.json | grep -oE '"server":"[^"]*"'

Il servizio deve rispondere active, le due porte devono essere in ascolto e il numero di build deve essere cambiato. Cerca poi gli errori di avvio:

Terminale
sudo grep -a -E "Could not (find|start) dependency|Couldn't (find|start) resource|can't run|Failed to load script|SCRIPT ERROR" /home/fivem/fxserver.log

Questo comando non deve restituire nulla di nuovo rispetto al solito. Se usi un database, verifica anche la connessione:

Terminale
sudo grep -a 'Database server connection established' /home/fivem/fxserver.log

Connettiti infine al gioco e prova le funzioni principali: connessione del personaggio, inventario, veicolo, comandi di amministrazione.

Conserva /home/fivem/server.previous per qualche giorno. Quando tutto è stabile, libera lo spazio:

Terminale
sudo -u fivem rm -rf /home/fivem/server.previous

Tornare alla versione precedente

Rimetti al suo posto la cartella conservata:

Terminale
sudo systemctl stop fivem.service
sudo -u fivem rm -rf /home/fivem/server.failed
sudo -u fivem mv /home/fivem/server /home/fivem/server.failed
sudo -u fivem mv /home/fivem/server.previous /home/fivem/server
sudo systemctl start fivem.service

Controlla la versione con il comando del passo 1, poi guarda la console:

Terminale
sudo tail -n 50 /home/fivem/fxserver.log

Se txAdmin rifiuta di avviarsi dopo il ripristino

Una versione recente di txAdmin può aver convertito il suo database dei giocatori. La vecchia versione si ferma allora con questo messaggio:

Testo
Your players database is on v5, and this txAdmin supports up to v4.

Ripristina txData dall'archivio del passo 2, sostituendo DATE:

Terminale
sudo systemctl stop fivem.service
sudo mv /home/fivem/txData /home/fivem/txData.failed
sudo -u fivem tar -xzf /home/fivem/backups/fivem_DATE.tar.gz -C /home/fivem
sudo systemctl start fivem.service

Le azioni eseguite in txAdmin dopo questo backup, come i ban, vanno perse. Non serve ripristinare MariaDB: l'aggiornamento di FXServer non modifica il tuo database. Elimina /home/fivem/txData.failed una volta verificato il server.

In caso di problemi

Indirizzo di download non trovato

Lo script non ha ottenuto una risposta utilizzabile da Cfx.re. Prova l'accesso:

Terminale
curl -fsSI https://changelogs-live.fivem.net/api/changelog/versions/linux/server

Se il comando fallisce, verifica la connessione in uscita e il DNS del server, poi riprova più tardi.

curl: (22) The requested URL returned error: 404

L'indirizzo dell'archivio è incompleto o errato. Ricopialo per intero, con il numero di build, il suo identificatore e fx.tar.xz.

tar (child): xz: Cannot exec: No such file or directory

Manca il pacchetto che decomprime l'archivio:

Terminale
sudo apt install -y xz-utils

No space left on device

Il disco è pieno. Individua cosa occupa spazio con sudo bash -c 'du -sh /home/fivem/*', poi elimina le vecchie cartelle server.failed e txData.failed oppure sposta degli archivi fuori dal server. Elimina anche ogni cartella temporanea /home/fivem/fxserver.* lasciata da un'interruzione.

Il servizio è attivo ma le porte non sono in ascolto

Consulta la console e verifica i permessi:

Terminale
sudo tail -n 100 /home/fivem/fxserver.log
sudo ls -l /home/fivem/server/run.sh
sudo chown -R fivem:fivem /home/fivem/server

Resource can't run dopo l'aggiornamento

Il messaggio Resource 'nome' can't run: seguito da server needs to be 12345 or higher indica che la risorsa richiede una build più recente. Installa questa build o una versione più vecchia della risorsa. Se una risorsa funzionava prima e ora fallisce in altro modo, segui Diagnosticare crash e rallentamenti di un server FiveM, oppure torna alla versione precedente il tempo di correggere.

Avviso end-of-support o end-of-life

Il messaggio compare ai giocatori e all'amministratore quando gli artifact sono troppo vecchi. Un avviso grigio (end-of-support) lascia il server accessibile. Un avviso rosso (end-of-life) può impedire la connessione: aggiorna il server.