Proxy Protocol Support
Когда ваш сервер Minecraft спрятан за прокси-сервером вроде HAProxy, Nginx или TCPShield, стандартный серверный софт видит только IP самого прокси. Это ломает баны по IP, геолокацию и любые инструменты, завязанные на адреса игроков. Мод Proxy Protocol Support решает эту проблему, позволяя серверу читать заголовки PROXY-протокола и восстанавливать настоящие IP-адреса. Он работает на стороне сервера, не требует установки на клиент и поддерживает гибридный режим — одновременный приём прямых и проксированных подключений.
Как работает Proxy Protocol Support
Мод добавляет поддержку PROXY-протокола (HAProxy) прямо в ядро сервера Minecraft. Когда трафик проходит через прокси, тот добавляет специальный заголовок с реальным IP игрока. Proxy Protocol Support считывает этот заголовок и передаёт настоящий адрес серверу, поэтому в консоли, плагинах и логах отображаются корректные данные. Без этого мода вы видели бы только IP прокси, что делало бы невозможным нормальное администрирование.
Мод работает исключительно на серверной стороне. Если вы случайно установите его на клиент, ничего не произойдёт — он просто не активируется. Это делает его безопасным для любых сборок, где клиентские и серверные моды могут пересекаться.
Поддерживаемые версии и загрузчики
Proxy Protocol Support совместим с Fabric и Quilt для версий Minecraft от 1.14 до 1.21.10. Разработчик также указывает, что мод, скорее всего, будет работать и на более новых версиях без изменений. Установка возможна на любой сервер, использующий эти загрузчики, и не требует дополнительных библиотек.
Гибридный безопасный режим
Главная фишка мода — возможность одновременно принимать подключения от доверенных прокси (с PROXY-заголовком) и прямые соединения от администраторов или локальных игроков. При этом действует принцип «Default Deny»: если IP-адрес входящего соединения не внесён в белый список, он будет отклонён. Это исключает обход прокси и защищает реальный IP сервера от несанкционированного доступа.
Как установить Proxy Protocol Support
Процесс установки прост и не требует специальных знаний. Достаточно поместить файл мода в папку mods вашего сервера, работающего на Fabric или Quilt. Перед этим убедитесь, что у вас установлен соответствующий загрузчик для выбранной версии Minecraft. Скачать Proxy Protocol Support можно с проверенных источников, но всегда обращайте внимание на совместимость с вашей версией игры.
Если вы пользуетесь лаунчером foxygame.net, то можете найти Proxy Protocol Support прямо в каталоге дополнений и установить его в один клик — это избавляет от ручного поиска и проверки версий.
Конфигурация файла proxy_protocol_support.json
После первого запуска мод создаст конфигурационный файл в папке config. Вот основные параметры, которые вам нужно настроить:
- enableProxyProtocol — включает или отключает мод (по умолчанию true).
- proxyServerIPs — список IP-адресов ваших доверенных прокси-серверов. Подключения с этих адресов обязаны отправлять PROXY-заголовок. По умолчанию ["127.0.0.1"].
- directAccessIPs — список IP или CIDR-диапазонов, которым разрешено прямое подключение без заголовка. Идеально для администраторов, локальной сети и серверных инструментов. По умолчанию ["127.0.0.1", "192.168.0.0/16"].
- whitelistTCPShieldServers — при значении true мод автоматически загружает официальные IP-адреса прокси TCPShield и добавляет их в proxyServerIPs. По умолчанию false.
Настройка интуитивно понятна, а примеры ниже помогут разобраться в типичных сценариях.
Примеры сценариев использования
Сервер за FRP на одной машине
Вы запускаете frpc на том же компьютере, что и сервер Minecraft. Игроки из интернета подключаются через прокси, а вы хотите заходить напрямую со своего игрового ПК в локальной сети (192.168.1.100). Конфигурация будет такой:
- proxyServerIPs = ["127.0.0.1"]
- directAccessIPs = ["127.0.0.1", "192.168.1.100"]
Сервер под защитой удалённого прокси
Ваш сервер находится дома, а в качестве прокси используется VPS с IP 203.0.113.10. Вы хотите, чтобы вся домашняя сеть (192.168.0.0/24) имела прямой доступ. Тогда:
- proxyServerIPs = ["203.0.113.10"]
- directAccessIPs = ["127.0.0.1", "192.168.0.0/24"]
Максимальная безопасность: только прокси
Вы разрешаете подключения исключительно через доверенные прокси, запрещая даже локальные соединения. Список прямых подключений оставляете пустым:
- proxyServerIPs = ["1.2.3.4", "5.6.7.8"]
- directAccessIPs = []
Преимущества Proxy Protocol Support
Мод даёт администраторам Minecraft-серверов несколько критически важных возможностей. Во-первых, вы наконец-то видите реальные IP игроков, что необходимо для банов, анти-читов и аналитики. Во-вторых, гибридный режим позволяет совмещать защиту прокси с удобным прямым доступом для доверенных лиц. В-третьих, строгая политика «Default Deny» предотвращает обход прокси и защищает ваш сервер от атак по настоящему IP.
Благодаря поддержке Fabric и Quilt, а также широкому диапазону версий (1.14–1.21.10), Proxy Protocol Support легко встраивается в любую серверную сборку. А если вы хотите максимально упростить установку, помните, что в лаунчере foxygame.net этот мод доступен в каталоге и обновляется автоматически, что особенно удобно при частой смене версий.
Независимо от того, используете ли вы TCPShield, FRP, Nginx или собственный HAProxy, этот мод станет незаменимым инструментом для сохранения конфиденциальности и корректной работы сервера. Скачать Proxy Protocol Support для Minecraft стоит каждому, кто ценит безопасность и точность данных.