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/ — и ваши логи, баны и вайтлист снова будут отражать реальность.