Хостинг · Сеть серверов и домены

Velocity: настройка прокси

Как собрать сетку серверов на Velocity: конфиг, секретный ключ, режим forwarding, список серверов и типичные ошибки подключения.

Обновлено 13 августа 2026 г.

Velocity — современный прокси: игроки заходят на один адрес, а прокси переводит их между серверами сетки.

Конфиг

velocity.toml на прокси-сервере:

bind = "0.0.0.0:25577"
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"

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

Секретный ключ

Файл forwarding.secret на прокси и та же строка на каждом бэкенд-сервере:

  • Paper: config/paper-global.yml → proxies.velocity.enabled: true, secret: <ключ>, online-mode: true;
  • в server.properties бэкендов: online-mode=false.

Без совпадающего ключа игрок получит отказ Unable to authenticate — IP-forwarding.

Правило безопасности

Бэкенд-серверы не должны быть доступны напрямую: иначе игрок зайдёт мимо прокси под любым ником. В Millida сетевая изоляция обеспечивается платформой — снаружи виден только вход сетки.

Плагины прокси

На Velocity ставятся свои плагины: очередь, общий чат, лимбо, синхронизация. Плагины Bukkit туда не ставятся.

Что дальше