Панель управления 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 <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)В процессе инсталляции вам будут предложены следующие опции:
- Изменение настроек панели: Рекомендуется согласиться (ввести
y) для повышения уровня безопасности. - Указание порта панели: Желательно использовать нестандартный порт.
Установка конкретной версии
Чтобы установить определенную версию панели, укажите ее номер в переменной команды установки. Например, для версии v1.7.9 это будет выглядеть так:
VERSION=v1.7.9 && bash <(curl -Ls "https://raw.githubusercontent.com/mhsanaei/3x-ui/$VERSION/install.sh") $VERSIONРазвертывание через Docker
Установка Docker:
bash
bash <(curl -sSL https://get.docker.com) ```
Клонирование репозитория проекта:
bash
git clone https://github.com/mhsanaei/3x-ui.git cd 3x-ui ```
Запуск сервиса:
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 достаточно выполнить следующие команды:
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 <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)Если вы используете Docker для развертывания, потребуется выполнить следующие команды:
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 интегрирован и не требует отдельной установки.
Достаточно активировать нужную конфигурацию непосредственно в панели управления.