Corriger l'erreur Connection Timed Out getsockopt sur Minecraft

Si vous avez essayé de rejoindre un serveur Minecraft et que vous avez été renvoyé à l'écran multijoueur avec Connection Timed Out: getsockopt (ou sa grande soeur en stack trace Java, java.net.ConnectException: Connection timed out: no further information: getsockopt), la bonne nouvelle, c'est que cette erreur n'a rien à voir avec votre compte, vos mods, votre version ou la whitelist du serveur. C'est une panne au niveau réseau : votre client Minecraft n'a jamais atteint l'IP et le port du serveur. Ce guide déroule toutes les solutions qui fonctionnent réellement, dans l'ordre qui résout le plus de tickets sur notre panneau de contrôle.

Une baie de datacenter avec des serveurs de jeu Minecraft en fonctionnement

Ce que signifie vraiment "Connection Timed Out: getsockopt"

getsockopt est un appel système de la couche réseau de Java qui demande au système d'exploitation dans quel état se trouve une socket TCP. Quand Minecraft l'affiche à l'intérieur d'une erreur de connexion, voici ce qui s'est réellement passé : votre client a ouvert une socket TCP, envoyé un paquet SYN vers l'IP et le port du serveur, puis attendu. Au bout d'environ 30 secondes sans réponse SYN-ACK, le code réseau de Java a abandonné et levé l'exception. Minecraft l'a interceptée et vous en a montré la version courte à l'écran.

En clair : le serveur n'a même jamais su que vous essayiez de vous connecter. Rien du côté Minecraft ne vous a rejeté, ni whitelist, ni ban, ni contrôle de version. Les paquets ne sont tout simplement pas arrivés jusqu'au serveur, ou la réponse du serveur n'est pas revenue jusqu'à vous.

C'est pour cette raison que getsockopt élimine d'emblée toute une catégorie de problèmes de connexion classiques sur Minecraft :

Ce n'est pas un ban (You are banned from this server est une autre erreur, qui s'affiche après la connexion).
Ce n'est pas la whitelist (You are not white-listed on this server! s'affiche lui aussi après la connexion).
Ce n'est pas un écart de version (Outdated client / Outdated server arrive après la fin du handshake TCP).
Ce ne sont pas les mods (une erreur de mod ressemble à Disconnected: Internal Exception, après une connexion réussie).
C'est aussi un message propre à l'édition Java, et à elle seule. Bedrock utilise RakNet sur UDP et signale ses échecs avec des messages du type Unable to connect to world ou Could not connect to server. Si vous lisez le mot getsockopt tel quel, vous êtes sur Java.

Cela étant posé, voici la liste des solutions, classées selon la fréquence à laquelle chacune règle le problème quand notre équipe de support 24/7 traite un ticket.

Quelles sont les causes de l'erreur Connection Timed Out: getsockopt ?

Grosso modo dans l'ordre de fréquence :

Le serveur est hors ligne, en cours de redémarrage ou encore en train de démarrer (l'écoute TCP n'est pas encore ouverte).
Mauvaise IP ou mauvais port : faute de frappe, sous-domaine obsolète, ou adresse play.example.com collée en oubliant un port personnalisé comme :25566.
Pare-feu local qui bloque le trafic sortant sur le port Minecraft, fréquent sous Windows après une mise à jour de Java qui déplace le chemin du binaire.
Cache DNS périmé qui renvoie votre client vers une ancienne IP après une migration de node.
Routeur ou NAT qui coupe la connexion, classique sur les réseaux d'hôtel, d'université et d'entreprise.
FAI qui bloque le port, ce qui arrive chez certains opérateurs mobiles et quelques FAI grand public qui filtrent les ports non standard.
VPN, proxy d'entreprise ou filtre réseau d'antivirus qui perturbe le handshake TCP.
Problème de routage entre votre FAI et le datacenter du serveur (rare, mais bien réel, et la seule solution est alors un transfert de node).

Déroulez les solutions ci-dessous dans l'ordre et vous couvrirez plus de 95 % des cas.

Solution 1 : vérifier que le serveur est vraiment en ligne

Avant de toucher au pare-feu ou de vider le cache DNS, commencez par l'évidence. Ouvrez votre panneau de contrôle et regardez l'indicateur d'état du serveur. Dans Pterodactyl (ce que nous utilisons chez DoomHosting, comme la plupart des hébergeurs sérieux), le panneau affiche un point vert quand le démon répond et que la JVM tourne. S'il est jaune (démarrage) ou rouge (hors ligne), l'écoute TCP n'est pas encore ouverte et tous les joueurs prendront un getsockopt pendant le boot.

Surveillez la console. La ligne que vous attendez est celle-ci :

[Server thread/INFO]: Done (X.XXXs)! For help, type "help"

