From c3926222c21ee5868638ba10b93a178b428099fe Mon Sep 17 00:00:00 2001 From: Ivan Razin Date: Tue, 14 Jul 2026 09:49:55 +0300 Subject: [PATCH] Document AdGuard Home script in README (RU + EN) Co-Authored-By: Claude Fable 5 --- README.md | 22 ++++++++++++++++++++++ README_EN.md | 22 ++++++++++++++++++++++ 2 files changed, 44 insertions(+) diff --git a/README.md b/README.md index cf612de..4f6facb 100644 --- a/README.md +++ b/README.md @@ -22,6 +22,7 @@ | Диагностика | MTR-трейсер + тест скорости в браузере | | Фейковый сайт | Случайный HTML-сайт-прикрытие | | Бэкап | Скрипт резервного копирования | +| AdGuard Home | Опционально: DNS с блокировкой рекламы (DoH) — отдельный скрипт | --- @@ -50,6 +51,27 @@ bash <(curl -fsSL https://raw.githubusercontent.com/mozaroc/3x-ui-pro/main/x-ui- --- +## AdGuard Home (опционально) + +Устанавливает [AdGuard Home](https://github.com/AdguardTeam/AdGuardHome) на домен панели — без отдельного домена и открытых портов, всё через существующий 443: + +- **DNS-over-HTTPS** для клиентов: `https://<домен-панели>/dns-query` +- **Админка** — на случайном пути `/adg-/` (логин и пароль выводит скрипт) + +```bash +bash <(curl -fsSL https://raw.githubusercontent.com/mozaroc/3x-ui-pro/main/x-ui-adguard.sh) +``` + +Повторный запуск безопасен (настройки и пароль сохраняются). После установщика или патча запустите скрипт ещё раз — они перезаписывают конфиг nginx. + +Удаление: + +```bash +bash <(curl -fsSL https://raw.githubusercontent.com/mozaroc/3x-ui-pro/main/x-ui-adguard.sh) -uninstall y +``` + +--- + ## Удаление ```bash diff --git a/README_EN.md b/README_EN.md index f8a37e8..d6c591c 100644 --- a/README_EN.md +++ b/README_EN.md @@ -22,6 +22,7 @@ Automated installer for the [3x-ui](https://github.com/MHSanaei/3x-ui) panel wit | Diagnostics | MTR tracer + in-browser speed test | | Fake site | Random HTML cover site | | Backup | Backup / restore script | +| AdGuard Home | Optional: ad-blocking DNS (DoH) — separate script | --- @@ -50,6 +51,27 @@ bash <(curl -fsSL https://raw.githubusercontent.com/mozaroc/3x-ui-pro/main/x-ui- --- +## AdGuard Home (optional) + +Installs [AdGuard Home](https://github.com/AdguardTeam/AdGuardHome) on the panel domain — no separate domain or open ports, everything goes through the existing 443: + +- **DNS-over-HTTPS** for clients: `https:///dns-query` +- **Admin UI** — at a random `/adg-/` path (login and password are printed by the script) + +```bash +bash <(curl -fsSL https://raw.githubusercontent.com/mozaroc/3x-ui-pro/main/x-ui-adguard.sh) +``` + +Re-running is safe (settings and password are kept). After the installer or the patch, run this script again — they rewrite the nginx config. + +Uninstall: + +```bash +bash <(curl -fsSL https://raw.githubusercontent.com/mozaroc/3x-ui-pro/main/x-ui-adguard.sh) -uninstall y +``` + +--- + ## Uninstall ```bash