Configurer un nom de domaine et un enregistrement SRV pour un serveur FiveM

Les noms de domaine permettent de remplacer une adresse IP difficile à retenir par un nom lisible. Pour héberger un serveur FiveM accessible via un domain personnalisé, il faut configurer la zone DNS du domaine avec un enregistrement de type SRV. Cet enregistrement indique aux serveurs DNS quel service, quel protocole et quel port utiliser pour joindre l'IP du serveur. En pratique, vos joueurs tapent connect play.exemple.fr dans la console F8 au lieu de mémoriser connect 203.0.113.10:30120.

Ce guide s'adresse à l'administrateur qui a déjà configuré son serveur FiveM et qui veut publier une adresse lisible. Il couvre la préparation DNS, la syntaxe d'un enregistrement SRV, les vérifications réseau et les erreurs courantes, que votre serveur tourne sur un VPS Linux, un serveur dédié ou un hébergement FiveM.

Avant de commencer

Préparez les éléments suivants avant de toucher à votre zone DNS :

• Un nom de domaine enregistré chez un registrar et un accès au panneau DNS (ou à la zone DNS gérée par votre hébergeur).
• L'adresse IPv4 publique (IP du serveur) sur laquelle FiveM écoute. Sur un VPS ou un serveur dédié, récupérez-la en SSH avec ip -4 addr show.
• Le port configuré dans le fichier server.cfg de FiveM (par défaut 30120).
• Un accès root ou administrateur au serveur pour vérifier l'écoute réseau et les règles du pare-feu.

Sous Ubuntu ou Debian, installez les outils de diagnostic DNS si ce n'est pas déjà fait :

sudo apt update && sudo apt install -y dnsutils

Ce paquet fournit dig et nslookup, indispensables pour valider vos configurations DNS après chaque modification.

Comment fonctionnent les serveurs DNS

Quand un joueur tape votre nom de domaine, son système envoie des requêtes DNS à un serveur DNS récursif, souvent celui configuré par le routeur ou le fournisseur d'accès. Ce serveur DNS interroge à son tour les serveurs DNS faisant autorité sur la zone de votre domain, jusqu'à obtenir l'adresse IP correspondante. Sur un réseau local, le résolveur DNS peut être le routeur lui-même ou un service DHCP qui distribue l'adresse du serveur DNS aux machines connectées.

Les logiciels de serveur DNS les plus courants sont BIND (BIND9, le plus répandu sur les serveurs Linux sous Debian et Ubuntu), Unbound (résolveur récursif) et les résolveurs intégrés aux panneaux d'administration comme Plesk. En tant qu'administrateur de serveur FiveM, vous n'avez généralement pas besoin d'installer votre propre serveur DNS : le registrar de votre nom de domaine héberge déjà la zone DNS et répond aux requêtes pour votre domain.

Retenez que la résolution DNS repose sur une chaîne de serveurs DNS : les résolveurs récursifs du réseau du joueur, puis les serveurs faisant autorité pour votre zone. Si un seul maillon est mal configuré, la résolution échoue et votre domain ne pointe nulle part.

Préparer la configuration du serveur FiveM

Avant de créer un enregistrement DNS, confirmez que la configuration du serveur est fonctionnelle. Connectez-vous en SSH à votre VPS ou serveur dédié et vérifiez que FiveM écoute sur le bon port :

ss -tulnp | grep 30120

Cette commande doit afficher une ligne avec l'état LISTEN. Si rien n'apparaît, le processus FiveM n'est pas démarré ou le port est différent de celui configuré. Vérifiez le fichier server.cfg et pensez à redémarrer le serveur FiveM si nécessaire.

Contrôlez aussi les règles du pare-feu. Sous Ubuntu ou Debian, avec UFW :

sudo ufw status
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp

Le port doit être ouvert en TCP et en UDP. Sur un serveur virtuel chez un hébergeur, vérifiez aussi le pare-feu réseau dans le panneau d'administration : certains hébergeurs filtrent le trafic entrant par défaut. Un serveur FiveM a besoin de suffisamment de RAM et de CPU pour répondre aux connexions. Un enregistrement DNS ne compense pas un serveur sous-dimensionné qui ne répond plus.

