Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

3X-UI – Руководство по установке и использованию панели

Установка панели 3X-UI на виртуальный сервер для настройки VPN VLESS, ShadowSocks, Wireguard и VMess.

Краткое описание 3X-UI

3X-UI – современная open-source веб-панель для удобного управления Xray-core, которая переводит рутинные операции администрирования в привычный веб-кабинет и сокращает время на обслуживание сервисов.

Это решение упрощает эксплуатацию – централизует управление подключениями, учётом пользователей и аналитикой, даёт быстрый доступ к конфигурациям и логам, чтобы провайдеры, системные администраторы и продвинутые пользователи могли запускать и поддерживать сервисы без лишних усилий.

Подробное перечисление функций и возможностей – в разделе «Возможности панели 3X-UI» ниже.

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

Возможности панели 3X-UI

  • Поддержка популярных протоколов – VMess, VLESS, Trojan, Shadowsocks, WireGuard, SOCKS, HTTP и др.

  • Многоязычный интерфейс – русский, английский, 中文, español и другие, включая переключение в один клик.

  • Управление пользователями и квотами – создание/удаление аккаунтов, лимиты трафика, сроки действия, блокировка и приоритеты.

  • Автоматическая выдача и продление SSL – интеграция с Let’s Encrypt и поддержка собственных сертификатов.

  • Поддержка транспорта Reality – конфигурации для обхода блокировок и безопасной передачи трафика.

  • Мониторинг и статистика в реальном времени – трафик, активные подключения, графики, журналы и экспорт данных.

  • Интеграция с Docker – готовые образы и развёртывание через Docker / Docker-Compose.

  • Полнофункциональный веб-интерфейс – все задачи администрирования выполняются через GUI (работа в консоли не требуется).

Ручная установка

Для установки 3X-UI выполните следующую команду:

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

  • при запросе параметров панели выберите y для активации защиты;

  • используйте нестандартный порт для доступа к веб-интерфейсу.

Установка определённой версии

Чтобы установить нужную версию панели, укажите её номер в команде установки. Например, для версии v1.7.9:

1. Установка через Docker

Альтернативный вариант:

Настройка SSL-сертификатов

В 3x-ui предусмотрено несколько способов настройки SSL-сертификата.

Способ 1. Настройка SSL-сертификата через ACME в панели 3X-UI.

  1. Убедитесь, что ваш домен корректно указывает на сервер (A-запись в DNS настроена правильно).

  2. Выполните в терминале команду: x-ui Затем выберите пункт «Управление SSL-сертификатами».

  3. В открывшемся меню доступны следующие действия:

    • Получить SSL – выпустить новый сертификат.

    • Отозвать SSL – удалить существующий сертификат.

    • Принудительное продление – обновить сертификат вручную.

    • Показать домены – вывести список доступных сертификатов.

    • Указать пути к сертификатам панели – задать пути к файлам сертификата, которые будет использовать панель управления.

Способ 2. Настройка SSL-сертификата через через Certbot.

Замените yourdomain.com на ваш домен.

Вход в веб-панель

После установки выполните:

Выберите пункт 10, чтобы просмотреть текущие настройки панели: URL, логин и пароль.

Откройте ссылку из Access URL и войдите с полученными данными.

Настройка подключений (Inbounds)

Создание подключения

  1. Перейдите в раздел Inbounds.

  2. Нажмите Add inbound.

  3. Укажите любое имя в поле Remark.

  4. Выберите протокол (VMess, VLESS, Trojan, ShadowSocks или WireGuard).

  5. Сохраните настройки.

Настройка протоколов

VLESS + Reality

(рекомендуется для обхода блокировок)

  1. В поле Security type выберите Reality.

  2. Установите uTLS – chrome.

  3. В поле Dest укажите значение, например:

  4. В поле SNI укажите значение, например:

  5. Нажмите Get New Cert для автоматической генерации случайных ключей.

  6. Нажмите Create, чтобы сохранить и создать подключение.

Настройка ограничений

Для каждого подключения можно задать:

  • лимит трафика (ГБ);

  • срок действия (в днях);

  • лимит по IP (одновременные подключения);

  • автоматическое отключение при превышении лимита.

Управление пользователями

  1. В разделе Inbounds нажмите на + рядом с подключением.

  2. Выберите Add Client.

  3. Укажите имя, лимиты, уникальный ID и срок действия.

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

Windows, macOS, Linux

Рекомендуемые клиенты:

  • V2RayTun (Windows, Linux, macOS)

  • Hiddify (Windows, Linux, macOS)

  • Happ (Windows)

Для подключения:

  1. В панели 3X-UI нажмите на QR-код пользователя.

  2. Скопируйте конфигурацию либо отсканируйте QR-код с помощью VPN-клиента.

  3. Импортируйте конфигурацию и подключитесь.

Android и iOS

Рекомендуемые клиенты:

  • V2RayTun

  • Happ

  • Hiddify

Для подключения:

  1. Установите приложение.

  2. Отсканируйте QR-код или импортируйте конфигурацию.

  3. Выполните подключение.

Мониторинг и статистика

Панель отображает:

  • общий объём трафика;

  • использование трафика по пользователям;

  • статусы подключений;

  • срок действия и статус учётных записей;

  • IP-адреса подключений.

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

Для Docker:

Решение проблем

Стандартные параметры:

  • порт панели: 2053

  • база данных: /etc/x-ui/x-ui.db

  • конфигурация Xray: /usr/local/x-ui/bin/config.json

Дополнительные функции

  • блокировка рекламы и IP-адресов;

  • маршрутизация трафика (Google, Netflix, Spotify, OpenAI) через WARP;

  • поддержка WARP встроена, начиная с версии v2.1.0.

Просто включите нужную опцию в панели управления.

PreviousWireGuard – Установка и настройка на собственном сервереNextOpenVPN – Настройка личного VPN-сервера

Last updated