Skip to content

Панель управления 3x-ui: установка и использование

О панели 3x-ui

3X-UI представляет собой универсальную веб-панель для эффективного управления серверами, обеспечивающую поддержку широкого спектра протоколов, включая VMess, VLESS, Trojan, ShadowSocks и WireGuard.

Этот инструмент упрощает настройку приватных соединений, управление множеством пользователей, а также позволяет устанавливать лимиты на объем трафика, срок действия и количество подключений с различных IP-адресов.

Важное примечание

Для клиентов нашего хостинга предусмотрена полностью автоматизированная установка панели 3X-UI, которая активируется как при первоначальном заказе услуги, так и с помощью скриптов в панели управления виртуальной машиной. После этого вам останется только создать пользователей и настроить параметры подключений для ваших устройств.

Ключевые возможности 3X-UI

  • Мультиязычный интерфейс: Доступны английский, фарси, китайский, русский, вьетнамский и испанский языки.
  • Поддержка различных протоколов: Совместимость с VMess, VLESS, Trojan, ShadowSocks, WireGuard.
  • Многопользовательское управление: Возможность создавать и управлять множеством аккаунтов.
  • Настраиваемые ограничения: Установка лимитов трафика, срока действия и количества IP-адресов.
  • Автоматизация SSL-сертификатов: Упрощенное управление SSL-сертификатами.
  • Интуитивный веб-интерфейс: Удобство использования благодаря простому и понятному интерфейсу.
  • Мониторинг трафика: Подробная статистика потребления трафика.
  • Функции фильтрации: Блокировка рекламы и гибкая маршрутизация сетевого трафика.
  • Поддержка Reality: Использование технологии Reality для обхода сетевых ограничений.

Инструкции по установке

Автоматическая установка для пользователей хостинга

При первичном заказе

В процессе оформления услуги выберите опцию "3X-UI" в выпадающем меню, завершите заказ и дождитесь окончания обработки. Сразу после активации сервера вы получите все необходимые данные для доступа к операционной системе и панели 3X-UI, что позволит вам приступить к настройке подключений.

Через панель управления виртуальной машиной

Перейдите в панель управления ВМ, выберите нужный сервер, затем в правом верхнем углу разверните "Меню" и выберите "Запустить скрипт". В появившемся диалоговом окне выберите "3X-UI" и активируйте опцию "Отправить письмо, которое привязано к скрипту". После завершения установки на ваш адрес электронной почты придет письмо с данными для входа в панель управления, после чего вы сможете войти и начать настройку подключений.

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

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

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

В процессе инсталляции вам будут предложены следующие опции:

  • Изменение настроек панели: Рекомендуется согласиться (ввести y) для повышения уровня безопасности.
  • Указание порта панели: Желательно использовать нестандартный порт.

Установка конкретной версии

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

bash
VERSION=v1.7.9 && bash <(curl -Ls "https://raw.githubusercontent.com/mhsanaei/3x-ui/$VERSION/install.sh") $VERSION

Развертывание через Docker

  1. Установка Docker:

    bash

