3X-UI: полная инструкция по установке и настройке в 2026 году

9 февраля 2026 г.

3X-UI — это веб-панель управления прокси-сервером на базе Xray-core. С её помощью можно развернуть собственный VPN-сервер с протоколом VLESS + Reality, который работает в России и обходит блокировки. В этой статье — пошаговая инструкция: от покупки VPS до первого подключения.

Что такое 3X-UI и зачем она нужна

3X-UI — это форк X-UI с расширенной функциональностью. Панель предоставляет веб-интерфейс для управления Xray-core — движком, который поддерживает протоколы VLESS, VMess, Trojan, Shadowsocks и другие.

Почему именно 3X-UI?

Веб-интерфейс — не нужно редактировать конфиги вручную
Мультипротокольность — VLESS, VMess, Trojan, Shadowsocks в одной панели
Reality — новейшая технология маскировки трафика, не требует домен и сертификат
Управление пользователями — создание, лимиты трафика, сроки действия
Подписки — автоматическая раздача конфигов клиентам по ссылке
Мониторинг — статистика трафика, нагрузки, состояния сервера
Бесплатная — open-source проект на GitHub

3X-UI vs другие панели

Параметр	3X-UI	Marzban	Hiddify
Протоколы	Все (Xray)	Все (Xray)	Все (Xray + Sing-box)
Веб-интерфейс	Да	Да	Да
Reality	Да	Да	Да
Мультисервер	Нет (1 сервер)	Нет (есть Node)	Да
Сложность	Низкая	Средняя	Средняя
Подписки	Да	Да	Да
Telegram-бот	Да	Да	Да
API	Да	Да	Да
Популярность	Самая высокая	Высокая	Растёт

3X-UI — самая популярная панель в мире (50K+ звёзд на GitHub). Она проще других в установке и настройке, поэтому идеально подходит для начинающих.

Требования к серверу

Для запуска 3X-UI вам понадобится VPS (виртуальный сервер) за пределами России.

Минимальные требования

ОС: Ubuntu 22.04 / 24.04 LTS (рекомендуется), Debian 11/12, CentOS 8+
CPU: 1 ядро
RAM: 512 МБ (рекомендуется 1 ГБ)
Диск: 10 ГБ SSD
Сеть: 1 публичный IPv4-адрес
Трафик: от 500 ГБ/мес (зависит от количества пользователей)

Покупка VPS

На что обращать внимание

Локация — Нидерланды или Германия для минимального пинга из РФ
Трафик — минимум 1 ТБ/мес для 10–20 пользователей
IP-репутация — некоторые IP могут быть в чёрных списках
Порты — убедитесь, что порт 443 не заблокирован провайдером

Пример: покупка VPS на Hetzner

Зарегистрируйтесь на hetzner.com
Перейдите в Cloud Console → Add Server
Выберите: Location: Falkenstein (DE) или Helsinki (FI)
Image: Ubuntu 24.04
Type: CX22 (2 vCPU, 4 GB RAM) — от €4.35/мес
Добавьте SSH-ключ (или пароль придёт на email)
Нажмите «Create & Buy Now»

Через 30 секунд сервер готов. IP-адрес появится в панели.

Установка 3X-UI на сервер

Шаг 1: Подключение к серверу по SSH

Windows — используйте PowerShell или PuTTY:

ssh root@ВАШ_IP_АДРЕС

macOS / Linux — откройте Terminal:

ssh root@ВАШ_IP_АДРЕС

При первом подключении введите yes для подтверждения отпечатка сервера.

Шаг 2: Обновление системы

apt update && apt upgrade -y

Дождитесь завершения (1–3 минуты).

Шаг 3: Установка 3X-UI

Выполните одну команду:

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

Установщик автоматически:

Установит Docker и необходимые зависимости
Загрузит последнюю версию 3X-UI
Настроит базу данных
Создаст systemd-сервис

Шаг 4: Настройка при установке

Во время установки вас спросят:

Username — имя администратора (не используйте admin)
Password — сложный пароль (минимум 12 символов)
Port — порт панели (по умолчанию 2053, рекомендуется изменить на случайный, например 48321)

Совет по безопасности: не используйте стандартные логин/пароль. Боты постоянно сканируют серверы в поисках панелей 3X-UI с дефолтными credentials.

Шаг 5: Проверка установки

x-ui status

Вы должны увидеть:

3x-ui is running

Также полезные команды:

x-ui start      # запустить
x-ui stop       # остановить
x-ui restart    # перезапустить
x-ui log        # посмотреть логи
x-ui update     # обновить до последней версии
x-ui settings   # изменить настройки (логин, пароль, порт)

