# 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`.
Просто включите нужную опцию в панели управления.
