Réseau et proxys

Migrer un réseau de BungeeCord vers Velocity

Relu le 6 septembre 2026 2 min de lecture

Velocity est le proxy moderne et la migration en vaut la peine. Ce n'est cependant pas un remplacement direct : le format de configuration, les extensions et la sécurité du forwarding diffèrent tous, et ce dernier point laisse un réseau exposé sans rien dire.

Ce qui change

BungeeCordVelocity
Fichier de configurationconfig.ymlvelocity.toml
ExtensionsExtensions BungeeCordExtensions Velocity — non compatibles
ForwardingForwarding héritémodern avec un secret partagé
Réglage du backendbungeecord: true dans spigot.ymlSection velocity dans paper-global.yml
PerformanceCorrecteNettement meilleure sous charge

La migration, dans l'ordre

  1. Listez vos extensions BungeeCord et cherchez des équivalents d'abord

    Faites cela avant tout. Si une extension dont dépend votre réseau n'a pas de version Velocity, cela décide si vous migrez tout court.

  2. Installez Velocity à côté, pas à la place

    Faites-le tourner sur un autre port avec les mêmes backends listés. Vous pouvez tout tester avant de déplacer un seul joueur.

  3. Passez le forwarding en modern des deux côtés

    player-info-forwarding-mode = "modern" dans velocity.toml, et le bloc proxies.velocity correspondant dans le paper-global.yml de chaque backend, avec le secret recopié.

  4. Déplacez l'adresse en dernier

    Quand cela marche, pointez votre DNS ou votre adresse publiée vers le nouveau proxy. C'est la seule étape que les joueurs remarquent.

Le forwarding hérité sur un proxy moderne est une porte ouverte

Si un backend reste configuré pour le forwarding BungeeCord alors que le proxy envoie du modern, les joueurs ne peuvent pas se connecter ou — pire, selon les réglages — se connectent sans authentification. Tous les backends doivent basculer en même temps que le proxy, et tous doivent être injoignables depuis internet dans tous les cas.

Gardez l'ancien proxy configuré mais arrêté une semaine

Si quelque chose s'avère cassé un mardi soir, revenir en arrière est un bouton de démarrage, pas une reconstruction. Supprimez-le après une semaine sans en avoir eu besoin.

Comment vérifier que c'est réglé

Vous vous connectez via Velocity, /server vous déplace entre backends, votre skin et votre UUID sont corrects partout, et une connexion directe au port d'un backend échoue.