Первый вход в панель 3X-UI

Откройте в браузере:

http://ВАШ_IP:ПОРТ_ПАНЕЛИ

Например: http://123.45.67.89:48321

Введите логин и пароль, которые указали при установке.

Обзор интерфейса

После входа вы увидите:

Dashboard — общая статистика: аптайм, трафик, количество подключений
Inbounds — входящие подключения (здесь создаются протоколы)
Clients — управление пользователями
Settings — настройки панели (порт, путь, сертификат)
Xray Settings — настройки ядра Xray

Смена языка

По умолчанию панель на английском. Для переключения на русский:

Перейдите в Panel Settings
Найдите Language
Выберите Русский
Нажмите Save

Настройка VLESS + Reality

VLESS + Reality — это самая актуальная связка для обхода блокировок в России. Reality не требует собственного домена и TLS-сертификата — она маскирует ваш трафик под посещение легитимного сайта (например, google.com).

Почему VLESS + Reality?

Не блокируется — трафик неотличим от обычного HTTPS
Не нужен домен — в отличие от VLESS+TLS+WebSocket
Быстрый — минимальные накладные расходы
Безопасный — полноценное шифрование

Шаг 1: Создание Inbound

Перейдите в Inbounds → Add Inbound
Заполните:
- Remark: vless-reality (любое имя)
- Protocol: vless
- Listen IP: оставьте пустым
- Port: 443
- Total Traffic: 0 (безлимит) или укажите лимит в ГБ

Шаг 2: Настройка VLESS

В разделе Client:
- Email: имя пользователя (например, user1)
- Flow: xtls-rprx-vision — обязательно!

Шаг 3: Настройка Reality

В разделе Stream Settings:
- Transmission: TCP
- Security: Reality
- uTLS: chrome (рекомендуется) или firefox
В разделе Reality Settings:
- Dest (target): google.com:443 — сайт для маскировки
- Server Names (SNI): google.com
- Нажмите кнопку Get New Cert — сгенерируются ключи Reality
- Private Key и Public Key заполнятся автоматически
- Short IDs: оставьте значение по умолчанию
Нажмите Add

Сайт	Рекомендация
`google.com:443`	Универсальный вариант
`www.microsoft.com:443`	Хорошо для корпоративных сетей
`www.samsung.com:443`	Стабильный
`dl.google.com:443`	Хорош для маскировки больших объёмов
`yahoo.com:443`	Альтернатива

Создание подключений для пользователей

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

В списке Inbounds найдите созданный vless-reality
Нажмите значок + (Add Client)
Заполните:
- Email: уникальное имя (например, ivan, petya)
- Flow: xtls-rprx-vision
- Total Traffic (GB): лимит трафика (0 = безлимит)
- Expiry Date: дата окончания доступа
Нажмите Add Client

Получение ссылки подключения

После создания клиента:

Нажмите на иконку QR-код рядом с клиентом
Вы увидите:
- QR-код — для сканирования телефоном
- Ссылка (URI) — для копирования в клиентское приложение

Ссылка выглядит примерно так:

vless://UUID@IP:443?type=tcp&security=reality&pbk=PUBLIC_KEY&fp=chrome&sni=google.com&sid=SHORT_ID&flow=xtls-rprx-vision#имя

Управление клиентами

Редактировать — изменить лимиты, срок действия
Сбросить трафик — обнулить счётчик
Удалить — убрать доступ
Временно отключить — приостановить без удаления

Подключение клиентов

Android

Рекомендуемые приложения:

v2rayNG (Google Play / GitHub) — самое популярное
NekoBox (GitHub) — продвинутое

Настройка v2rayNG:

Установите приложение
Нажмите + → Import config from clipboard
Вставьте ссылку подключения
Нажмите кнопку Connect (значок V внизу)

iOS / iPadOS

Рекомендуемые приложения:

Streisand (App Store, бесплатно) — самое простое
V2Box (App Store) — много функций
FoXray (App Store) — продвинутое

Настройка Streisand:

Установите из App Store
Скопируйте ссылку подключения
Приложение автоматически предложит импорт
Нажмите Connect

Windows

Рекомендуемые приложения:

v2rayN (GitHub) — самое популярное
NekoRay (GitHub) — с удобным GUI
Invisible Man - XRay (GitHub) — минималистичное

Настройка v2rayN:

Скачайте последнюю версию с GitHub
Распакуйте архив
Запустите v2rayN.exe
Нажмите Servers → Import bulk URL from clipboard
Нажмите кнопку подключения в нижнем правом углу

macOS

Рекомендуемые приложения:

V2Box (App Store)
FoXray (App Store)
NekoRay (GitHub)

