Corriger « Failed handshake to server » et HTTP 502, 503 ou 403 dans FiveM
« Failed handshake to server » signifie que FiveM a atteint quelque chose à l'adresse du serveur, mais que sa demande de connexion n'a pas reçu de réponse correcte. Quand un code HTTP s'affiche, la réponse vient d'un proxy, d'un filtre ou d'un pare-feu placé devant le serveur, et non d'un FXServer en bonne santé.
Ce que signifie l'erreur
Avant le chargement du jeu, FiveM envoie au serveur une demande de connexion, appelée handshake, pour obtenir l'autorisation de se connecter. Si cette demande échoue, vous voyez cette erreur. Si le message se termine par un code HTTP, quelque chose a répondu mais n'a pas transmis la demande à FXServer. S'il se termine par un code CURL, la connexion elle-même a échoué ; voyez le guide des erreurs CURL de FiveM.
Ce que signifie le code HTTP
| Code | Ce que cela signifie généralement |
|---|---|
| HTTP 502 | Un proxy placé devant le serveur n'a pas obtenu de réponse valide : le serveur est arrêté, a planté ou est injoignable depuis le proxy. |
| HTTP 503 | Le serveur ou le proxy est surchargé, redémarre ou refuse temporairement de nouvelles requêtes. |
| HTTP 504 | Le proxy a attendu le serveur puis a abandonné. Le serveur est figé ou trop lent. |
| HTTP 403 | Quelque chose vous bloque volontairement : une règle de pare-feu, un filtre DDoS, un blocage par pays ou un bannissement. |
| HTTP 405 | Ce qui a répondu n'accepte pas la demande de connexion. Cela arrive avec un proxy web devant le port de jeu, ou lors d'un problème du côté de Cfx.re. |
Vérifications rapides pour les joueurs
- Connectez-vous directement. Appuyez sur F8 et tapez
connect ip:portavec l'adresse du serveur. Cela évite la liste de serveurs et marche pour beaucoup de joueurs. - Essayez d'autres serveurs. Si tous les serveurs échouent, le problème vient de votre réseau ou de Cfx.re, pas d'un serveur. Si un seul échoue, prévenez son propriétaire.
- Vérifiez le filtre de votre réseau. Les filtres d'école, de travail et de certains FAI bloquent FiveM. Demandez d'autoriser cfx.re, ou testez avec le partage de connexion de votre téléphone.
- Désactivez votre VPN et vérifiez que votre pare-feu et votre antivirus autorisent FiveM.
- Patientez et comparez. Si l'erreur mentionne l'authentification, un ticket ou un nom d'hôte Cfx.re, le serveur n'est pas en cause. Demandez sur le Discord de la communauté si d'autres la voient aussi, videz votre cache DNS et réessayez plus tard.
Corrections pour les propriétaires de serveurs
1. Utilisez une version récente du serveur
Des joueurs ont signalé des erreurs de handshake sur d'anciennes versions de FXServer que la version actuelle n'affiche plus. Passez à la dernière version recommandée et redémarrez.
2. Testez le serveur depuis l'extérieur
Depuis un ordinateur d'un autre réseau, demandez la page d'informations du serveur et regardez la ligne de statut :
curl -i http://YOUR_SERVER_IP:30120/info.json
HTTP 200 avec du JSON signifie que FXServer répond. Tout autre résultat, ou un timeout, signifie que quelque chose entre le joueur et le serveur fait obstacle.
3. Retirez les proxys web du port de jeu
FiveM a besoin de TCP et d'UDP bruts sur le port de jeu. Un proxy HTTP comme nginx, Apache ou le proxy de Cloudflare placé devant provoque des erreurs 502, 503 et 405. Si vous avez besoin d'un filtrage contre les attaques, utilisez une IP protégée qui laisse passer TCP et UDP, pas un proxy HTTP.
4. Vérifiez les bannissements et les limites de débit
Un 403 pour certains joueurs signifie généralement qu'une règle les bloque. Passez en revue les jails fail2ban, les limites de débit iptables, les blocages par pays et les règles du filtre DDoS. Beaucoup de joueurs partagent une même adresse IP sur les réseaux mobiles et universitaires : une limite stricte par IP peut donc exclure tout un groupe. Demandez l'adresse IP d'un joueur concerné et cherchez-la dans vos journaux.
5. Vérifiez la santé du serveur
Un serveur qui redémarre ou qui est bloqué par un long hitch répond par 503 ou 504. Surveillez la console au moment des erreurs et corrigez les avertissements de hitch ; voyez comment corriger le « server thread hitch warning ».
6. Vérifiez le pare-feu et les listes de blocage de votre hébergeur
Certains panneaux de VPS ont leur propre pare-feu devant le système d'exploitation. Vérifiez qu'il autorise TCP et UDP sur le port de jeu, et que l'adresse IP de votre serveur n'est pas sur une liste de blocage.
Les erreurs qui touchent tous les serveurs
« Could not fetch C->S authentication ticket », « Could not resolve host » avec un nom Cfx.re, et les erreurs HTTP de l'étape d'authentification touchent généralement chaque joueur sur chaque serveur. Elles se situent entre le PC du joueur et les services de Cfx.re : il n'y a donc rien à corriger sur votre serveur. Elles disparaissent souvent d'elles-mêmes en quelques heures ; vider le cache DNS ou passer à 1.1.1.1 aide quand la cause est le DNS.
Toujours bloqué ?
Notez le texte exact de l'erreur, l'heure, l'adresse IP du joueur et le résultat du test curl. Avec ces éléments, votre hébergeur peut consulter ses journaux et voir où la requête s'est arrêtée.
Hébergez votre serveur FiveM à Singapour
Un ping faible pour les joueurs en Inde, en Malaisie et en Indonésie, sur AMD EPYC avec NVMe et protection DDoS Gcore sur chaque IP.
