Des échecs de connexion FiveM surviennent lors de l'établissement d'une liaison TCP (30120), de l'initialisation du flux UDP (30110-30125) ou de l'expiration du délai d'authentification avec les serveurs Nucleus. L'erreur se présente comme suit : Échec de la connexion au serveur : la connexion a expiré après le seuil de 15 secondes.
Cadre de diagnostic
- Validation du chemin réseau
- Confirmation de disponibilité du serveur
- Élimination des interférences côté client
- Vérification de la chaîne d'authentification
Si vous êtes propriétaire d'un serveur, assurez-vous d'héberger votre serveur sur un bon hébergeur.
Diagnostic réseau
1. Test d'accessibilité du port
:: Connectivité TCP powershell -commande "Test-NetConnection -ComputerName serverip -Port 30120" :: UDP nécessite nmap nmap -sU -p 30110-30125 serverip
Attendu: TcpTestSucceeded : vrai
2. Analyse de traceroute
pathping -n -q 10 -p 250 adresse IP du serveur
Une perte de paquets > 5% à n'importe quel saut indique un problème de routage du FAI.
3. Vérification de la résolution DNS
domaine du serveur nslookup domaine du serveur nslookup 8.8.8.8
Des résultats non concordants indiquent un empoisonnement DNS.
Solutions côté client
1. Règles du pare-feu Windows
New-NetFirewallRule -DisplayName "FiveM TCP" -Direction Sortie -Protocole TCP -LocalPort 30120 -Action Autoriser New-NetFirewallRule -DisplayName "FiveM UDP" -Direction Sortie -Protocole UDP -LocalPort 30110-30125 -Action Autoriser New-NetFirewallRule -DisplayName "FiveM Entrante" -Direction Entrante -Protocole UDP -LocalPort 30110-30125 -Action Autoriser
2. Correction des interférences IPv6
:: Désactiver IPv6 pour FiveM netsh int ipv6 set prefixpolicy ::ffff:0:0/96 46 4 netsh int ipv6 set prefixpolicy ::1/128 45 4
3. Réinitialisation de Winsock
netsh winsock réinitialiser le catalogue netsh int ip reset reset.log ipconfig /flushdns
Corrections de configuration du serveur
1. Visibilité des points finaux
-- server.cfg définit sv_endpointprivacy sur false définit sv_listingIPoverride "serverip:30120" définit sv_forceIndirectListing sur true
2. Gestion de la file d'attente de connexion
-- Augmenter les emplacements et le délai d'expiration définir sv_maxClients 128 définir sv_connectTimeout 300 définir sv_authMaxRetries 10
3. Ajustements de limitation de débit
-- Empêcher la détection DoS faussement positive définir sv_requestParanoia 0 définir sv_rateLimit 0
Réparation de la chaîne d'authentification
1. Connectivité du serveur Nucleus
:: Tester les services Cfx.re curl -I https://servers-frontend.fivem.net/api/servers/single/serverid curl -I https://nucleus.cfx.re/
HTTP 200 requis pour les deux.
2. Validation de la clé de licence
-- server.cfg set sv_licenseKey "cfxk_your_32_char_key" redémarrer sessionmanager
3. Corruption du cache
:: Suppression du cache Nucleus côté client : rmdir /s /q "%appdata%CitizenFXkvs" del "%localappdata%FiveMFiveM.appcaches.xml""
Solutions de contournement spécifiques aux FAI
1. Contournement CGNAT
:: Forcer la pile IPv4 netsh int ipv6 6to4 définir l'état désactivé netsh int ipv6 isatap définir l'état désactivé netsh int ipv6 définir teredo désactivé
2. Découverte MTU
:: Trouver le MTU optimal ping -f -l 1500 serverip :: Diminuer de 28 jusqu'à la réussite netsh int ipv4 set subinterface "Ethernet" mtu=1472 store=persistent
3. Configuration de port alternative
Le propriétaire du serveur doit configurer :
-- server.cfg endpoint_add_tcp "0.0.0.0:30121" endpoint_add_udp "0.0.0.0:30121"
Le client se connecte via : connecter le serveur IP:30121
Débogage avancé
1. Analyse de capture de paquets
:: Filtre Wireshark tcp.port == 30120 ou udp.port >= 30110 et udp.port <= 30125
Recherchez les paquets RST ou les ACK manquants.
2. Surveillance de l'état de la connexion
-- Console F8 pendant la connexion netstats 1 netgraph 1
3. Problèmes de certificat TLS
:: Vérifier la chaîne de certificats openssl s_client -connect servers-frontend.fivem.net:443 -servername servers-frontend.fivem.net
Problèmes spécifiques à la plateforme
Conflits VPN
- Désactiver le tunneling fractionné
- Exclure FiveM du VPN :
route ajouter masque IP serveur 255.255.255.255 192.168.1.1
Réseaux universitaires/d'entreprise
- Demander des exceptions de pare-feu pour :
- TCP 30120 sortant
- UDP 30110-30125 bidirectionnel
- TCP 443 vers nucleus.cfx.re
Limitations des points d'accès mobiles
- Blocs NAT de niveau opérateur P2P
- Utiliser un point de terminaison TCP uniquement :
connecter le serveur IP:30120+tcp
Incertitudes
- Les travailleurs de Cloudflare bloquent par intermittence les appels d'API FiveM (détection de bot faussement positif)
- Le service de reconnaissance de l'emplacement réseau de Windows 11 peut nécessiter un redémarrage manuel
- Some Xfinity modems silently drop UDP packets >1400 bytes
Référence aux normes
- RFC 4787 (Exigences comportementales NAT)
- Spécification du protocole CitizenFX v2.4.1
- Streaming UDP de type QUIC (implémentation personnalisée)
Conclusion: Les échecs de connexion proviennent de ports bloqués, de non-concordances MTU ou de délais d'authentification nécessitant une validation systématique du chemin réseau.
Liste de contrôle pratique
Utilisez ce guide comme liste de vérification avant de modifier un serveur FiveM en production. Assurez-vous de la version actuelle des artefacts serveur, de la version du framework, des dépendances des ressources, des modifications de la base de données et des fichiers côté client avant d'appliquer la modification.
- Sauvegardez les fichiers de configuration et les tables de base de données concernés.
- Appliquez d'abord la modification sur un serveur de test.
- Surveillez la console du serveur et la console F8 du client pour détecter les erreurs.
- Vérifiez si la modification affecte les emplois, l'inventaire, les véhicules, les cartes, la voix, les autorisations ou les données des joueurs.
- Documentez précisément le fichier, la commande ou le paramètre que vous avez modifié afin de pouvoir le rétablir rapidement.
Tests avant production
Après le premier test, connectez-vous avec un compte joueur standard et répétez le processus du point de vue du joueur. Si le sujet concerne les performances, effectuez des mesures avant et après en conservant le même nombre de joueurs, le même parcours et les mêmes ressources. Si le sujet concerne les outils d'administration ou les permissions, vérifiez les utilisateurs autorisés et ceux qui n'y sont pas autorisés.
Erreurs courantes
La plupart des problèmes rencontrés avec FiveM proviennent de dépendances manquantes, d'un cache obsolète, de noms de dossiers incorrects, d'incompatibilités de frameworks ou d'une configuration copiée depuis un autre serveur. Évitez de modifier plusieurs systèmes simultanément ; effectuez une modification, testez-la, puis poursuivez.
Ressources connexes
Pour les ressources prêtes à la production, comparez les ressources payantes dans le Boutique FiveMX. Pour accéder à des ressources gratuites, consultez Scripts FiveM gratuits et tester chaque ressource avant de l'utiliser publiquement.
Notes de déploiement de la production
Avant d'appliquer ce guide sur un serveur FiveM en production, définissez précisément le résultat attendu. Dans le cas de l'erreur de connexion FiveM : Guide de diagnostic et de résolution, vérifiez quelle ressource, quel paramètre, quelle commande ou quel processus est concerné et assurez-vous que la modification est compatible avec votre infrastructure, votre version d'artefacts et les règles de votre serveur. Déployez la modification progressivement afin de pouvoir l'annuler rapidement si des joueurs signalent des erreurs.
Utilisez un serveur de test avec la même infrastructure, le même schéma de base de données, le même ordre de ressources et les mêmes dépendances clés que le serveur de production. Si le sujet abordé modifie le gameplay, les permissions, les graphismes, le doublage, les véhicules, les cartes, l'inventaire ou le comportement économique, effectuez des tests avec au moins un compte administrateur et un compte joueur. Surveillez la sortie de la console du serveur, les journaux F8 du client et le temps d'accès aux ressources tout en reproduisant exactement le parcours de jeu qui se déroulera sur le serveur de production.
Liste de contrôle de restauration
- Sauvegardez le fichier de configuration précédent, le dossier de ressources et l'état de la base de données avant toute modification.
- Notez la version de la ressource, le commit, la page de téléchargement ou la valeur du paramètre que vous avez testée.
- Redémarrez d'abord uniquement la ressource concernée lorsque cela est possible, puis redémarrez le serveur complet si des dépendances l'exigent.
- En cas d'erreur, rétablissez la ressource ou le paramètre modifié avant de tester une autre solution.
Conseils d'entretien
Revérifiez cette configuration après chaque mise à jour des artefacts FiveM, du framework ou modification importante des ressources. Une configuration fonctionnelle aujourd'hui peut devenir inutilisable suite à des mises à jour de dépendances, des modifications d'exports, des changements d'événements ou des migrations de base de données. Conservez des notes dans la documentation de votre serveur afin que les futurs administrateurs comprennent les modifications apportées, leurs raisons et comment les reproduire.
Examen en cours
Consultez à nouveau le guide de diagnostic et de résolution des erreurs de connexion à FiveM après des mises à jour majeures des artefacts, des modifications du framework ou des migrations de ressources. Assurez-vous que les conseils correspondent toujours au comportement actuel du serveur, que les sources liées restent disponibles et que les étapes d'installation correspondent toujours aux fichiers que le propriétaire du serveur téléchargera ou configurera.
Pour les serveurs publics, conservez un bref historique des modifications à côté de la documentation du serveur. Indiquez ce qui a été testé, ce qui a changé, les comptes utilisés pour la vérification et la procédure de retour en arrière. Cela facilitera la maintenance future et évitera que les anciennes notes de configuration ne deviennent obscures ou dangereuses pour les joueurs.
Références officielles et prochaines étapes
Utilisez ces références officielles pour vérifier les étapes techniques avant de modifier un serveur FiveM en production.
Guides FiveMX associés :
