Aller au contenu
+90 850 303 07 52 [email protected]
Assistance Espace client
Sur une sélection d'offres d'hébergement annuelles et de VDS sur 3 mois, nom de domaine .com / .com.tr offert la première année · Voir les offres

Guides

Des guides pas à pas pour installer et gérer votre propre serveur, serveur de jeu ou site web, rédigés par l'équipe qui exploite notre infrastructure à Istanbul.

Minecraft

Comment créer un réseau de serveurs Minecraft avec Velocity et BungeeCord

26 août 2026 14 min de lecture Mis à jour :
Partager cet article

Dans ce guide, vous allez mettre en place un réseau proxy qui réunit plusieurs serveurs Minecraft, par exemple un lobby (où les joueurs attendent), un serveur survie et des mini-jeux, sous une seule adresse IP. Vous configurerez pas à pas Velocity, le choix moderne, verrez comment monter le même réseau avec BungeeCord, et traiterez avec des règles de pare-feu la partie la plus critique : faire en sorte que les serveurs backend ne soient accessibles qu'à travers le proxy.

Avant de commencer

  • Un VDS : le script de démarrage d'exemple de PaperMC attribue 1 Go de mémoire à Velocity, mais comme chaque serveur backend est un processus Java distinct, prévoyez au moins 8 Go de RAM pour un réseau de trois serveurs comme lobby, survie et mini-jeux. La gamme VDS AMD Ryzen 9 9950X propose des options de 2 à 64 Go de RAM DDR5 ; consultez la page Location de serveur Minecraft pour toutes les options.
  • Java : Velocity nécessite au moins Java 25 ; les builds actuels de BungeeCord nécessitent au moins Java 17. Une seule installation de Java 25 couvre les deux proxys ainsi que les versions actuelles de Paper.
  • Au moins deux serveurs Paper fonctionnels : si vous n'avez pas encore de serveur, commencez par le guide Comment installer un serveur Minecraft à partir de zéro : Paper sous Windows et Linux ; les autres sujets se trouvent sur la page Guides Minecraft. Le modern forwarding de Velocity est intégré à Paper 1.14 et aux versions ultérieures ; Spigot ne le prend pas en charge.
  • Accès au serveur : vous vous connectez à un VDS Linux via SSH (22) et à un VDS Windows via RDP (3389). Vous gérez vous-même le pare-feu depuis le système d'exploitation.
  • Vigilance sur la sécurité : dans un réseau proxy, les serveurs backend tournent avec online-mode=false ; si vous sautez l'étape 6, n'importe qui peut rejoindre directement un serveur backend sous le pseudo de joueur de son choix.

Les deux proxys font le même travail ; la différence tient au modèle de sécurité et à l'écosystème de plugins.

CaractéristiqueVelocityBungeeCord
DéveloppeurPaperMCSpigotMC
Java requisAu moins Java 25Au moins Java 17
Port par défaut2556525577
Fichier de configurationvelocity.tomlconfig.yml
Transmission des infos joueurmodern (avec clé secrète), legacy, bungeeguardip_forward (sans clé ; une clé nécessite le plugin BungeeGuard)
PluginsSa propre API de plugins ; les plugins BungeeCord ne fonctionnent pasPlugins BungeeCord
RecommandationNouvelles installationsSi vous dépendez d'un plugin BungeeCord auquel vous ne pouvez pas renoncer

1. Planifiez le réseau et les ports

La logique d'un réseau proxy est simple : les joueurs se connectent uniquement au port du proxy, et le proxy les dirige vers les serveurs backend. Le port du proxy doit être le seul port ouvert vers l'extérieur ; les serveurs backend ne doivent écouter que sur l'adresse locale 127.0.0.1.

