К содержимому
Подключить

3x-ui на VPS: установка и VLESS Reality

Панель Xray с лимитами

Установить на VPSGitHub
Категория
VPN / Прокси
Хостинг
VPN-сервер
Автор
MHSanaei
Лицензия
GPL-3.0
Версия
3.8.5
Обновлено

Скрипт бесплатный · VPS от $2.79 в месяц · установка около 6 минут

Установка по SSH

root@vps:~# bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)

  • SystemUbuntu 24.04 · x86_64ok
  • Sourcegithub.com/MHSanaei/3x-uiok
  • Version3.8.5ok
  • Port2053/tcplisten
  • Port443/tcplisten

✓ 3x-ui 3.8.5 установлен · около 60 секунд

root@vps:~#

Команда установки из библиотеки. Вывод сокращён: на вашем сервере он может отличаться.

Что это

  • Xray
  • VLESS
  • REALITY
  • Hysteria2
  • Лимиты

3x-ui — веб-панель для Xray-core, развитие проекта X-UI. В ней вы создаёте подключения (inbounds) и клиентов, задаёте каждому лимит трафика, срок и число устройств и раздаёте ссылки, QR-коды и подписки.

Панель ставится одним скриптом без Docker и почти не потребляет ресурсов, поэтому её часто выбирают для одного-двух серверов. Кроме VLESS с REALITY есть VMess, Trojan, Shadowsocks, WireGuard, AmneziaWG, Hysteria2 и MTProto.

При установке скрипт генерирует случайные логин, пароль, порт и путь к панели, а управление сервисом идёт через консольное меню x-ui.

  • VLESS, VMess, Trojan, Shadowsocks, WireGuard, AmneziaWG, Hysteria2, MTProto
  • Транспорты TCP, WebSocket, gRPC, XHTTP с TLS и REALITY
  • Лимиты по трафику, сроку, IP и устройствам для каждого клиента
  • Встроенный сервер подписок: raw, JSON и Clash
  • Telegram-бот, REST API и управление несколькими нодами
  • База SQLite по умолчанию или PostgreSQL

Кому подойдёт

  • Нужен свой VPN на VLESS Reality для себя, семьи или небольшой команды — с лимитом трафика, сроком и числом устройств у каждого клиента.
  • Обычный WireGuard блокируют, а нужен WireGuard-подобный туннель: AmneziaWG в 3x-ui встроен в саму панель.
  • Один-два сервера без Docker: панель ставится одним скриптом, а управляется меню x-ui.

Рекомендуемый тариф

Для 3x-ui — не меньше 1 vCPU, 2 ГБ RAM и 10 ГБ NVMe.

Минимум для запуска
1 vCPU · 1 ГБ RAM · 10 ГБ диска
Системы
Ubuntu 22.04 · Ubuntu 24.04 · Debian 11 · Debian 12 · AlmaLinux 9
Виртуализация
KVM — на всех наших VPS

Установка в 1 клик через Telegram-бот

Три шага в боте, командная строка не нужна. Бот показывает прогресс, установка обычно занимает около 6 минут.

  1. 01

    Откройте бота по кнопке

    Кнопка установки на этой странице откроет @ExpressHost_bot — скрипт 3x-ui бот подставит сам.

  2. 02

    Выберите тариф и ОС

    Скрипт появится на шаге «Скрипты» автоматически, останется оплатить сервер.

  3. 03

    Получите данные для входа

    Когда установка закончится, бот пришлёт данные для входа в чат.

Что настроит бот

  • Ставит последний релиз 3x-ui с GitHub на Ubuntu 22.04 или 24.04.
  • Генерирует случайные логин, пароль и секретный путь панели; панель слушает порт 1024.
  • Выпускает сертификат Let’s Encrypt на домен сервера вида имя-сервера.expresshost.cloud — панель сразу открывается по HTTPS.
  • Когда установка закончится, бот пришлёт адрес панели (Access URL), логин и пароль; копия лежит в /root/info.txt.
  • Подключения (inbounds) бот не создаёт: VLESS Reality или AmneziaWG добавьте в панели по шагам ниже.

Установка 3x-ui вручную

Если сервер уже есть или нужна своя конфигурация, поставьте панель официальным скриптом. Он работает на Ubuntu, Debian, AlmaLinux и других дистрибутивах, запускать его нужно под root.

Порты 3x-ui
ПортПротоколНазначение
2053tcpВеб-панель (порт по умолчанию; установщик предлагает случайный)
443tcpОбычно занимают под VLESS REALITY (настраивается в панели)
  1. 01

    Подключитесь к серверу

    IP и пароль root бот присылает после создания сервера.

    Код
    ssh root@SERVER_IP
  2. 02

    Запустите установщик

    Скрипт поставит службу и команду управления x-ui, сгенерирует случайные логин, пароль и путь к панели. Порт можно задать самому или оставить случайный.

    Код
    bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)
  3. 03

    Выберите SSL-сертификат

    Установщик предложит Let’s Encrypt для домена (90 дней) или для IP-адреса (6 дней), оба продлеваются сами. Для проверки нужен открытый порт 80, для домена заранее создайте A-запись на IP сервера.

  4. 04

    Сохраните данные для входа

    В конце скрипт выведет Username, Password, Port, WebBasePath и Access URL — полный адрес панели. Он же записывает их в /etc/x-ui/install-result.env. Текущие настройки можно посмотреть командой ниже.

    Код
    x-ui settings
  5. 05

    Защитите панель

    Включите двухфакторную аутентификацию в Panel Settings и откройте в файрволе только нужные порты. Сменить логин, пароль, путь и порт можно в меню x-ui.

