docs: add Hosts Engine section detailing static DNS overrides, remote host lists, and mirror retry logic

This commit is contained in:
Dushnilin
2026-08-11 16:13:34 +03:00
parent 5b6e0c6a78
commit 3ddd321575
2 changed files with 14 additions and 0 deletions
+7
View File
@@ -35,6 +35,13 @@ The entire backend logic is written in **ucode** — OpenWrt's native, lightweig
* **By GeoIP & Countries**: Flexible inclusion/exclusion list controls based on destination country. * **By GeoIP & Countries**: Flexible inclusion/exclusion list controls based on destination country.
* **Automated Subscription Updates**: Background fetching, parsing, and node rotation from remote subscription URLs. * **Automated Subscription Updates**: Background fetching, parsing, and node rotation from remote subscription URLs.
#### 🌐 Hosts Sections & DNS Overrides (Hosts Engine)
* **Static DNS Overriding (`dns_hosts`)**: Direct mapping of domains to static IP addresses in sing-box DNS and dnsmasq without editing `/etc/hosts`.
* **Remote Hosts Lists Ingestion (`hosts_list_urls`)**: Automatic background downloading and parsing of external host lists and blocklists (AdAway, StevenBlack, custom blocklists).
* **Unified Cache (`combined.txt`)**: High-performance deduplication, merging, and global caching of multiple remote host sources into a single lightweight cache.
* **GitHub Mirror Failover**: Resilient downloads that automatically retry via mirrors (`gh-proxy.com`, `ghproxy.net`) if direct access to github.com is blocked or throttled.
* **Hosts-Only Action Sections (`action = hosts`)**: Dedicated routing sections operating purely as DNS override engines without requiring an outbound proxy association.
--- ---
### 🤖 2. AI Doctor & HTTP REST Agent API (AI Stack) ### 🤖 2. AI Doctor & HTTP REST Agent API (AI Stack)
+7
View File
@@ -35,6 +35,13 @@
* **По GeoIP и странам**: Гибкие списки включения/исключения по странам назначения. * **По GeoIP и странам**: Гибкие списки включения/исключения по странам назначения.
* **Автоматические подписки**: Фоновая загрузка, распарсинг и обновление прокси-нод по подписочным URL. * **Автоматические подписки**: Фоновая загрузка, распарсинг и обновление прокси-нод по подписочным URL.
#### 🌐 Секции Hosts и Списки DNS-блокировок (Hosts Engine)
* **Статический DNS-Overriding (`dns_hosts`)**: Прямое переопределение IP-адресов для доменов в DNS-модуле sing-box и dnsmasq без необходимости подмены `/etc/hosts`.
* **Загрузка сторонних списков Hosts (`hosts_list_urls`)**: Автоматическая фоновая загрузка и интеграция внешних реестров и списков блокировок (AdAway, StevenBlack, РКН/Антизапрет списки).
* **Умный кэш (`combined.txt`)**: Автоматическое слияние, очистка и единое кэширование нескольких источников списков с поддержкой мгновенного переиспользования.
* **Резервирование через зеркала (GitHub Mirror Retry)**: При сетевых блокировках github.com модули загрузки автоматически переключаются на зеркала (`gh-proxy.com`, `ghproxy.net`).
* **Секции чистого Hosts (`action = hosts`)**: Создание изолированных правил перенаправления DNS без обязательной привязки к прокси-нодам.
--- ---
### 🤖 2. ИИ-Доктор и HTTP REST Agent API (AI Stack) ### 🤖 2. ИИ-Доктор и HTTP REST Agent API (AI Stack)