IP-forwarding и «Unable to authenticate»

Зачем прокси передаёт адрес игрока бэкенду, режимы forwarding, как настроить ключ и разбор ошибки аутентификации.

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

Без проброса адреса бэкенд-сервер видит всех игроков как один адрес — адрес прокси. Ломается всё, что зависит от IP: баны, лимиты, антибот, статистика.

Режимы Velocity

Режим	Когда
`modern`	Paper 1.13+ — рекомендуемый
`legacy`	Совместимость со старым BungeeCord
`bungeeguard`	Bungee с плагином защиты
`none`	Только для тестов

Настройка modern

На прокси:

player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"

На каждом бэкенде (Paper), config/paper-global.yml:

proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: "тот_же_ключ"

И online-mode=false в server.properties бэкенда.

Ошибка Unable to authenticate

Появляется при несовпадении ключа или режима:

Ключ на прокси и на бэкенде отличается (лишний пробел, перенос строки).
На бэкенде не включён proxies.velocity.enabled.
Режим на прокси legacy, а бэкенд ждёт modern.
Бэкенд с online-mode=true при modern forwarding.

Безопасность

online-mode=false на бэкенде безопасен только при закрытом прямом доступе: иначе любой зайдёт под чужим ником напрямую. В Millida бэкенды сетки недоступны снаружи — Сеть серверов.