> For the complete documentation index, see [llms.txt](https://wiki.u1host.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.u1host.com/vpn-guide/3x-ui-rukovodstvo-po-ustanovke-i-ispolzovaniyu-paneli.md). # 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 This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://wiki.u1host.com/vpn-guide/3x-ui-rukovodstvo-po-ustanovke-i-ispolzovaniyu-paneli.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.