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 @@
[](https://t.me/stressozz_manager)
[](http://stresskvn.lol/)
[](https://github.com/StressOzz/Zapret-Manager)
+
+
+
+
+
+
+
+
+
+
+
+Дашборд Web UI: что установлено и работает, состояние роутера, версии компонентов
+
+**[🖼️ Скриншоты](#️-как-это-выглядит) · [💻 Установка](#-установка) · [🏁 Первые шаги](#-первые-шаги-после-установки) · [❓ Проблемы](#-частые-проблемы) · [🛠️ Для продвинутых](#️-техническая-документация-для-продвинутых)**
+
---
@@ -91,10 +106,52 @@
---
+## 🖼️ Как это выглядит
+
+> Все скриншоты сняты с настоящего Web UI версии **4.71** (тема «Светлая», роутер Cudy TR3000). Адреса, ключи и устройства на них — демонстрационные. Нажмите на картинку, чтобы открыть её в полном размере.
+
+
+
+
+ 
+ Вход — логин и пароль те же, что от роутера
+ |
+
+ 
+ Zapret → Тест стратегий — роутер сам находит лучшую стратегию
+ |
+
+
+
+ 
+ Steer — галочками выбираете, что пустить через WARP или VPN
+ |
+
+ 
+ Блокировка рекламы — сразу для всех устройств, со статистикой
+ |
+
+
+
+ 
+ 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` и ваш пароль). Всё — панель готова. Теперь переходите к разделу [🏁 Первые шаги после установки](#-первые-шаги-после-установки).
+
+ 
+ Экран входа. Галочка «Запомнить на этом устройстве» — чтобы не вводить пароль каждый раз.
+
+
+> [!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 на телефоне: меню, Дашборд, 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, выбор стратегии одним нажатием, дополнения и редактор.
+
Установка и управление
@@ -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: общие настройки, две секции («Основная» и «Нейросети»), сколько туннелей WARP работает и в каких странах.
+
+
+
+ 
+ Вкладка «Сервисы»: включили переключатель — сервис пошёл через туннель. Ниже — категории, дополнительные списки и «Свой список».
+
+
Секции — разные сервисы через разные туннели
@@ -566,6 +709,11 @@ Web UI: http://192.168.1.1:7788
**1. 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) |
+
+ 
+ Готовая ссылка и 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 позволяет записать **правильный адрес** вручную, и сайт открывается без прокси и туннелей. Здесь это делается галочками.
+
+ 
+ Готовые наборы включаются переключателем. 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`.
+
+ 
+ Выбор сервера с замером скорости ответа («Проверить все») и цепочка запасных серверов с журналом переключений.
+
+
**Серверы на выбор:**
| Группа | Серверы |
@@ -863,6 +1053,13 @@ Web UI: http://192.168.1.1:7788
>
> **Кому нужен:** если у вас свой сервер или конфиг AmneziaWG / WireGuard, или вы хотите сделать бесплатный туннель WARP и пустить через него Steer, Forkozz или весь интернет. Для автоматического WARP в Steer всё ставится само.
+
+📸 Скриншот: раздел 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), начните с **Система → Системная информация → «Скопировать отчёт»** — в нём уже есть почти всё из таблицы выше.
---