Знакомство с 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, добавляющий более широкую поддержку протоколов, повышенную стабильность, поклиентский учёт трафика, управление несколькими узлами и множество улучшений для удобства работы.
Готовы к установке? Переходите к разделу Установка.
Документация 3x-ui
Официальная документация по 3x-ui — продвинутой веб-панели для управления серверами Xray-core, прокси, клиентами и подписками.
Установка
Установите 3x-ui с помощью официального скрипта (стабильная, фиксированная или dev-сборка), в автоматическом режиме / через cloud-init либо в Docker — и выберите SQLite или PostgreSQL.

3x-ui