From 3ddd3215752b581bbbc68803d83e3f04b6c5d535 Mon Sep 17 00:00:00 2001 From: Dushnilin Date: Tue, 11 Aug 2026 16:13:34 +0300 Subject: [PATCH] docs: add Hosts Engine section detailing static DNS overrides, remote host lists, and mirror retry logic --- README.en.md | 7 +++++++ README.md | 7 +++++++ 2 files changed, 14 insertions(+) diff --git a/README.en.md b/README.en.md index 28f22695..608449c1 100644 --- a/README.en.md +++ b/README.en.md @@ -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. * **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) diff --git a/README.md b/README.md index 1c550e65..60c6088e 100644 --- a/README.md +++ b/README.md @@ -35,6 +35,13 @@ * **По GeoIP и странам**: Гибкие списки включения/исключения по странам назначения. * **Автоматические подписки**: Фоновая загрузка, распарсинг и обновление прокси-нод по подписочным 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)