> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.lumiweb.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Marzban

> Мультипротокольная VPN-панель

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

<Note>
  Команды актуальны на момент написания. Перед установкой сверься с официальными репозиториями [Gozargah/Marzban](https://github.com/Gozargah/Marzban) и [Marzban-scripts](https://github.com/Gozargah/Marzban-scripts) — скрипт и команды панели обновляются.
</Note>

## Marzban или 3X-UI

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

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

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

## Установка

<Steps>
  <Step title="Запусти официальный скрипт">
    ```bash theme={"system"}
    sudo bash -c "$(curl -sL https://github.com/Gozargah/Marzban-scripts/raw/master/marzban.sh)" @ install
    ```

    Скрипт скачает и запустит Marzban. После установки появится команда управления `marzban` (статус, логи, рестарт).
  </Step>

  <Step title="Создай администратора">
    Заведи sudo-админа для входа в панель:

    ```bash theme={"system"}
    marzban cli admin create --sudo
    ```

    Команда спросит логин и пароль — ими ты будешь логиниться в дашборд.
  </Step>

  <Step title="Проверь статус">
    ```bash theme={"system"}
    marzban status
    ```

    Должен видеть `active (running)`.
  </Step>

  <Step title="Открой порт в файрволе">
    ```bash theme={"system"}
    ufw allow 8000/tcp
    ```

    Плюс порты, на которых работают твои инбаунды. Подробно про файрвол: [Файрвол (ufw)](/vps/firewall).
  </Step>
</Steps>

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

Дашборд по умолчанию работает на порту `8000`, адрес — `http://ТВОЙ_ДОМЕН:8000/dashboard/` (HTTPS — после настройки SSL, см. [/vps/ssl](/vps/ssl)).

<Note>
  Чтобы быстро заглянуть в панель без домена, используй проброс порта по SSH с локальной машины:

  ```bash theme={"system"}
  ssh -L 8000:localhost:8000 root@IP_СЕРВЕРА
  ```

  После этого открой `http://localhost:8000/dashboard/` в браузере. Это только для проверки — для постоянной работы настрой домен и SSL.
</Note>

<Warning>
  В целях безопасности дашборд Marzban не открывается по голому IP — нужен домен с SSL. Получи сертификат (например, через Let's Encrypt) и пропиши пути в переменных `UVICORN_SSL_CERTFILE` и `UVICORN_SSL_KEYFILE`, либо поставь панель за reverse-proxy (nginx). Инструкции — в официальной документации Marzban.
</Warning>

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

<Steps>
  <Step title="Войди в дашборд">
    Открой панель по своему домену и залогинься данными админа из шага выше.
  </Step>

  <Step title="Создай пользователя">
    Добавь нового пользователя, при желании задай лимит трафика и срок действия.
  </Step>

  <Step title="Выдай подписку">
    Скопируй ссылку-подписку пользователя и передай ему. Её вставляют в клиентское приложение (**v2rayNG**, **NekoBox**, **Hiddify**) — конфиги подтянутся автоматически и будут обновляться сами.
  </Step>
</Steps>

***

Lumi отвечает за сервер и сеть; настройку софта делаешь ты. Сеть или порт не работают — пиши в [@lumisup\_robot](https://t.me/lumisup_robot).

## Куда дальше

<CardGroup cols={2}>
  <Card title="3X-UI" icon="gauge-high" href="/vps/3x-ui">
    Панель Xray попроще — для небольшого числа подключений.
  </Card>

  <Card title="SSL-сертификат" icon="certificate" href="/vps/ssl">
    Подключи HTTPS к дашборду через домен.
  </Card>
</CardGroup>