Tant qu'elle n'apparaît pas, le serveur n'accepte aucune connexion. Générer un monde neuf ou appliquer un gros modpack peut allonger le démarrage à 60 secondes ou plus, laissez-lui le temps. Si la console reste bloquée sur Preparing spawn area: 50% pendant plusieurs minutes, la JVM est saturée : redémarrez avec plus de RAM ou consultez le guide pour corriger le lag d'un serveur Minecraft.

Pour les pannes globales touchant les serveurs d'authentification de Mojang, jetez un oeil à downdetector.com. Votre serveur dédié ne dépend plus de Mojang une fois le joueur connecté, mais un joueur qui se connecte pour la première fois avec un jeton de session tout frais échouera si les serveurs de session de Mojang sont à terre.

Solution 2 : vérifier l'IP et le port (et passer par l'IP brute pendant le diagnostic)

La cause de ticket numéro un : quelqu'un a collé le mauvais port, utilisé un sous-domaine qui n'a pas encore propagé, ou supposé le port 25565 par défaut alors que le serveur tourne sur un port personnalisé.

Dans votre panneau de contrôle, copiez l'adresse de connexion exactement telle qu'elle est affichée. Chez DoomHosting, elle apparaît sous la forme IP:PORT dans les allocations du serveur.
Dans Minecraft, allez dans Multijoueur, puis Connexion directe, et collez-la sans rien modifier.
Si votre serveur utilise le port par défaut 25565, le suffixe :25565 est facultatif. Pour tout le reste (:25566, :30000, etc.), le port est obligatoire.

Astuce de diagnostic essentielle : pendant le dépannage, collez l'IP brute, pas votre sous-domaine. Un sous-domaine ajoute la résolution DNS comme point de panne possible. Si l'IP brute fonctionne et pas le sous-domaine, votre problème vient du DNS (TTL pas encore expiré, enregistrement A qui pointe vers une IP obsolète), pas du serveur. Une fois l'IP brute validée, le sous-domaine se remettra à marcher dès que le DNS aura propagé (en général 5 à 30 minutes après une modification, jusqu'à 24 heures dans le pire des cas).

Si vous passez par un proxy NAT (certains hébergeurs low cost partagent une seule IP publique entre de nombreux serveurs), l'adresse de connexion publique peut différer de l'allocation interne. Collez toujours exactement ce que le panneau désigne comme adresse de connexion, n'essayez pas de la reconstituer.

Solution 3 : vider le cache DNS

Un DNS périmé, ça existe vraiment, surtout juste après une migration de node : l'IP du serveur change, mais votre ordinateur garde l'ancienne en cache pendant quelques heures. Videz-le :

# Windows (Command Prompt as Administrator):
ipconfig /flushdns

# macOS:
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder

# Linux (systemd-resolved):
sudo systemd-resolve --flush-caches
# Ubuntu 22.04 and newer:
sudo resolvectl flush-caches

Après avoir vidé le cache, fermez complètement le launcher Minecraft et relancez-le (pas seulement la liste des mondes). La JVM met les résolutions DNS en cache pour toute la durée de vie du processus : redémarrer le launcher force une nouvelle résolution.

Si vider le cache ne change rien, essayez d'ajouter 8.8.8.8 (Google) ou 1.1.1.1 (Cloudflare) comme serveur DNS dans les paramètres de votre carte réseau. Certains FAI font tourner un DNS capricieux qui renvoie parfois de mauvaises réponses.

Solution 4 : autoriser Java dans le pare-feu Windows

Windows empêche par défaut les nouvelles applications d'ouvrir des connexions sortantes, et chaque mise à jour de Java peut installer un nouveau javaw.exe à un chemin que l'ancienne règle de pare-feu ne couvre pas. Réautorisez le binaire actuel :

Paramètres → Mise à jour et sécurité → Sécurité Windows → Pare-feu et protection du réseau → Autoriser une application via le pare-feu.
Cliquez sur Modifier les paramètres, puis sur Autoriser une autre application.
Parcourez jusqu'à votre runtime Java et ajoutez à la fois java.exe et javaw.exe.
Cochez Privé et Public sur les deux lignes.
Cliquez sur OK et retentez la connexion.

L'emplacement de javaw.exe dépend de votre launcher :

Launcher Minecraft officiel (Microsoft Store) : C:\Users\<You>\AppData\Local\Packages\Microsoft.4297127D64EC6_8wekyb3d8bbwe\LocalCache\Local\runtime\java-runtime-gamma\windows-x64\java-runtime-gamma\bin\javaw.exe
Launcher officiel (installation autonome) : C:\Users\<You>\AppData\Roaming\.minecraft\runtime\java-runtime-gamma\windows-x64\java-runtime-gamma\bin\javaw.exe
Prism / MultiMC / Modrinth : ouvrez le launcher, Settings → Java, et copiez le chemin configuré. Ces launchers utilisent souvent un JDK installé séparément.
JDK installé séparément : en général C:\Program Files\Java\jdk-XX\bin\javaw.exe.

