Document AdGuard Home script in README (RU + EN)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-14 09:49:55 +03:00
parent d10a16a1a2
commit c3926222c2
2 changed files with 44 additions and 0 deletions
@@ -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-<random>/` (логин и пароль выводит скрипт)
+
+```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
@@ -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://<panel-domain>/dns-query`
+- **Admin UI** — at a random `/adg-<random>/` 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