FiveM server.cfg Guide : Configuration de démarrage sécurisée

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sets sv_projectName "Mon Serveur"
sets sv_projectDesc "Une description claire en une phrase"
sv_hostname "Mon Serveur"
set onesync on
sv_maxclients 48
sv_licenseKey "remplacer_par_la_clé_du_portail"
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap

Le serveur.cfg Le fichier est au cœur de chaque serveur FiveM. Il définit le fonctionnement de votre serveur : emplacements, réseau, création de jeu, OneSync, journalisation et visibilité dans la liste des serveurs. Ce guide est destiné aux propriétaires et développeurs de serveurs qui recherchent des paramètres par défaut sûrs, un renforcement de la production et des pratiques optimales en matière de performances. Conservez toujours des sauvegardes et utilisez le contrôle de version. Si vous débutez, commencez par notre Comment créer un serveur FiveMPour des optimisations plus approfondies, consultez notre Centre de performance.

TL;DR : Ligne de base prête pour la production (annotée)

Un nettoyage serveur.cfg est le fondement de la stabilité. Voici deux exemples : un minimum configuration de développement et un configuration de production renforcée.

Configuration de développement minimale

# server.cfg (développement)
# Configuration de base pour les tests locaux

# Réseau
endpoint_add_tcp "0.0.0.0:30120" # Liaison de port TCP
endpoint_add_udp "0.0.0.0:30120" # Liaison de port UDP

# Informations du serveur
sv_hostname "Mon serveur de développement"
sv_maxclients 8

# OneSync
set onesync on

# Ressources (exemple de base)
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure baseevents

# Permissions (ACL par défaut)
exec permissions.cfg

Configuration de production renforcée

# server.cfg (production)

# Réseau
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# Sécurité
sv_endpointPrivacy true # Masque les adresses IP des joueurs des rapports publics du serveur ; cela ne masque pas l'origine du serveur
sv_scriptHook 0 # Désactive les mods clients
# Laissez rcon_password non défini sauf si RCon hérité est explicitement requis

# Slots
sv_maxclients 64 # Ajustez selon la capacité de l'hôte

# Version du jeu (utilisez la dernière recommandée)
# Optionnel : épinglez une version de jeu documentée uniquement lorsque vos ressources l'exigent

# Informations sur le projet
sv_hostname "FIVEMX Roleplay | Serious RP"
sets sv_projectName "FIVEMX RP Server"
sets sv_projectDesc "RP réaliste avec QBCore & scripts personnalisés"
sets tags "roleplay, seriousrp, qbcore"
sets locale "en-US"
load_server_icon mylogo.png
sets banner_detail "https://cdn.example.com/banner.png"
sets banner_connecting "https://cdn.example.com/loading.png"

# OneSync
set onesync on

# Ressources (utilisez la liste des ressources)
exec resources.cfg

# Journalisation & ACL
set sv_logLevel 2
exec permissions.cfg

# Intégration txAdmin
# Chargez la configuration du framework/base de données à partir d'une configuration séparément autorisée ; ne publiez pas les identifiants réels

Conseil: Validez toujours votre configuration après modification avec les contrôles d'intégrité et les journaux de la console txAdmin. Voir journaux txAdmin.

Informations et liste du serveur

Les variables suivantes contrôlent la façon dont votre serveur apparaît dans le navigateur de serveur et API :

Voir le référence officielle des commandes et cvars du serveur FiveM pour la syntaxe et le comportement actuels.

Réseautage et créneaux horaires

Utilisation des serveurs FiveM Points de terminaison TCP/UDP. Par défaut, le port 30120 est utilisé.

endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" sv_maxclients 64

• Exécutez plusieurs serveurs sur une seule machine avec décalages de port: par exemple 30121, 30122.
• Associez les règles de pare-feu pour ouvrir les ports TCP/UDP.
• sv_maxclients affecte directement l'utilisation du processeur et de la RAM — ne définissez pas une valeur plus élevée que ce que votre matériel peut gérer. Voir les fournisseurs d'hébergement de serveurs

