3x-ui3x-ui
Начало работы

Знакомство с 3x-ui

Веб-панель для Xray-core — управляйте входящими подключениями, протоколами, клиентами и подписками из браузера, не редактируя JSON вручную.

3x-ui — это веб-панель управления, которая работает поверх Xray-core, прокси-движка, который непосредственно передаёт ваш трафик. Вместо того чтобы вручную писать и перезагружать JSON-конфигурацию Xray, вы управляете всем — входящими подключениями, протоколами, клиентами, сертификатами, подписками — из панели управления в браузере.

Как всё связано между собой

  • Панель — это уровень управления: она хранит вашу конфигурацию в базе данных, отображает панель управления, предоставляет REST API и записывает актуальную конфигурацию Xray.
  • Xray-core — это уровень передачи данных: он принимает клиентские подключения на ваших входящих подключениях и пересылает трафик к месту назначения.
  • Клиентские приложения (такие как v2rayNG, Clash/Mihomo, Hiddify и другие) подключаются по ссылке для подключения или подписке, которую панель генерирует для каждого клиента.

Что она вам даёт

  • Панель управления входящими подключениями по всем основным протоколам — VLESS, VMess, Trojan, Shadowsocks, WireGuard, Hysteria2, SOCKS, HTTP и Dokodemo-door.
  • Полноценная поддержка REALITY и XTLS-Vision для скрытных и быстрых транспортов.
  • Поклиентские квоты трафика, даты истечения, ограничения по IP, статус «онлайн» и ссылки для подключения / QR-коды в один клик.
  • Подписки в форматах VLESS, Clash/Mihomo и JSON.
  • Инструменты для эксплуатации: управление несколькими узлами, Telegram-бот, резервные копии, ограничение по IP на базе Fail2ban и документированный REST API.

Что под капотом

УровеньТехнология
БэкендGo с веб-фреймворком Gin
ФронтендTypeScript / React
База данныхSQLite (по умолчанию) или PostgreSQL
Прокси-движокXray-core (входит в комплект и управляется панелью)

База данных SQLite по умолчанию находится по пути /etc/x-ui/x-ui.db, а панель слушает порт 2053 по умолчанию. Оба значения настраиваются — см. Первый вход и справочник по переменным окружения.

Для кого она

3x-ui рассчитана на всех, кто запускает собственный сервер Xray: от одного личного VPS до операторов, управляющих множеством узлов и клиентов. Если вам нужна вся мощь Xray-core без необходимости жить в файлах JSON-конфигурации, это для вас.

3x-ui — это улучшенный форк оригинального проекта X-UI, добавляющий более широкую поддержку протоколов, повышенную стабильность, поклиентский учёт трафика, управление несколькими узлами и множество улучшений для удобства работы.

Готовы к установке? Переходите к разделу Установка.

On this page