Comment mettre à jour les artifacts FXServer
Mettez à jour FXServer et txAdmin sur votre serveur FiveM Linux : contrôle de la version, sauvegarde, installation d'une build recommandée ou précise, vérification et retour arrière.
Sur cette page
Les artifacts sont les fichiers du serveur FiveM publiés par Cfx.re : FXServer et la version de txAdmin qu'il embarque. Ce guide vous explique comment les mettre à jour proprement, en gardant la version précédente pour pouvoir revenir en arrière en quelques commandes.
Prérequis
- Un serveur installé avec le guide Créer un serveur FiveM, dont le script
/home/fivem/update-fxserver.shet le script de sauvegarde/usr/local/sbin/backup-fivem.sh - Un accès SSH avec
sudo - Un moment sans joueurs : le serveur est arrêté pendant l'opération
Ce guide concerne FiveM pour GTA V Legacy, comme le guide d'installation. FiveM pour GTA V Enhanced utilise une autre archive serveur.
Quand mettre à jour
Cfx.re publie notamment deux canaux :
| Canal | Usage |
|---|---|
recommended |
Version conseillée pour un serveur en production |
latest |
Version la plus récente, utile pour tester une nouveauté ou une correction |
Selon la politique de support de Cfx.re, une version recommandée est suivie jusqu'à six semaines après la suivante, et une version latest jusqu'à deux semaines après la suivante. Une version ancienne continue de fonctionner, mais elle n'est plus prise en charge. Les versions non prises en charge de plus de trois mois ne peuvent plus être rejointes depuis la liste des serveurs.
Étape 1 : relever les versions
Le serveur étant démarré, affichez la version installée :
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 première ligne affiche par exemple FXServer-master v1.0.0.12345 linux : le numéro de build est le dernier nombre, ici 12345. La seconde donne la version de txAdmin. Notez ces deux valeurs.
Comparez avec les versions publiées :
curl -fsSL https://changelogs-live.fivem.net/api/changelog/versions/linux/server | grep -oE '"(recommended|latest)":"[0-9]+"'Si votre build est égale à recommended, aucune mise à jour n'est nécessaire.
Étape 2 : sauvegarder
Vérifiez l'espace disque, puis lancez la sauvegarde :
df -h /home
sudo du -sh /home/fivem/server
sudo /usr/local/sbin/backup-fivem.sh
sudo ls -lh /home/fivem/backupsIl faut de la place pour une seconde copie de /home/fivem/server. Notez la date de la dernière archive fivem_DATE.tar.gz.
Étape 3 : installer la version recommandée
Arrêtez le serveur, gardez une copie de la version actuelle, puis lancez le script d'installation :
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.serviceLe script remplace uniquement /home/fivem/server. Vos ressources, server.cfg et les comptes txAdmin restent dans /home/fivem/txData.
Installer une build précise
Cette méthode sert à tester latest ou à choisir une build donnée. Créez un second script :
sudo -iu fivem
nano ~/install-fxserver-build.sh#!/bin/bash
set -euo pipefail
URL="${1:?Indiquez en argument le lien vers fx.tar.xz}"
case "$URL" in
https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/*/fx.tar.xz) ;;
*) echo "Adresse refusée : archive Linux officielle attendue" >&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 "Archive incomplète" >&2; exit 1; }
rm -rf "$HOME/server"
mkdir -p "$HOME/server"
mv "$TMP"/* "$HOME/server/"
echo "Version installée : $URL"chmod +x ~/install-fxserver-build.sh
exitRécupérez ensuite l'adresse voulue. Pour latest :
curl -fsSL https://changelogs-live.fivem.net/api/changelog/versions/linux/server | grep -oE '"latest_download":"[^"]*"' | cut -d'"' -f4Pour une autre build, copiez l'adresse de son fichier fx.tar.xz depuis la liste officielle des builds Linux. Après la sauvegarde de l'étape 2, installez-la en remplaçant ADRESSE_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 'ADRESSE_FX_TAR_XZ'
sudo systemctl start fivem.serviceÉtape 4 : vérifier le serveur
Attendez environ une minute, puis contrôlez le service, les ports et la nouvelle version :
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":"[^"]*"'Le service doit répondre active, les deux ports doivent écouter et le numéro de build doit avoir changé. Cherchez ensuite les erreurs de démarrage :
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.logCette commande ne doit rien renvoyer de nouveau par rapport à d'habitude. Si vous utilisez une base de données, vérifiez aussi la connexion :
sudo grep -a 'Database server connection established' /home/fivem/fxserver.logConnectez-vous enfin au jeu et testez les fonctions principales : connexion du personnage, inventaire, véhicule, commandes d'administration.
Gardez /home/fivem/server.previous quelques jours. Lorsque tout est stable, libérez la place :
sudo -u fivem rm -rf /home/fivem/server.previousRevenir à la version précédente
Remettez le dossier conservé en place :
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.serviceContrôlez la version avec la commande de l'étape 1, puis regardez la console :
sudo tail -n 50 /home/fivem/fxserver.logSi txAdmin refuse de démarrer après le retour arrière
Une version récente de txAdmin peut avoir converti sa base de joueurs. L'ancienne version s'arrête alors avec ce message :
Your players database is on v5, and this txAdmin supports up to v4.Restaurez txData depuis l'archive de l'étape 2, en remplaçant 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.serviceLes actions faites dans txAdmin depuis cette sauvegarde, comme les bannissements, sont perdues. Il n'est pas nécessaire de restaurer MariaDB : la mise à jour de FXServer ne modifie pas votre base. Supprimez /home/fivem/txData.failed une fois le serveur vérifié.
En cas de problème
Adresse de téléchargement introuvable
Le script n'a pas obtenu de réponse exploitable de Cfx.re. Testez l'accès :
curl -fsSI https://changelogs-live.fivem.net/api/changelog/versions/linux/serverSi la commande échoue, vérifiez la connexion sortante et le DNS du serveur, puis réessayez plus tard.
curl: (22) The requested URL returned error: 404
L'adresse de l'archive est incomplète ou erronée. Recopiez-la entièrement, avec le numéro de build, son identifiant et fx.tar.xz.
tar (child): xz: Cannot exec: No such file or directory
Le paquet qui décompresse l'archive est absent :
sudo apt install -y xz-utilsNo space left on device
Le disque est plein. Repérez ce qui occupe la place avec sudo bash -c 'du -sh /home/fivem/*', puis supprimez les anciens dossiers server.failed et txData.failed ou déplacez des archives hors du serveur. Supprimez aussi tout dossier temporaire /home/fivem/fxserver.* laissé par une coupure.
Le service est actif mais les ports n'écoutent pas
Consultez la console et vérifiez les droits :
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 après la mise à jour
Le message Resource 'nom' can't run: suivi de server needs to be 12345 or higher indique que la ressource demande une build plus récente. Installez cette build ou une version plus ancienne de la ressource. Si une ressource fonctionnait avant et échoue autrement, suivez Diagnostiquer les crashs et lenteurs d'un serveur FiveM, ou revenez à la version précédente le temps de corriger.
Avertissement end-of-support ou end-of-life
Le message apparaît aux joueurs et à l'administrateur quand les artifacts sont trop anciens. Un avertissement gris (end-of-support) laisse le serveur accessible. Un avertissement rouge (end-of-life) peut empêcher la connexion : mettez à jour le serveur.