К содержимому
Tickwise
КритичноVelocity и проксиSIG-VE-012

Velocity не стартует: не задан forwarding secret

Платформы
Velocity · вся сеть
Проверено
Проверено
Уверенность
Уверенность 98%

Как это выглядит в логе

Достаточно одной из строк. Агент сверяет их с логом локально, на вашем сервере.

logs/latest.log
  • You don't have a forwarding secret set
  • The forwarding-secret в stack trace

Симптомы

  • Прокси завершается сразу после запуска, игроки не могут зайти в сеть
  • В логе: «You don't have a forwarding secret set. This is required for security.» или «The forwarding-secret file must not be empty.»

Причина

В velocity.toml выбран режим forwarding modern или bungeeguard, но секрет пуст: файл из forwarding-secret-file пустой, а переменная VELOCITY_FORWARDING_SECRET не задана. Velocity отказывается стартовать.

Вероятные причины

  • Файл forwarding.secret (или указанный в forwarding-secret-file) существует, но пустой — например, очищен при переносе/деплое
  • forwarding-secret-file указывает не на тот файл (относительный путь от другой рабочей директории, опечатка в имени)
  • Секрет передаётся переменной VELOCITY_FORWARDING_SECRET, но в окружении контейнера/панели она пустая

Как исправитьСредний риск

  1. Откройте velocity.toml и проверьте forwarding-secret-file (по умолчанию forwarding.secret рядом с velocity.toml) и player-info-forwarding-mode.
  2. Запишите в этот файл секрет — случайную строку (например, из менеджера паролей). Если backend уже настроены, используйте тот же секрет, что в proxies.velocity.secret их config/paper-global.yml, — копируйте локально, не пересылая его в чаты и сторонние сервисы.
  3. Если файла нет вовсе, Velocity при старте сам создаст его со случайным секретом — затем перенесите этот секрет на backend.
  4. Запустите прокси и убедитесь, что в логе нет Your configuration is invalid.

Источники