Add files via upload

This commit is contained in:
StressOzz authored and GitHub committed 2026-10-27 22:40:34 +05:00
1 parent 2401f0ea5a
commit c614fc667f
26 files changed
+508 -41

No files matched your search

Binary file not shown.

After

Width:  |  Height:  |  Size: 91 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 158 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 208 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 131 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 157 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 282 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 74 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 104 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 189 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 130 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 215 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 124 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 305 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 132 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 65 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 31 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 70 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 59 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 207 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 175 KiB

+508 -41
View File
@@ -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)
<br>
<a href="docs/screenshots/dashboard.png"><img src="docs/screenshots/dashboard.png" alt="Zapret Manager — Дашборд" width="900"></a>
<sub>Дашборд Web UI: что установлено и работает, состояние роутера, версии компонентов</sub>
**[🖼️ Скриншоты](#️-как-это-выглядит) · [💻 Установка](#-установка) · [🏁 Первые шаги](#-первые-шаги-после-установки) · [❓ Проблемы](#-частые-проблемы) · [🛠️ Для продвинутых](#️-техническая-документация-для-продвинутых)**
</div>
---
@@ -91,10 +106,52 @@
---
## 🖼️ Как это выглядит
> Все скриншоты сняты с настоящего Web UI версии **4.71** (тема «Светлая», роутер Cudy TR3000). Адреса, ключи и устройства на них — демонстрационные. Нажмите на картинку, чтобы открыть её в полном размере.
<table>
<tr>
<td width="50%" align="center">
<a href="docs/screenshots/login.png"><img src="docs/screenshots/thumbs/login.png" alt="Вход в Web UI"></a><br>
<sub><b>Вход</b> — логин и пароль те же, что от роутера</sub>
</td>
<td width="50%" align="center">
<a href="docs/screenshots/zapret-test.png"><img src="docs/screenshots/thumbs/zapret-test.png" alt="Тест стратегий Zapret"></a><br>
<sub><b>Zapret → Тест стратегий</b> — роутер сам находит лучшую стратегию</sub>
</td>
</tr>
<tr>
<td align="center">
<a href="docs/screenshots/steer-services.png"><img src="docs/screenshots/thumbs/steer-services.png" alt="Steer: сервисы"></a><br>
<sub><b>Steer</b> — галочками выбираете, что пустить через WARP или VPN</sub>
</td>
<td align="center">
<a href="docs/screenshots/adblock.png"><img src="docs/screenshots/thumbs/adblock.png" alt="Блокировка рекламы"></a><br>
<sub><b>Блокировка рекламы</b> — сразу для всех устройств, со статистикой</sub>
</td>
</tr>
<tr>
<td align="center">
<a href="docs/screenshots/tg-ws-proxy.png"><img src="docs/screenshots/thumbs/tg-ws-proxy.png" alt="TG WS Proxy с QR-кодом"></a><br>
<sub><b>TG WS Proxy</b> — прокси для Telegram подключается по QR-коду</sub>
</td>
<td align="center">
<a href="docs/screenshots/monitor.png"><img src="docs/screenshots/thumbs/monitor.png" alt="Монитор ресурсов"></a><br>
<sub><b>Монитор ресурсов</b> — «диспетчер задач» роутера</sub>
</td>
</tr>
</table>
🎨 **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` и ваш пароль). Всё — панель готова. Теперь переходите к разделу [🏁 Первые шаги после установки](#-первые-шаги-после-установки).
<p align="center">
<img src="docs/screenshots/login.png" alt="Экран входа Web UI" width="720"><br>
<sub>Экран входа. Галочка «Запомнить на этом устройстве» — чтобы не вводить пароль каждый раз.</sub>
</p>
> [!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. Что умеет одна, то умеет и другая.
<p align="center">
<a href="docs/screenshots/themes.png"><img src="docs/screenshots/themes.png" alt="11 тем оформления Web UI" width="900"></a><br>
<sub>Один и тот же Дашборд во всех 11 темах. Последняя картинка — экран входа в тёмной теме.</sub>
</p>
<p align="center">
<a href="docs/screenshots/mobile.png"><img src="docs/screenshots/mobile.png" alt="Web UI на телефоне" width="900"></a><br>
<sub>Web UI на телефоне: меню, Дашборд, Steer и TG WS Proxy с QR-кодом.</sub>
</p>
<details>
<summary><b>Как устроено меню Web UI (все разделы)</b></summary>
| Группа | Разделы |
|---|---|
| **Обзор** | Дашборд |
| **Обход блокировок** | Zapret · Zapret2 · Steer · Forkozz · ByeTube · TG WS Proxy · Mixomo |
| **Сеть** | Hosts · Блокировка рекламы · DNS over HTTPS · AmneziaWG · Удалённый доступ · Терминал |
| **Сервис** | Система · Резервная копия · Монитор ресурсов · Фоновые проверки · Очистка и удаление · Системная информация |
Шестерёнка рядом с «Обзор» — **«Настроить меню»**: лишние разделы можно скрыть. Внизу боковой панели — модель роутера и четыре мини-шкалы: нагрузка процессора, температура, ОЗУ и флеш. Вверху справа: **StressKVN**, ссылка на **сообщество в Telegram**, ⟳ «обновить страницу», 🎨 «тема» и «Выйти».
</details>
---
## 🧩 Разбор разделов
@@ -403,6 +509,21 @@ Web UI: http://192.168.1.1:7788
> **Простыми словами:** главная страница — «приборная панель» роутера. За минуту понятно, что работает, что сломалось и что пора обновить.
<p align="center">
<a href="docs/screenshots/dashboard.png"><img src="docs/screenshots/dashboard.png" alt="Дашборд" width="860"></a><br>
<sub>Карточки «Компоненты», «Система» и «Версии». Зелёная точка у пункта меню — компонент работает.</sub>
</p>
**Как читать цветные метки** (они одинаковые во всей панели):
| Метка | Что значит |
|---|---|
| 🟢 зелёная — «запущен», «работает», «актуальна» | всё в порядке |
| 🟡 жёлтая — «доступна 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**, **Редактор списков**, **Исключение устройств**.
<p align="center">
<a href="docs/screenshots/zapret-strategies.png"><img src="docs/screenshots/zapret-strategies.png" alt="Zapret: вкладка Стратегии" width="860"></a><br>
<sub>Вкладка «Стратегии»: статус Zapret, выбор стратегии одним нажатием, дополнения и редактор.</sub>
</p>
<details>
<summary><b>Установка и управление</b></summary>
@@ -457,6 +583,13 @@ Web UI: http://192.168.1.1:7788
Тест идёт в фоне — вкладку можно закрыть. После теста настройки Zapret возвращаются как были, пока вы сами не нажмёте «Применить».
<p align="center">
<a href="docs/screenshots/zapret-test.png"><img src="docs/screenshots/zapret-test.png" alt="Результаты теста и автоподбор" width="820"></a><br>
<sub>Результаты теста (сверху — «Без Zapret» для сравнения) и автоподбор по расписанию с журналом.</sub>
</p>
**Как прочитать результат:** строка «Без Zapret» — сколько сайтов открывается вообще без обхода (на скриншоте 5 из 12). Всё, что ниже, — стратегии от лучшей к худшей. `12 / 12` и зелёная полоса — открылось всё; жёлтая — лучше, чем без Zapret; красная — пользы нет. Нажмите на строку, чтобы увидеть, какие именно сайты не открылись, и **«Применить»** у лучшей.
| Режим | Что делает |
|---|---|
| **Текущая стратегия** | Проверяет то, что стоит сейчас, ничего не меняя. |
@@ -544,6 +677,16 @@ Web UI: http://192.168.1.1:7788
Вкладки Steer: **Подключение**, **Сервисы**, **Устройства**, **Исключения**, **Настройки**. Кнопки **«Выключить»** (всё пойдёт напрямую, настройки сохранятся) и **«Удалить»** — на карточке Steer.
<p align="center">
<a href="docs/screenshots/steer-overview.png"><img src="docs/screenshots/steer-overview.png" alt="Steer: обзор и секции" width="820"></a><br>
<sub>Карточка Steer: общие настройки, две секции («Основная» и «Нейросети»), сколько туннелей WARP работает и в каких странах.</sub>
</p>
<p align="center">
<a href="docs/screenshots/steer-services.png"><img src="docs/screenshots/steer-services.png" alt="Steer: вкладка Сервисы" width="820"></a><br>
<sub>Вкладка «Сервисы»: включили переключатель — сервис пошёл через туннель. Ниже — категории, дополнительные списки и «Свой список».</sub>
</p>
<details>
<summary><b>Секции — разные сервисы через разные туннели</b></summary>
@@ -566,6 +709,11 @@ Web UI: http://192.168.1.1:7788
**1. WARP — бесплатно, рекомендуется для начала**
<p align="center">
<a href="docs/screenshots/steer-warp.png"><img src="docs/screenshots/steer-warp.png" alt="Steer: туннели WARP" width="780"></a><br>
<sub>Три туннеля WARP в разных странах: через какой сейчас идёт трафик, когда была последняя связь, сколько трафика прошло, и кнопки ремонта.</sub>
</p>
- **Автоматический режим (рекомендуется)** — роутер сам получит бесплатные ключи 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) |
<p align="center">
<a href="docs/screenshots/tg-ws-proxy.png"><img src="docs/screenshots/tg-ws-proxy.png" alt="TG WS Proxy: ссылка и QR-код" width="820"></a><br>
<sub>Готовая ссылка и QR-код для Telegram. Ниже — карточки каждого варианта прокси с версией, портом и кнопками.</sub>
</p>
- **Как подключить в Telegram:** для каждого запущенного прокси есть готовая ссылка `tg://`, кнопка «Скопировать» и **QR-код** — наведите камеру телефона, и Telegram предложит добавить прокси.
<details>
<summary><b>Пошагово: как добавить прокси в Telegram на телефоне</b></summary>
1. Телефон должен быть подключён к **домашнему Wi-Fi** (прокси живёт на роутере).
2. Откройте в панели **TG WS Proxy** и нажмите **«QR-код»** у запущенного прокси.
3. Наведите камеру телефона на QR-код и нажмите на появившуюся ссылку — откроется Telegram.
4. Telegram спросит «Подключить прокси?» — нажмите **«Подключить»**.
5. Готово: в настройках Telegram (раздел **«Данные и память»** → настройки прокси) он будет помечен как подключённый.
Если камера не открывает ссылку — нажмите **«Скопировать»** и отправьте ссылку себе в «Избранное» в Telegram, затем нажмите на неё там.
> [!NOTE]
> Вне дома этот прокси не работает (если не настроен [Удалённый доступ](#-удалённый-доступ-tailscale)). Telegram сам переключится на прямое соединение, но удобнее выключить прокси переключателем в тех же настройках.
</details>
- Ставится последняя версия с GitHub; если для вашего роутера сборки нет — проверенная.
- Удаление срабатывает всегда, даже если обычное удаление «упирается».
- Если Rust-прокси уже стоит отдельно (`luci-app-tg-ws-proxy-rs`), панель его не трогает, а только показывает настройки.
@@ -781,6 +950,11 @@ Web UI: http://192.168.1.1:7788
> **Простыми словами:** некоторые сайты блокируют «по-простому» — провайдер подсовывает неправильный адрес. Файл hosts позволяет записать **правильный адрес** вручную, и сайт открывается без прокси и туннелей. Здесь это делается галочками.
<p align="center">
<a href="docs/screenshots/hosts.png"><img src="docs/screenshots/hosts.png" alt="Hosts" width="820"></a><br>
<sub>Готовые наборы включаются переключателем. AI-сервисы собраны в одну группу — стрелка справа раскрывает её.</sub>
</p>
- **Готовые наборы** — отметьте нужные и нажмите «Сохранить и применить»: 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), они обновляются сами каждый день.
<p align="center">
<a href="docs/screenshots/adblock.png"><img src="docs/screenshots/adblock.png" alt="Блокировка рекламы: статистика" width="820"></a><br>
<sub>Главная карточка: какой список включён, сколько доменов блокируется, статистика и «кто спрашивает больше всего».</sub>
</p>
<details>
<summary><b>📸 Скриншот: выбор строгости списка</b></summary>
<br>
<img src="docs/screenshots/adblock-levels.png" alt="Выбор списка блокировки" width="820">
</details>
**Насколько строго блокировать:**
| Список | Что делает |
@@ -828,6 +1013,11 @@ Web UI: http://192.168.1.1:7788
На базе `https-dns-proxy`.
<p align="center">
<a href="docs/screenshots/doh.png"><img src="docs/screenshots/doh.png" alt="DNS over HTTPS" width="820"></a><br>
<sub>Выбор сервера с замером скорости ответа («Проверить все») и цепочка запасных серверов с журналом переключений.</sub>
</p>
**Серверы на выбор:**
| Группа | Серверы |
@@ -863,6 +1053,13 @@ Web UI: http://192.168.1.1:7788
>
> **Кому нужен:** если у вас свой сервер или конфиг AmneziaWG / WireGuard, или вы хотите сделать бесплатный туннель WARP и пустить через него Steer, Forkozz или весь интернет. Для автоматического WARP в Steer всё ставится само.
<details>
<summary><b>📸 Скриншот: раздел AmneziaWG</b></summary>
<br>
<img src="docs/screenshots/amneziawg.png" alt="AmneziaWG: пакеты и интерфейсы" width="820">
<br><sub>Пакеты и список туннелей: какие из них ведёт Steer, через какой сейчас идёт трафик, точка входа и трафик. Адрес своего сервера панель прячет, пока его не раскроешь.</sub>
</details>
- **Установка** — нужные программы под точную версию вашей прошивки (сборки [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
>
> **Когда нужен:** интернет стал тормозить, роутер «задумывается», страницы долго открываются — здесь сразу видно, в чём дело.
<p align="center">
<a href="docs/screenshots/monitor.png"><img src="docs/screenshots/monitor.png" alt="Монитор ресурсов" width="820"></a><br>
<sub>Вкладка «Обзор»: кольца загрузки, графики за 5 минут, ядра процессора, «кто сколько занимает», топ процессов, сеть и датчики.</sub>
</p>
**Вкладка «Обзор»** — обновляется каждые **2 секунды**:
- **Процессор** — общая нагрузка и **каждое ядро** отдельно; сколько занимают программы, система, прерывания.
- **Память** — сколько занято и свободно.
@@ -977,6 +1179,13 @@ Web UI: http://192.168.1.1:7788
#### Параметры роутера
<details>
<summary><b>📸 Скриншот: раздел «Система»</b></summary>
<br>
<img src="docs/screenshots/system.png" alt="Система: параметры роутера, время, поиск новых версий" width="820">
<br><sub>Блокировка QUIC, IPv6, поправки Flow Offloading, время на роутере, проверка сети и поиск новых версий с автообновлением.</sub>
</details>
- **Блокировка 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. Сделали копию → экспериментировали → что-то сломали → нажали «Восстановить» → всё как было.
<p align="center">
<a href="docs/screenshots/backup.png"><img src="docs/screenshots/backup.png" alt="Резервная копия" width="820"></a><br>
<sub>Список копий на роутере: автоматические (перед установкой или обновлением) и ваши, с названием. У каждой — что в неё попало.</sub>
</p>
- **Что сохраняется:** всё, что настроено через 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 и сайты<br/>открываются?"}
C -- Да --> D(["Готово 🎉<br/>Включите автоподбор и сделайте резервную копию"])
C -- Нет --> E["Zapret → «Тест стратегий»<br/>→ «Применить» у лучшей"]
E --> F{Заработало?}
F -- Да --> D
F -- "Не открывается конкретный сервис<br/>(Instagram, Gemini, ChatGPT…)" --> G["Steer + бесплатный WARP<br/>для выбранных сервисов"]
F -- "Не работает только Telegram" --> H["TG WS Proxy<br/>(QR-код в Telegram)"]
F -- "Нужен только YouTube" --> I["ByeTube"]
G --> J{"Есть своя VPN-подписка<br/>или сервер?"}
J -- Да --> K["Steer → VPN<br/>или 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<br/>LuCI"]
U7788["uhttpd «zmweb» :7788<br/>Web UI"]
UBUS["/ubus — JSON-RPC<br/>uhttpd-mod-ubus"]
RPCD["rpcd<br/>сессии + ACL"]
PLUG["rpcd-плагин<br/>/usr/libexec/rpcd/zapret-manager"]
BE["backend.sh<br/>/opt/zapret-manager-luci"]
JOBS[("Фоновые задания<br/>/tmp/zapret-manager-luci")]
STATE[("Состояние и копии<br/>/opt/zapret-manager-luci/state, backups")]
COMP["Компоненты<br/>zapret · zapret2 · steer · sing-box · mihomo<br/>AmneziaWG · https-dns-proxy · tg-ws-proxy<br/>ByeDPI · ttyd · tailscale"]
SYS["Система<br/>UCI · fw4 / nftables · dnsmasq · procd"]
CRON["cron<br/>сторож и расписания"]
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 всегда умеют одно и то же.
- **Маршрутизация** — через `#/<id>`: `#/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=<timestamp>`), поэтому браузер получает новые файлы.
### API: объект ubus `zapret-manager`
Всё, что умеет панель, доступно как методы ubus — из браузера, из SSH и из ваших скриптов. Всего в плагине **больше 120 методов**. Посмотреть полный список с параметрами:
```sh
ubus -v list zapret-manager
```
Методы делятся на «читающие» (статусы, списки, журналы — без побочных эффектов) и «действующие» (установка, применение, удаление). В ACL читающим выдано право `read` (≈50 методов), действующим — `write` (≈80 методов).
<details>
<summary><b>Файлы на роутере</b></summary>
<summary><b>Самые полезные методы</b></summary>
| Путь | Что это |
|---|---|
| `/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
```
</details>
<details>
<summary><b>Фоновые операции</b></summary>
<summary><b>Пакетный вызов <code>multi</code></b></summary>
Установка, удаление, тесты и другие долгие действия запускаются **на самом роутере** как фоновые задания с журналом. *Зачем:* закрытая вкладка или оборванный 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` — строки `метод` или `метод<TAB>аргумент`, по одной на строку.
- В пакет попадают только безопасные методы: `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` недоступен (старая версия плагина, нет прав), клиент сам переходит на одиночные вызовы.
</details>
### Фоновые задания
Установка, удаление, тесты стратегий и другие долгие операции **не выполняются внутри 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`.
<details>
<summary><b>Сторож (раз в 2 минуты)</b></summary>
<summary><b>Что делает сторож (каждые 2 минуты)</b></summary>
«Дежурный», который сам чинит типичные поломки:
«Дежурный», который сам чинит типичные поломки. Если чинить нечего, выходит сразу и почти не нагружает роутер.
- поднимает службу **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). У **Удалённого доступа** свой сторож — раз в минуту.
</details>
<details>
<summary><b>«Не изменять» (#nochange) и большие тексты</b></summary>
### Файлы и каталоги
- Строка `#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-…` |
</details>
### Обновление панели
Кнопка «Обновить панель», автообновление и команда `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), начните с **Система → Системная информация → «Скопировать отчёт»** — в нём уже есть почти всё из таблицы выше.
---