Marzban: панель управления для ChatGPT¶

Marzban — это программное обеспечение с открытым исходным кодом, предназначенное для развёртывания и управления прокси-серверами на базе протокола VLESS с расширением XTLS Reality. Инструмент получил распространение в русскоязычном сегменте интернета как решение для организации доступа к заблокированным ресурсам, включая сервисы искусственного интеллекта, такие как ChatGPT. Marzban предоставляет веб-интерфейс для администрирования пользователей, отслеживания трафика и настройки параметров подключения.

¶История и происхождение

Проект был создан разработчиком под псевдонимом Gozargah в 2022 году. Название происходит от персидского слова «марзбан» (مرزبان), что означает «хранитель границы» или «пограничник». Изначально инструмент позиционировался как альтернатива существующим панелям управления для прокси-серверов, таким как Hiddify и X-UI, с упором на современный интерфейс и простоту развертывания. Исходный код распространяется на платформе GitHub под лицензией AGPL-3.0, что позволяет свободно использовать, модифицировать и распространять программное обеспечение.

Активное развитие проекта пришлось на 2023–2024 годы, когда в России участились блокировки зарубежных интернет-сервисов, включая мессенджеры и платформы искусственного интеллекта. Marzban стал одним из популярных инструментов для обхода ограничений благодаря использованию технологии Reality, которая маскирует трафик под обычные HTTPS-соединения к легитимным сайтам.

¶Технические основы

¶Протокол VLESS и XTLS Reality

Marzban работает на основе протокола VLESS — облегчённой версии протокола VMess, разработанного для проекта V2Ray. VLESS не шифрует трафик самостоятельно, полагаясь на внешние механизмы защиты. В сочетании с расширением XTLS Reality обеспечивается шифрование и маскировка трафика. Технология Reality использует криптографические ключи реальных TLS-серверов (например, сайтов крупных корпораций) для установления защищённого соединения, что делает детектирование прокси-трафика крайне затруднительным.

¶Архитектура

Система состоит из нескольких компонентов:

• Ядро Xray — основной прокси-движок, обрабатывающий входящие и исходящие соединения.
• Backend-сервер — REST API на языке Python (фреймворк FastAPI), управляющий конфигурацией и данными пользователей.
• Frontend — веб-интерфейс на JavaScript (фреймворк React), через который администратор взаимодействует с системой.
• База данных — по умолчанию используется SQLite, при необходимости может быть заменена на MySQL или PostgreSQL.

¶Функциональные возможности

¶Управление пользователями

Администратор может создавать неограниченное количество пользовательских учётных записей, для каждой из которых генерируется уникальная ссылка-приглашение (подписка). Подписка содержит все необходимые параметры для настройки клиентского приложения. Для каждого пользователя можно задать:

• лимит исходящего трафика;
• срок действия учётной записи;
• максимальное количество одновременных подключений;
• статус активности (включён/отключён).

¶Мониторинг и статистика

Веб-интерфейс отображает информацию о текущем количестве активных подключений, объёме использованного трафика по каждому пользователю и общую нагрузку на сервер. Данные обновляются в режиме реального времени. Система уведомлений оповещает администратора о достижении лимитов, истечении сроков действия и других событиях через Telegram-бота.

¶Управление сервером

Панель позволяет изменять порты прослушивания, настраивать параметры Reality (включая выбор сайта для маскировки), управлять системными пользователями и просматривать журналы (логи) работы сервера. Поддерживается работа с несколькими серверами через единую панель — для этого используется функция «узлов» (nodes), которая появилась в версии 0.6.0.

¶Установка и развертывание

Для установки Marzban требуется сервер с операционной системой Linux (поддерживаются Ubuntu, Debian, CentOS) и установленным Docker. Официальная документация предлагает скрипт автоматической установки, который разворачивает все компоненты в контейнерах. Минимальные требования к серверу: один виртуальный процессор, 512 МБ оперативной памяти и 10 ГБ дискового пространства.

Процесс настройки включает:

1. Установку Docker и Docker Compose.
2. Загрузку установочного скрипта с GitHub.
3. Запуск скрипта и ожидание автоматической настройки.
4. Получение учётных данных администратора и вход в веб-панель.

Для обеспечения безопасности рекомендуется настроить HTTPS-сертификат для домена, на котором размещается панель, и ограничить доступ к административной части по IP-адресу.

¶Клиентские приложения

Для подключения к серверу Marzban используются клиентские приложения, поддерживающие протокол VLESS. Среди наиболее распространённых:

• v2rayNG — приложение для Android;
• Streisand — приложение для iOS;
• Nekoray — кроссплатформенное приложение для Windows и Linux;
• V2Box — приложение для macOS.

Пользователю достаточно импортировать подписку (ссылку) в приложение, после чего оно автоматически загрузит конфигурацию и позволит подключиться к серверу.

¶Распространение и сообщество

Marzban имеет активное сообщество пользователей, преимущественно русскоязычное. Разработчики публикуют обновления несколько раз в месяц, добавляя новые функции и исправляя ошибки. Документация переведена на русский и английский языки. В связи с технической сложностью самостоятельной настройки, на рынке появились коммерческие услуги по установке и обслуживанию панелей Marzban, а также готовые конфигурации для аренды.

¶Правовой статус в России

Использование средств обхода блокировок, включая прокси-серверы и VPN, не запрещено законодательством Российской Федерации для частных лиц. Однако предоставление таких услуг в коммерческих целях может быть ограничено. Согласно статье 15.1 Федерального закона «Об информации, информационных технологиях и о защите информации», доступ к интернет-ресурсам, предоставляющим возможность обхода блокировок, может быть ограничен Роскомнадзором. Сам программный продукт Marzban не внесён в реестр запрещённой информации, но сайты, предлагающие его настройку как услугу, могут подпадать под блокировку.

¶Преимущества и недостатки

К достоинствам Marzban относят:

• высокую степень защиты от детектирования благодаря технологии Reality;
• удобный и интуитивно понятный веб-интерфейс;
• открытый исходный код и активное сообщество;
• низкие требования к ресурсам сервера.

Среди недостатков отмечают:

• необходимость наличия выделенного сервера за пределами России;
• сложность первоначальной настройки для неопытных пользователей;
• отсутствие официальной мобильной версии панели управления;
• зависимость от стабильности работы выбранного для маскировки сайта.