HAProxyCompat (Эйчэйпрокси компат)

Мод для серверов Майнкрафт, работающий с Fabric и NeoForge за обратным прокси. Он принимает заголовки PROXY protocol v1 и v2 от HAProxy, nginx, FRP или Traefik, передаёт серверу настоящий IP игрока и позволяет корректно использовать IP-баны, логи и геолокацию.

Возможности

• Поддерживает PROXY protocol v1 и v2.
• Показывает в логах реальный адрес игрока вместо адреса прокси.
• Применяет настоящий IP при проверке банов и в других серверных инструментах.
• Распознаёт служебные проверки PROXY LOCAL.
• Работает только на выделенном сервере и не затрагивает одиночные миры или игру по локальной сети.

Как пользоваться

Поместите файл мода в папку mods сервера и включите отправку PROXY-заголовка в прокси:

• HAProxy — send-proxy или send-proxy-v2 в строке server.
• nginx stream — proxy_protocol on; в блоке server.
• FRP — transport.proxyProtocolVersion = "v2" для перенаправляемой службы.
• Traefik — включите proxyProtocol у сервера TCP-службы.

Если прокси расположен не на той же машине, что и сервер, добавьте его IP-адрес или CIDR-диапазон в список доверенных прокси. Также стоит закрыть порт Майнкрафт в фаерволе, оставив доступ к нему только прокси: иначе подключающийся напрямую сможет попытаться подделать свой адрес.

Настройки

На NeoForge параметры находятся в config/haproxycompat-common.toml и применяются без перезапуска. На Fabric используется config/haproxycompat.json; после изменения нужен перезапуск сервера.

• enabled / enabled — включает мод.
• require_proxy_protocol / requireProxyProtocol — принимает только подключения с корректным PROXY-заголовком от доверенного прокси. При значении false разрешены и прямые подключения.
• trusted_proxies / trustedProxies — IP-адреса и CIDR-диапазоны прокси, заголовкам которых можно доверять.
• log_connections / logConnections — записывает решение по каждому подключению в лог.
• kick_message / kickMessage — сообщение при прямом подключении, если требуется PROXY protocol.

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

Мод предназначен для выделенных серверов Fabric и NeoForge и не требует других модов. Прокси должен уметь отправлять PROXY-заголовки; без этого мод пропускает прямые подключения только при отключённом require_proxy_protocol.