> ## 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.

# 3X-UI (Xray/VLESS)

> Веб-панель Xray: VLESS, VMess и другие

3X-UI — это веб-панель поверх Xray-core. Через браузер ты создаёшь подключения (инбаунды) и пользователей по протоколам VLESS, VMess, Trojan, Shadowsocks, видишь статистику трафика и ставишь лимиты — вместо ручной правки конфигов Xray. Команды для Ubuntu/Debian, под root.

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

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

* Сервер Lumi (по умолчанию Ubuntu 22.04). IP, логин и пароль root — в карточке сервера в [@lumivps\_bot](https://t.me/lumivps_bot).
* Подключение к серверу по SSH под root: [Подключение к серверу](/vps/connect).

## Установка

<Tabs>
  <Tab title="Скрипт — просто и быстро">
    Поставь панель официальным скриптом одной командой:

    ```bash theme={"system"}
    bash <(curl -Ls https://raw.githubusercontent.com/MHSanaei/3x-ui/master/install.sh)
    ```

    Скрипт спросит логин, пароль и порт панели, поставит сервис и запустит его. Бэкенд по умолчанию — SQLite, файл базы лежит в `/etc/x-ui/x-ui.db`, отдельная настройка не нужна.

    <Warning>
      Не оставляй значения по умолчанию. Сразу задай свой логин, надёжный пароль и нестандартный порт панели — открытая панель со стандартными данными попадает под перебор в первые часы.
    </Warning>
  </Tab>

  <Tab title="Вручную через Docker">
    Альтернативный способ — запустить официальный образ из репозитория [MHSanaei/3x-ui](https://github.com/MHSanaei/3x-ui). Сначала поставь Docker: [Docker](/vps/docker).

    <Steps>
      <Step title="Создай папку для данных">
        ```bash theme={"system"}
        mkdir -p /etc/x-ui
        ```
      </Step>

      <Step title="Запусти контейнер">
        ```bash theme={"system"}
        docker run -itd \
          --name 3x-ui \
          --restart=unless-stopped \
          -v /etc/x-ui:/etc/x-ui \
          -p 2053:2053 \
          ghcr.io/mhsanaei/3x-ui:latest
        ```
      </Step>

      <Step title="Проверь, что контейнер запущен">
        ```bash theme={"system"}
        docker ps
        ```

        Должен видеть контейнер `3x-ui` в статусе `Up`.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Проверка

```bash theme={"system"}
systemctl status x-ui
```

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

## Управление панелью

Меню управления вызывается командой:

```bash theme={"system"}
x-ui
```

В нём можно сменить логин, пароль и порт, посмотреть текущие настройки, перезапустить сервис и включить SSL. Перезапуск сервиса вручную:

```bash theme={"system"}
systemctl restart x-ui
```

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

Панель открывается в браузере по адресу вида:

```text theme={"system"}
http://IP:ПОРТ/ПУТЬ
```

Где `IP` — адрес твоего сервера, `ПОРТ` — порт, который ты задал при установке, `ПУТЬ` — веб-путь панели (его тоже задаёт скрипт; точные значения покажет команда `x-ui`). Логинься теми данными, что указал при установке.

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

```bash theme={"system"}
ufw allow ПОРТ/tcp
```

Подставь порт, который задал при установке. Подробно про файрвол: [Файрвол (ufw)](/vps/firewall).

<Warning>
  По возможности не держи панель открытой на голом IP. Заведи домен и включи SSL (пункт в меню `x-ui` или reverse-proxy через nginx), а в `ufw` открывай только тот порт, который реально используешь. Чем меньше открыто наружу — тем меньше поверхность для атаки.
</Warning>

## Базовая раздача: VLESS + Reality

<Steps>
  <Step title="Создай инбаунд">
    В панели открой раздел Inbounds и добавь новый. Выбери протокол VLESS и тип безопасности Reality — рабочий вариант по умолчанию, который сложно отличить от обычного HTTPS-трафика.
  </Step>

  <Step title="Добавь клиента">
    Внутри инбаунда заведи пользователя (клиента). При желании задай ему лимит трафика и срок действия.
  </Step>

  <Step title="Выдай ссылку или QR">
    Панель сформирует строку подключения и QR-код. Передай их тому, кто будет подключаться.
  </Step>

  <Step title="Подключись из приложения">
    Строку или QR вставляют в клиентское приложение: **v2rayNG** (Android), **NekoBox** (Android/Windows), **Hiddify** (кроссплатформенный). Импорт ссылки — и подключение готово.
  </Step>
</Steps>

***

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

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

<CardGroup cols={2}>
  <Card title="Marzban" icon="layer-group" href="/vps/marzban">
    Мультипользовательская панель с подписками.
  </Card>

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