NG HaProxy Support

NG Proxy Support

Добавляет поддержку протокола HAProxy PROXY на ваш сервер Minecraft Forge.

Видьте реальные IP-адреса игроков, когда ваш сервер стоит за прокси вроде Velocity, TCPShield, FRP, Nginx или любого другого обратного прокси, совместимого с HAProxy.

Возможности

• HAProxy PROXY Protocol v1/v2 — Полная поддержка обеих версий протокола
• Определение реального IP — Игроки, подключающиеся через прокси, будут показывать свой реальный IP в логах сервера, банах и плагинах
• Гибридный режим — Поддерживает одновременные подключения как через прокси, так и напрямую
• Безопасность Fail-Closed — Подключения с неизвестных IP автоматически отклоняются, что предотвращает атаки в обход прокси
• CIDR-нотация — Добавляйте в белый список целые подсети (например, 192.168.0.0/16)
• Интеграция с TCPShield — Автоматически получает и добавляет в белый список IP-адреса серверов TCPShield
• Горячая перезагрузка конфига — Перезагружайте конфигурацию без перезапуска сервера
• Команда статуса — Просматривайте текущую конфигурацию и статистику подключений прямо в игре
• Логирование подключений — Записывайте реальные IP игроков и IP прокси в отдельный лог-файл

Команды

Конфигурация

Файл конфига: config/proxy_protocol_support.json

{
  "enableProxyProtocol": true,
  "proxyServerIPs": ["127.0.0.1"],
  "directAccessIPs": ["127.0.0.1", "192.168.0.0/16"],
  "whitelistTCPShieldServers": false,
  "logConnections": true
}

Как это работает

Игрок → Прокси (Velocity/HAProxy/FRP) → Сервер Forge (с NG Proxy Support)
                                          ↓
                                   Читает PROXY-заголовок
                                   Извлекает реальный IP
                                   Устанавливает адрес игрока

1. Ваш прокси отправляет заголовок протокола PROXY с реальным IP клиента
2. NG Proxy Support перехватывает входящие подключения и читает заголовок
3. Адрес игрока устанавливается на его реальный IP вместо IP прокси
4. Все логи сервера, системы банов и плагины видят правильный IP

Модель безопасности

NG Proxy Support использует модель fail-closed:

• ✅ Подключения с proxyServerIPs → PROXY-заголовок читается, реальный IP извлекается
• ✅ Подключения с directAccessIPs → Разрешены без PROXY-заголовка
• ❌ Подключения с любого другого IP → Автоматически отклоняются

Это не даёт игрокам обойти ваш прокси, подключиться напрямую и подделать свой IP.

Руководство по установке

С Velocity

1. Установи NG Proxy Support на свой Forge-сервер
2. Включи протокол PROXY в velocity.toml у Velocity:

   [advanced]
   haproxy-protocol = true

1. Добавь IP своего Velocity-сервера в proxyServerIPs в конфиге мода
2. Перезапусти оба сервера

С HAProxy / Nginx / FRP

1. Настрой свой обратный прокси на отправку заголовков протокола PROXY
2. Добавь IP прокси в proxyServerIPs
3. Перезапусти Forge-сервер

Требования

• Minecraft 1.20.1
• Forge 47.x
• Java 17+
• Только серверная часть (клиентский мод не нужен)

Благодарности

Сделано xylos | © 2024-2026 Все права защищены