Comment mettre à jour les artefacts du serveur FiveM en toute sécurité

Mettez à jour le runtime FXServer tout en préservant votre répertoire server-data, la configuration, les données txAdmin et la base de données. Téléchargez l'artefact recommandé pour votre système d'exploitation, testez-le et conservez le runtime précédent jusqu'à ce que la nouvelle version ait passé une session normale.

Les exemples de configuration et de code ici ciblent FiveM pour GTA V Legacy. Enhanced a des règles d'exécution et de compatibilité différentes ; vérifiez les changements Legacy-to-Enhanced de Cfx.re avant de les appliquer à un serveur Enhanced.

Préparez la mise à jour

Enregistrez l'artefact actuel et la commande ou le service de démarrage. Localisez le runtime séparément de server.cfg, resources/ et txData. Sauvegardez les fichiers et la base de données et vérifiez comment les restaurer. Planifiez une fenêtre de maintenance et arrêtez le processus du serveur géré avant de remplacer les fichiers d'exécution.

Windows ou Linux : mettez à jour uniquement les fichiers d'exécution

Consultez artefacts Windows officiels ou artefacts Linux officiels . Suivez le lien de la version recommandée ; ne supposez pas que le numéro de version le plus élevé est la version recommandée.

Extrayez l'archive dans un répertoire séparé et examinez sa structure. Remplacez le runtime via la procédure documentée de votre installation. Conservez l'ancien répertoire du runtime pour une éventuelle restauration. Sous Linux, conservez les permissions d'exécution requises. Ne supposez pas que chaque archive contient un dossier nommé fx_server.

Redémarrez avec le même lanceur, service ou profil txAdmin que vous utilisiez auparavant. Vérifiez son répertoire de travail et le chemin de server-data. Ne copiez pas la configuration d'exemple sur votre serveur existant et ne traitez pas un git pull comme une mise à jour d'artefact.

Panneaux d'hébergement gérés

Utilisez la fonction de mise à jour d'artefact documentée par le fournisseur après avoir vérifié la sauvegarde et la version sélectionnée. Les noms des panneaux diffèrent. Confirmez les fichiers qu'il remplace et les options de récupération qu'il offre avant d'exécuter la mise à jour.

Vérifiez le démarrage et le gameplay

Confirmez la version de l'artefact en cours d'exécution et examinez les journaux de démarrage. Testez une nouvelle connexion, le chargement des personnages, la voix, l'inventaire et vos ressources essentielles. Vérifiez les nouvelles erreurs au cours d'une session normale. Si la connexion échoue, examinez l'erreur spécifique et la configuration du point de terminaison existant plutôt que de modifier les règles du pare-feu sans preuve.

Si la mise à jour échoue

Conservez les journaux d'échec. Arrêtez le processus et restaurez le runtime précédent avec le même chemin server-data. Si vous avez également modifié des ressources ou la structure de la base de données, utilisez leur procédure de récupération distincte ; la restauration des fichiers d'exécution seuls ne peut pas annuler une migration de données.

Enregistrez le résultat et la version que vous avez conservée. Supprimez l'ancien runtime seulement après ne plus en avoir besoin pour la récupération.

Références

Guide de support des artefacts Cfx.re; configuration de txAdmin.