Linux

# Установка sing-box (универсальный клиент)
bash <(curl -fsSL https://sing-box.app/deb-install.sh)

Или используйте NekoRay с графическим интерфейсом.

Настройка подписок (Subscription)

Подписки позволяют раздавать конфигурации по одной ссылке. Когда вы меняете настройки сервера, клиенты получают обновления автоматически.

Включение подписок в 3X-UI

Перейдите в Panel Settings → Subscription
Включите Enable Subscription
Настройте:
- Subscription Port: порт для подписок (например, 2096)
- Subscription Path: путь (например, /sub/)
Нажмите Save и Restart Panel

Ссылка подписки

После включения у каждого клиента появится ссылка подписки:

https://ВАШ_IP:2096/sub/UUID_КЛИЕНТА

Эту ссылку клиент вводит один раз в приложение, и далее все обновления конфигов приходят автоматически.

Преимущества подписок

Один клиент — одна ссылка (вместо нескольких конфигов)
Автообновление при смене сервера
Можно добавить несколько серверов в одну подписку

Безопасность панели

Обязательные меры

1. Сменить порт панели

Не используйте порт по умолчанию (2053):

x-ui settings

Или в веб-интерфейсе: Panel Settings → Panel Port

2. Установить URL-путь панели

Вместо http://IP:PORT настройте путь:

Panel Settings → Panel URI Root Path: /mysecretpath/

Теперь панель доступна только по: http://IP:PORT/mysecretpath/

3. Настроить SSL для панели

Используйте Let’s Encrypt (нужен домен):

# Установка certbot
apt install certbot -y

# Получение сертификата
certbot certonly --standalone -d your-domain.com

Укажите пути к сертификатам в Panel Settings:

Public Key File: /etc/letsencrypt/live/your-domain.com/fullchain.pem
Private Key File: /etc/letsencrypt/live/your-domain.com/privkey.pem

4. Включить Fail2Ban

Защита от перебора паролей:

apt install fail2ban -y
systemctl enable fail2ban
systemctl start fail2ban

5. Настроить файрвол

# Установка UFW
apt install ufw -y

# Разрешить SSH
ufw allow 22

# Разрешить VLESS
ufw allow 443

# Разрешить панель (ваш порт)
ufw allow ПОРТ_ПАНЕЛИ

# Включить файрвол
ufw enable

Дополнительные меры

Регулярно обновляйте панель: x-ui update
Меняйте пароль раз в месяц
Настройте Telegram-бот для уведомлений об авторизации
Ограничьте доступ к панели по IP (если есть статический IP)

Мониторинг и обслуживание

Проверка состояния

# Статус 3X-UI
x-ui status

# Логи Xray
x-ui log

# Использование ресурсов
htop

# Свободное место на диске
df -h

# Сетевые подключения
ss -tulnp

Обновление 3X-UI

x-ui update

Или установить конкретную версию:

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

Бэкап базы данных

База данных 3X-UI хранится в /etc/x-ui/x-ui.db. Создавайте регулярные бэкапы:

# Ручной бэкап
cp /etc/x-ui/x-ui.db /root/x-ui-backup-$(date +%Y%m%d).db

# Автоматический бэкап (cron, каждый день в 3:00)
echo "0 3 * * * cp /etc/x-ui/x-ui.db /root/x-ui-backup-\$(date +\%Y\%m\%d).db" | crontab -

Telegram-бот для уведомлений

3X-UI поддерживает встроенный Telegram-бот:

Создайте бота через @BotFather в Telegram
Получите Bot Token
Узнайте свой Chat ID через @userinfobot
В 3X-UI: Panel Settings → Telegram Bot
Введите токен и Chat ID
Включите уведомления

Бот будет отправлять:

Уведомления о входе в панель
Отчёты о трафике
Предупреждения об истечении подписок

Частые ошибки и решения

«Connection refused» при входе в панель

Причина: панель не запущена или неверный порт.

x-ui status    # проверить статус
x-ui start     # запустить
x-ui restart   # перезапустить

Проверьте файрвол:

ufw status
ufw allow ПОРТ_ПАНЕЛИ

«Timeout» при подключении через VPN

Причина: порт 443 заблокирован провайдером или IP в чёрном списке.

Проверьте, открыт ли порт: ss -tulnp | grep 443
Проверьте IP: попробуйте открыть https://ВАШ_IP в браузере
Если IP заблокирован — смените IP у хостера или купите новый VPS

Reality не работает

Причина: неправильный Dest/SNI или отсутствует flow.

Убедитесь, что Flow = xtls-rprx-vision (и в Inbound, и в клиенте)
Проверьте, что Dest и SNI совпадают (например, оба google.com)
Убедитесь, что целевой сайт поддерживает TLS 1.3

Низкая скорость

Проверьте нагрузку на сервер: htop
Проверьте канал: speedtest-cli
Попробуйте другую локацию сервера (ближе к РФ)
Убедитесь, что uTLS = chrome в настройках Reality

Панель не обновляется

x-ui update
# Если не помогает:
systemctl stop x-ui
bash <(curl -Ls https://raw.githubusercontent.com/MHSanaei/3x-ui/master/install.sh)

Автоматизация с Tunly

Ручная настройка 3X-UI — это хороший способ разобраться в технологии. Но если вы хотите запустить VPN как бизнес и продавать подключения, ручное управление быстро становится проблемой:

Создавать пользователей вручную
Отслеживать оплаты и продлевать подписки
Управлять несколькими серверами
Общаться с каждым клиентом в личке
Нет удобного приложения для клиентов

Что делает Tunly

Tunly — это платформа, которая работает поверх 3X-UI и автоматизирует всё:

Задача	Без Tunly (вручную)	С Tunly
Создание пользователей	Вручную в 3X-UI	Автоматически при оплате
Приём платежей	Вручную (перевод на карту)	YooKassa, СБП, Telegram Stars, крипта
Продление подписок	Вручную	Автоматически
Приложение для клиентов	Нет	Telegram Mini App с вашим брендом
Управление серверами	Отдельно для каждого	Единая панель для всех
Тарифы и промокоды	Нет	Гибкая система
Аналитика	Нет	Дашборд с метриками

Как это работает

Вы подключаете свои VPS-серверы (с 3X-UI или без — Tunly установит автоматически)
Настраиваете бренд: название, логотип, цвета
Получаете готовый Telegram Mini App для ваших клиентов
Клиенты оплачивают подписку → получают VPN-ключ автоматически
Вы управляете всем из одной админ-панели

Для кого Tunly

Вы уже настроили 3X-UI и раздаёте VPN друзьям → хотите монетизировать
Вы хотите запустить VPN-сервис, но не хотите писать код
У вас уже есть серверы с 3X-UI → подключите их к Tunly за 5 минут

Попробуйте бесплатно на tunly.net →

Заключение

3X-UI — мощная и бесплатная панель для запуска собственного VPN-сервера. С протоколом VLESS + Reality вы получаете стабильное соединение, которое работает в России.

Подведём итог:

Купите VPS за пределами РФ (от 3€/мес)
Установите 3X-UI одной командой
Настройте VLESS + Reality
Раздайте ссылки подключения клиентам

Если вы хотите превратить это в бизнес — используйте Tunly для автоматизации продаж, платежей и управления клиентами. Платформа работает поверх 3X-UI, так что ваши существующие серверы подключатся за минуты.

Есть вопросы? Напишите нам в Telegram — поможем с настройкой.

Содержание

Что такое 3X-UI и зачем она нужна

Почему именно 3X-UI?

3X-UI vs другие панели

Требования к серверу

Минимальные требования

Рекомендуемые требования (до 50 пользователей)

Покупка VPS

Рекомендуемые провайдеры

На что обращать внимание

Пример: покупка VPS на Hetzner

Установка 3X-UI на сервер

Шаг 1: Подключение к серверу по SSH

Шаг 2: Обновление системы

Шаг 3: Установка 3X-UI

Шаг 4: Настройка при установке

Шаг 5: Проверка установки

Первый вход в панель 3X-UI

Обзор интерфейса

Смена языка

Настройка VLESS + Reality

Почему VLESS + Reality?

Шаг 1: Создание Inbound

Шаг 2: Настройка VLESS

Шаг 3: Настройка Reality

Популярные Dest-сайты для Reality

Создание подключений для пользователей

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

Получение ссылки подключения

Управление клиентами

Подключение клиентов

Android

iOS / iPadOS

Windows

macOS

Linux

Настройка подписок (Subscription)

Включение подписок в 3X-UI

Ссылка подписки

Преимущества подписок

Безопасность панели

Обязательные меры

1. Сменить порт панели

2. Установить URL-путь панели

3. Настроить SSL для панели

4. Включить Fail2Ban

5. Настроить файрвол

Дополнительные меры

Мониторинг и обслуживание

Проверка состояния

Обновление 3X-UI

Бэкап базы данных

Telegram-бот для уведомлений

Частые ошибки и решения

«Connection refused» при входе в панель

«Timeout» при подключении через VPN

Reality не работает

Низкая скорость

Панель не обновляется

Автоматизация с Tunly

Что делает Tunly

Как это работает

Для кого Tunly

Заключение