Avertissement: N'exposez pas les ports MySQL ou RCON à Internet.

Construction du jeu et artefacts

Une version d'artefact FXServer et une construction de jeu GTA sont des choix séparés. Mettez à jour les artefacts via le chemin de construction recommandé par Cfx.re ; définissez sv_enforceGameBuild uniquement lorsque les ressources du serveur nécessitent une construction de contenu GTA documentée, et vérifiez la valeur par rapport à la référence de commande actuelle de Cfx.re.

# Paramètre de démarrage facultatif ; choisissez une valeur dans la référence Cfx.re actuelle
# sv_enforceGameBuild 

• [Documentation officielle des convars][1] répertorie les numéros de build valides.
• Ensemble intégré serveur.cfg ou dans txAdmin → Paramètres → FXServer → Arguments supplémentaires:

+set sv_enforceGameBuild 2944

• Télécharger la dernière version artefacts depuis [runtime.fivem.net][4] (Windows) ou la page de build Linux.
• Ne mélangez jamais les versions client et serveur.

Configuration de OneSync

OneSync permet synchronisation des entités côté serveur: plus de joueurs, des états précis, un meilleur streaming. Utilisez toujours OneSync activé pour les frameworks modernes (QBCore, ESX).

Conseil: Échelle sv_maxclients avec du matériel. Utiliser Guide Resmon pour mesurer l’impact des ressources.

Ordre de démarrage des ressources et dépendances

Les ressources se chargent dans l'ordre défini par assurerCommencez toujours par les dépendances.

# resources.cfg (fichier divisé) ensure oxmysql ensure qb-core ensure qb-adminmenu ensure qb-inventory ensure qb-policejob ensure my-custom-scripts

Dans serveur.cfg:

ressources exécutives.cfg

• Gardez les frameworks et les connecteurs de base de données en premier.
• Ressources liées au groupe.
• Éviter assurer * en production ; cela provoque un ordre non déterministe.

Renforcement de la sécurité et des abus

Un sécurisé serveur.cfg prévient les fuites et les abus.

Liste de contrôle:

• sv_endpointPrivacy vrai
• sv_scriptHook 0 (bloquer les mods clients)
• Fort ou handicapé mot de passe rcon
• Utiliser ajouter_principal et ajouter_ace pour les ACL
• Gardez les secrets hors des dépôts publics et des fichiers de ressources clients/partagés ; restreignez l'accès à la configuration réservée au serveur qui les contient
• Mettre à jour régulièrement les artefacts
• Moniteur journaux txAdmin
• Utiliser Guide Resmon pour attraper des scripts lourds

Exemple d'ACL :

La commande add_ace group.admin autorise add_principal identifier.steam:110000112345678 group.admin

CDN et streaming d'actifs (quand les utiliser)

Pour les grands MLO, les voitures personnalisées et les textures, utilisez un CDN pour réduire rejoindre les heures.

• Héberger des fichiers sur un CDN comme Cloudflare R2 (définir [en-têtes CORS][6]).
• Pour des performances élevées, BunnyCDN prend en charge les [requêtes de plage][7] (nécessaires pour .rpf streaming).
• Ajoutez des URL versionnées pour éviter les conflits de cache.

Voir notre Optimiser les temps de chargement guide.

Mythes et drapeaux déconseillés

De nombreuses configurations en ligne s'affichent toujours Cvars du moteur source comme:

sv_maxrate 0 sv_minrate 30000 sv_maxupdaterate 60

Ne pas utiliser. Ces variables ne sont pas prises en charge par FiveM et n'ont aucun effet. Voir [convars officielles][1].

Convars obsolètes/héritées :

• sv_master1 → n'est plus nécessaire.
• sv_useDirectListing → remplacé par sv_endpointConfidentialité.

Validation et dépannage

Vérifications clés après l'édition serveur.cfg:

Packs serveur

Découvrez des produits serveur complets pour les lancements et les refontes.

Packs serveurBase du serveur ESX (par RibSosay)$53.99

Packs serveurServeur complet QBus / QBCore v4.1$43.99