Si votre serveur FiveM utilise une base MySQL (ESX, QBCore), vérifiez aussi que le service MySQL tourne avant de lancer FiveM. Un serveur FiveM qui n'arrive pas à se connecter à sa base de données ne démarre pas correctement, même si la configuration du serveur DNS est parfaite. Consultez notre guide pour lier une base de données MySQL à un serveur FiveM.

Pour un projet FiveM, consultez aussi notre guide des premières questions avant d'ouvrir un serveur.

Créer la cible du domaine : enregistrement A et alias DNS

La première étape consiste à pointer votre nom de domaine (ou un sous-domaine) vers l'adresse IP de votre serveur. Créez un enregistrement DNS de type A dans la zone DNS de votre domain :

Si votre serveur possède une adresse IPv6, ajoutez aussi un enregistrement AAAA avec la même logique. Le sous-domaine créé constitue la cible (target) que l'enregistrement SRV référencera ensuite.

Un enregistrement CNAME fonctionne comme un alias DNS : il redirige un nom vers un autre nom au lieu de pointer directement vers une adresse IP. Par exemple, vous pouvez créer un alias play.exemple.fr qui pointe vers fivem.exemple.fr. Attention : un CNAME ne peut pas coexister avec d'autres types d'enregistrements sur le même nom. Évitez de placer un CNAME sur la racine (root) de votre nom de domaine (l'apex), car cela empêcherait de configurer les enregistrements MX pour les emails ou les enregistrements TXT pour la validation SPF.

Le TTL (Time to Live) indique combien de temps les serveurs DNS intermédiaires conservent la réponse en cache. Pendant une migration ou un changement d'IP du serveur, réduisez le TTL à 300 secondes quelques heures avant la bascule, puis remontez-le après stabilisation. Ne confondez pas propagation DNS et redirection HTTP : la propagation DNS est le délai de rafraîchissement du cache des résolveurs, tandis qu'une redirection HTTP (301, 302) est une réponse du serveur web.

Ajouter l'enregistrement SRV

L'enregistrement SRV (Service Record) associe un service et un protocole à un hôte et un port. Pour FiveM, le service est _cfx et le protocole est _udp. Dans la zone DNS de votre domain, ajoutez l'enregistrement suivant :

Si votre serveur FiveM utilise le port par défaut 30120, un simple enregistrement A suffit souvent : le client FiveM tente d'abord le port 30120 sur le domain indiqué. L'enregistrement SRV devient indispensable dès que vous utilisez un port personnalisé ou que vous voulez héberger plusieurs serveurs FiveM sur la même machine avec des ports différents.

La priorité et le poids prennent tout leur sens quand vous administrez plusieurs serveurs derrière le même domaine. Un SRV de priorité 0 sera toujours préféré à un SRV de priorité 10. À priorité égale, le poids sert à répartir les requêtes entre les cibles. Pour une installation simple avec un seul serveur, laissez priorité 0 et poids 5.

Configurer le DNS selon votre type d'hébergement

L'interface de configuration du serveur DNS varie selon votre environnement. Voici les cas les plus courants, applicables à tous les serveurs de jeu :

• VPS Linux (serveur virtuel) : la zone DNS est généralement gérée chez le registrar de votre nom de domaine, pas sur le VPS. Connectez-vous à l'interface de votre registrar pour ajouter les enregistrements A et SRV. Si vous avez installé un panneau comme Plesk sur votre VPS, il peut aussi gérer la zone DNS à condition que les serveurs DNS de Plesk soient déclarés comme serveurs de noms (NS) pour votre domain.
• Hébergement mutualisé avec panneau : si votre hébergement mutualisé dispose d'un panneau Plesk ou cPanel, accédez à l'éditeur de zone DNS intégré. Sur Plesk, rendez-vous dans Sites Web & Domaines > DNS. Les champs "Service", "Protocole", "Port" et "Cible" sont séparés. Ce type d'hébergement ne convient pas à FiveM (le serveur de jeu a besoin d'un accès root), mais vous pouvez y gérer la zone DNS de votre domain si c'est là que le nom est enregistré.
• Serveur dédié avec BIND : si vous administrez votre propre serveur DNS avec BIND9 sur Debian ou Ubuntu, éditez le fichier de zone (ex. /etc/bind/db.exemple.fr), ajoutez la ligne SRV, incrémentez le serial et rechargez le service : sudo systemctl reload bind9. Pensez à redémarrer BIND complètement si un simple reload ne suffit pas : sudo systemctl restart bind9.
• Cloudflare : désactivez le proxy (icône orange) sur l'enregistrement A utilisé par FiveM. Le proxy Cloudflare intercepte le trafic HTTP pour le serveur web, ce qui casse la connexion FiveM. L'enregistrement A doit être en mode "DNS only" (icône grise).

