PROXY protocol v2 Wrapper: реальные IP игроков за прокси

PROXY protocol v2 Wrapper для Minecraft возвращает настоящие IP игроков за HAProxy, Velocity и CDN. Узнайте, как установить мод и настроить прокси.

PROXY protocol v2 Wrapper

Если вы держите Minecraft-сервер за обратным прокси, балансировщиком нагрузки или защитой от DDoS, вы наверняка сталкивались с классической проблемой: в логах, банах и вайтлисте все игроки выглядят как 127.0.0.1 или один и тот же IP прокси. PROXY protocol v2 Wrapper решает это на уровне сетевого стека — мод встраивается в Netty-конвейер и восстанавливает реальные адреса клиентов ещё на этапе рукопожатия.

Это лёгкий серверный мод для Fabric, который добавляет нативную поддержку протокола HAProxy PROXY v2. Никаких костылей с плагинами и парсингом заголовков: обработчики динамически подключаются к pipeline канала и корректно передают настоящий IP дальше по цепочке.

Зачем нужен мод и какие задачи он закрывает

Без поддержки PROXY protocol сервер видит только адрес промежуточного узла. Это ломает сразу несколько вещей, которые критичны для живого проекта:

  • Баны и кики работают неправильно — вы блокируете прокси, а не нарушителя.
  • Вайтлист пропускает или отклоняет не тех игроков, потому что сравнивает адреса с IP балансировщика.
  • Логи и статистика теряют смысл: невозможно отследить, кто именно заходил и откуда.
  • Античит и системы защиты от мультиаккаунтов не могут сопоставить игроков по IP.

PROXY protocol v2 Wrapper для Minecraft возвращает реальные IP клиентов в логи сервера, систему банов и вайтлист. В результате инфраструктура с HAProxy, Velocity или облачной защитой работает так, будто прокси и нет вовсе.

Ключевые возможности

Нативная интеграция с Netty

Мод обновляет channel pipeline прямо во время фазы handshake. Это значит, что адрес клиента подставляется до того, как сервер начнёт обрабатывать подключение, и дальше всё работает штатно — без задержек и без вмешательства в игровую логику.

Точная передача IP

Настоящий адрес клиента восстанавливается в логах, бан-листах и вайтлисте. Больше никаких 127.0.0.1 и адресов прокси вместо реальных игроков.

Готовность к продакшену

Автор исправил типичные гонки в pipeline, из-за которых вылетал NoSuchElementException, и безопасно зашейдил нужные Netty HAProxy-кодеки. Мод не конфликтует с другими библиотеками на сервере.

Кстати, если не хочется возиться с ручной сборкой окружения, в лаунчере foxygame.net установка в один клик подтягивает нужную версию загрузчика и сразу добавляет PROXY protocol v2 Wrapper в сборку — остаётся только прописать конфиг прокси.

Совместимость и требования

Мод рассчитан на современные сборки Fabric. Проверьте, что ваше окружение соответствует следующим требованиям:

  • Fabric Loader 0.18.4 и выше.
  • Minecraft 1.21.11 или 26.3.
  • Fabric API версии 0.159.1+26.3 или новее.

Мод серверный: на клиент его ставить не нужно, игроки заходят на обычный сервер без дополнительных модов. Убедитесь, что ваш upstream-прокси или балансировщик включает PROXY protocol v2 для порта Minecraft-бэкенда — например, директива send-proxy-v2 в конфигурации HAProxy.

Как установить

Установка занимает пару минут и не требует глубоких знаний. Порядок действий такой:

  • Скачайте скомпилированный .jar-файл мода.
  • Поместите его в папку mods/ вашего сервера.
  • Включите PROXY protocol v2 на стороне прокси или балансировщика для backend-порта Minecraft.
  • Перезапустите сервер и проверьте логи — там должны появиться реальные IP игроков.

Если вы хотите скачать PROXY protocol v2 Wrapper без риска перепутать версии, обратите внимание на каталог дополнений в лаунчере foxygame.net: там мод отмечен совместимостью с конкретными сборками, а автообновление само подтянет свежий билд при выходе новой версии Minecraft.

Настройка прокси

Самая частая ошибка новичков — установить мод, но забыть включить сам протокол на прокси. Без send-proxy-v2 (или аналогичной опции в вашем балансировщике) сервер продолжит видеть адрес промежуточного узла. Проверьте конфигурацию HAProxy, Velocity или облачного провайдера защиты и только потом делайте выводы о работе мода.

Проверка результата

После перезапуска зайдите на сервер с обычного клиента и посмотрите логи подключений. Если там отображается ваш реальный IP, а не 127.0.0.1, всё настроено правильно. Дополнительно можно проверить работу бана: забаньте тестовый аккаунт и убедитесь, что блокируется именно он, а не все игроки разом.

Итог

PROXY protocol v2 Wrapper — это небольшой, но крайне полезный инструмент для любого Minecraft-сервера, который работает за прокси, CDN или системой анти-DDoS. Он убирает главную головную боль такой инфраструктуры: потерю реальных IP игроков. Нативная интеграция с Netty, исправленные гонки pipeline и безопасный шейдинг кодеков делают мод надёжным выбором для продакшена на Fabric с Minecraft 1.21.11 и 26.3. Настройте прокси, закиньте .jar в mods/ — и ваши логи, баны и вайтлист снова будут отражать реальность.