Les suites de sécurité tierces (Norton, McAfee, Avast, ESET) gèrent leur propre pare-feu par-dessus celui de Windows. Si vous en avez une, refaites la même autorisation dans son interface : les règles du pare-feu Windows ne s'y appliquent pas.

Solution 5 : tester un autre réseau (pour écarter le FAI et le routeur)

Le diagnostic le plus rapide pour savoir où se situe le problème, en 60 secondes : activez le partage de connexion de votre téléphone, connectez-y votre PC et retentez le serveur.

Ça marche en partage de connexion, pas en Wi-Fi maison → le problème vient de votre routeur ou de votre FAI. Redémarrez le routeur (solution 6) ou appelez votre FAI.
Ça échoue dans les deux cas → le problème vient de votre ordinateur (pare-feu, DNS, antivirus) ou du serveur lui-même.
Ça marche dans les deux cas chez vous, mais un ami n'arrive pas à se connecter → c'est son réseau qui pose problème, pas le vôtre ni celui du serveur.

Si le partage de connexion règle temporairement le souci, installez Cloudflare WARP (gratuit, sans compte) et refaites le test. WARP fait passer votre trafic TCP par le réseau de Cloudflare, ce qui contourne beaucoup de filtrages au niveau FAI. L'offre gratuite de ProtonVPN fait la même chose. Si le serveur répond avec un VPN mais pas sans, c'est que votre FAI filtre l'IP de destination : le cas est connu sur certaines plages de ports chez plusieurs opérateurs mobiles européens et une poignée de FAI grand public dans les pays les plus restrictifs.

Solution 6 : redémarrer le routeur et le PC

Bête, gratuit, souvent négligé, et souvent la réponse. Les routeurs grand public tiennent une table de traduction NAT qui se corrompt de temps en temps, surtout après plusieurs semaines d'uptime, de gros téléchargements ou du torrent. Une entrée périmée peut faire disparaître silencieusement le paquet SYN-ACK sur le chemin du retour vers votre PC, ce qui produit un getsockopt parfait alors que toutes vos autres connexions marchent très bien.

Coupez l'alimentation du routeur pendant 30 secondes (débranchez, attendez, rebranchez, pas un redémarrage logiciel). Redémarrez ensuite le PC. Puis retentez le serveur. Cette étape règle plus de cas qu'on ne l'imagine.

Solution 7 : vérifier si votre FAI bloque le port

Certains FAI filtrent le trafic sortant sur les ports non standard. Le test le plus rapide :

# Windows (PowerShell):
Test-NetConnection -ComputerName <server-ip> -Port <port>

# macOS / Linux:
nc -zv <server-ip> <port>

Un TcpTestSucceeded: True (Windows) ou un succeeded / open (macOS/Linux) signifie que le port est joignable depuis votre réseau. Si vous obtenez False, Connection timed out ou filtered, quelque chose entre vous et le serveur le bloque.

Refaites le même test sur le partage de connexion de votre téléphone. Si ça passe en 4G et pas en Wi-Fi maison, le coupable est votre FAI. La solution la plus propre est de demander à votre hébergeur (ou de le changer vous-même, si vous auto-hébergez) de faire écouter le serveur sur un port courant comme le 25565 par défaut, que la plupart des FAI autorisent explicitement. Chez DoomHosting, nous changeons le port de votre allocation depuis un ticket de support en moins de 5 minutes.

Solution 8 : demander un transfert de node (en dernier recours)

Si toutes les solutions précédentes ont échoué, que plusieurs joueurs sur des FAI différents voient tous getsockopt, et que le panneau indique le serveur en ligne avec un port joignable depuis le réseau de l'hébergeur, le problème se situe au niveau du routage : le trafic entre certaines régions et le node qui héberge votre serveur n'aboutit pas. La solution est de déplacer le serveur sur un autre node.

Contactez le support de votre hébergeur et demandez un transfert de node. Chez DoomHosting, c'est gratuit et notre équipe 24/7 s'en occupe sans perte de données : votre monde, vos configurations, vos plugins et vos données joueurs vous suivent.