Quel que soit le panneau, la logique reste la même : un enregistrement A (ou AAAA) pour la cible, un enregistrement SRV pour le service. L'accès aux fichiers du serveur FiveM (scripts, configurations) se fait séparément par FTP, SFTP ou SSH, pas via la zone DNS.

Comprendre l'adresse de connexion

Une fois l'enregistrement SRV configuré, les joueurs peuvent se connecter en tapant votre nom de domaine dans la console F8 de FiveM :

connect play.exemple.fr

Le client FiveM résout d'abord le SRV _cfx._udp.play.exemple.fr, récupère le port et la cible, puis se connecte. Si le joueur utilise un VPN, les serveurs DNS du VPN répondront aux requêtes à la place de ceux de son fournisseur d'accès. Un VPN peut aussi masquer la localisation réelle du joueur, ce qui affecte la latence mais pas la résolution DNS elle-même.

Conservez toujours une adresse de secours avec l'IP et le port direct (connect 203.0.113.10:30120) pendant les tests et dans la documentation de votre équipe. Elle permet de distinguer rapidement une panne du serveur FiveM d'un problème de résolution DNS.

Vérifier la résolution DNS

Après avoir configuré vos enregistrements, vérifiez la résolution depuis votre machine d'administration. Sous Ubuntu, Debian ou tout autre Linux avec les outils DNS installés :

# Vérifier l'enregistrement A (cible)
dig A fivem.exemple.fr +short

# Vérifier l'enregistrement SRV
dig SRV _cfx._udp.play.exemple.fr

# Alternative avec nslookup
nslookup -type=SRV _cfx._udp.play.exemple.fr

La réponse SRV doit afficher le port (30120), la cible (fivem.exemple.fr) et un TTL cohérent. Testez aussi depuis un autre réseau (un téléphone en 4G, un serveur distant en SSH) pour vérifier que la réponse ne vient pas uniquement du cache de votre réseau local.

Si dig ne renvoie rien, vérifiez que les serveurs DNS faisant autorité pour votre domain contiennent bien l'enregistrement. Utilisez dig NS exemple.fr pour identifier les serveurs DNS de votre zone, puis interrogez-les directement :

dig @ns1.registrar.fr SRV _cfx._udp.play.exemple.fr

Cette méthode aide à déterminer si le problème vient de la zone DNS elle-même ou du cache d'un résolveur intermédiaire.

Pour un diagnostic DNS complet sur un serveur Linux, consultez notre guide de diagnostic de résolution DNS.

Tester le service et le pare-feu

Une résolution DNS réussie ne signifie pas que le serveur est joignable. Testez la connectivité réseau vers le port FiveM depuis une machine distante :

nc -vz 203.0.113.10 30120

Si la connexion échoue, le problème se situe entre la résolution DNS et le service applicatif. Les causes les plus fréquentes :

