Update readme.md
Updated the readme to improve clarity and added new sections on ad blocking and terminal features.
This commit is contained in:
StressOzz authored and GitHub committed
1 parent
9856e1ea28
commit
0a644a44a4
1 file changed
+58
-5
@@ -2,7 +2,7 @@
|
||||
|
||||
# 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.
|
||||
|
||||
</details>
|
||||
@@ -602,11 +635,29 @@ Web UI доступен только из локальной сети.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>После включения блокировки рекламы перестал открываться сайт или ссылка</b></summary>
|
||||
|
||||
1. Добавьте его домен в **белый список** на странице «Блокировка рекламы» и примените.
|
||||
2. Если сайты не открываются совсем — нажмите **«Выключить»** и проверьте, пропала ли проблема: чаще причина в интернете или DNS, а не в списке.
|
||||
3. На роутере с малым объёмом ОЗУ выберите список полегче (Light) или отключите защиту от фишинга — при нехватке памяти панель сама откажется ставить тяжёлый список.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Терминал не открывается во встроенном окне</b></summary>
|
||||
|
||||
Панель открыта по https, а `ttyd` работает по http — браузер не разрешает встроить его. Нажмите **«Открыть в новой вкладке»** (адрес вида `http://192.168.1.1:7681`). Терминал доступен только из локальной сети.
|
||||
|
||||
</details>
|
||||
|
||||
---
|
||||
|
||||
## 🗑️ Удаление
|
||||
|
||||
- **Только панель** — «Система → Удалить 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) |
|
||||
|
||||
|
||||
Reference in new issue
Block a user