ComposantAdresse d'écoutePortOuvert sur Internet ?
Proxy (Velocity ou BungeeCord)0.0.0.0 (l'IP du VDS)25565 TCPOui
lobby127.0.0.125566 TCPNon
survival127.0.0.125567 TCPNon
minigames127.0.0.125568 TCPNon

Les numéros de port sont des exemples ; la configuration par défaut de Velocity utilise les ports 30066–30068, et n'importe quel port libre convient. Placez chaque serveur dans son propre dossier, par exemple /opt/mc/proxy, /opt/mc/lobby sous Linux et C:\mc\proxy, C:\mc\lobby sous Windows. L'adresse que vous donnez aux joueurs est l'IP du VDS ou un nom de domaine que vous faites pointer vers elle ; 25565 étant le port par défaut, les joueurs n'ont pas besoin de saisir de port.

2. Installez Java

PaperMC recommande la distribution Amazon Corretto 25. Sur Ubuntu/Debian, exécutez ces commandes dans l'ordre :

sudo apt-get update
sudo apt-get install ca-certificates apt-transport-https gnupg wget
wget -O - https://apt.corretto.aws/corretto.key | sudo gpg --dearmor -o /usr/share/keyrings/corretto-keyring.gpg && \
echo "deb [signed-by=/usr/share/keyrings/corretto-keyring.gpg] https://apt.corretto.aws stable main" | sudo tee /etc/apt/sources.list.d/corretto.list
sudo apt-get update
sudo apt-get install -y java-25-amazon-corretto-jdk libxi6 libxtst6 libxrender1

Sous Windows, téléchargez l'installateur JDK Windows x64 d'Amazon Corretto 25 (https://corretto.aws/downloads/latest/amazon-corretto-25-x64-windows-jdk.msi) et installez-le avec les options par défaut. Sur l'un ou l'autre système, ouvrez un nouveau terminal et vérifiez :

java -version

La première ligne de la sortie doit commencer par openjdk version "25, et la dernière ligne doit contenir 64-Bit. N'utilisez pas les paquets Java dont le nom contient -headless ; PaperMC ne les recommande pas.

3. Préparez les serveurs backend (Paper)

Dans le dossier de chaque serveur backend, ouvrez le fichier server.properties et modifiez trois lignes selon votre plan (exemple pour le lobby) :

server-port=25566
server-ip=127.0.0.1
online-mode=false

online-mode=false est nécessaire, car c'est désormais le proxy qui gère l'authentification des comptes Mojang, et le serveur backend ne peut pas effectuer une seconde authentification. server-ip=127.0.0.1 rend le serveur accessible uniquement depuis la même machine ; la page de sécurité de PaperMC recommande cette méthode lorsque tous les serveurs se trouvent sur une seule machine.

Le fait de transmettre l'IP réelle et l'UUID du joueur du proxy au serveur backend s'appelle l'IP forwarding. Pour que cela fonctionne, vous devez aussi activer sur le serveur backend le réglage correspondant à votre type de proxy.

Pour Velocity (modern forwarding), complétez ainsi la section proxies du fichier config/paper-global.yml sur chaque serveur backend :

proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: "CONTENTS-OF-THE-forwarding.secret-FILE"

La valeur secret doit être exactement identique au contenu du fichier forwarding.secret qui sera créé dans le dossier du proxy à l'étape 4, et la valeur online-mode doit correspondre à online-mode dans velocity.toml. Vérifiez aussi que, dans le fichier spigot.yml, settings.bungeecord reste à false. Les modes de transmission sont expliqués en détail sur la page de PaperMC consacrée à la transmission des informations des joueurs.

Pour BungeeCord, en revanche, dans le fichier spigot.yml, réglez settings.bungeecord: true, et dans config/paper-global.yml, laissez proxies.bungee-cord.online-mode identique au réglage online_mode de votre proxy (true). La page d'installation de SpigotMC demande également de régler connection-throttle dans bukkit.yml sur -1. N'activez pas les deux méthodes de transmission à la fois ; si bungeecord: true reste activé alors que Velocity utilise le modern forwarding, les joueurs ne peuvent pas se connecter.

Redémarrez ensuite chaque serveur backend.

4. Installez et configurez Velocity

Téléchargez la dernière version stable de Velocity depuis https://papermc.io/downloads/velocity et placez-la dans le dossier du proxy ; la procédure d'installation officielle se trouve sur la page de démarrage Velocity de PaperMC. Sous Linux, créez un fichier start.sh avec les flags recommandés par PaperMC :

#!/bin/sh
java -Xms1G -Xmx1G -XX:+UseG1GC -XX:G1HeapRegionSize=4M -XX:+UnlockExperimentalVMOptions -XX:+ParallelRefProcEnabled -XX:+AlwaysPreTouch -XX:MaxInlineLevel=15 -jar velocity*.jar

Sous Linux, rendez le script exécutable avec chmod u+x start.sh et lancez-le avec ./start.sh. Sous Windows, écrivez dans un fichier start.bat, dans l'ordre : @echo off, la même ligne java mais se terminant par -jar velocity.jar, et pause ; renommez aussi le fichier téléchargé en velocity.jar. Le premier lancement génère les fichiers velocity.toml et forwarding.secret ; lorsque vous voyez dans la console Listening on ...:25565 suivi de la ligne Done, tapez shutdown pour arrêter le proxy.

Modifiez maintenant le fichier velocity.toml. Les lignes importantes :

bind = "0.0.0.0:25565"
motd = "<#09add3>Your Network Name"
show-max-players = 500
online-mode = true
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"

[servers]
lobby = "127.0.0.1:25566"
survival = "127.0.0.1:25567"
minigames = "127.0.0.1:25568"
try = [
    "lobby"
]

[forced-hosts]
"survival.example.com" = [
    "survival"
]

Signification des lignes :

  • bind : l'adresse et le port sur lesquels le proxy écoute ; 0.0.0.0 signifie écouter sur toutes les IP du VDS.
  • online-mode = true : les joueurs sont authentifiés auprès de Mojang. Le passer à false ouvre tout le réseau aux comptes crackés.
  • player-info-forwarding-mode = "modern" : l'IP réelle et l'UUID du joueur sont signés avec la clé secrète et transmis au serveur backend. La valeur par défaut est "NONE" : modifiez impérativement cette ligne.
  • forwarding-secret-file : le fichier qui contient la clé secrète. Le fichier doit être en UTF-8 et ne doit pas être vide ; copiez son contenu dans le champ secret de l'étape 3 et ne le partagez avec personne.
  • [servers] et try : les serveurs du réseau, et les serveurs à essayer dans l'ordre lorsqu'un joueur se connecte ou est expulsé d'un serveur. Placez le lobby en premier.
  • [forced-hosts] : envoie directement vers ce serveur un joueur qui se connecte avec un nom de domaine précis ; facultatif.

Enregistrez le fichier et redémarrez le proxy. Par la suite, vous pourrez recharger la configuration avec /velocity reload, soit depuis la console, soit en jeu depuis un compte disposant de la permission velocity.command.reload ; si le fichier contient une erreur de syntaxe, la commande n'applique aucune modification.

5. Alternative : monter le même réseau avec BungeeCord

Si vous avez choisi BungeeCord, téléchargez le dernier build depuis le serveur de builds indiqué sur la page d'installation de BungeeCord de SpigotMC (https://ci.md-5.net/job/BungeeCord/) et placez-le dans le dossier du proxy sous le nom BungeeCord.jar. Script de démarrage (Linux) :

#!/bin/sh
cd "$( dirname -- "$0" )"
java -Xms512M -Xmx512M -jar BungeeCord.jar

Sous Windows, écrivez ces lignes dans un fichier start.bat, dans l'ordre : @echo off, java -Xms512M -Xmx512M -jar BungeeCord.jar et pause. Le premier lancement génère config.yml ; modifiez les sections importantes selon votre plan :

online_mode: true
ip_forward: true
listeners:
- host: 0.0.0.0:25565
  query_port: 25565
  motd: '&1Your Network Name'
  max_players: 500
  priorities:
  - lobby
  force_default_server: false
servers:
  lobby:
    address: 127.0.0.1:25566
    restricted: false
  survival:
    address: 127.0.0.1:25567
    restricted: false
  minigames:
    address: 127.0.0.1:25568
    restricted: false

La ligne ip_forward: true est obligatoire : SpigotMC indique que, si ce réglage est désactivé, les UUID online-mode, les changements de pseudo et les bannissements d'IP provoqueront de graves incohérences de données. Le port par défaut est 25577 ; nous avons réglé la valeur host sur 25565 pour que les joueurs n'aient pas à saisir de port. priorities est l'équivalent de la liste try de Velocity ; un serveur réglé sur restricted: true n'est accessible qu'aux joueurs disposant de la permission bungeecord.server.<servername>.

La transmission de BungeeCord n'utilise pas de clé secrète ; le plugin BungeeGuard peut servir de protection supplémentaire. Avec BungeeCord, le pare-feu de l'étape 6 est encore plus critique.

6. Rendez les serveurs backend accessibles uniquement depuis le proxy

Comme les serveurs backend tournent avec online-mode=false, si vous ne restreignez pas l'accès, quelqu'un peut se faire passer pour n'importe quel joueur de votre serveur, membres du staff compris. La clé secrète du modern forwarding constitue une seconde couche, mais elle ne remplace pas un pare-feu. Deux cas se présentent.

Tous les serveurs sur le même VDS : grâce au réglage server-ip=127.0.0.1 de l'étape 3, les serveurs backend ne sont pas visibles depuis Internet ; activez tout de même le pare-feu et n'autorisez que les ports nécessaires. Sur Ubuntu (autorisez d'abord le port SSH, sinon vous vous bloquerez l'accès) :

sudo ufw allow 22
sudo ufw allow 25565
sudo ufw enable
sudo ufw status verbose

Sous Windows Server, ouvrez le port du proxy avec PowerShell ; le pare-feu Windows bloque déjà par défaut les autres connexions entrantes :

New-NetFirewallRule -DisplayName "Minecraft proxy 25565" -Direction Inbound -Protocol TCP -LocalPort 25565 -Action Allow

Serveur backend sur un VDS séparé : sur cette machine, laissez la ligne server-ip vide, et dans le pare-feu, n'autorisez le port du serveur backend que depuis l'IP du proxy. Dans cet exemple, l'IP du proxy est 203.0.113.10 :

sudo ufw allow 22
sudo ufw allow proto tcp from 203.0.113.10 to any port 25566
sudo ufw enable
New-NetFirewallRule -DisplayName "Lobby proxy only" -Direction Inbound -Protocol TCP -LocalPort 25566 -RemoteAddress 203.0.113.10 -Action Allow

Sous Windows, le pare-feu peut afficher une demande d'autorisation au premier lancement de Java. N'accordez pas l'accès dans cette fenêtre sur le VDS du serveur backend ; sinon, une règle d'autorisation sans restriction de port est créée pour java.exe, et la restriction ci-dessus perd tout son sens. Côté proxy, dans velocity.toml ou config.yml, indiquez l'adresse de ce serveur avec l'IP réelle du VDS backend au lieu de 127.0.0.1.

7. Testez

Démarrez d'abord les serveurs backend, puis le proxy. Liste de contrôle :

  1. Dans la console du proxy, vérifiez que la ligne Listening on indique le port 25565.
  2. Connectez-vous à l'IP du VDS depuis le client Minecraft (sans saisir de port) ; vous devez arriver dans le lobby.
  3. Tapez /server survival en jeu ; le serveur doit changer. Dans Velocity, /server est ouvert à tous ; /glist all affiche la liste des joueurs par serveur et nécessite une permission.
  4. Vérifiez la ligne de connexion du joueur dans la console du lobby : l'IP doit être l'adresse réelle du joueur et non 127.0.0.1 ; sinon, la transmission ne fonctionne pas.
  5. Depuis l'extérieur, essayez de vous connecter directement à IP:25566. La connexion doit être refusée ou expirer ; si vous parvenez à entrer, revenez à l'étape 6.

Récapitulatif des réglages

Les réglages que vous avez modifiés dans une installation Velocity sur un seul VDS :

FichierRéglageValeur
velocity.tomlbind"0.0.0.0:25565"
velocity.tomlonline-modetrue
velocity.tomlplayer-info-forwarding-mode"modern"
velocity.toml[servers]lobby = "127.0.0.1:25566", etc.
server.properties (chaque serveur backend)server-ip / online-mode127.0.0.1 / false
config/paper-global.ymlproxies.velocity.enabled / online-mode / secrettrue / true / contenu de forwarding.secret
spigot.ymlsettings.bungeecordfalse (true pour BungeeCord)

Erreurs fréquentes

  • Le joueur n'arrive pas dans le lobby et reçoit une erreur de connexion : le serveur backend est arrêté, écoute sur le mauvais port, ou l'adresse dans [servers] est erronée ; vérifiez l'adresse et le port dans la console du serveur backend.
  • Le serveur backend Paper expulse les joueurs avec « Unable to verify player details » : le secret de paper-global.yml n'est pas exactement identique au fichier forwarding.secret. Copiez la valeur depuis le fichier au lieu de la saisir à la main ; attention aux différences d'espaces et de fins de ligne.
  • Le message « This server requires you to connect with Velocity. » : le modern forwarding est activé sur le serveur backend, mais le proxy ne transmet pas ; vérifiez que velocity.toml contient player-info-forwarding-mode = "modern". Quelqu'un qui contourne le proxy et se connecte directement au serveur backend voit aussi ce message ; si le backend est accessible depuis l'extérieur, vérifiez les règles de l'étape 6.
  • Spigot/Paper affiche « If you wish to use IP forwarding, please enable it in your BungeeCord config as well ! » : dans spigot.yml, bungeecord: true est activé, mais le proxy ne transmet pas. Sur BungeeCord, réglez ip_forward: true ; si vous utilisez le modern forwarding de Velocity, réglez bungeecord sur false.
  • Les inventaires et la progression des joueurs ont été réinitialisés : tant que la transmission est désactivée, ou que les valeurs online-mode diffèrent entre le proxy et le serveur backend, le joueur est reconnu avec un UUID différent. Alignez les valeurs ; restaurez les anciennes données depuis une sauvegarde.
  • Le proxy ne démarre pas, avec UnsupportedClassVersionError ou une erreur « requires Java 17 or above » : la version de Java est trop ancienne. Velocity nécessite au moins Java 25 et BungeeCord au moins Java 17 ; vérifiez avec java -version.
  • La connexion SSH a été coupée après l'activation du pare-feu : le port 22 n'a pas été autorisé avant ufw enable. Connectez-vous via la console VNC de l'Espace client et exécutez sudo ufw allow 22.

Questions fréquentes

Faut-il choisir Velocity ou BungeeCord ?

Si vous créez un nouveau réseau, choisissez Velocity : le modern forwarding avec clé secrète y est intégré et il est développé par l'équipe PaperMC. Ne choisissez BungeeCord que si vous dépendez d'un plugin BungeeCord sans équivalent Velocity.

online-mode=false sur les serveurs backend permet-il les connexions crackées ?

Pas tant que le proxy est en online-mode = true ; c'est le proxy qui gère l'authentification. Le risque vient de quelqu'un qui peut atteindre directement un serveur backend. C'est pourquoi vous ne devez pas mettre le réseau en ligne sans server-ip=127.0.0.1 ni règles de pare-feu.

Combien de serveurs backend puis-je faire tourner sur un VDS ?

La RAM et le CPU fixent la limite : attribuez 1 Go au proxy et au moins 2 Go à chaque serveur Paper, et laissez de la marge pour le système d'exploitation. Vous attribuez sa mémoire à chaque serveur avec la valeur -Xmx de son script de démarrage ; pour plus de détails, consultez le guide Comment allouer de la RAM à un serveur Minecraft : Xms, Xmx et flags d'Aikar.

Comment générer le fichier forwarding.secret ?

Velocity crée ce fichier dans le dossier du proxy au premier lancement. Si vous voulez modifier son contenu, écrivez une seule ligne de texte imprévisible ; le fichier doit être en UTF-8 et ne doit pas être vide. Lorsque vous le modifiez, reportez aussi la même valeur dans le fichier paper-global.yml de chaque serveur backend et redémarrez-les tous.

Guides associés

Commentaires0

Pas encore de commentaire

Soyez le premier à partager votre avis.

Rejoignez la discussion

Veuillez vous connecter ou vous inscrire pour laisser un commentaire.

Ne manquez aucun article

Recevez nos derniers tutoriels, guides et actualités produit dans votre boîte de réception.

Votre abonnement à notre newsletter est confirmé.