Перейти к основному содержанию
Marzban — это панель поверх Xray для раздачи доступа множеству пользователей. Каждому пользователю выдаётся ссылка-подписка: одна ссылка содержит все его конфиги и обновляется на лету. Команды для Ubuntu/Debian, под root.
Команды актуальны на момент написания. Перед установкой сверься с официальными репозиториями Gozargah/Marzban и Marzban-scripts — скрипт и команды панели обновляются.

Marzban или 3X-UI

И то, и другое — панели над Xray. 3X-UI проще, когда подключений немного и ты ведёшь их вручную. Marzban мощнее для многопользовательских сетапов: управление пользователями, лимиты, сроки и, главное, ссылки-подписки вместо ручной выдачи каждого конфига.

Что понадобится

  • Сервер Lumi (@lumivps_bot) — подойдёт даже базовый VPS-0. ОС по умолчанию Ubuntu 22.04.
  • IP, логин (root) и пароль из карточки сервера в боте — по ним ты подключаешься по SSH.
  • Для нормальной работы дашборда — домен и SSL (по голому IP панель не открывается).

Установка

1

Запусти официальный скрипт

sudo bash -c "$(curl -sL https://github.com/Gozargah/Marzban-scripts/raw/master/marzban.sh)" @ install
Скрипт скачает и запустит Marzban. После установки появится команда управления marzban (статус, логи, рестарт).
2

Создай администратора

Заведи sudo-админа для входа в панель:
marzban cli admin create --sudo
Команда спросит логин и пароль — ими ты будешь логиниться в дашборд.
3

Проверь статус

marzban status
Должен видеть active (running).
4

Открой порт в файрволе

ufw allow 8000/tcp
Плюс порты, на которых работают твои инбаунды. Подробно про файрвол: Файрвол (ufw).

Доступ к панели

Дашборд по умолчанию работает на порту 8000, адрес — http://ТВОЙ_ДОМЕН:8000/dashboard/ (HTTPS — после настройки SSL, см. /vps/ssl).
Чтобы быстро заглянуть в панель без домена, используй проброс порта по SSH с локальной машины:
ssh -L 8000:localhost:8000 root@IP_СЕРВЕРА
После этого открой http://localhost:8000/dashboard/ в браузере. Это только для проверки — для постоянной работы настрой домен и SSL.
В целях безопасности дашборд Marzban не открывается по голому IP — нужен домен с SSL. Получи сертификат (например, через Let’s Encrypt) и пропиши пути в переменных UVICORN_SSL_CERTFILE и UVICORN_SSL_KEYFILE, либо поставь панель за reverse-proxy (nginx). Инструкции — в официальной документации Marzban.

Первый пользователь

1

Войди в дашборд

Открой панель по своему домену и залогинься данными админа из шага выше.
2

Создай пользователя

Добавь нового пользователя, при желании задай лимит трафика и срок действия.
3

Выдай подписку

Скопируй ссылку-подписку пользователя и передай ему. Её вставляют в клиентское приложение (v2rayNG, NekoBox, Hiddify) — конфиги подтянутся автоматически и будут обновляться сами.

Lumi отвечает за сервер и сеть; настройку софта делаешь ты. Сеть или порт не работают — пиши в @lumisup_robot.

Куда дальше

3X-UI

Панель Xray попроще — для небольшого числа подключений.

SSL-сертификат

Подключи HTTPS к дашборду через домен.