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.
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.she 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:
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.luaLa 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:
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:
df -h /home
sudo du -sh /home/fivem/server
sudo /usr/local/sbin/backup-fivem.sh
sudo ls -lh /home/fivem/backupsServe 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:
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.serviceLo 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:
sudo -iu fivem
nano ~/install-fxserver-build.sh#!/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"chmod +x ~/install-fxserver-build.sh
exitRecupera poi l'indirizzo desiderato. Per latest:
curl -fsSL https://changelogs-live.fivem.net/api/changelog/versions/linux/server | grep -oE '"latest_download":"[^"]*"' | cut -d'"' -f4Per 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:
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.servicePasso 4: verificare il server
Attendi circa un minuto, poi controlla il servizio, le porte e la nuova versione:
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:
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.logQuesto comando non deve restituire nulla di nuovo rispetto al solito. Se usi un database, verifica anche la connessione:
sudo grep -a 'Database server connection established' /home/fivem/fxserver.logConnettiti 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:
sudo -u fivem rm -rf /home/fivem/server.previousTornare alla versione precedente
Rimetti al suo posto la cartella conservata:
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.serviceControlla la versione con il comando del passo 1, poi guarda la console:
sudo tail -n 50 /home/fivem/fxserver.logSe 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:
Your players database is on v5, and this txAdmin supports up to v4.Ripristina txData dall'archivio del passo 2, sostituendo DATE:
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.serviceLe 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:
curl -fsSI https://changelogs-live.fivem.net/api/changelog/versions/linux/serverSe 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:
sudo apt install -y xz-utilsNo 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:
sudo tail -n 100 /home/fivem/fxserver.log
sudo ls -l /home/fivem/server/run.sh
sudo chown -R fivem:fivem /home/fivem/serverResource 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.