Comment ouvrir les ports d'un serveur Minecraft (25565, 19132, proxy)
Si vos amis n'arrivent pas à se connecter alors que la console du serveur affiche « Done », la cause est le plus souvent un port resté fermé dans le pare-feu. Dans ce guide, vous apprendrez à ouvrir le port 25565 TCP (Java), le port 19132 (Bedrock et Geyser) et le port du proxy BungeeCord/Velocity dans le pare-feu Windows Defender, ufw et firewalld, à tester la connexion depuis l'extérieur et à masquer le port derrière un nom de domaine grâce à un enregistrement SRV.
Avant de commencer
- Un serveur Minecraft en cours d'exécution (Vanilla, Paper, Spigot, Purpur ou Bedrock Dedicated Server). Si vous n'en avez pas encore installé, suivez d'abord le guide Comment installer un serveur Minecraft à partir de zéro.
- Un accès administrateur au serveur : le compte Administrator via RDP (3389) sur un VDS Windows, ou root ou un utilisateur disposant des droits sudo via SSH (22) sur un VDS Linux.
- L'adresse IPv4 publique de votre serveur. Chaque serveur VDS HanHosting est fourni avec 1 adresse IPv4 ; vous la trouverez sur la page du service dans l'Espace client et dans l'e-mail d'activation.
- L'Espace client ne comporte pas d'écran d'ouverture de ports ; les ports s'ouvrent dans le pare-feu du système d'exploitation lui-même. La redirection de port (NAT) sur un modem ou une box n'est nécessaire que pour les serveurs hébergés à domicile.
1. Déterminez le port et le protocole à ouvrir
Le port et le protocole dépendent du logiciel : Java utilise TCP et Bedrock Dedicated Server utilise UDP, tandis que Geyser utilise le port 19132 à la fois en TCP et en UDP. Une règle ouverte avec le mauvais protocole ne laissera pas entrer les joueurs.
| Logiciel | Port par défaut | Protocole | Emplacement du réglage |
|---|---|---|---|
| Java Edition (Vanilla, Paper, Spigot, Purpur) | 25565 | TCP | server.properties → server-port |
| Bedrock Dedicated Server | 19132 (IPv6 : 19133) | UDP | server.properties → server-port, server-portv6 |
| Geyser (permet aux joueurs Bedrock de rejoindre un serveur Java) | 19132 | TCP + UDP | Geyser config.yml → bedrock → port |
| Proxy BungeeCord | 25577 | TCP | config.yml → listeners → host |
| Proxy Velocity | 25565 | TCP | velocity.toml → bind |
| Query (informations sur le serveur, facultatif) | 25565 | UDP | enable-query, query.port |
| RCON (console à distance, facultatif) | 25575 | TCP | enable-rcon, rcon.port |
Query et RCON sont désactivés par défaut (false) ; si vous ne les avez pas activés, n'ajoutez pas de règles pour eux. Si vous activez RCON, limitez son port à votre seule adresse IP.
2. Vérifiez le port dans server.properties
Vérifiez d'abord dans le fichier server.properties sur quel port le serveur écoute :
server-port=25565
server-ip=
Dans une installation à serveur unique, laissez la ligne server-ip vide ; lorsqu'elle est vide, le serveur écoute sur toutes les interfaces réseau, alors qu'une adresse IP erronée est la cause la plus fréquente de l'erreur « Failed to bind to port ». Si vous changez le port (par exemple pour 25566), mettez à jour la règle du pare-feu avec le même numéro et redémarrez le serveur ; le fichier n'est lu qu'au démarrage.
Pendant que le serveur tourne, vérifiez sur le serveur lui-même que le port est bien en écoute. Sous Linux :
ss -tulpn
Sous Windows, dans PowerShell ou dans l'invite de commandes :
netstat -ano -p tcp
Si la sortie ne contient aucune ligne se terminant par :25565 avec l'état LISTEN (LISTENING sous Windows), le problème vient du serveur et non du pare-feu ; consultez d'abord le fichier logs/latest.log. Pour UDP, utilisez netstat -ano -p udp.
3. Ouvrir un port dans le pare-feu Windows Defender
Interface graphique : tapez wf.msc dans le menu Démarrer et appuyez sur Entrée ; la console « Windows Defender Firewall with Advanced Security » (pare-feu Windows Defender avec fonctions avancées de sécurité) s'ouvre.
- Sélectionnez Inbound Rules (règles de trafic entrant) dans le volet de gauche, puis cliquez sur New Rule (nouvelle règle) dans le volet de droite.
- Choisissez Port comme type de règle.
- Sélectionnez TCP et saisissez
25565dans le champ « Specific local ports » (ports locaux spécifiques). - Laissez Allow the connection (autoriser la connexion) sélectionné.
- Sur la page « Profile », laissez cochées les trois cases « Domain », « Private » et « Public » ; le profil réseau d'un VDS est généralement détecté comme « Public », si bien qu'une règle attribuée au seul profil « Private » reste sans effet.
- Donnez à la règle un nom explicite, par exemple « Minecraft Java 25565 », puis cliquez sur « Finish ».
Pour Bedrock, relancez l'assistant, cette fois avec UDP et 19132 (Geyser a aussi besoin du port TCP 19132, voir l'étape 6) ; une règle de port est soit TCP, soit UDP.
PowerShell : dans une fenêtre PowerShell ouverte en tant qu'administrateur, vous pouvez créer les mêmes règles avec des commandes ; les paramètres sont expliqués dans la documentation de New-NetFirewallRule de Microsoft.
New-NetFirewallRule -DisplayName "Minecraft Java 25565" -Direction Inbound -Protocol TCP -LocalPort 25565 -Action Allow -Profile Any
New-NetFirewallRule -DisplayName "Minecraft Bedrock 19132" -Direction Inbound -Protocol UDP -LocalPort 19132 -Action Allow -Profile Any
Pour plusieurs ports ou une plage, le format -LocalPort 25565,25570-25575 est valide. Vous pouvez afficher la règle avec Get-NetFirewallRule -DisplayName "Minecraft*" et la supprimer avec Remove-NetFirewallRule -DisplayName "Minecraft Java 25565".
4. Ouvrir des ports avec ufw sous Linux (Ubuntu et Debian)
ufw est l'outil de configuration du pare-feu par défaut d'Ubuntu. Il est désactivé après l'installation ; comme la politique entrante par défaut est « deny » (refuser), tout ce que vous n'avez pas autorisé est fermé dès que vous l'activez. S'il n'est pas installé sous Debian, installez-le d'abord avec sudo apt install ufw. L'ordre compte : SSH d'abord, puis Minecraft, et l'activation en dernier. Les détails se trouvent dans la documentation d'Ubuntu Server.
sudo ufw allow 22/tcp
sudo ufw allow 25565/tcp
sudo ufw allow 19132/udp
sudo ufw enable
sudo ufw status verbose
Si vous sautez la règle SSH et exécutez ufw enable, votre session ouverte risque de tomber et les nouvelles connexions SSH sont refusées. Dans ce cas, connectez-vous au serveur avec la console VNC de l'Espace client et exécutez sudo ufw allow 22/tcp pour rétablir l'accès. Pour supprimer une règle, placez delete devant elle ou utilisez son numéro :
sudo ufw delete allow 25565/tcp
sudo ufw status numbered
sudo ufw delete 3
5. Ouvrir des ports avec firewalld sous Linux (AlmaLinux et CentOS)
Les distributions de la famille RHEL sont fournies avec firewalld à la place d'ufw. Si la sortie de sudo firewall-cmd --state n'est pas running, démarrez le service avec sudo systemctl enable --now firewalld ; la zone par défaut public autorise déjà SSH. Ajoutez ensuite les ports de façon permanente et rechargez les règles :
sudo firewall-cmd --permanent --zone=public --add-port=25565/tcp
sudo firewall-cmd --permanent --zone=public --add-port=19132/udp
sudo firewall-cmd --reload
sudo firewall-cmd --zone=public --list-ports
Une règle ajoutée sans --permanent est perdue au redémarrage, tandis qu'une règle ajoutée avec --permanent ne prend effet qu'après l'exécution de --reload. Pour retirer un port, écrivez --remove-port=25565/tcp et exécutez à nouveau --reload. Si votre zone par défaut est différente, affichez-la avec firewall-cmd --get-default-zone et modifiez la valeur de --zone.
6. Le port 19132 pour Bedrock et Geyser
Le Bedrock Dedicated Server officiel utilise UDP et est livré avec server-port=19132 (IPv4) et server-portv6=19133 (IPv6) ; pour lui, une règle 19132 UDP suffit.
Pour accueillir des joueurs Bedrock sur votre serveur Java, vous installez Geyser dans le dossier plugins sous Paper/Spigot ou, si vous avez un proxy, uniquement sur le proxy (BungeeCord ou Velocity) ; pour les joueurs sans compte Java, vous ajoutez Floodgate en complément. Dans les versions actuelles de Geyser, les joueurs découvrent le serveur en TCP et jouent en UDP ; c'est pourquoi la page d'installation officielle demande d'ouvrir le port 19132 à la fois en TCP et en UDP. Si vous n'ouvrez que l'UDP, le serveur n'apparaîtra pas dans la liste. En plus de la règle UDP, avec ufw :
sudo ufw allow 19132/tcp
Avec firewalld :
sudo firewall-cmd --permanent --zone=public --add-port=19132/tcp
sudo firewall-cmd --reload
Sous Windows, avec PowerShell :
New-NetFirewallRule -DisplayName "Geyser 19132 TCP" -Direction Inbound -Protocol TCP -LocalPort 19132 -Action Allow -Profile Any
Si vous choisissez transport: both dans la configuration de Geyser, ouvrez aussi un port UDP distinct pour webrtc-port. Comme l'édition Bedrock ne permet pas de se connecter sans préciser de port, un enregistrement SRV (étape 9) n'est d'aucune utilité aux joueurs Bedrock ; donnez-leur le port 19132 en même temps que l'adresse.
7. BungeeCord et Velocity : ouvrez le port du proxy, fermez les serveurs backend
Si vous utilisez BungeeCord ou Velocity pour servir plusieurs serveurs depuis une seule adresse, le seul port à ouvrir vers l'extérieur est celui du proxy. Par défaut, BungeeCord écoute sur le port 25577 via host: 0.0.0.0:25577 dans config.yml, et Velocity écoute sur le port 25565 via bind dans velocity.toml. Si vous ne voulez pas que les joueurs aient à saisir un port, réglez cette valeur sur 0.0.0.0:25565 dans BungeeCord et attribuez aux serveurs backend des ports comme 25566 et 25567.
Les serveurs placés derrière un proxy tournent avec online-mode=false ; quiconque les atteint directement pourrait entrer sous le nom d'un autre joueur, c'est pourquoi la documentation de Velocity recommande explicitement un pare-feu. Si le proxy et les serveurs backend se trouvent sur le même VDS, écrivez server-ip=127.0.0.1 dans le fichier server.properties des serveurs backend et définissez-les dans la configuration du proxy sous la forme 127.0.0.1:25566. Ainsi, seul le proxy peut les atteindre, et vous n'ouvrez pas de règles pour 25566 et 25567. Pour le réglage de transmission des informations des joueurs (ip_forward: true dans BungeeCord, « player info forwarding » dans Velocity), consultez le guide Comment créer un réseau de serveurs Minecraft avec Velocity et BungeeCord.
8. Testez le port depuis l'extérieur
Lancez le test depuis votre propre ordinateur ; un test exécuté sur le serveur lui-même peut contourner le pare-feu. Le serveur doit être en cours d'exécution ; si aucun programme n'écoute, le port apparaît fermé même lorsque la règle est correcte. Remplacez 203.0.113.10 par l'adresse IP de votre serveur.
Depuis Windows (PowerShell) :
Test-NetConnection -ComputerName 203.0.113.10 -Port 25565
Si vous voyez TcpTestSucceeded : True dans la sortie, le côté TCP est en ordre. Depuis Linux ou macOS :
nc -zv 203.0.113.10 25565
Pour UDP, ces outils sont trompeurs : Test-NetConnection ne teste que TCP, et nc -uz indique toujours un succès, quel que soit l'état de la cible. Le test le plus fiable pour le port 19132 UDP consiste à se connecter depuis un client Bedrock ; vous pouvez tester séparément le port TCP de Geyser avec les commandes ci-dessus. Enfin, dans le client Minecraft, ouvrez « Multijoueur → Ajouter un serveur », saisissez 203.0.113.10:25565 et vérifiez que le serveur répond dans la liste.
9. Masquez le port avec un nom de domaine et un enregistrement SRV
Si vous voulez que les joueurs saisissent play.example.com au lieu de 203.0.113.10:25566, deux enregistrements DNS suffisent : un enregistrement A pointant vers l'adresse IP du serveur (par exemple mc.example.com) et l'enregistrement SRV que le client Java interroge :
| Champ | Valeur | Description |
|---|---|---|
| Nom | _minecraft._tcp.play | Service _minecraft, protocole _tcp, suivis du sous-domaine que les joueurs saisiront |
| Priorité | 0 | Laissez 0 pour un serveur unique |
| Poids | 5 | Sans importance pour un serveur unique |
| Port | 25566 | Le port réel du serveur |
| Cible | mc.example.com | Le nom de l'enregistrement A ; un nom de domaine, pas une adresse IP |
Une fois l'enregistrement propagé, le client récupère le port dans l'enregistrement SRV. L'enregistrement SRV est public : il ne dissimule pas le port, il évite seulement aux joueurs d'avoir à le saisir. Il ne remplace pas non plus le pare-feu ; le port 25566 doit toujours être ouvert. Si vous utilisez Cloudflare, l'enregistrement A ne doit pas passer par le proxy (nuage gris, « DNS only ») ; le nuage orange ne laisse passer que certains ports HTTP/HTTPS. Pour plus de détails, consultez le guide DNS et configuration du nom de domaine.
Exemple de jeu de règles : trois configurations types
| Scénario | Ouvert dans le pare-feu | Reste fermé |
|---|---|---|
| Serveur Java unique (Paper) | 25565/TCP, plus 22/TCP ou 3389/TCP pour l'administration | 25575 RCON, 25565 UDP (si Query est désactivé) |
| Java + Geyser/Floodgate | 25565/TCP, 19132/TCP et UDP, port d'administration | RCON et Query |
| Velocity + lobby + survie (même VDS) | 25565/TCP (proxy), port d'administration | 25566, 25567 (serveurs backend en server-ip=127.0.0.1) |
Pour n'ouvrir le port d'administration qu'à votre propre adresse IP, ajoutez d'abord dans ufw la règle sudo ufw allow proto tcp from YOUR_IP to any port 22, puis supprimez la règle générale avec sudo ufw delete allow 22/tcp. Sous Windows, cela se fait dans l'onglet « Scope » (étendue) des propriétés de la règle.
Erreurs fréquentes
- « Connection timed out » (délai de connexion dépassé) : aucune réponse ne revient ; le plus souvent, la règle du pare-feu est absente ou a été ouverte avec le mauvais protocole. Sous Windows, vérifiez que la règle est activée dans les trois profils.
- « Connection refused » (connexion refusée) : le trafic traverse le pare-feu, mais aucun programme n'écoute sur le port. Le serveur a planté, n'a pas encore démarré ou tourne sur un autre port ; vérifiez avec les commandes de l'étape 2.
- « Failed to bind to port » : une adresse IP erronée a été saisie dans le champ
server-ip, ou une autre instance du serveur utilise le même port. Videz la ligne ; attribuez un port différent au second serveur. - Les joueurs Java peuvent entrer, mais pas les joueurs Bedrock : la règle UDP pour le port 19132 est absente, ou seul le TCP a été ouvert. Bedrock Dedicated Server a besoin d'UDP ; Geyser a besoin à la fois de TCP et d'UDP.
- Le nom de domaine ne fonctionne pas, mais l'adresse IP oui : une adresse IP a été saisie comme cible SRV, l'enregistrement A est absent ou le proxy Cloudflare est resté activé.
Questions fréquentes
Dois-je utiliser un autre port que 25565 ?
Ce n'est pas obligatoire ; cependant, les outils de scan automatiques essaient surtout le port par défaut. Avec un port différent et un enregistrement SRV, rien ne change pour les joueurs, et les tentatives de connexion inutiles diminuent. Le filtrage DDoS de StormWall et d'OVH sur le réseau HanHosting fonctionne au niveau du réseau ; changer de port ne le remplace pas, cela réduit seulement le bruit.
Dois-je ouvrir à la fois TCP et UDP ?
Pas pour Java ; le port 25565 TCP suffit, et si vous avez activé Query, il vous faut aussi l'UDP sur le même numéro. Bedrock Dedicated Server n'a besoin que d'UDP, tandis que Geyser utilise le port 19132 à la fois en TCP et en UDP. Laisser ouvert un protocole inutile ne fait qu'élargir la surface d'attaque ; désactiver entièrement le pare-feu, en revanche, expose tout à Internet, RDP et SSH compris.
J'ai ouvert le port, mais personne ne peut encore se connecter. Que faire ensuite ?
Vérifiez dans cet ordre : le serveur tourne-t-il et la console a-t-elle affiché « Done » ; le port est-il en écoute dans la sortie de ss ou de netstat ; et le test TCP externe réussit-il ? Si ces trois points sont en ordre, le problème se situe très probablement du côté du joueur : version du jeu incompatible, faute de frappe dans l'adresse ou restriction sur le réseau du joueur. Si vous ne parvenez pas à le résoudre, ouvrez un ticket d'assistance depuis l'Espace client en joignant le journal du serveur et la sortie du test.
Guides associés
- Comment installer un serveur Minecraft à partir de zéro : Paper sous Windows et Linux
- Comment créer un réseau de serveurs Minecraft avec Velocity et BungeeCord
- Comment gérer le pare-feu d'un VDS : règles, fail2ban et journaux
- Qu'est-ce que VNC (console web) et comment l'utiliser en cas d'oubli du mot de passe ?
- Serveurs VDS HanHosting : guide DNS et configuration du nom de domaine
Pour d'autres guides Minecraft, consultez la page Guides Minecraft ; pour les options de serveur, consultez la page Location de serveur Minecraft.
Commentaires0
Pas encore de commentaire
Soyez le premier à partager votre avis.
Veuillez vous connecter ou vous inscrire pour laisser un commentaire.