From 0a644a44a462921a282612de3df601b0ee18b513 Mon Sep 17 00:00:00 2001
From: StressOzz <131419324+StressOzz@users.noreply.github.com>
Date: Sun, 11 Oct 2026 20:26:46 +0500
Subject: [PATCH] Update readme.md
Updated the readme to improve clarity and added new sections on ad blocking and terminal features.
---
readme.md | 67 +++++++++++++++++++++++++++++++++++++++++++++++++------
1 file changed, 60 insertions(+), 7 deletions(-)
diff --git a/readme.md b/readme.md
index c08ebd1..f1018d5 100644
--- a/readme.md
+++ b/readme.md
@@ -1,8 +1,8 @@
-
+
# Zapret Manager
-
-**Одна панель для обхода блокировок на роутере OpenWrt — Zapret, Steer, Forkozz, ByeTube, Mixomo, TG WS Proxy, AmneziaWG, DoH и hosts в одном месте.**
+
+**Одна панель для обхода блокировок на роутере OpenWrt — Zapret, Steer, Forkozz, ByeTube, Mixomo, TG WS Proxy, AmneziaWG, DoH, блокировка рекламы и hosts в одном месте.**
[](https://github.com/StressOzz/Zapret-Manager/stargazers)
[](https://t.me/stressozz_manager)
@@ -63,8 +63,10 @@
- [TG WS Proxy](#-tg-ws-proxy)
- [Mixomo](#-mixomo)
- [Hosts](#-hosts)
+ - [Блокировка рекламы](#-блокировка-рекламы)
- [DNS over HTTPS](#-dns-over-https)
- [AmneziaWG](#-amneziawg)
+ - [Терминал](#-терминал)
- [Система](#️-система)
- [Совместимость компонентов](#-совместимость-компонентов)
- [Как это устроено](#-как-это-устроено)
@@ -84,7 +86,8 @@
- 🔀 **пускать выбранные сервисы через туннель** — бесплатный Cloudflare WARP, свой VPN по подписке или свой сервер (Steer, Forkozz, Mixomo);
- ✈️ **ускорять Telegram** — четыре вида TG WS Proxy;
- 🔐 **шифровать DNS** для всей сети — DNS over HTTPS;
-- 🧰 **обслуживать роутер** — системный отчёт, время и часовой пояс, зеркала пакетов, Flow Offloading fix и многое другое.
+- 🚫 **блокировать рекламу и трекеры** на всех устройствах — списки HaGeZi прямо в dnsmasq, без отдельных программ на телефонах и ПК;
+- 🧰 **обслуживать роутер** — системный отчёт, время и часовой пояс, зеркала пакетов, Flow Offloading fix, командная строка в браузере и многое другое.
Всё, что панель скачивает, берётся из официальных источников — GitHub проектов-авторов и репозиториев OpenWrt. Долгие операции идут в фоне на самом роутере: вкладку можно закрыть, а ход работы виден в окне вывода, когда вы вернётесь.
@@ -139,6 +142,7 @@ sh <(wget -qO - https://raw.githubusercontent.com/StressOzz/Zapret-Manager/refs/
| OpenWrt с **firewall4 / nftables** | на этом построены все правила обхода |
| **opkg** (24.10 и старше) или **apk** (25.12 и новее) | панель работает с обоими менеджерами |
| ~15 МБ свободного флеша | для Forkozz + sing-box; расширенный sing-box — ~40 МБ |
+| ~60 МБ свободной ОЗУ | для блокировки рекламы: список хранится в памяти dnsmasq |
| **aarch64_cortex-a53** | только для Zapret2 |
| OpenWrt **24.10+** | для Forkozz и ByeTube (`hev-socks5-tunnel` в фидах) |
| `ip-full` | для ByeTube (fwmark с маской) |
@@ -149,7 +153,7 @@ sh <(wget -qO - https://raw.githubusercontent.com/StressOzz/Zapret-Manager/refs/
### LuCI
-Пункт меню **Службы → Zapret Manager**, 12 страниц. Работает как обычное приложение LuCI.
+Пункт меню **Службы → Zapret Manager**, 14 страниц: Дашборд, Zapret, Zapret2, Steer, Forkozz, Hosts, Блокировка рекламы, DNS over HTTPS, AmneziaWG, Терминал, TG WS Proxy, Mixomo, ByeTube, Система. Работает как обычное приложение LuCI.
### Web UI на порту 7788
@@ -172,7 +176,7 @@ sh <(wget -qO - https://raw.githubusercontent.com/StressOzz/Zapret-Manager/refs/
Сводка всего, что стоит на роутере.
-- **Компоненты** — статус каждого инструмента: Zapret, Zapret2, Steer (и через что идут сервисы — WARP, свой WARP или VPN), Forkozz, ByeTube, TG WS Proxy, Mixomo, DoH, AmneziaWG (сколько туннелей работает), домены в hosts.
+- **Компоненты** — статус каждого инструмента: Zapret, Zapret2, Steer (и через что идут сервисы — WARP, свой WARP или VPN), Forkozz, ByeTube, TG WS Proxy, Mixomo, DoH, AmneziaWG (сколько туннелей работает), домены в hosts, блокировка рекламы, терминал.
- **Система** — модель, архитектура, платформа, версия OpenWrt, время работы, наличие интернета с задержкой (пинг `ya.ru` / `vk.ru`), шкалы температуры и нагрузки ЦП, ОЗУ, флеша и `/tmp` — обновляются каждые 5 секунд.
- **Версии** — установленная и последняя версия каждого пакета: Zapret Manager, Zapret, Mihomo, MagiTrickle, hev-socks5-tunnel, TG WS Proxy, sTGWS, ядро steer, Forkozz, sing-box, Zapret2, ByeDPI, AmneziaWG, https-dns-proxy.
- **Подсказки-баннеры**: «Включён Flow Offloading, а FIX не применён», «Роутер работает по IPv6, а в Zapret IPv6 выключен» — с кнопкой «Применить»; «Желательно перезагрузить роутер» — после удаления компонентов.
@@ -440,13 +444,28 @@ sh <(wget -qO - https://raw.githubusercontent.com/StressOzz/Zapret-Manager/refs/
### 📝 Hosts
-- **16 готовых блоков** для `/etc/hosts`: nalog.ru, ntc.party, Instagram/Facebook, lib.rus.ec, AI-сервисы (ChatGPT, Claude, Gemini, Grok, DeepL, Copilot, ElevenLabs, Windsurf и др.), Twitch, Telegram Web, Spotify (обычный и расширенный), rutor, rutracker, Supercell, GitHub и GitHub Raw, tapeop.dev, финские IP Discord. Отметьте нужные и нажмите «Сохранить и применить».
+- **Готовые блоки** для `/etc/hosts`: nalog.ru, ntc.party, Instagram/Facebook, lib.rus.ec, AI-сервисы (ChatGPT, Claude, Gemini, Grok, DeepL, Copilot, ElevenLabs, Windsurf и др.), Twitch, Telegram Web, Spotify (обычный и расширенный), rutor, rutracker, Supercell, GitHub и GitHub Raw, tapeop.dev, финские IP Discord. Отметьте нужные и нажмите «Сохранить и применить».
- **GeoHide RU / EU / US** — полная замена hosts списком [GeoHideDNS](https://github.com/Internet-Helper/GeoHideDNS).
- **Восстановить hosts** — вернуть чистый файл.
- **Редактор** всего `/etc/hosts` (резервная копия — `/etc/hosts.bak`). Для очень больших файлов (например, GeoHide) редактор отключается, чтобы не перегружать роутер.
---
+### 🚫 Блокировка рекламы
+
+Реклама, трекеры и телеметрия отсекаются на уровне DNS — для **всех устройств в сети** сразу: телефонов, ТВ, приставок, ПК. Списки [HaGeZi](https://github.com/hagezi/dns-blocklists) подключаются прямо к `dnsmasq`, отдельные приложения на устройствах не нужны.
+
+- **Список на выбор**: Light, Multi, **Pro** (по умолчанию), Pro++, Ultimate — от мягкого до самого строгого.
+- **Дополнительно**: **TIF mini** — защита от фишинга и вредоносных доменов; **запрет чужих DoH** — устройства не смогут обойти блокировку, уйдя на свой публичный DoH-сервер. DoH-серверы самого роутера (`https-dns-proxy`) не блокируются никогда.
+- **Белый список** — до 500 доменов, по одному в строке. Сразу заполнен тем, что ломать нельзя: переходы по рекламе в поиске Яндекса, ссылки из писем и приложений Яндекса, рассылки Mail.ru, партнёрские ссылки AliExpress. Лишнее (`http://`, путь, `*.`) панель отрезает сама.
+- **Автообновление** раз в сутки в 04:xx (минуту панель выбирает случайно, чтобы не грузить источник одновременно) и кнопка **«Обновить сейчас»**. Свежие копии (младше 12 часов) повторно не качаются.
+- **Безопасное подключение**: список скачивается с GitHub, а при недоступности — через jsDelivr; в нём остаются только домены; перед применением конфиг проверяется `dnsmasq --test`. Если после перезапуска dnsmasq не отвечает в течение 30 секунд, **прежнее состояние возвращается автоматически**.
+- **Память**: панель проверяет свободную ОЗУ (нужно не меньше ~60 МБ) и показывает, сколько занимает dnsmasq со списком. Роутеру с малым объёмом памяти подойдёт Light и без защиты от фишинга.
+- После перезагрузки папки dnsmasq пустеют — **сторож** сам собирает список заново из копии на флеше.
+- **«Выключить»** — убирает список из dnsmasq одной кнопкой.
+
+---
+
### 🔐 DNS over HTTPS
Шифрованный DNS для всей сети на базе `https-dns-proxy`.
@@ -474,6 +493,17 @@ WireGuard с маскировкой: провайдеру сложнее зам
---
+### 💻 Терминал
+
+Командная строка роутера прямо в браузере — на базе [ttyd](https://github.com/tsl0922/ttyd), без отдельного SSH-клиента.
+
+- **Установка в один клик** — пакет `ttyd` из репозитория OpenWrt (около 1 МБ); терминал запускается сам и добавляется в автозапуск.
+- **Безопасно по умолчанию**: слушает порт **7681** только в домашней сети (`@lan`), вход — по логину и паролю роутера (`/bin/login`).
+- **Встроен в панель** — открывается внутри страницы LuCI или Web UI; в Web UI не сбрасывается при переходе в другой раздел. Если панель открыта по https, а терминал работает по http, он откроется в отдельной вкладке.
+- **Кнопки**: «Открыть в новой вкладке», «Перезапустить», «Удалить» (останавливает терминал и убирает `ttyd` вместе с настройками).
+
+---
+
### ⚙️ Система
- **Блокировка QUIC** (UDP 80/443 из LAN в WAN), **IPv6 в Zapret**, **Fix для Flow Offloading** (правка шаблона firewall4).
@@ -513,6 +543,8 @@ Steer и ByeTube могут работать параллельно — пане
| `/opt/zapret-manager-luci/backend.sh` | бэкенд: вся логика панели |
| `/opt/zapret-manager-luci/netshift.uc` | ucode-модуль Forkozz |
| `/opt/zapret-manager-luci/state/` | состояние панели (тема, кэши версий, автоподбор и т.д.) |
+| `/opt/zapret-manager-luci/state/adblock/` | настройки, белый список и скачанные списки блокировки рекламы |
+| `zm-adblock.conf` в папке настроек dnsmasq | собранный список блокировки (живёт в ОЗУ, после перезагрузки восстанавливается сторожем) |
| `/usr/libexec/rpcd/zapret-manager` | rpcd-плагин — объект `zapret-manager` в ubus |
| `/usr/share/rpcd/acl.d/luci-app-zapret-manager.json` | права доступа |
| `/usr/share/luci/menu.d/luci-app-zapret-manager.json` | пункт меню LuCI |
@@ -542,6 +574,7 @@ Steer и ByeTube могут работать параллельно — пане
- перезапускает **Forkozz**, если он включён, но не работает (с нарастающей паузой), чинит мёртвые серверы и переключает DNS;
- проверяет **VPN Steer** и чинит его;
- поднимает упавшие **TG WS Proxy**;
+- возвращает **список блокировки рекламы** в dnsmasq после перезагрузки (или скачивает заново, если копии нет);
- переводит ядро steer 1.x на 2.x.
@@ -602,11 +635,29 @@ Web UI доступен только из локальной сети.
+
+После включения блокировки рекламы перестал открываться сайт или ссылка
+
+1. Добавьте его домен в **белый список** на странице «Блокировка рекламы» и примените.
+2. Если сайты не открываются совсем — нажмите **«Выключить»** и проверьте, пропала ли проблема: чаще причина в интернете или DNS, а не в списке.
+3. На роутере с малым объёмом ОЗУ выберите список полегче (Light) или отключите защиту от фишинга — при нехватке памяти панель сама откажется ставить тяжёлый список.
+
+
+
+
+Терминал не открывается во встроенном окне
+
+Панель открыта по https, а `ttyd` работает по http — браузер не разрешает встроить его. Нажмите **«Открыть в новой вкладке»** (адрес вида `http://192.168.1.1:7681`). Терминал доступен только из локальной сети.
+
+
+
---
## 🗑️ Удаление
- **Только панель** — «Система → Удалить Zapret Manager». Компоненты останутся и продолжат работать.
+- **Блокировка рекламы** — кнопка «Выключить»: список убирается из dnsmasq.
+- **Терминал** — кнопка «Удалить»: останавливает `ttyd` и удаляет пакет с настройками.
- **Компоненты** — кнопкой «Удалить» на странице каждого из них. Удаление полное: пакеты, настройки, правила файрвола и маршрутизации, задания cron. После удаления панель проверяет интернет и DNS роутера и при необходимости сама перезапускает сеть.
---
@@ -641,6 +692,8 @@ Zapret Manager собирает в одном месте работу этих
| domain-list-community | [v2fly](https://github.com/v2fly/domain-list-community) |
| dpi-checkers | [hyperion-cs](https://github.com/hyperion-cs/dpi-checkers) |
| awg-openwrt (сборки) | [2Grey](https://github.com/2Grey/awg-openwrt) |
+| dns-blocklists (списки рекламы) | [hagezi](https://github.com/hagezi/dns-blocklists) |
+| ttyd (терминал) | [tsl0922](https://github.com/tsl0922/ttyd) |
| warpscout (разведка WARP) | [vernette](https://github.com/vernette/warpscout) |
| base-relay (реле регистрации WARP) | [nellimonix](https://github.com/nellimonix/base-relay) |