Attention : un transfert de node change l'adresse IP de votre serveur et peut aussi en changer le port. Après le transfert, il faudra rajouter le serveur dans votre liste Multijoueur avec la nouvelle adresse, mettre à jour l'enregistrement A ou le CNAME du sous-domaine que vous auriez configuré (la propagation DNS peut prendre jusqu'à 24 heures) et communiquer la nouvelle adresse à vos joueurs. Faites toujours une sauvegarde de votre monde avant de demander un transfert : la plupart des hébergeurs le font automatiquement, mais vérifiez-le.

Le cas du LAN, de Hamachi et de `getsockopt` sur réseau local

Si vous voyez getsockopt en essayant de vous connecter en LAN (un ami a ouvert son monde au réseau local, ou vous utilisez Hamachi / Radmin VPN pour jouer "en local" avec quelqu'un via Internet), les mêmes règles TCP s'appliquent, mais les coupables habituels sont un peu différents :

L'adaptateur Hamachi/Radmin n'était pas connecté avant que l'hôte n'ouvre au LAN. Relancez les deux, connectez Hamachi d'abord, puis ouvrez le monde.
La règle de pare-feu Java de l'hôte autorise les réseaux publics mais pas les privés, ou l'inverse. Cochez les deux pour javaw.exe (solution 4).
Le profil Wi-Fi de l'hôte est réglé sur Public (que Windows considère comme non fiable et verrouille par défaut). Paramètres → Réseau et Internet → passez le profil du réseau actif sur Privé.
Sous-réseaux différents : si vous êtes en 192.168.1.x et l'autre en 192.168.0.x, la découverte LAN automatique ne fonctionnera pas. Utilisez la connexion directe avec l'IP réelle de l'hôte et le port LAN aléatoire ouvert par sa session.

Toujours bloqué sur "Connection Timed Out: getsockopt" ?

Si vous avez épuisé toutes les solutions et que l'erreur persiste, il est temps de faire remonter. L'équipe de support 24/7 de DoomHosting peut extraire des traces TCP depuis le node du serveur pour identifier exactement où la connexion est coupée, souvent en quelques minutes. Nous hébergeons sur du matériel Ryzen 9 avec protection DDoS complète, installation instantanée et installation en un clic de Forge / Fabric / Paper / Spigot, à partir de 5 $/mois.

FAQ

Que signifie exactement "Connection Timed Out: getsockopt" dans Minecraft ?

C'est une erreur de l'édition Java qui indique que le client Minecraft a tenté d'ouvrir une socket TCP vers l'IP et le port de votre serveur, mais que la connexion n'a jamais abouti. La partie getsockopt désigne l'appel système Java/OS qui a signalé le timeout : ce n'est pas du code propre à Minecraft, c'est la couche réseau de Java qui abandonne après avoir attendu une trentaine de secondes une réponse du serveur.

L'erreur getsockopt vient-elle de moi ou du serveur ?

En général de vous, mais pas toujours. Si plusieurs joueurs sur des réseaux différents voient getsockopt en même temps, c'est que le serveur est hors ligne ou que son IP publique est fausse : la responsabilité est côté serveur. Si vous êtes le seul concerné, c'est presque toujours quelque chose entre votre ordinateur et le serveur : pare-feu, DNS, routage FAI, antivirus, ou une mauvaise IP / un mauvais port dans le champ de connexion directe.

"Connection Timed Out: getsockopt" veut-il dire que je suis ban ?

Non. Un ban produit une autre erreur, You are banned from this server, après l'établissement de la connexion. Même chose pour un refus de whitelist (You are not white-listed on this server!) et un écart de version (Outdated client / Outdated server). Tout cela arrive une fois le handshake TCP terminé. getsockopt, lui, échoue avant même que le serveur sache que vous avez essayé de vous connecter.

Un VPN corrige-t-il l'erreur getsockopt ?

Parfois. Si votre FAI bloque le port de destination ou route mal vers le datacenter du serveur, un VPN emprunte un autre chemin et contourne le problème. Si la cause est votre pare-feu local, une mauvaise IP ou un cache DNS périmé, le VPN ne servira à rien. Essayez Cloudflare WARP en premier : gratuit, sans compte, et largement suffisant pour le test.

Pourquoi getsockopt n'apparaît-il que sur un serveur Minecraft précis ?

Parce que le problème se situe entre votre réseau et l'IP de ce serveur-là, pas dans votre client. Chaque serveur Minecraft vit sur une IP différente, dans un datacenter différent, derrière des opérateurs de transit différents (Hetzner, OVH, Equinix, AWS, etc.). Si votre FAI a un souci de routage avec l'un d'eux seulement, vous verrez getsockopt sur les serveurs hébergés là et vous vous connecterez normalement partout ailleurs. Un VPN, ou un transfert vers un autre node, règle généralement la question.

"Connection Timed Out: getsockopt" existe-t-il sur Minecraft Bedrock ?

Non. L'édition Bedrock utilise une autre pile réseau (RakNet sur UDP) et signale ses échecs de connexion avec des messages du type "Unable to connect to world" ou "Could not connect to server". Si vous lisez littéralement getsockopt dans l'erreur, vous êtes sur l'édition Java. Les solutions ci-dessus ne s'appliquent pas telles quelles à Bedrock : pour les problèmes de connexion Bedrock, voyez notre guide pour rejoindre un serveur Minecraft Bedrock.