bash <(curl -sSL https://get.docker.com) ```

  1. Клонирование репозитория проекта:

    bash

git clone https://github.com/mhsanaei/3x-ui.git cd 3x-ui ```

  1. Запуск сервиса:

    bash

docker compose up -d ```

В качестве альтернативы можно использовать следующую команду:

```bash

docker run -itd
-e XRAY_VMESS_AEAD_FORCED=false
-v $PWD/db/:/etc/x-ui/
-v $PWD/cert/:/root/cert/
--network=host
--restart=unless-stopped
--name 3x-ui
ghcr.io/mhsanaei/3x-ui:latest ```

Конфигурация SSL-сертификатов

Панель 3x-ui предлагает несколько методов для настройки SSL-сертификатов.

Через ACME

Для управления SSL-сертификатами с использованием протокола ACME:

  • Удостоверьтесь, что ваш домен корректно направлен на этот сервер (проверьте правильность А-записи в DNS).
  • Выполните команду x-ui в терминале, затем выберите опцию "Управление SSL-сертификатами".
  • Вам будут доступны следующие функции:
    • Получить SSL: Для получения новых SSL-сертификатов.
    • Отозвать: Для аннулирования существующих SSL-сертификатов.
    • Принудительное продление: Для принудительного обновления SSL-сертификатов.
    • Показать домены: Для просмотра всех доменных сертификатов, установленных на сервере.
    • Настройка путей: Для указания сертификата, который будет использоваться панелью управления для вашего домена.

С помощью Certbot

Для установки и использования утилиты Certbot достаточно выполнить следующие команды:

bash
apt-get install certbot -y
certbot certonly --standalone --agree-tos --register-unsafely-without-email -d yourdomain.com
certbot renew --dry-run
  • где yourdomain.com следует заменить на ваш домен.

Доступ к веб-панели

После завершения установки панели управления следуйте этим инструкциям:

  • Введите в терминале команду x-ui.
  • Выберите опцию 10, введя соответствующее число.

Вам будут предоставлены учетные данные для входа в панель в формате console.

Перейдите по ссылке, указанной в Access URL, и авторизуйтесь, используя свои username и password.

Управление входящими подключениями (Inbounds)

Создание нового входящего подключения

  • Перейдите в раздел "Inbounds".
  • Нажмите кнопку "Add inbound" для создания нового подключения.
  • В появившемся окне введите любое удобное название в поле "Remark".
  • Выберите требуемый тип протокола (VMess, VLESS, Trojan, ShadowSocks или WireGuard).

Конфигурация протоколов

Протокол VLESS + Reality (рекомендован для обхода блокировок)

  • Установите тип безопасности - Reality.
  • Укажите uTLS - chrome.
  • В поле "Dest" введите значение, например, dl.google.com:443.
  • В поле "SNI" задайте значение, например, dl.google.com.
  • Нажмите Get New Cert для автоматической генерации случайных ключей.
  • Нажмите кнопку Create для сохранения и создания подключения.

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

Для каждого подключения доступна настройка следующих параметров:

  • Лимит на объем трафика (в гигабайтах).
  • Срок действия (в днях).
  • Ограничение на количество IP-адресов (для одновременных подключений).
  • Возможность включения или отключения установленных ограничений.

Управление учетными записями пользователей

В разделе "Inbounds":

  • Чтобы просмотреть дополнительные параметры, нажмите значок + рядом с созданным подключением.
  • Для добавления нового пользователя выберите опцию "Add Client" add client.
  • Для каждой учетной записи можно настроить:
    • Имя: Произвольное название для идентификации.
    • Лимит трафика: Максимальный объем передаваемых данных.
    • Срок действия: Период активности учетной записи.
    • Уникальный ID: Персональный идентификатор пользователя.

Подключение пользовательских устройств

Для Windows, macOS и Linux

Рекомендованные клиенты для этих операционных систем:

  • Hiddify (Windows, Linux, macOS)
  • NekoRay (Windows, Linux)

Процесс подключения:

  • В веб-панели 3x-ui найдите QR-код для нужного пользователя.
  • Скопируйте конфигурацию или отсканируйте QR-код с помощью вашего VPN-клиента.
  • Импортируйте полученную конфигурацию в клиент и установите соединение.

Для Android

Рекомендованные клиенты для Android-устройств:

  • Hiddify
  • v2rayNG

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

  • Загрузите и установите клиент из Google Play Store.
  • В веб-панели 3x-ui найдите QR-код для требуемого пользователя.
  • Отсканируйте QR-код с помощью VPN-клиента или скопируйте и импортируйте конфигурацию вручную.
  • Используя импортированную конфигурацию, установите соединение.

Для iOS

Рекомендованные клиенты для устройств на базе iOS:

  • FoXray
  • v2box
  • ShadowRocket

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

  • Загрузите и установите клиент из Apple App Store.
  • В веб-панели 3x-ui найдите QR-код для требуемого пользователя.
  • Отсканируйте QR-код с помощью клиента или скопируйте и импортируйте конфигурацию вручную.
  • Используя импортированную конфигурацию, установите соединение.

Отслеживание активности и сбор статистики

В веб-панели 3X-UI вы можете отслеживать активность ваших пользователей по следующим параметрам:

  • Общий объем потребленного трафика: Суммарные данные по всем пользователям.
  • Трафик по каждому пользователю: Детальная информация о потреблении трафика.
  • Статус соединений: Актуальное состояние подключений.
  • Сроки действия подписок: Информация о датах окончания подписок.
  • Использование IP-адресов: Данные о задействованных IP-адресах.

Процедура обновления 3X-UI

Для обновления панели до самой актуальной версии выполните следующую команду:

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

Если вы используете Docker для развертывания, потребуется выполнить следующие команды:

bash
cd 3x-ui
docker compose down
docker compose pull 3x-ui
docker compose up -d

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

Основные параметры

  • Порт: 2053.
  • Расположение базы данных: /etc/x-ui/x-ui.db.
  • Путь к конфигурационному файлу Xray: /usr/local/x-ui/bin/config.json.

Расширенные параметры Xray

Через веб-панель вы можете сконфигурировать дополнительные возможности Xray, включая:

  • Блокировку рекламного контента.
  • Фильтрацию IP-адресов определенных стран.
  • Блокировку доменов.
  • Перенаправление трафика для Google, Netflix, Spotify, OpenAI (ChatGPT) через WARP.

Конфигурация WARP

В версиях панели v2.1.0 и более поздних WARP интегрирован и не требует отдельной установки.

Достаточно активировать нужную конфигурацию непосредственно в панели управления.