144 lines
5.1 KiB
Markdown
144 lines
5.1 KiB
Markdown
# 3x-ui-pro
|
||
|
||
🇬🇧 [English version](README_EN.md)
|
||
|
||
Автоматическая установка панели [3x-ui](https://github.com/MHSanaei/3x-ui) с nginx, SSL, Clash-подпиской и диагностикой сети.
|
||
|
||
- Debian 12 / Ubuntu 24
|
||
- Два домена или поддомена (для панели и для REALITY)
|
||
- Автоматическое обновление SSL-сертификатов
|
||
- Поддержка VLESS+REALITY, VLESS+WebSocket, VLESS+XHTTP, Trojan+gRPC — всё через порт 443
|
||
|
||
---
|
||
|
||
## Что устанавливается
|
||
|
||
| Компонент | Описание |
|
||
|-----------|----------|
|
||
| 3x-ui | VPN-панель с веб-интерфейсом |
|
||
| nginx | Обратный прокси, SNI-роутинг |
|
||
| certbot | Let's Encrypt SSL |
|
||
| Clash-подписка | Автоматическая выдача `clash.yaml` по User-Agent |
|
||
| Диагностика | MTR-трейсер + тест скорости в браузере |
|
||
| Фейковый сайт | Случайный HTML-сайт-прикрытие |
|
||
| Бэкап | Скрипт резервного копирования |
|
||
| AdGuard Home | Опционально: DNS с блокировкой рекламы (DoH) — отдельный скрипт |
|
||
|
||
---
|
||
|
||
## Установка
|
||
|
||
**Шаг 1 — скачать скрипт**
|
||
|
||
```bash
|
||
wget -qO x-ui-latest.sh https://git.pub38.com/Evgen/3x-ui-pro/raw/branch/main/x-ui-latest.sh
|
||
```
|
||
|
||
**Шаг 2 — запустить**
|
||
|
||
```bash
|
||
bash x-ui-latest.sh
|
||
```
|
||
|
||
---
|
||
## Патч
|
||
|
||
Применить текущие фиксы к существующей установке (без изменений БД):
|
||
|
||
```bash
|
||
bash <(curl -fsSL https://git.pub38.com/Evgen/3x-ui-pro/raw/branch/main/x-ui-patch.sh)
|
||
```
|
||
|
||
---
|
||
|
||
## AdGuard Home (опционально)
|
||
|
||
Устанавливает [AdGuard Home](https://github.com/AdguardTeam/AdGuardHome) на домен панели — без отдельного домена и открытых портов, всё через существующий 443:
|
||
|
||
- **DNS-over-HTTPS** для клиентов: `https://<домен-панели>/dns-query`
|
||
- **Админка** — на случайном пути `/adg-<random>/` (логин и пароль выводит скрипт)
|
||
|
||
```bash
|
||
bash <(curl -fsSL https://git.pub38.com/Evgen/3x-ui-pro/raw/branch/main/x-ui-adguard.sh)
|
||
```
|
||
|
||
Повторный запуск безопасен (настройки и пароль сохраняются). После установщика или патча запустите скрипт ещё раз — они перезаписывают конфиг nginx.
|
||
|
||
Удаление:
|
||
|
||
```bash
|
||
bash <(curl -fsSL https://git.pub38.com/Evgen/3x-ui-pro/raw/branch/main/x-ui-adguard.sh) -uninstall y
|
||
```
|
||
|
||
---
|
||
|
||
## Удаление
|
||
|
||
```bash
|
||
bash x-ui-latest.sh -uninstall y
|
||
```
|
||
|
||
---
|
||
|
||
## Параметры запуска
|
||
|
||
| Параметр | Описание |
|
||
|----------|----------|
|
||
| `-install n` | Пропустить установку системных пакетов (по умолчанию `y`) |
|
||
| `-subdomain <домен>` | Домен панели и подписок |
|
||
| `-reality_domain <домен>` | Домен назначения для REALITY |
|
||
| `-auto_domain y` | Автоопределение домена (без ручного ввода) |
|
||
| `-version <версия>` | Установить конкретную версию 3x-ui (например `3.4.2`), по умолчанию — последняя |
|
||
| `-uninstall y` | Полное удаление |
|
||
|
||
---
|
||
|
||
## Clash-подписка
|
||
|
||
Работает через определение User-Agent — один URL, разное поведение:
|
||
|
||
- **Clash / Mihomo / Stash** → получают `clash.yaml` с готовой конфигурацией
|
||
- **Обычный браузер / другие клиенты** → получают стандартную страницу подписки 3x-ui
|
||
|
||
Ссылку для импорта выводит скрипт после установки.
|
||
|
||
---
|
||
|
||
## Бэкап и восстановление
|
||
|
||
**Установить скрипт бэкапа**
|
||
|
||
```bash
|
||
wget -qO /usr/local/bin/x-ui-backup https://git.pub38.com/Evgen/3x-ui-pro/raw/branch/main/assets/backup/x-ui-backup.sh
|
||
chmod +x /usr/local/bin/x-ui-backup
|
||
```
|
||
|
||
**Создать бэкап**
|
||
|
||
```bash
|
||
x-ui-backup backup
|
||
```
|
||
|
||
**Список бэкапов**
|
||
|
||
```bash
|
||
x-ui-backup list
|
||
```
|
||
|
||
**Восстановить из бэкапа** (на чистом сервере, пакеты ставятся автоматически)
|
||
|
||
```bash
|
||
x-ui-backup restore /var/backups/x-ui/x-ui-backup-20260101-120000.tar.gz
|
||
```
|
||
|
||
Бэкап включает: конфиги nginx, БД панели, бинарник 3x-ui, SSL-сертификаты, веб-контент, systemd-юниты, cron, правила UFW.
|
||
|
||
---
|
||
|
||
## Диагностика сети
|
||
|
||
После установки доступна по ссылке, которую выводит скрипт. Включает:
|
||
|
||
- MTR-трейс до вашего IP
|
||
- Тест скорости загрузки и отдачи (512 МБ файлы)
|