diff --git a/docs/screenshots/adblock-levels.png b/docs/screenshots/adblock-levels.png new file mode 100644 index 0000000..9d48cea Binary files /dev/null and b/docs/screenshots/adblock-levels.png differ diff --git a/docs/screenshots/adblock.png b/docs/screenshots/adblock.png new file mode 100644 index 0000000..9a76427 Binary files /dev/null and b/docs/screenshots/adblock.png differ diff --git a/docs/screenshots/amneziawg.png b/docs/screenshots/amneziawg.png new file mode 100644 index 0000000..199ac50 Binary files /dev/null and b/docs/screenshots/amneziawg.png differ diff --git a/docs/screenshots/backup.png b/docs/screenshots/backup.png new file mode 100644 index 0000000..3f9db02 Binary files /dev/null and b/docs/screenshots/backup.png differ diff --git a/docs/screenshots/dashboard.png b/docs/screenshots/dashboard.png new file mode 100644 index 0000000..97d5cc3 Binary files /dev/null and b/docs/screenshots/dashboard.png differ diff --git a/docs/screenshots/doh.png b/docs/screenshots/doh.png new file mode 100644 index 0000000..58b6a3f Binary files /dev/null and b/docs/screenshots/doh.png differ diff --git a/docs/screenshots/hosts.png b/docs/screenshots/hosts.png new file mode 100644 index 0000000..006756d Binary files /dev/null and b/docs/screenshots/hosts.png differ diff --git a/docs/screenshots/login.png b/docs/screenshots/login.png new file mode 100644 index 0000000..17666a3 Binary files /dev/null and b/docs/screenshots/login.png differ diff --git a/docs/screenshots/mobile.png b/docs/screenshots/mobile.png new file mode 100644 index 0000000..adac195 Binary files /dev/null and b/docs/screenshots/mobile.png differ diff --git a/docs/screenshots/monitor.png b/docs/screenshots/monitor.png new file mode 100644 index 0000000..073bbf2 Binary files /dev/null and b/docs/screenshots/monitor.png differ diff --git a/docs/screenshots/steer-overview.png b/docs/screenshots/steer-overview.png new file mode 100644 index 0000000..b4449c5 Binary files /dev/null and b/docs/screenshots/steer-overview.png differ diff --git a/docs/screenshots/steer-services.png b/docs/screenshots/steer-services.png new file mode 100644 index 0000000..925db68 Binary files /dev/null and b/docs/screenshots/steer-services.png differ diff --git a/docs/screenshots/steer-warp.png b/docs/screenshots/steer-warp.png new file mode 100644 index 0000000..aaab252 Binary files /dev/null and b/docs/screenshots/steer-warp.png differ diff --git a/docs/screenshots/system.png b/docs/screenshots/system.png new file mode 100644 index 0000000..3ef1e8c Binary files /dev/null and b/docs/screenshots/system.png differ diff --git a/docs/screenshots/tg-ws-proxy.png b/docs/screenshots/tg-ws-proxy.png new file mode 100644 index 0000000..28b2307 Binary files /dev/null and b/docs/screenshots/tg-ws-proxy.png differ diff --git a/docs/screenshots/themes.png b/docs/screenshots/themes.png new file mode 100644 index 0000000..e48f984 Binary files /dev/null and b/docs/screenshots/themes.png differ diff --git a/docs/screenshots/thumbs/adblock.png b/docs/screenshots/thumbs/adblock.png new file mode 100644 index 0000000..8a740b6 Binary files /dev/null and b/docs/screenshots/thumbs/adblock.png differ diff --git a/docs/screenshots/thumbs/dashboard.png b/docs/screenshots/thumbs/dashboard.png new file mode 100644 index 0000000..40b3a18 Binary files /dev/null and b/docs/screenshots/thumbs/dashboard.png differ diff --git a/docs/screenshots/thumbs/login.png b/docs/screenshots/thumbs/login.png new file mode 100644 index 0000000..9dfc847 Binary files /dev/null and b/docs/screenshots/thumbs/login.png differ diff --git a/docs/screenshots/thumbs/monitor.png b/docs/screenshots/thumbs/monitor.png new file mode 100644 index 0000000..f964676 Binary files /dev/null and b/docs/screenshots/thumbs/monitor.png differ diff --git a/docs/screenshots/thumbs/steer-services.png b/docs/screenshots/thumbs/steer-services.png new file mode 100644 index 0000000..995b288 Binary files /dev/null and b/docs/screenshots/thumbs/steer-services.png differ diff --git a/docs/screenshots/thumbs/tg-ws-proxy.png b/docs/screenshots/thumbs/tg-ws-proxy.png new file mode 100644 index 0000000..f1d865d Binary files /dev/null and b/docs/screenshots/thumbs/tg-ws-proxy.png differ diff --git a/docs/screenshots/thumbs/zapret-test.png b/docs/screenshots/thumbs/zapret-test.png new file mode 100644 index 0000000..5612dc4 Binary files /dev/null and b/docs/screenshots/thumbs/zapret-test.png differ diff --git a/docs/screenshots/zapret-strategies.png b/docs/screenshots/zapret-strategies.png new file mode 100644 index 0000000..5534f3e Binary files /dev/null and b/docs/screenshots/zapret-strategies.png differ diff --git a/docs/screenshots/zapret-test.png b/docs/screenshots/zapret-test.png new file mode 100644 index 0000000..77145ed Binary files /dev/null and b/docs/screenshots/zapret-test.png differ diff --git a/readme.md b/readme.md index ffa2b02..ed99a1d 100644 --- a/readme.md +++ b/readme.md @@ -8,6 +8,21 @@ [![Telegram](https://img.shields.io/badge/Telegram-сообщество-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/stressozz_manager) [![StressKVN](https://img.shields.io/badge/StressKVN-обход_белых_списков-3C3489?style=for-the-badge)](http://stresskvn.lol/) [![Views](https://gitviews.com/repo/StressOzz/Zapret-Manager.svg?style=for-the-badge&label=Views&label-color=%23555&color=%2310B981&base=559060)](https://github.com/StressOzz/Zapret-Manager) + +![OpenWrt](https://img.shields.io/badge/OpenWrt-22.03%2B%20·%20лучше%2024.10%2B-00B5E2?style=flat-square&logo=openwrt&logoColor=white) +![opkg и apk](https://img.shields.io/badge/пакеты-opkg%20и%20apk-6E56CF?style=flat-square) +![LuCI + Web UI](https://img.shields.io/badge/интерфейс-LuCI%20+%20Web%20UI%20:7788-2563EB?style=flat-square) +![Темы](https://img.shields.io/badge/темы-11%20+%20авто-F59E0B?style=flat-square) +![Язык](https://img.shields.io/badge/язык-русский-16A34A?style=flat-square) + +
+ +Zapret Manager — Дашборд + +Дашборд Web UI: что установлено и работает, состояние роутера, версии компонентов + +**[🖼️ Скриншоты](#️-как-это-выглядит) · [💻 Установка](#-установка) · [🏁 Первые шаги](#-первые-шаги-после-установки) · [❓ Проблемы](#-частые-проблемы) · [🛠️ Для продвинутых](#️-техническая-документация-для-продвинутых)** + --- @@ -91,10 +106,52 @@ --- +## 🖼️ Как это выглядит + +> Все скриншоты сняты с настоящего Web UI версии **4.71** (тема «Светлая», роутер Cudy TR3000). Адреса, ключи и устройства на них — демонстрационные. Нажмите на картинку, чтобы открыть её в полном размере. + + + + + + + + + + + + + + +
+ Вход в Web UI
+ Вход — логин и пароль те же, что от роутера +
+ Тест стратегий Zapret
+ Zapret → Тест стратегий — роутер сам находит лучшую стратегию +
+ Steer: сервисы
+ Steer — галочками выбираете, что пустить через WARP или VPN +
+ Блокировка рекламы
+ Блокировка рекламы — сразу для всех устройств, со статистикой +
+ TG WS Proxy с QR-кодом
+ TG WS Proxy — прокси для Telegram подключается по QR-коду +
+ Монитор ресурсов
+ Монитор ресурсов — «диспетчер задач» роутера +
+ +🎨 **11 тем оформления** и 📱 **версия для телефона** — в разделе [Два интерфейса: LuCI и Web UI](#️-два-интерфейса-luci-и-web-ui). Скриншоты каждого раздела — в [Разборе разделов](#-разбор-разделов). + +--- + ## 📖 Содержание **Для всех:** - [Что это и зачем](#-что-это-и-зачем) +- [Как это выглядит (скриншоты)](#️-как-это-выглядит) - [Словарик](#-словарик) - [Подойдёт ли мой роутер](#-подойдёт-ли-мой-роутер) - [Установка](#-установка) @@ -123,9 +180,19 @@ - [Монитор ресурсов](#-монитор-ресурсов) - [Система](#️-система) -**Для любопытных:** +**Для любопытных и продвинутых:** - [Совместимость компонентов](#-совместимость-компонентов) -- [Как это устроено](#-как-это-устроено) +- [Техническая документация](#️-техническая-документация-для-продвинутых) + - [Архитектура](#архитектура) + - [Web UI изнутри](#web-ui-изнутри) + - [API: объект ubus `zapret-manager`](#api-объект-ubus-zapret-manager) + - [Фоновые задания](#фоновые-задания) + - [Расписания (cron)](#расписания-cron) + - [Файлы и каталоги](#файлы-и-каталоги) + - [Обновление панели](#обновление-панели) + - [Формат резервной копии `.zmb`](#формат-резервной-копии-zmb) + - [Безопасность](#безопасность) + - [Диагностика из SSH](#диагностика-из-ssh) - [Удаление](#️-удаление) - [Благодарности](#-благодарности) @@ -191,6 +258,13 @@ Установка делается **один раз** и занимает пару минут. Дальше всё — в браузере. Есть два способа — выберите любой. +**Перед началом проверьте:** + +- [ ] на роутере стоит **OpenWrt** (см. [Подойдёт ли мой роутер](#-подойдёт-ли-мой-роутер)); +- [ ] вы знаете **пароль роутера** — тот, с которым входите в LuCI (если пароля нет, задайте его в LuCI: **Система → Администрирование**); +- [ ] компьютер или телефон подключён **к этому роутеру** — по Wi-Fi или кабелю, **VPN на нём выключен**; +- [ ] на самом роутере **есть интернет** — установщик скачивает файлы с GitHub. + ### 🟢 Способ 1. Для Windows — просто запустите файл (самый простой) Ничего вводить не нужно — ни команд, ни программ вроде PuTTY. @@ -292,6 +366,14 @@ Web UI: http://192.168.1.1:7788 Откройте адрес **Web UI** в браузере и войдите с **тем же логином и паролем, что от роутера** (`root` и ваш пароль). Всё — панель готова. Теперь переходите к разделу [🏁 Первые шаги после установки](#-первые-шаги-после-установки). +

+ Экран входа Web UI
+ Экран входа. Галочка «Запомнить на этом устройстве» — чтобы не вводить пароль каждый раз. +

+ +> [!NOTE] +> **Не открывается `192.168.1.1:7788`?** Подставьте адрес вашего роутера — установщик пишет его в последней строке (`Web UI: http://…`). Панель открывается **только из домашней сети**: с мобильного интернета или через VPN на телефоне не откроется. Если не помогло — см. [«Web UI не открывается на порту 7788»](#-частые-проблемы). + > [!TIP] > **Сохраните адрес панели в закладки** (`http://192.168.1.1:7788`). На телефоне его удобно добавить на главный экран: в браузере меню → «Добавить на главный экран» — панель будет открываться как приложение. > @@ -395,6 +477,30 @@ Web UI: http://192.168.1.1:7788 Страницы LuCI и Web UI — один и тот же код: Web UI загружает те же модули и подменяет только «обвязку» LuCI. Что умеет одна, то умеет и другая. +

+ 11 тем оформления Web UI
+ Один и тот же Дашборд во всех 11 темах. Последняя картинка — экран входа в тёмной теме. +

+ +

+ Web UI на телефоне
+ Web UI на телефоне: меню, Дашборд, Steer и TG WS Proxy с QR-кодом. +

+ +
+Как устроено меню Web UI (все разделы) + +| Группа | Разделы | +|---|---| +| **Обзор** | Дашборд | +| **Обход блокировок** | Zapret · Zapret2 · Steer · Forkozz · ByeTube · TG WS Proxy · Mixomo | +| **Сеть** | Hosts · Блокировка рекламы · DNS over HTTPS · AmneziaWG · Удалённый доступ · Терминал | +| **Сервис** | Система · Резервная копия · Монитор ресурсов · Фоновые проверки · Очистка и удаление · Системная информация | + +Шестерёнка рядом с «Обзор» — **«Настроить меню»**: лишние разделы можно скрыть. Внизу боковой панели — модель роутера и четыре мини-шкалы: нагрузка процессора, температура, ОЗУ и флеш. Вверху справа: **StressKVN**, ссылка на **сообщество в Telegram**, ⟳ «обновить страницу», 🎨 «тема» и «Выйти». + +
+ --- ## 🧩 Разбор разделов @@ -403,6 +509,21 @@ Web UI: http://192.168.1.1:7788 > **Простыми словами:** главная страница — «приборная панель» роутера. За минуту понятно, что работает, что сломалось и что пора обновить. +

+ Дашборд
+ Карточки «Компоненты», «Система» и «Версии». Зелёная точка у пункта меню — компонент работает. +

+ +**Как читать цветные метки** (они одинаковые во всей панели): + +| Метка | Что значит | +|---|---| +| 🟢 зелёная — «запущен», «работает», «актуальна» | всё в порядке | +| 🟡 жёлтая — «доступна 1.4.3», «работает частично» | не авария, но стоит заглянуть: вышла новая версия или часть функций не работает | +| 🔴 красная — «не работает», «нет поправки» | что-то сломалось — откройте раздел, там будет подсказка и кнопка | +| ⚪ серая — «выключен», «не проверялась» | функция выключена вами или ещё не настроена | +| 🔵 синяя — «Flow Offloading программный» | просто информация | + - **Компоненты** — статус каждого инструмента: Zapret, Zapret2, Steer (и через что идут сервисы — WARP, свой WARP, VPN или интерфейс AmneziaWG), Forkozz, ByeTube, TG WS Proxy, Mixomo, DoH, AmneziaWG (сколько туннелей работает), **Удалённый доступ** (подключён ли роутер к Tailscale), домены в 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, Tailscale. *Зачем:* видно, что устарело и что можно обновить. Как часто искать новые версии, выбирается в **Система → Поиск новых версий**: раз в сутки ночью (по умолчанию — Дашборд тогда открывается быстро и в интернет не ходит), при каждом открытии Дашборда или только кнопкой «Проверить». @@ -420,7 +541,12 @@ Web UI: http://192.168.1.1:7788 > > **Кому нужен:** почти всем. Начинайте с него. -Основан на [zapret-openwrt](https://github.com/remittor/zapret-openwrt). Самый большой раздел — 7 вкладок. +Основан на [zapret-openwrt](https://github.com/remittor/zapret-openwrt). Самый большой раздел — 7 вкладок: **Стратегии**, **Тест стратегий**, **YouTube**, **Игры**, **Discord**, **Редактор списков**, **Исключение устройств**. + +

+ Zapret: вкладка Стратегии
+ Вкладка «Стратегии»: статус Zapret, выбор стратегии одним нажатием, дополнения и редактор. +

Установка и управление @@ -457,6 +583,13 @@ Web UI: http://192.168.1.1:7788 Тест идёт в фоне — вкладку можно закрыть. После теста настройки Zapret возвращаются как были, пока вы сами не нажмёте «Применить». +

+ Результаты теста и автоподбор
+ Результаты теста (сверху — «Без Zapret» для сравнения) и автоподбор по расписанию с журналом. +

+ +**Как прочитать результат:** строка «Без Zapret» — сколько сайтов открывается вообще без обхода (на скриншоте 5 из 12). Всё, что ниже, — стратегии от лучшей к худшей. `12 / 12` и зелёная полоса — открылось всё; жёлтая — лучше, чем без Zapret; красная — пользы нет. Нажмите на строку, чтобы увидеть, какие именно сайты не открылись, и **«Применить»** у лучшей. + | Режим | Что делает | |---|---| | **Текущая стратегия** | Проверяет то, что стоит сейчас, ничего не меняя. | @@ -544,6 +677,16 @@ Web UI: http://192.168.1.1:7788 Вкладки Steer: **Подключение**, **Сервисы**, **Устройства**, **Исключения**, **Настройки**. Кнопки **«Выключить»** (всё пойдёт напрямую, настройки сохранятся) и **«Удалить»** — на карточке Steer. +

+ Steer: обзор и секции
+ Карточка Steer: общие настройки, две секции («Основная» и «Нейросети»), сколько туннелей WARP работает и в каких странах. +

+ +

+ Steer: вкладка Сервисы
+ Вкладка «Сервисы»: включили переключатель — сервис пошёл через туннель. Ниже — категории, дополнительные списки и «Свой список». +

+
Секции — разные сервисы через разные туннели @@ -566,6 +709,11 @@ Web UI: http://192.168.1.1:7788 **1. WARP — бесплатно, рекомендуется для начала** +

+ Steer: туннели WARP
+ Три туннеля WARP в разных странах: через какой сейчас идёт трафик, когда была последняя связь, сколько трафика прошло, и кнопки ремонта. +

+ - **Автоматический режим (рекомендуется)** — роутер сам получит бесплатные ключи Cloudflare, поставит AmneziaWG, если его нет, проверит точки входа и оставит **3 рабочих туннеля в разных странах**. Займёт 5–10 минут; интернет всё это время работает, страницу можно закрыть — роутер доделает сам. Перед началом панель покажет, что будет делаться, — без подтверждения ничего не начнётся. - **Какой туннель главный:** «самый быстрый живой» (упал один — Steer сам переключится на другой) или «первый живой по порядку» (порядок меняется стрелками; когда верхний оживёт — Steer вернётся на него). - **Российские узлы не используются:** туннели, попавшие в российский узел Cloudflare (Домодедово и другие), в работу не берутся — заблокированное через них не открывается. Панель покажет такой туннель и предложит его переделать. @@ -748,7 +896,28 @@ Web UI: http://192.168.1.1:7788 | **Rust (MTProto)** | 2443 | [valnesfjord/tg-ws-proxy-rs](https://github.com/valnesfjord/tg-ws-proxy-rs) | | **sTGWS** | — | [xyzmean/brb](https://gitlab.com/xyzmean/brb) | +

+ TG WS Proxy: ссылка и QR-код
+ Готовая ссылка и QR-код для Telegram. Ниже — карточки каждого варианта прокси с версией, портом и кнопками. +

+ - **Как подключить в Telegram:** для каждого запущенного прокси есть готовая ссылка `tg://`, кнопка «Скопировать» и **QR-код** — наведите камеру телефона, и Telegram предложит добавить прокси. + +
+Пошагово: как добавить прокси в Telegram на телефоне + +1. Телефон должен быть подключён к **домашнему Wi-Fi** (прокси живёт на роутере). +2. Откройте в панели **TG WS Proxy** и нажмите **«QR-код»** у запущенного прокси. +3. Наведите камеру телефона на QR-код и нажмите на появившуюся ссылку — откроется Telegram. +4. Telegram спросит «Подключить прокси?» — нажмите **«Подключить»**. +5. Готово: в настройках Telegram (раздел **«Данные и память»** → настройки прокси) он будет помечен как подключённый. + +Если камера не открывает ссылку — нажмите **«Скопировать»** и отправьте ссылку себе в «Избранное» в Telegram, затем нажмите на неё там. + +> [!NOTE] +> Вне дома этот прокси не работает (если не настроен [Удалённый доступ](#-удалённый-доступ-tailscale)). Telegram сам переключится на прямое соединение, но удобнее выключить прокси переключателем в тех же настройках. + +
- Ставится последняя версия с GitHub; если для вашего роутера сборки нет — проверенная. - Удаление срабатывает всегда, даже если обычное удаление «упирается». - Если Rust-прокси уже стоит отдельно (`luci-app-tg-ws-proxy-rs`), панель его не трогает, а только показывает настройки. @@ -781,6 +950,11 @@ Web UI: http://192.168.1.1:7788 > **Простыми словами:** некоторые сайты блокируют «по-простому» — провайдер подсовывает неправильный адрес. Файл hosts позволяет записать **правильный адрес** вручную, и сайт открывается без прокси и туннелей. Здесь это делается галочками. +

+ Hosts
+ Готовые наборы включаются переключателем. AI-сервисы собраны в одну группу — стрелка справа раскрывает её. +

+ - **Готовые наборы** — отметьте нужные и нажмите «Сохранить и применить»: 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, финские IP Discord и другие. - **Готовые большие списки** — **GeoHide RU / EU / US** ([GeoHideDNS](https://github.com/Internet-Helper/GeoHideDNS)) или **dns.malw.link** для обхода гео-ограничений. ⚠ Полностью заменяют файл hosts — все отмеченные наборы и ваши записи будут удалены. - **Восстановить hosts** — вернуть чистый файл, если что-то пошло не так. @@ -797,6 +971,17 @@ Web UI: http://192.168.1.1:7788 Используются известные списки [HaGeZi](https://github.com/hagezi/dns-blocklists), они обновляются сами каждый день. +

+ Блокировка рекламы: статистика
+ Главная карточка: какой список включён, сколько доменов блокируется, статистика и «кто спрашивает больше всего». +

+ +
+📸 Скриншот: выбор строгости списка +
+Выбор списка блокировки +
+ **Насколько строго блокировать:** | Список | Что делает | @@ -828,6 +1013,11 @@ Web UI: http://192.168.1.1:7788 На базе `https-dns-proxy`. +

+ DNS over HTTPS
+ Выбор сервера с замером скорости ответа («Проверить все») и цепочка запасных серверов с журналом переключений. +

+ **Серверы на выбор:** | Группа | Серверы | @@ -863,6 +1053,13 @@ Web UI: http://192.168.1.1:7788 > > **Кому нужен:** если у вас свой сервер или конфиг AmneziaWG / WireGuard, или вы хотите сделать бесплатный туннель WARP и пустить через него Steer, Forkozz или весь интернет. Для автоматического WARP в Steer всё ставится само. +
+📸 Скриншот: раздел AmneziaWG +
+AmneziaWG: пакеты и интерфейсы +
Пакеты и список туннелей: какие из них ведёт Steer, через какой сейчас идёт трафик, точка входа и трафик. Адрес своего сервера панель прячет, пока его не раскроешь. +
+ - **Установка** — нужные программы под точную версию вашей прошивки (сборки [2Grey/awg-openwrt](https://github.com/2Grey/awg-openwrt)). Если не получилось, панель подробно объяснит почему. - **Список туннелей** — все туннели AmneziaWG (в том числе туннели Steer): работает ли, адрес, точка входа, трафик, когда была последняя связь, и **где используется** (в Steer, в Forkozz, «весь трафик роутера»). - **Проверить** — какой у туннеля внешний адрес и страна, есть ли потери и обрывы (если DPI рвёт туннель через пару секунд — панель скажет и посоветует другую точку входа или маску). @@ -947,6 +1144,11 @@ Web UI: http://192.168.1.1:7788 > > **Когда нужен:** интернет стал тормозить, роутер «задумывается», страницы долго открываются — здесь сразу видно, в чём дело. +

+ Монитор ресурсов
+ Вкладка «Обзор»: кольца загрузки, графики за 5 минут, ядра процессора, «кто сколько занимает», топ процессов, сеть и датчики. +

+ **Вкладка «Обзор»** — обновляется каждые **2 секунды**: - **Процессор** — общая нагрузка и **каждое ядро** отдельно; сколько занимают программы, система, прерывания. - **Память** — сколько занято и свободно. @@ -977,6 +1179,13 @@ Web UI: http://192.168.1.1:7788 #### Параметры роутера +
+📸 Скриншот: раздел «Система» +
+Система: параметры роутера, время, поиск новых версий +
Блокировка QUIC, IPv6, поправки Flow Offloading, время на роутере, проверка сети и поиск новых версий с автообновлением. +
+ - **Блокировка QUIC** — *зачем:* браузеры всё чаще используют протокол QUIC, который может проходить мимо обхода. Блокировка заставляет их вернуться на обычный способ, который обходится надёжно. - **IPv6 в Zapret** — *зачем:* если у вашего провайдера есть IPv6, без этой галочки часть трафика пойдёт мимо обхода. - **Fix для Flow Offloading** — *зачем:* функция «ускорения» роутера пропускает пакеты в обход Zapret, и обход перестаёт работать. Фикс это исправляет. @@ -991,7 +1200,7 @@ Web UI: http://192.168.1.1:7788 #### Фоновые проверки -**Сторож панели** раз в 2 минуты проверяет, что всё работает, и сам чинит сбои (подробнее — в разделе [Как это устроено](#-как-это-устроено)). Если делать нечего — выходит сразу, почти не нагружая роутер. +**Сторож панели** раз в 2 минуты проверяет, что всё работает, и сам чинит сбои (подробнее — в разделе [Расписания (cron)](#расписания-cron)). Если делать нечего — выходит сразу, почти не нагружая роутер. - Показано, **за чем он следит** и когда была последняя проверка; кнопка **«Проверить сейчас»**. - Можно **выключить**, если не хотите, чтобы роутер что-то делал в фоне. Тогда после сбоя или перезагрузки чинить придётся вручную — панель честно предупредит об этом. Расписания, которые вы включили сами (автотест, автообновление списков и т.п.), этот переключатель не трогает. @@ -1008,6 +1217,11 @@ Web UI: http://192.168.1.1:7788 > **Простыми словами:** «точка восстановления», как в Windows. Сделали копию → экспериментировали → что-то сломали → нажали «Восстановить» → всё как было. +

+ Резервная копия
+ Список копий на роутере: автоматические (перед установкой или обновлением) и ваши, с названием. У каждой — что в неё попало. +

+ - **Что сохраняется:** всё, что настроено через Zapret Manager — компоненты и список их пакетов с версиями, стратегии, Steer, Forkozz, AmneziaWG, DNS, блокировка рекламы, расписания, настройки самой панели, а также сеть, firewall, DHCP и hosts — целиком, как они есть сейчас. Wi-Fi, пароль роутера и остальные настройки OpenWrt не трогаются. - **«Создать копию»** — занимает несколько секунд и ничего не перезапускает. Можно дать название, например «до экспериментов со Steer». - **Копия перед рискованными действиями** (включено по умолчанию) — панель **сама** сохраняет копию перед установкой и удалением компонентов, полным удалением и обновлением панели. Хранятся 5 последних таких копий, старые удаляются сами. @@ -1029,6 +1243,22 @@ Web UI: http://192.168.1.1:7788 **Правило простое:** начинайте с **Zapret** — он бесплатный, быстрый и решает большинство задач. Остальное добавляйте, только если что-то не заработало. +```mermaid +flowchart TD + A([Поставили панель]) --> B["Zapret → «Установить и настроить»"] + B --> C{"YouTube, Discord и сайты
открываются?"} + C -- Да --> D(["Готово 🎉
Включите автоподбор и сделайте резервную копию"]) + C -- Нет --> E["Zapret → «Тест стратегий»
→ «Применить» у лучшей"] + E --> F{Заработало?} + F -- Да --> D + F -- "Не открывается конкретный сервис
(Instagram, Gemini, ChatGPT…)" --> G["Steer + бесплатный WARP
для выбранных сервисов"] + F -- "Не работает только Telegram" --> H["TG WS Proxy
(QR-код в Telegram)"] + F -- "Нужен только YouTube" --> I["ByeTube"] + G --> J{"Есть своя VPN-подписка
или сервер?"} + J -- Да --> K["Steer → VPN
или Forkozz / Mixomo"] + J -- Нет --> D +``` + | Ваша задача | Что поставить | Почему | |---|---|---| | Чтобы просто работали YouTube, Discord и заблокированные сайты | **Zapret** | Бесплатно, без серверов, без потери скорости. | @@ -1333,72 +1563,309 @@ Zapret совместим со всеми туннельными инструм --- -## 🔧 Как это устроено +## 🛠️ Техническая документация (для продвинутых) -*Раздел для тех, кому интересно, что происходит «под капотом». Для обычной работы читать не обязательно.* +*Раздел для тех, кому интересно, что происходит «под капотом»: администраторов, разработчиков и тех, кто хочет разобраться в проблеме сам. Для обычной работы читать не обязательно — всё это панель делает за вас.* + +> [!NOTE] +> Описание соответствует версии **4.71**. Пути, имена методов и расписания взяты из установщика `ZapretManager_LuCI.sh` этой версии. В новых версиях детали могут меняться. + +### Архитектура + +Панель — это **один shell-скрипт-установщик** (`ZapretManager_LuCI.sh`). Он раскладывает по роутеру бэкенд, rpcd-плагин, ACL, страницы LuCI и отдельный Web UI, а затем настраивает второй экземпляр веб-сервера `uhttpd`. Никаких демонов панель не держит: вся логика — это вызовы `backend.sh` по запросу из браузера или по расписанию cron. + +```mermaid +flowchart LR + subgraph CLIENT["Устройство в домашней сети"] + BR["Браузер"] + end + subgraph ROUTER["Роутер OpenWrt"] + direction LR + U80["uhttpd :80 / :443
LuCI"] + U7788["uhttpd «zmweb» :7788
Web UI"] + UBUS["/ubus — JSON-RPC
uhttpd-mod-ubus"] + RPCD["rpcd
сессии + ACL"] + PLUG["rpcd-плагин
/usr/libexec/rpcd/zapret-manager"] + BE["backend.sh
/opt/zapret-manager-luci"] + JOBS[("Фоновые задания
/tmp/zapret-manager-luci")] + STATE[("Состояние и копии
/opt/zapret-manager-luci/state, backups")] + COMP["Компоненты
zapret · zapret2 · steer · sing-box · mihomo
AmneziaWG · https-dns-proxy · tg-ws-proxy
ByeDPI · ttyd · tailscale"] + SYS["Система
UCI · fw4 / nftables · dnsmasq · procd"] + CRON["cron
сторож и расписания"] + end + BR --> U80 + BR --> U7788 + U80 --> UBUS + U7788 --> UBUS + UBUS --> RPCD --> PLUG --> BE + CRON --> BE + BE --> JOBS + BE --> STATE + BE --> COMP + BE --> SYS +``` + +| Слой | Где | Что делает | +|---|---|---| +| **Страницы LuCI** | `/www/luci-static/resources/view/zapret-manager/*.js`, общий модуль `…/zapret-manager/common.js`, стили `…/view/zapret-manager/style.css` | 16 страниц-модулей LuCI (`view.extend`). Меню — `/usr/share/luci/menu.d/luci-app-zapret-manager.json` (**Службы → Zapret Manager**). | +| **Web UI** | `/www/zm-webui.html`, `/www/zm/app.js`, `/www/zm/app.css` | Отдельная «оболочка», которая грузит **те же** JS-модули страниц, что и LuCI (см. [Web UI изнутри](#web-ui-изнутри)). | +| **Транспорт** | `uhttpd` + `uhttpd-mod-ubus`, путь `/ubus` | JSON-RPC 2.0 поверх HTTP: `call(sid, object, method, params)`. | +| **Авторизация** | `rpcd` (сессии), `/usr/share/rpcd/acl.d/luci-app-zapret-manager.json` | Логин — стандартный `session.login` (пользователь и пароль роутера). ACL решает, какие методы доступны сессии. | +| **Плагин** | `/usr/libexec/rpcd/zapret-manager` (shell, `jshn`) | Регистрирует объект ubus `zapret-manager`, разбирает параметры и вызывает `backend.sh <метод> <аргументы>`. | +| **Бэкенд** | `/opt/zapret-manager-luci/backend.sh` (+ ucode-модуль Forkozz `netshift.uc`, base64-хелпер `b64.uc`) | Вся логика: установка, настройка, тесты, расписания, диагностика. Отвечает JSON. | +| **Каталог сервисов** | `/usr/share/zm-redbtn/services.conf`, `/usr/share/zm-redbtn/svc/*.lst` | Встроенный список сервисов Steer/Forkozz (YouTube, Discord, Meta, …) и дополнительные домены к ним. | + +### Web UI изнутри + +- **Отдельный экземпляр `uhttpd`** с именем секции `zmweb`. Установщик создаёт его так (если секции ещё нет): + + ```sh + uci set uhttpd.zmweb=uhttpd + uci add_list uhttpd.zmweb.listen_http='0.0.0.0:7788' + uci add_list uhttpd.zmweb.listen_http='[::]:7788' + uci set uhttpd.zmweb.home='/www' + uci set uhttpd.zmweb.index_page='zm-webui.html' + uci set uhttpd.zmweb.ubus_prefix='/ubus' + uci set uhttpd.zmweb.no_dirlists='1' + uci set uhttpd.zmweb.rfc1918_filter='1' + uci set uhttpd.zmweb.max_requests='12' + uci set uhttpd.zmweb.script_timeout='120' + uci commit uhttpd && /etc/init.d/uhttpd restart + ``` + + Порт можно поменять в `uhttpd.zmweb.listen_http`: установщик при обновлении секцию не перезаписывает и в конце печатает фактический порт. +- **Тонкая прослойка вместо LuCI.** `app.js` реализует минимальный набор API LuCI, на который опираются страницы: `L`, `E()`, `baseclass`, `view`, `rpc.declare`, `uci`, `fs`, `ui`. Модуль страницы (`/luci-static/resources/view/zapret-manager/<страница>.js`) скачивается и исполняется как есть — поэтому LuCI и Web UI всегда умеют одно и то же. +- **Маршрутизация** — через `#/`: `#/dashboard`, `#/strategy`, `#/steer`, `#/forkozz`, `#/adblock`, `#/doh`, `#/monitor`, `#/system`, `#/backup` и т.д. Подразделы «Системы» (`#/watch`, `#/cleanup`, `#/sysinfo`, `#/backup`) — это та же страница `system.js`, показанная по частям. +- **Сессия.** Вход — `session.login` с `timeout: 3600`. Идентификатор сессии (`ubus_rpc_session`) хранится в `sessionStorage`, а с галочкой «Запомнить на этом устройстве» — в `localStorage`. Перед тем как выкинуть на экран входа, панель проверяет сессию через `session.access` (с повтором), чтобы короткий сбой rpcd не разлогинивал. +- **Устойчивость.** Таймаут запроса — 60 с. Ответ `Object not found` (rpcd ещё перечитывает плагины после обновления) повторяется до 6 раз с паузой 1,5 с. На `/ubus` → `404` панель прямо пишет, что не хватает `uhttpd-mod-ubus`. +- **Пакетные запросы.** Чтобы страница открывалась быстро, несколько «читающих» вызовов склеиваются в один `multi` (подробно — ниже). +- **Тема и меню хранятся на роутере**: тема — `/www/zm/theme.txt` (копия — `state/ui.theme`, переживает переустановку), скрытые разделы меню — в состоянии панели. Поэтому они одинаковы на всех устройствах. В браузере остаются только мелочи вроде последней открытой вкладки. +- **Сброс кэша после обновления.** Установщик подставляет вместо `__ZMW_BUILD__` метку времени сборки в ссылки на `app.js`/`app.css` (`?v=`), поэтому браузер получает новые файлы. + +### API: объект ubus `zapret-manager` + +Всё, что умеет панель, доступно как методы ubus — из браузера, из SSH и из ваших скриптов. Всего в плагине **больше 120 методов**. Посмотреть полный список с параметрами: + +```sh +ubus -v list zapret-manager +``` + +Методы делятся на «читающие» (статусы, списки, журналы — без побочных эффектов) и «действующие» (установка, применение, удаление). В ACL читающим выдано право `read` (≈50 методов), действующим — `write` (≈80 методов).
-Файлы на роутере +Самые полезные методы -| Путь | Что это | -|---|---| -| `/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 | -| `/www/luci-static/resources/view/zapret-manager/` | страницы LuCI | -| `/www/zm/`, `/www/zm-webui.html` | Web UI | -| `/tmp/zapret-manager-luci/` | журналы и pid фоновых операций | -| `/etc/zm-steer/`, `/etc/zm-awg/` | данные Steer и AmneziaWG | -| `/opt/zapret-manager-luci/backups/` | резервные копии панели (`.zmb`) | -| `/usr/bin/zms`, `/usr/bin/zmw` | команды запуска консольной версии и переустановки панели | +| Метод | Параметры | Что возвращает / делает | +|---|---|---| +| `status` | — | Состояние Zapret/Zapret2: установлен, запущен, версия, текущая стратегия, флаги дополнений, идёт ли тест. | +| `health` | — | Сводка «светофора» для всех компонентов: `dots` (0 — не установлен, 1 — работает, 2 — ошибка, 3 — частично, 4 — выключен), плюс предупреждения (`flow_warn`, `ipv6_warn`, `reboot_hint`…). | +| `system_info` | — | Модель, архитектура, платформа, версия OpenWrt, ядро, флеш и `/tmp`, температура и загрузка ЦП, есть ли интернет и пинг. | +| `system_status` | — | QUIC, IPv6 в Zapret, режим Flow Offloading и поправки к нему, время и часовой пояс роутера. | +| `versions` | `action` (`''` / `refresh`) | Установленные и последние версии компонентов, расписание проверки. | +| `zm_update_status` | — | Текущая и последняя версия самой панели. | +| `steer_status`, `forkop_status`, `doh_status`, `adblock_status`, `awg_status`, `tg_status`, `tsc_status`… | — | Полное состояние соответствующего раздела. | +| `zapret_action` | `action`: `install` / `update` / `remove` / `start` / `restart` … | Управление Zapret. Долгие действия запускаются фоновым заданием. | +| `job_status`, `log_tail` | `job` | Состояние и журнал фонового задания. | +| `backup_list`, `backup_action` | `action`, `value` | Список резервных копий; создание, восстановление, удаление. | +| `monitor`, `monitor_procs` | — | Срез `/proc` для Монитора ресурсов: ЦП по ядрам, память, сеть, датчики, процессы. | +| `multi` | `calls` | Пакетный вызов нескольких читающих методов (ниже). | + +Примеры из SSH: + +```sh +ubus call zapret-manager health +ubus call zapret-manager status +ubus call zapret-manager system_info +ubus call zapret-manager versions '{"action":"refresh"}' +``` + +Бэкенд можно вызывать и напрямую, без ubus, — ответ будет тем же JSON: + +```sh +/opt/zapret-manager-luci/backend.sh health +```
-Фоновые операции +Пакетный вызов multi -Установка, удаление, тесты и другие долгие действия запускаются **на самом роутере** как фоновые задания с журналом. *Зачем:* закрытая вкладка или оборванный Wi-Fi не прервут операцию на полпути. Вернулись — ход работы виден в окне вывода. +Web UI при открытии страницы делает много «читающих» запросов. Чтобы не гонять их по одному, клиент собирает их в очередь и отправляет одним вызовом: -Вывод показывается с подсветкой шагов (`✓`, `✗`, `→`). Если операция не отвечает дольше 2 минут, внизу появляется кнопка **«Остановить все операции»** — она завершает всё и откатывает незаконченное (например, возвращает прежнюю версию Forkozz). +```sh +ubus call zapret-manager multi '{"calls":"status\nsystem_status\ndoh_status"}' +# → {"r":[ {…status…}, {…system_status…}, {…doh_status…} ]} +``` -Шаги с сетью и установкой пакетов ограничены по времени, а если DNS роутера не отвечает, на время операции подставляются 1.1.1.1 и 9.9.9.9 — потом прежний DNS возвращается. *Зачем:* установка не зависнет навсегда из-за сломанного DNS. +- `calls` — строки `метод` или `методаргумент`, по одной на строку. +- В пакет попадают только безопасные методы: `status`, `health`, `versions`, `zm_update_status`, `lan_ip`, `bytetube_installed`, `*_status`, `*_get`, `strategy_list_*`, `mixomo_proxies`. Аргумент — не длиннее 64 символов из `[A-Za-z0-9_.:@-]`. +- На сервере вызовы выполняются **параллельно**, не больше 16 за раз; клиент шлёт пачки по 12. +- Если какой-то ответ не получился, на его месте будет `{"__fail":true}`, и клиент повторит этот вызов отдельно. Если `multi` недоступен (старая версия плагина, нет прав), клиент сам переходит на одиночные вызовы.
+### Фоновые задания + +Установка, удаление, тесты стратегий и другие долгие операции **не выполняются внутри HTTP-запроса** — иначе закрытая вкладка или оборвавшийся Wi-Fi прервали бы их на полпути. Вместо этого бэкенд запускает фоновое задание и сразу отвечает `{"started":true,"job":"<имя>"}`. + +```mermaid +sequenceDiagram + autonumber + participant UI as Браузер + participant R as rpcd / ubus + participant B as backend.sh + participant J as /tmp/zapret-manager-luci + UI->>R: zapret-manager.zapret_action {"action":"install"} + R->>B: backend.sh zapret_action install + B->>J: install_zapret.pid + install_zapret.log + B-->>UI: {"started":true,"job":"install_zapret"} + loop каждые 1,2 с + UI->>R: log_tail / job_status {"job":"install_zapret"} + R-->>UI: новые строки журнала (→ ✓ ✗) + end + B->>J: последняя строка «__DONE__ <код>» + UI->>UI: «Готово» или ошибка, статусы обновляются +``` + +- Журнал — `/tmp/zapret-manager-luci/<задание>.log`, PID — рядом в `<задание>.pid`. Последняя строка журнала — `__DONE__ <код выхода>`; код `130` означает «остановлено пользователем». +- Перед рискованным заданием автоматически делается [резервная копия](#-резервная-копия-панели) (если это не выключено), после него — проверка и восстановление сети. +- Шаги с сетью и установкой пакетов ограничены по времени. Если DNS роутера не отвечает, на время операции подставляются `1.1.1.1` и `9.9.9.9`, потом прежний DNS возвращается. +- Если журнал не меняется дольше 2 минут, в окне вывода появляется кнопка **«Остановить все операции»**: она завершает задания и откатывает незаконченное (например, возвращает прежнюю версию Forkozz). +- Пока идёт операция, установщик панели и самообновление не стартуют — они проверяют `*.pid` в этой папке. + +### Расписания (cron) + +Все задания панели лежат в `/etc/crontabs/root` и помечены комментарием `# zm-…`, поэтому их легко найти и панель удаляет их без остатка: + +```sh +grep '# zm-' /etc/crontabs/root +``` + +| Метка | Когда | Что делает | +|---|---|---| +| `# zm-rpcd-watch` | каждые 2 мин | **Сторож** (`backend.sh zm_watch`, подробнее — ниже). Не ставится, если фоновые проверки выключены в «Системе». | +| `# zm-versions` | по выбору (по умолчанию раз в сутки ночью) | Поиск новых версий; при включённом автообновлении — тихое обновление. | +| `# zm-autobest` | ежедневно в выбранное время | Автоподбор стратегии Zapret (`test_action auto_tick`). | +| `# zm-excl-auto` | раз в 2 / 4 / 6 / 12 ч | Обновление списка исключений Zapret. | +| `# zm-dohwatch` | каждые 2 мин | Переключение DNS over HTTPS на запасной сервер и обратно. | +| `# zm-adblock`, `# zm-abstats` | ежедневно / периодически | Обновление списков рекламы и сбор статистики. | +| `# zm-steer` | по выбору | Автоперезапуск Steer и туннелей. | +| `# zm-wfix` | каждые 10 мин | Автоподбор «мёртвых» туннелей WARP в Steer. | +| `# zm-subupd`, `# zm-subping` | по выбору | Обновление подписок VPN и автовыбор сервера по пингу в Steer. | +| `# zm-awgfix` | каждые 10 мин | Автопочинка туннелей WARP на вкладке AmneziaWG. | +| `# zm-tg-auto-<прокси>` | раз в 1–12 ч | Автоперезапуск выбранного TG WS Proxy. | +| `# zm-tailscale` | каждую минуту | Сторож Удалённого доступа: возвращает настройки Tailscale на место. | +| `# zm-autoclean` | по выбору | Автоматическая «Очистка мусора». | + +Расписания появляются только для включённых функций. После переустановки панели пользовательские расписания восстанавливаются из `state/cron.saved`. +
-Сторож (раз в 2 минуты) +Что делает сторож (каждые 2 минуты) -«Дежурный», который сам чинит типичные поломки: +«Дежурный», который сам чинит типичные поломки. Если чинить нечего, выходит сразу и почти не нагружает роутер. -- поднимает службу **rpcd**, если она упала или зависла (иначе пропадает вход в LuCI); +- поднимает службу **rpcd**, если она упала или зависла (иначе пропадает вход в LuCI и Web UI); - возвращает DNS роутера, если операция прервалась на полпути; - перезапускает **Forkozz**, если он включён, но не работает (с нарастающей паузой, чтобы не зациклиться), чинит мёртвые серверы и переключает DNS; -- проверяет и чинит **VPN в Steer**; +- проверяет и чинит **VPN в Steer** и в его секциях; - следит, чтобы туннели WARP не уходили на **российские узлы** Cloudflare; -- проверяет и чинит **VPN в секциях Steer**; - поднимает упавшие **TG WS Proxy**; -- возвращает **список блокировки рекламы** после перезагрузки; +- возвращает **список блокировки рекламы** после перезагрузки (список живёт в ОЗУ); - обновляет адреса DNS провайдера для российских сайтов, если провайдер их сменил; - переводит ядро steer 1.x на 2.x. -Сторожа можно выключить в **Система → Фоновые проверки**. У **Удалённого доступа** свой сторож — раз в минуту он возвращает настройки Tailscale на место. +Сторожа можно выключить в **Система → Фоновые проверки** (появится файл `state/watch.off`, и установщик при обновлении не вернёт задание в cron). У **Удалённого доступа** свой сторож — раз в минуту.
-
-«Не изменять» (#nochange) и большие тексты +### Файлы и каталоги -- Строка `#nochange` в стратегии или списке запрещает панели их менять — ни при установке, ни при обновлении, ни в тестах. Переключатели «Не изменять» ставят и снимают её сами. *Зачем:* защита ваших ручных правок. -- Веб-сервер роутера принимает не больше 64 КБ за один запрос, поэтому большие тексты (hosts, списки, конфиги) отправляются частями и собираются на роутере. *Зачем:* иначе большие файлы не сохранились бы. -- После обновления панель сама сбрасывает кэш браузера. *Зачем:* не нужно ничего чистить вручную. -- Всё, что панель скачивает, берётся из официальных источников — GitHub авторов проектов и репозиториев OpenWrt. +| Путь | Что это | +|---|---| +| `/opt/zapret-manager-luci/backend.sh` | бэкенд: вся логика панели; версия — в строке `ZM_VERSION=` | +| `/opt/zapret-manager-luci/netshift.uc`, `b64.uc` | ucode-модуль Forkozz; кодирование base64 для скачивания копий | +| `/opt/zapret-manager-luci/state/` | состояние панели: тема (`ui.theme`), флаги подсказок (`ui.flags`), кэш версий (`versions.json`, `latest.*`), автоподбор, `watch.off`, `cron.saved` и т.д. | +| `/opt/zapret-manager-luci/state/adblock/` | настройки, белый и чёрный список, скачанные списки блокировки рекламы | +| `/opt/zapret-manager-luci/backups/` | резервные копии панели (`*.zmb`) | +| `/usr/libexec/rpcd/zapret-manager` | rpcd-плагин — объект `zapret-manager` в ubus | +| `/usr/share/rpcd/acl.d/luci-app-zapret-manager.json` | права доступа (ACL) | +| `/usr/share/luci/menu.d/luci-app-zapret-manager.json` | пункт меню LuCI | +| `/www/luci-static/resources/view/zapret-manager/` | страницы (общие для LuCI и Web UI) | +| `/www/luci-static/resources/zapret-manager/common.js` | общий JS-модуль: вызовы API, тосты, журналы заданий, пакетные запросы | +| `/www/zm-webui.html`, `/www/zm/` | Web UI: оболочка, стили, `theme.txt` | +| `/usr/share/zm-redbtn/` | каталог сервисов для Steer и Forkozz | +| `/etc/zm-steer/`, `/etc/zm-awg/` | данные Steer (секции, подписки, свой WARP) и AmneziaWG (`WARP.conf`, точки входа) | +| `/etc/config/zapret` | конфигурация Zapret (блок `NFQWS_OPT` — стратегия) | +| `zm-adblock.conf` в каталоге настроек dnsmasq | собранный список блокировки (живёт в ОЗУ, после перезагрузки его возвращает сторож) | +| `/tmp/zapret-manager-luci/` | журналы и PID фоновых заданий, временные файлы | +| `/usr/bin/zms`, `/usr/bin/zmw` | запуск консольной версии и переустановка панели | +| `/etc/crontabs/root` | задания с метками `# zm-…` | -
+### Обновление панели + +Кнопка «Обновить панель», автообновление и команда `zmw` идут одним путём: + +1. С GitHub скачивается свежий `ZapretManager_LuCI.sh`. Если GitHub не отвечает напрямую, загрузка повторяется через зеркала из настройки **Система → Доступ к GitHub**. +2. Файл проверяется **до запуска**: + - первая строка — `#!/bin/sh` (а не HTML-заглушка провайдера); + - в файле есть строка `# Version:`; + - в последних строках есть финальное сообщение `Web UI:` — значит, файл скачался целиком; + - `sh -n` — синтаксис скрипта корректен. +3. Только после этого установщик запускается отдельным процессом, а панель на полминуты пропадает. +4. Установщик не начнёт работу, пока в панели идёт операция. Затем он заменяет файлы (настройки компонентов и расписания сохраняются), при необходимости включает Web UI, сверяет конфигурацию компонентов с новой версией (Forkozz, блок DoH в стратегии Zapret, скрипты ByeTube) и чистит остатки прошлых версий. Через 30 секунд сторож проверяет, что `rpcd` подхватил новый плагин. +5. При следующем входе панель показывает **«Что нового»** — список изменений берётся с GitHub, а если он недоступен — из копии, сохранённой при установке. + +Версия панели записана в одном месте — строке `# Version:` в начале установщика. Отсюда она попадает в `backend.sh` (`ZM_VERSION`). + +### Формат резервной копии `.zmb` + +Файл копии — обычный **tar-архив** из четырёх частей: + +| Файл внутри | Содержимое | +|---|---| +| `manifest` | `key=value`: `format`, `id`, `at`, `kind` (auto/manual), `name`, `reason`, `panel` (версия), `owrt`, `arch`, `board`, `host`, `lan`, `pkg` (opkg/apk), `comps` (какие компоненты), версии их пакетов (`pkgv=`), состояние служб (`svc=`), системные флаги, `sha` и `lsha` | +| `files.lst` | список сохранённых файлов с контрольными суммами | +| `cron.lst` | строки cron, принадлежащие панели | +| `files.tgz` | сами файлы конфигурации (gzip) | + +- `sha` — SHA-256 архива `files.tgz`, `lsha` — SHA-256 списков. Перед восстановлением панель сверяет их, поэтому повреждённую копию восстановить не даст. +- Имя копии — `ГГГГММДД-ЧЧММСС.zmb`, хранятся в `/opt/zapret-manager-luci/backups/`. Перед созданием проверяется свободное место на флеше. +- Загрузка копии с компьютера идёт частями в base64 (до 32 МБ), скачивание — тоже частями, через `backup_down`. +- Посмотреть содержимое копии на компьютере: `tar -xf копия.zmb && cat manifest && tar -tzf files.tgz`. + +> [!WARNING] +> В `files.tgz` лежат **ключи WARP и AmneziaWG, ссылки подписок и вход Tailscale** в открытом виде. Не публикуйте файл копии и не отправляйте его в чаты. + +### Безопасность + +- **Вход — только по паролю роутера.** Своих учётных записей у панели нет: используются сессии `rpcd`, как в LuCI. Каждый вызов проходит проверку ACL. +- **Только домашняя сеть.** Для Web UI включён `rfc1918_filter`: `uhttpd` не отвечает на запросы с публичных адресов к своему приватному адресу. Плюс стандартный firewall OpenWrt не открывает порт 7788 со стороны WAN. **Не пробрасывайте порт 7788 в интернет.** Для доступа извне используйте [Удалённый доступ](#-удалённый-доступ-tailscale). +- **Терминал (ttyd)** слушает только локальную сеть и спрашивает пароль роутера. Вкладка htop в Мониторе работает, только пока страница открыта. +- **Отчёт «Системная информация»** вычищает адреса, ключи, пароли и ссылки подписок — его можно отправлять в поддержку. +- **Опасные изменения проверяются и откатываются:** список рекламы (DNS не ответил 30 с — откат), конфигурация Mihomo и sing-box (не запустился — откат), смена зеркала OpenWrt, сеть после восстановления копии (через 90 с). +- **Источники загрузок** — GitHub авторов проектов и репозитории OpenWrt. Зеркала GitHub используются только тогда, когда GitHub не ответил (это можно выключить: Система → Доступ к GitHub → «Напрямую»). +- **`#nochange`.** Строка `#nochange` в стратегии или списке запрещает панели их менять — ни при установке, ни при обновлении, ни в тестах. Переключатели «Не изменять» ставят и снимают её сами. +- **Большие тексты** (hosts, списки, конфиги) отправляются частями, потому что веб-сервер роутера принимает не больше 64 КБ за запрос. + +### Диагностика из SSH + +| Задача | Команда | +|---|---| +| Сводка состояния всех компонентов | `ubus call zapret-manager health` | +| Жив ли плагин панели | `ubus -v list zapret-manager \| head` | +| Перезапустить rpcd (ошибки «Object not found» / «метод не найден») | `/etc/init.d/rpcd restart` | +| Настройки и перезапуск Web UI | `uci show uhttpd.zmweb` и `/etc/init.d/uhttpd restart` | +| Какие операции сейчас идут | `ls /tmp/zapret-manager-luci/*.pid` | +| Журнал последней операции | `tail -n 50 /tmp/zapret-manager-luci/<задание>.log` | +| Расписания панели | `grep '# zm-' /etc/crontabs/root` | +| Состояние Zapret | `/etc/init.d/zapret status` и `ps w \| grep nfqws` | +| Текущая стратегия | `grep -A30 NFQWS_OPT /etc/config/zapret` | +| Системный журнал | `logread -e zapret`, `logread -e steer`, `logread -e https-dns-proxy` | +| Резервные копии | `ls -l /opt/zapret-manager-luci/backups/` | +| Переустановить панель | `zmw` | + +> [!TIP] +> Если просите помощи в [сообществе](https://t.me/stressozz_manager), начните с **Система → Системная информация → «Скопировать отчёт»** — в нём уже есть почти всё из таблицы выше. ---