FabricProxy: связующее звено между Fabric-сервером и прокси

Если вы когда-либо пытались объединить серверы Minecraft на Fabric в единую сеть с помощью BungeeCord или Velocity, то наверняка сталкивались с проблемой: игроки заходят, но их настоящие IP-адреса и скины не отображаются. Вместо этого все выглядят как безликие Стивы, а плагины на основе геолокации или системы банов работают некорректно. Решение существует — это мод FabricProxy, который настраивает корректную передачу данных от прокси к серверу. Давайте разберемся, как он устроен, какие версии поддерживает и как его правильно установить.

Что такое FabricProxy и зачем он нужен

FabricProxy — это серверный мод для Minecraft, работающий на загрузчике Fabric. Его главная задача — обеспечить поддержку современных протоколов проксирования, таких как BungeeCord и Velocity, на серверах, использующих Fabric API. Без подобного мода сервер, находящийся за прокси, видит только IP-адрес самого прокси, а не реальный адрес игрока. Это ломает работу многих функций: отображение скинов, передачу UUID, корректную работу онлайн-режима. FabricProxy исправляет эту ситуацию, позволяя серверу принимать и обрабатывать заголовки с реальными данными игрока.

Поддерживаемые версии и загрузчики

Мод разработан исключительно для серверов на Fabric. Он не совместим с Forge или ванильным сервером. FabricProxy поддерживает Minecraft версий 1.16, 1.17, 1.18 и 1.19. Однако важно отметить, что разработка оригинального FabricProxy прекращена, и автор рекомендует переходить на более актуальный форк — FabricProxy-Lite. Тем не менее, многие администраторы до сих пор используют классический FabricProxy на стабильных сборках, особенно если они не планируют обновлять ядро. Если вы ищете способ быстро скачать FabricProxy для Minecraft, то в некоторых лаунчерах, например, foxygame.net, можно найти готовые серверные сборки с уже интегрированным модом, что упрощает развертывание.

Как работает передача данных через прокси

Принцип работы основан на перехвате и обработке специальных пакетов, которые прокси-сервер (BungeeCord или Velocity) отправляет на сервер Fabric. В конфигурации прокси необходимо включить IP-форвардинг, а на стороне Fabric-сервера — активировать соответствующий режим в файле FabricProxy.toml. Мод поддерживает два основных протокола: классический BungeeCord-форвардинг и современный Velocity-форвардинг с секретным ключом. При правильной настройке сервер начинает видеть реальные IP-адреса, UUID и текстуры игроков, что делает игру полноценной даже в сетевой инфраструктуре.

Как установить FabricProxy на сервер

Процесс установки достаточно прост, но требует внимания к деталям. Вот пошаговая инструкция:

• Убедитесь, что на сервере установлен Fabric Loader и Fabric API подходящей версии. Для FabricProxy 1.4.1+ обязателен Fabric API 0.28 или новее.
• Скачайте FabricProxy с официального источника (CurseForge, Modrinth) и поместите файл в папку mods вашего сервера.
• Запустите сервер один раз, чтобы сгенерировался конфигурационный файл config/FabricProxy.toml.
• Откройте этот файл и настройте параметры в зависимости от используемого прокси: включите enableBungeeCord или enableVelocity, при необходимости укажите секретный ключ для Velocity.
• Перезапустите сервер — теперь он готов принимать подключения через прокси с корректной передачей данных.

Важно: если вы используете BungeeCord и сталкиваетесь с конфликтами с Fabric API, активируйте опцию BungeeCordWorkaround в конфигурации. Это решит проблему несовместимости, описанную в issue #16 на GitHub.

Настройка конфигурации FabricProxy

Файл FabricProxy.toml содержит несколько ключевых параметров. Рассмотрим их подробнее:

• BungeeCord — включает поддержку BungeeCord. Установите true, если ваш прокси — BungeeCord или его форк.
• BungeeCordWorkaround — обходной путь для несовместимости с Fabric API начиная с версии 0.28. Активируйте, если возникают ошибки сетевого API.
• Velocity — включает поддержку Velocity. Требует указания секретного ключа в поле secret.
• secret — строка, которая должна совпадать с настройкой форвардинга в конфигурации Velocity.
• allowBypassProxy (с версии 1.4.0) — разрешает игрокам подключаться напрямую, минуя прокси. Полезно для тестирования или если сервер используется и в локальной сети, и через прокси. При включении этой опции можно одновременно активировать поддержку BungeeCord и Velocity.

Помните, что при включенном allowBypassProxy сервер должен работать в режиме online-mode=true, чтобы избежать уязвимостей с подделкой UUID.

Почему стоит обратить внимание на FabricProxy-Lite

Оригинальный FabricProxy больше не обновляется, и разработчик рекомендует переходить на FabricProxy-Lite. Этот форк исправляет многие ошибки, поддерживает более новые версии Minecraft и загрузчика Fabric, а также предлагает улучшенную совместимость с современными прокси-серверами. Если вы только начинаете настройку сети серверов, возможно, имеет смысл сразу выбрать FabricProxy-Lite. Однако если ваша сборка стабильна и вы не планируете обновлений, классический FabricProxy всё ещё может служить верой и правдой. В любом случае, перед тем как скачать FabricProxy, проверьте актуальную версию и совместимость с вашим ядром.

Практические советы по использованию

При настройке FabricProxy для Minecraft важно помнить несколько моментов. Во-первых, мод должен быть установлен только на серверную часть — клиентам он не нужен. Во-вторых, если вы используете лаунчер foxygame.net, то можете найти FabricProxy в каталоге дополнений и установить его в один клик, что избавляет от ручного поиска и проверки совместимости. В-третьих, после изменения конфигурации всегда перезагружайте сервер, иначе новые параметры не вступят в силу. И наконец, если вы используете Velocity, обязательно задайте одинаковый секретный ключ в конфигурации прокси и в файле FabricProxy.toml — без этого форвардинг не заработает.

Заключение

FabricProxy — это незаменимый инструмент для администраторов, которые хотят объединить серверы Fabric в сеть с помощью BungeeCord или Velocity. Несмотря на то, что разработка мода прекращена, он всё ещё стабильно работает на многих версиях Minecraft и решает проблему передачи реальных IP-адресов и скинов. Правильная установка и настройка конфигурации позволят вам забыть о безликих Стивах и наслаждаться полноценным игровым процессом. Если же вы ищете более современное решение, обратите внимание на FabricProxy-Lite — логическое продолжение этого полезного мода.