← К вики

Установка 3x-ui

Как установить 3x-ui — веб-панель управления Xray-proxy — на VPS.

Время: 10 мин · Сложность: ★☆☆☆☆

Подходит: ✓ Ubuntu 22.04 · ✓ Debian 12


Краткое описание

3x-ui — веб-панель для управления Xray-сервером. Поддерживает протоколы VLESS, VMess и Trojan, позволяет создавать подключения и генерировать конфиги для клиентов через браузер — без ручной правки JSON-файлов. Используется для организации личного прокси-сервера.

Когда пригодится

  • Хотите поднять личный прокси-сервер с красивым интерфейсом
  • Нужно управлять несколькими пользователями и их лимитами трафика
  • Хотите использовать современные протоколы: VLESS+Reality, VMess+WS+TLS
  • Ищете удобную альтернативу ручной настройке Xray через конфигурационные файлы

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

  • VPS с чистой Ubuntu 22.04 или Debian 12
  • Root-доступ к серверу

Пошаговая инструкция

Шаг 1. Подключитесь к серверу

ssh root@YOUR_SERVER_IP

Шаг 2. Обновите систему

apt update && apt upgrade -y

Шаг 3. Запустите установщик 3x-ui

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

В процессе установщик задаст вопросы:

  • Порт панели — по умолчанию 2053. Можно оставить или указать свой.
  • Путь к веб-интерфейсу — произвольный путь, например /panel. Добавляет дополнительный уровень защиты.
  • Логин и пароль — задайте надёжные учётные данные.

Запишите порт и путь — они понадобятся для входа.

Шаг 4. Откройте порт панели

ufw allow 2053

Если задали другой порт — откройте его вместо 2053.

Шаг 5. Войдите в панель

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

http://YOUR_SERVER_IP:2053/ВАШ_ПУТЬ

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

Шаг 6. Добавьте первое подключение (Inbound)

  1. В панели перейдите в раздел Inbounds.
  2. Нажмите Add Inbound.
  3. Выберите протокол — VLESS рекомендуется для новых пользователей.
  4. В разделе Security выберите Reality — он не требует домена и обеспечивает маскировку трафика.
  5. Нажмите Add для сохранения.

Шаг 7. Получите конфигурацию для клиента

  1. В списке Inbounds найдите созданное подключение.
  2. Нажмите на иконку QR-кода или скопируйте ссылку вида vless://....
  3. Добавьте эту ссылку в клиентское приложение:
    • Windows/Linux — v2rayN
    • Android — v2rayNG или NekoBox
    • iOS — Shadowrocket или Streisand
    • macOS — Hiddify или NekoRay

Проверка результата

  • Панель открывается по адресу http://YOUR_SERVER_IP:2053/ВАШ_ПУТЬ.
  • В разделе Inbounds отображается созданное подключение со статусом активно.
  • Клиентское приложение подключается и показывает активное соединение.
  • Проверьте IP-адрес на сайте 2ip.ru — должен отображаться IP вашего VPS.

Возможные ошибки

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

ufw status | grep 2053

Если порта нет в списке — добавьте его: ufw allow 2053.

Сервис не запущен Проверьте статус x-ui:

systemctl status x-ui

Если сервис остановлен — запустите:

systemctl start x-ui

Для включения автозапуска:

systemctl enable x-ui

Клиент подключается, но интернет не работает Убедитесь, что на сервере разрешён форвардинг трафика:

sysctl net.ipv4.ip_forward

Если значение 0 — включите:

echo "net.ipv4.ip_forward=1" >> /etc/sysctl.conf && sysctl -p

Reality не работает Убедитесь, что порт, указанный в Inbound, не занят другим сервисом, и что uDest (целевой сайт для маскировки) доступен с вашего сервера.

FAQ

Чем VLESS+Reality лучше VMess? VLESS+Reality не требует домена и TLS-сертификата, при этом эффективно маскирует трафик. VMess+WebSocket+TLS подходит, если у вас есть домен и вы хотите использовать CDN (например, Cloudflare).

Как ограничить трафик для пользователя? При создании или редактировании Inbound укажите значение в поле Total Flow — после достижения лимита подключение автоматически отключится.

Как обновить 3x-ui? Запустите тот же установщик — он предложит опцию обновления:

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

Можно ли использовать 3x-ui с Cloudflare? Да, с протоколом VMess+WebSocket+TLS. Для этого нужен домен, подключённый к Cloudflare, и SSL-сертификат. VLESS+Reality с Cloudflare не совместим.

Как сделать резервную копию настроек? В панели перейдите в SettingsBackupExport. Файл резервной копии содержит все Inbounds и настройки.

Полезные ссылки

Следующие статьи

Сейчас работают только те cookie, без которых сайт не откроется. Разрешите ещё аналитические — будем видеть, где интерфейс мешает, и чинить это.