# 3X-UI – Руководство по установке и использованию панели ### **Краткое описание 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 выполните следующую команду: ```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 ``` *** #### 1. Установка через Docker ```bash bash <(curl -sSL https://get.docker.com) git clone https://github.com/mhsanaei/3x-ui.git cd 3x-ui 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-сертификата. #### **Способ 1.** Настройка SSL-сертификата через **ACME** в панели 3X-UI. 1. Убедитесь, что ваш домен корректно указывает на сервер (A-запись в DNS настроена правильно). 2. Выполните в терминале команду:\ `x-ui`\ Затем выберите пункт **«Управление SSL-сертификатами»**. 3. В открывшемся меню доступны следующие действия: * **Получить SSL** – выпустить новый сертификат. * **Отозвать SSL** – удалить существующий сертификат. * **Принудительное продление** – обновить сертификат вручную. * **Показать домены** – вывести список доступных сертификатов. * **Указать пути к сертификатам панели** – задать пути к файлам сертификата, которые будет использовать панель управления. *** #### **Способ 2.** Настройка SSL-сертификата через через Certbot. ```bash apt install certbot -y certbot certonly --standalone --agree-tos --register-unsafely-without-email -d yourdomain.com certbot renew --dry-run ``` Замените `yourdomain.com` на ваш домен. *** ### Вход в веб-панель После установки выполните: ```bash x-ui ``` Выберите пункт `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** укажите значение, например: ``` dl.google.com:443 ``` 4. В поле **SNI** укажите значение, например: ``` dl.google.com ``` 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 ```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` *** ### Дополнительные функции * блокировка рекламы и IP-адресов; * маршрутизация трафика (Google, Netflix, Spotify, OpenAI) через WARP; * поддержка **WARP** встроена, начиная с версии `v2.1.0`.
Просто включите нужную опцию в панели управления. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wiki.u1host.com/vpn-guide/3x-ui-rukovodstvo-po-ustanovke-i-ispolzovaniyu-paneli.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.