„Failed handshake to server” en HTTP 502, 503 of 403 in FiveM oplossen

„Failed handshake to server” betekent dat FiveM iets op het adres van de server bereikte, maar dat het joinverzoek geen goed antwoord kreeg. Wordt er een HTTP-code getoond, dan kwam het antwoord van een proxy, filter of firewall vóór de server en niet van een gezonde FXServer.

Door het Nodewave-team · Bijgewerkt op 8 november 2026

Wat de fout betekent

Voordat het spel laadt, stuurt FiveM de server een joinverzoek, een handshake genoemd, om toestemming te krijgen om te verbinden. Mislukt dat verzoek, dan zie je deze fout. Eindigt de melding met een HTTP-code, dan antwoordde iets maar gaf het verzoek niet door aan FXServer. Eindigt ze met een CURL-code, dan is de verbinding zelf mislukt; lees de handleiding over FiveM-CURL-fouten.

Wat de HTTP-code betekent

Snelle checks voor spelers

1. Verbind direct. Druk op F8 en typ connect ip:port met het adres van de server. Zo sla je de serverlijst over, en het werkt voor veel spelers.
2. Probeer andere servers. Falen alle servers, dan ligt het aan je netwerk of Cfx.re, niet aan één server. Faalt er maar één, vertel het dan aan de eigenaar.
3. Controleer je netwerkfilter. Filters op scholen, op werk en bij sommige providers blokkeren FiveM. Vraag om cfx.re toe te staan, of test met een hotspot op je telefoon.
4. Zet je VPN uit en controleer of je firewall en antivirus FiveM toestaan.
5. Wacht en vergelijk. Noemt de fout authenticatie, een ticket of een Cfx.re-hostnaam, dan ligt het niet aan de server. Vraag in de Discord van de community of anderen het ook zien, wis je DNS-cache en probeer het later opnieuw.

Oplossingen voor servereigenaren

1. Gebruik een actuele serverbuild

Spelers hebben handshake-fouten gemeld bij oude FXServer-builds die de huidige build niet meer toont. Update naar de nieuwste aanbevolen build en herstart.

2. Test de server van buitenaf

Vraag vanaf een computer in een ander netwerk de infopagina van de server op en kijk naar de statusregel:

curl -i http://YOUR_SERVER_IP:30120/info.json

HTTP 200 met JSON betekent dat FXServer antwoordt. Alles anders, of een timeout, betekent dat er iets tussen de speler en de server in de weg zit.

3. Haal webproxy's weg van de gamepoort

FiveM heeft rauw TCP en UDP nodig op de gamepoort. Een HTTP-proxy zoals nginx, Apache of de proxy van Cloudflare ervoor veroorzaakt 502-, 503- en 405-fouten. Heb je aanvalsfiltering nodig, gebruik dan een beschermd IP dat TCP en UDP doorlaat, geen HTTP-proxy.

4. Controleer bans en limieten

Een 403 voor sommige spelers betekent meestal dat een regel hen blokkeert. Bekijk fail2ban-jails, iptables-limieten, landblokkades en DDoS-filterregels. Veel spelers delen één IP-adres op mobiele en campusnetwerken, dus een strenge limiet per IP kan een hele groep buitensluiten. Vraag een getroffen speler om zijn IP-adres en zoek het in je logs.

5. Controleer de gezondheid van de server

Een server die herstart of vastzit in een lange hitch, antwoordt met 503 of 504. Houd de console in de gaten rond de fouten en los hitch-waarschuwingen op; lees hoe je de „server thread hitch warning” oplost.

6. Controleer de firewall en blokkeerlijsten van je host

Sommige VPS-panelen hebben een eigen firewall vóór het besturingssysteem. Zorg dat die TCP en UDP op de gamepoort toestaat en dat het IP-adres van je server niet op een blokkeerlijst staat.

Fouten die elke server raken

„Could not fetch C->S authentication ticket”, „Could not resolve host” met een Cfx.re-naam en HTTP-fouten uit de authenticatiestap raken meestal elke speler op elke server. Ze zitten tussen de pc van de speler en de diensten van Cfx.re, dus op jouw server valt niets te herstellen. Vaak verdwijnen ze binnen een paar uur vanzelf; DNS wissen of overstappen naar 1.1.1.1 helpt als DNS de oorzaak is.

Kom je er nog steeds niet uit?

Noteer de exacte fouttekst, het tijdstip, het IP-adres van de speler en het resultaat van de curl-test. Daarmee kan je host zijn logs bekijken en zien waar het verzoek stopte.