Как настроить VLESS Reality в 3x-ui

REALITY маскирует подключение под TLS-рукопожатие настоящего популярного сайта, поэтому свой домен и сертификат для него не нужны. Работает с VLESS, рекомендуемый flow — xtls-rprx-vision.

  1. 01

    Создайте inbound VLESS

    В разделе Inbounds добавьте подключение: протокол VLESS, Security — reality. Порт выберите свободный, например 443.

  2. 02

    Выберите target (dest) и SNI

    Нужен чужой посещаемый сайт с TLS 1.3 и HTTP/2, доступный и с сервера, и у клиентов, — в документации пример www.microsoft.com:443. Домен не должен быть редиректом. В SNI / Server Names укажите имя из сертификата этого сайта.

  3. 03

    Сгенерируйте ключи и Short ID

    Панель сама создаёт пару ключей x25519 и Short ID. Приватный ключ остаётся на сервере, клиенты получают только публичный.

  4. 04

    Укажите flow и отпечаток

    Flow — xtls-rprx-vision, и в записи клиента, и в ссылке. uTLS fingerprint — распространённый, например chrome.

  5. 05

    Добавьте клиента и отдайте ссылку

    Создайте клиента, задайте лимит трафика и срок и отправьте ссылку vless:// или QR-код. Подойдут v2rayNG, Hiddify, Mihomo и другие клиенты.

AmneziaWG в 3x-ui

AmneziaWG — форк WireGuard с обфускацией, чтобы DPI не узнавал WireGuard. В 3x-ui он работает внутри панели (amneziawg-go в пространстве пользователя), без модуля ядра и DKMS. Отдельного скрипта AmneziaWG в боте нет — поставьте 3x-ui и добавьте inbound. Другие способы, требования и клиенты — в отдельном гайде.

AmneziaWG-сервер на VPS: все способы
  1. 01

    Добавьте inbound AmneziaWG

    Выберите протокол AmneziaWG, задайте порт и подсеть туннеля, например 10.8.1.0/24.

  2. 02

    Оставьте обфускацию по умолчанию

    Панель сама генерирует случайный набор Jc, Jmin/Jmax, S1–S4, H1–H4 и умеет пересоздать его. Значения должны совпадать у сервера и клиентов — клиентские конфиги наследуют их автоматически.

  3. 03

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

    У каждого клиента свои ключи и адрес. Скачайте .conf или скопируйте ссылку vpn:// — её импортируют официальные приложения AmneziaWG и AmneziaVPN. Для параметров версии 3.1 нужно приложение Amnezia с поддержкой 3.1.

Обновление и бэкап 3x-ui

Обновление сохраняет базу и настройки. Перед переходом на новую мажорную версию сделайте бэкап.

  1. 01

    Сделайте копию базы

    Все подключения, клиенты и настройки лежат в /etc/x-ui/x-ui.db, сертификаты — в /root/cert/. Храните копию вне сервера.

    Код
    cp /etc/x-ui/x-ui.db /root/x-ui-backup-$(date +%F).db
  2. 02

    Обновите до последнего стабильного релиза

    То же самое делает пункт Update в меню x-ui.

    Код
    x-ui update

Частые ошибки 3x-ui

  • Панель не открывается

    Откройте Access URL целиком — с портом и секретным путём. Проверьте службу командой x-ui status и логи в меню x-ui (Logs Management); порт панели не должен быть занят другим сервисом.

  • Не выпускается сертификат

    A-запись домена должна указывать на сервер до выпуска, а порт 80 — быть доступен из интернета для HTTP-проверки. Для REALITY сертификат не нужен.

  • Клиент Reality не подключается

    Чаще всего виноваты target и SNI: сайт должен поддерживать TLS 1.3 и HTTP/2, а SNI — совпадать с его сертификатом. Проверьте flow xtls-rprx-vision в клиенте и в ссылке и открыт ли порт inbound.

  • Клиент перестал подключаться

    Проверьте, не исчерпан ли у клиента лимит трафика, срок или лимит IP.

  • Забыли логин или пароль

    Выполните x-ui и выберите Reset Username & Password. Порт и путь панели покажет x-ui settings.

Источники

Команды и шаги сверены с официальной документацией 25 октября 2026. Что делает установка из бота — по её скрипту.

Вопросы о 3x-ui

Не нашли ответ? Пишите @ExpressHost_SupportBot.

Сколько пользователей выдержит тариф?

Панель почти не нагружает сервер, ресурсы уходят на Xray. Для десятков активных клиентов хватает 1 vCPU и 2 ГБ RAM; при росте следите за загрузкой CPU и каналом.

Как обновить 3x-ui?

Командой x-ui update или через меню x-ui. Установщик проверяет контрольную сумму архива, настройки и клиенты сохраняются.

Где лежат данные?

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

Чем 3x-ui отличается от Marzban?

3x-ui ставится без Docker и подходит для одного-двух серверов. В Marzban и Remnawave сильнее мультисерверность и подписки для продажи доступа.

3x-ui ставится при заказе — в боте.

Установить 3x-uiКупить в Telegram