3X-UI (Xray/VLESS)

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

Команды актуальны на момент написания. Перед установкой сверься с официальным репозиторием MHSanaei/3x-ui — install-скрипт и панель обновляются.

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

Сервер Lumi (по умолчанию Ubuntu 22.04). IP, логин и пароль root — в карточке сервера в @lumivps_bot.
Подключение к серверу по SSH под root: Подключение к серверу.

Установка

Скрипт — просто и быстро
Вручную через Docker

Поставь панель официальным скриптом одной командой:

bash <(curl -Ls https://raw.githubusercontent.com/MHSanaei/3x-ui/master/install.sh)

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

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

Альтернативный способ — запустить официальный образ из репозитория MHSanaei/3x-ui. Сначала поставь Docker: Docker.

Создай папку для данных

mkdir -p /etc/x-ui

Запусти контейнер

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

Проверь, что контейнер запущен

docker ps

Должен видеть контейнер 3x-ui в статусе Up.

Проверка

systemctl status x-ui

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

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

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

x-ui

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

systemctl restart x-ui

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

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

http://IP:ПОРТ/ПУТЬ

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

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

ufw allow ПОРТ/tcp

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

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

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

Создай инбаунд

В панели открой раздел Inbounds и добавь новый. Выбери протокол VLESS и тип безопасности Reality — рабочий вариант по умолчанию, который сложно отличить от обычного HTTPS-трафика.

Добавь клиента

Внутри инбаунда заведи пользователя (клиента). При желании задай ему лимит трафика и срок действия.

Выдай ссылку или QR

Панель сформирует строку подключения и QR-код. Передай их тому, кто будет подключаться.

Подключись из приложения

Строку или QR вставляют в клиентское приложение: v2rayNG (Android), NekoBox (Android/Windows), Hiddify (кроссплатформенный). Импорт ссылки — и подключение готово.

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

Куда дальше

Marzban

Мультипользовательская панель с подписками.

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

Добавь HTTPS к панели через домен.

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

​Установка

​Проверка

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

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

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

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

​Куда дальше

Marzban

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

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

Установка

Проверка

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

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

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

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

Куда дальше