• Routeur ou NAT : si le serveur est derrière un routeur sur un réseau local domestique, le port doit être redirigé (port forwarding) vers l'IP locale du serveur. Le routeur fait office de passerelle entre le réseau local et Internet. Vérifiez aussi que le DHCP du routeur n'a pas changé l'adresse IP locale du serveur.
• Pare-feu : vérifiez les règles UFW, iptables ou le firewall du panneau d'hébergement. Notre guide ouvrir les ports d'un serveur de jeu avec UFW détaille la procédure.
• Service arrêté : le processus FiveM (ou txAdmin) peut avoir crashé. Vérifiez les logs et pensez à redémarrer le service.
• Hébergeur : certains hébergeurs de serveurs virtuels bloquent les ports de jeu par défaut. Vérifiez la politique réseau dans votre panneau client.

Pour les premiers réglages de sécurité d'un serveur Linux, consultez notre guide sécuriser un serveur dédié. Si votre serveur devient totalement inaccessible, suivez la méthode de diagnostic réseau rapide d'un VPS.

Au-delà de FiveM : les enregistrements SRV pour d'autres services

L'enregistrement SRV n'est pas spécifique à FiveM. D'autres services hébergés sur un serveur dédié ou un VPS utilisent le même mécanisme de découverte DNS :

Si vous administrez un serveur web Apache ou Nginx à côté de votre serveur FiveM, les enregistrements A et AAAA suffisent pour le trafic HTTP/HTTPS (ports 80 et 443). Le SRV n'est utile que lorsqu'un protocole a besoin d'indiquer un port non standard ou un service spécifique. Pour un serveur de messagerie complet (SMTP entrant et sortant), l'enregistrement MX reste la norme pour le routage des emails, tandis que le SRV sert à l'autodécouverte par les clients de messagerie.

Tableau comparatif des types d'enregistrements DNS

Erreurs courantes avec un enregistrement SRV

• Mauvais port : le SRV pointe vers un port différent de celui configuré dans server.cfg. Vérifiez les deux valeurs.
• Mauvais protocole : le nom utilise _tcp au lieu de _udp (ou inversement).
• Cible inexistante : le nom cible n'a pas d'enregistrement A ou AAAA qui se résout vers une IP valide.
• Double suffixe : le registrar ajoute automatiquement votre nom de domaine et crée _cfx._udp.play.exemple.fr.exemple.fr.
• Cache DNS : un résolveur conserve l'ancienne réponse jusqu'à l'expiration du TTL. Attendez ou purgez le cache local avec sudo resolvectl flush-caches sous Ubuntu.
• Port filtré par le routeur : le DNS répond correctement, mais le routeur ou un pare-feu bloque la connexion entrante sur le port du serveur.
• Proxy Cloudflare activé : le proxy HTTP intercepte le trafic destiné au serveur web et empêche la connexion FiveM. Désactivez-le pour l'enregistrement A concerné.
• Service FiveM arrêté : le processus n'écoute plus. Vérifiez les logs et pensez à redémarrer FiveM ou txAdmin.
• Redirection DNS non souhaitée : certains registrars proposent une "redirection web" qui crée une page intermédiaire au lieu d'un vrai enregistrement A. Utilisez un enregistrement A classique, pas une redirection HTTP.

Ne modifiez pas tous les paramètres en même temps. Changez une seule valeur, attendez la propagation, testez, puis passez à la suivante. Cette méthode conserve une trace utile pour votre équipe et simplifie le diagnostic.

Checklist avant de communiquer le domaine

• Le sous-domaine cible se résout vers la bonne adresse IP publique du serveur (dig A).
• L'enregistrement SRV contient le service _cfx, le protocole _udp et le bon port.
• Le port SRV correspond au port réellement configuré dans server.cfg.
• Le serveur FiveM écoute et son pare-feu autorise le trafic TCP et UDP sur ce port.
• Si le serveur est derrière un routeur, le port forwarding est configuré vers l'IP locale du serveur.
• Une résolution depuis un autre réseau (4G, serveur distant en SSH) renvoie les mêmes valeurs.
• Vous conservez une adresse IP de secours pour le diagnostic rapide.

Pour compléter votre infrastructure, découvrez aussi nos conseils sur les adresses IP secondaires et notre offre de serveurs dédiés.