Packs serveurModèle de serveur ESX Pro$136.99

Ressources internes et prochaines étapes

• Comment créer un serveur FiveM
• /fivem-serveurs

FAQ

1. Qu'est-ce que serveur.cfg dans FiveM ?
Il s'agit du fichier de configuration principal qui définit le nom du serveur, les emplacements, les ressources, la mise en réseau, la sécurité et la visibilité.

2. Où dois-je placer serveur.cfg?
Dans le dossier racine de votre serveur (à côté de serveur.exe ou Serveur FX point d'entrée). txAdmin le charge automatiquement.

3. Quelle est la différence entre ensemble, ensembles, et setr?

• ensemble: variable réservée au serveur.
• ensembles: apparaît dans la liste des serveurs (informations publiques).
• setr: synchronisé avec les clients.

4. Mon serveur n'apparaît pas dans la liste. Pourquoi ?
Vérifier sv_nom_hôte, définit des balises, définit les paramètres régionaux, et sv_endpointConfidentialitéAssurez-vous également que vos ports sont ouverts.

5. Comment puis-je augmenter le nombre d'emplacements de joueurs ?
Changement sv_maxclients. Évoluez progressivement et surveillez avec Guide ResmonAssurez-vous que votre matériel et votre réseau peuvent le gérer.

6. Qu'est-ce que sv_enforceGameBuild?
Une variable de configuration qui force les clients à utiliser une version spécifique de GTA V. Elle prévient les plantages dus à des versions incompatibles. Voir [Documentation sur les variables de configuration][1].

7. Dois-je utiliser des numéros de build ou des alias ?
Les deux fonctionnent. Numérique (2944) est explicite ; alias (mp2024_02) est plus facile à suivre. Les deux sont pris en charge.

8. Où dois-je régler sv_enforceGameBuild dans txAdmin ?
Dans txAdmin → Paramètres → FXServer → Arguments supplémentaires. Exemple : +set sv_enforceGameBuild 2944.

9. Qu'est-ce que OneSync ?
Un système permettant d'accueillir davantage de joueurs, de diffuser des entités avec précision et d'obtenir une autorité de serveur. Nécessaire pour les frameworks modernes. Voir [Documentation OneSync][3].

10. Infinity ou Legacy OneSync ?
Legacy = jusqu'à 64 emplacements. Infinity = prend en charge 128 emplacements et plus, synchronisation avancée des entités. À utiliser systématiquement. OneSync activé (Infini par défaut).

11. Comment organiser les ressources ?
Utiliser ressources exécutives.cfg. Démarrez d'abord les connecteurs de base de données, puis les frameworks, puis les tâches/scripts. Évitez assurer *.

12. Mes bannières n'apparaissent pas dans la liste des serveurs.
Assurez-vous que les URL sont HTTPS, publiques et pointent vers des images de taille correcte. Utilisez un CDN pour plus de fiabilité.

13. À quoi servent les journaux txAdmin ?
Ils affichent des erreurs, des plantages et des problèmes de ressources. Voir journaux txAdmin.

14. Comment puis-je vérifier les problèmes de performances ?
Utiliser résmon 1 dans la console. Voir notre Guide Resmon pour plus de détails.

15. Les indicateurs de taux du moteur source sont-ils nécessaires ?
Non. sv_maxrate, sv_minrate, sv_maxupdaterate Ne faites rien dans FiveM. Utilisez plutôt [Convars doc][1].

Crédits :

• [Convars – Documents Cfx.re][1]
• [Commandes du serveur – Documentation Cfx.re][2]
• [OneSync – Documentation Cfx.re][3]
• [Artefacts (versions Windows) – runtime.fivem.net

Pour les champs spécifiques à la liste et actuels sv_master1 comportement, continuez avec le guide de configuration de la liste de serveurs FiveM.

Références actuelles du serveur.cfg officiel

• Exemple de configuration FXServer vanilla Cfx.re
• Commandes et convars du serveur Cfx.re
• Configuration de Cfx.re txAdmin