Add files via upload
No files matched your search
|
After Width: | Height: | Size: 91 KiB |
|
After Width: | Height: | Size: 158 KiB |
|
After Width: | Height: | Size: 208 KiB |
|
After Width: | Height: | Size: 131 KiB |
|
After Width: | Height: | Size: 157 KiB |
|
After Width: | Height: | Size: 282 KiB |
|
After Width: | Height: | Size: 74 KiB |
|
After Width: | Height: | Size: 40 KiB |
|
After Width: | Height: | Size: 104 KiB |
|
After Width: | Height: | Size: 189 KiB |
|
After Width: | Height: | Size: 130 KiB |
|
After Width: | Height: | Size: 215 KiB |
|
After Width: | Height: | Size: 124 KiB |
|
After Width: | Height: | Size: 305 KiB |
|
After Width: | Height: | Size: 132 KiB |
|
After Width: | Height: | Size: 1.1 MiB |
|
After Width: | Height: | Size: 65 KiB |
|
After Width: | Height: | Size: 56 KiB |
|
After Width: | Height: | Size: 31 KiB |
|
After Width: | Height: | Size: 51 KiB |
|
After Width: | Height: | Size: 70 KiB |
|
After Width: | Height: | Size: 59 KiB |
|
After Width: | Height: | Size: 36 KiB |
|
After Width: | Height: | Size: 207 KiB |
|
After Width: | Height: | Size: 175 KiB |
@@ -8,6 +8,21 @@
|
|||||||
[](https://t.me/stressozz_manager)
|
[](https://t.me/stressozz_manager)
|
||||||
[](http://stresskvn.lol/)
|
[](http://stresskvn.lol/)
|
||||||
[](https://github.com/StressOzz/Zapret-Manager)
|
[](https://github.com/StressOzz/Zapret-Manager)
|
||||||
|
|
||||||
|

|
||||||
|

|
||||||
|

|
||||||
|

|
||||||
|

|
||||||
|
|
||||||
|
<br>
|
||||||
|
|
||||||
|
<a href="docs/screenshots/dashboard.png"><img src="docs/screenshots/dashboard.png" alt="Zapret Manager — Дашборд" width="900"></a>
|
||||||
|
|
||||||
|
<sub>Дашборд Web UI: что установлено и работает, состояние роутера, версии компонентов</sub>
|
||||||
|
|
||||||
|
**[🖼️ Скриншоты](#️-как-это-выглядит) · [💻 Установка](#-установка) · [🏁 Первые шаги](#-первые-шаги-после-установки) · [❓ Проблемы](#-частые-проблемы) · [🛠️ Для продвинутых](#️-техническая-документация-для-продвинутых)**
|
||||||
|
|
||||||
</div>
|
</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 — просто запустите файл (самый простой)
|
### 🟢 Способ 1. Для Windows — просто запустите файл (самый простой)
|
||||||
|
|
||||||
Ничего вводить не нужно — ни команд, ни программ вроде PuTTY.
|
Ничего вводить не нужно — ни команд, ни программ вроде PuTTY.
|
||||||
@@ -292,6 +366,14 @@ Web UI: http://192.168.1.1:7788
|
|||||||
|
|
||||||
Откройте адрес **Web UI** в браузере и войдите с **тем же логином и паролем, что от роутера** (`root` и ваш пароль). Всё — панель готова. Теперь переходите к разделу [🏁 Первые шаги после установки](#-первые-шаги-после-установки).
|
Откройте адрес **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]
|
> [!TIP]
|
||||||
> **Сохраните адрес панели в закладки** (`http://192.168.1.1:7788`). На телефоне его удобно добавить на главный экран: в браузере меню → «Добавить на главный экран» — панель будет открываться как приложение.
|
> **Сохраните адрес панели в закладки** (`http://192.168.1.1:7788`). На телефоне его удобно добавить на главный экран: в браузере меню → «Добавить на главный экран» — панель будет открываться как приложение.
|
||||||
>
|
>
|
||||||
@@ -395,6 +477,30 @@ Web UI: http://192.168.1.1:7788
|
|||||||
|
|
||||||
Страницы LuCI и Web UI — один и тот же код: Web UI загружает те же модули и подменяет только «обвязку» LuCI. Что умеет одна, то умеет и другая.
|
Страницы 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, блокировка рекламы, терминал, **резервная копия** (когда сделана последняя).
|
- **Компоненты** — статус каждого инструмента: Zapret, Zapret2, Steer (и через что идут сервисы — WARP, свой WARP, VPN или интерфейс AmneziaWG), Forkozz, ByeTube, TG WS Proxy, Mixomo, DoH, AmneziaWG (сколько туннелей работает), **Удалённый доступ** (подключён ли роутер к Tailscale), домены в hosts, блокировка рекламы, терминал, **резервная копия** (когда сделана последняя).
|
||||||
- **Система** — модель, архитектура, платформа, версия OpenWrt, время работы, есть ли интернет и с какой задержкой (пинг `ya.ru` / `vk.ru`), шкалы температуры и нагрузки процессора, памяти, флеша и `/tmp`. Обновляются каждые 5 секунд. *Зачем:* если роутер перегрет или кончается память, это видно сразу.
|
- **Система** — модель, архитектура, платформа, версия 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. *Зачем:* видно, что устарело и что можно обновить. Как часто искать новые версии, выбирается в **Система → Поиск новых версий**: раз в сутки ночью (по умолчанию — Дашборд тогда открывается быстро и в интернет не ходит), при каждом открытии Дашборда или только кнопкой «Проверить».
|
- **Версии** — установленная и последняя версия каждой программы: 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>
|
<details>
|
||||||
<summary><b>Установка и управление</b></summary>
|
<summary><b>Установка и управление</b></summary>
|
||||||
@@ -457,6 +583,13 @@ Web UI: http://192.168.1.1:7788
|
|||||||
|
|
||||||
Тест идёт в фоне — вкладку можно закрыть. После теста настройки Zapret возвращаются как были, пока вы сами не нажмёте «Применить».
|
Тест идёт в фоне — вкладку можно закрыть. После теста настройки 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.
|
Вкладки 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>
|
<details>
|
||||||
<summary><b>Секции — разные сервисы через разные туннели</b></summary>
|
<summary><b>Секции — разные сервисы через разные туннели</b></summary>
|
||||||
|
|
||||||
@@ -566,6 +709,11 @@ Web UI: http://192.168.1.1:7788
|
|||||||
|
|
||||||
**1. WARP — бесплатно, рекомендуется для начала**
|
**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 минут; интернет всё это время работает, страницу можно закрыть — роутер доделает сам. Перед началом панель покажет, что будет делаться, — без подтверждения ничего не начнётся.
|
- **Автоматический режим (рекомендуется)** — роутер сам получит бесплатные ключи Cloudflare, поставит AmneziaWG, если его нет, проверит точки входа и оставит **3 рабочих туннеля в разных странах**. Займёт 5–10 минут; интернет всё это время работает, страницу можно закрыть — роутер доделает сам. Перед началом панель покажет, что будет делаться, — без подтверждения ничего не начнётся.
|
||||||
- **Какой туннель главный:** «самый быстрый живой» (упал один — Steer сам переключится на другой) или «первый живой по порядку» (порядок меняется стрелками; когда верхний оживёт — Steer вернётся на него).
|
- **Какой туннель главный:** «самый быстрый живой» (упал один — Steer сам переключится на другой) или «первый живой по порядку» (порядок меняется стрелками; когда верхний оживёт — Steer вернётся на него).
|
||||||
- **Российские узлы не используются:** туннели, попавшие в российский узел Cloudflare (Домодедово и другие), в работу не берутся — заблокированное через них не открывается. Панель покажет такой туннель и предложит его переделать.
|
- **Российские узлы не используются:** туннели, попавшие в российский узел 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) |
|
| **Rust (MTProto)** | 2443 | [valnesfjord/tg-ws-proxy-rs](https://github.com/valnesfjord/tg-ws-proxy-rs) |
|
||||||
| **sTGWS** | — | [xyzmean/brb](https://gitlab.com/xyzmean/brb) |
|
| **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 предложит добавить прокси.
|
- **Как подключить в 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; если для вашего роутера сборки нет — проверенная.
|
- Ставится последняя версия с GitHub; если для вашего роутера сборки нет — проверенная.
|
||||||
- Удаление срабатывает всегда, даже если обычное удаление «упирается».
|
- Удаление срабатывает всегда, даже если обычное удаление «упирается».
|
||||||
- Если Rust-прокси уже стоит отдельно (`luci-app-tg-ws-proxy-rs`), панель его не трогает, а только показывает настройки.
|
- Если Rust-прокси уже стоит отдельно (`luci-app-tg-ws-proxy-rs`), панель его не трогает, а только показывает настройки.
|
||||||
@@ -781,6 +950,11 @@ Web UI: http://192.168.1.1:7788
|
|||||||
|
|
||||||
> **Простыми словами:** некоторые сайты блокируют «по-простому» — провайдер подсовывает неправильный адрес. Файл hosts позволяет записать **правильный адрес** вручную, и сайт открывается без прокси и туннелей. Здесь это делается галочками.
|
> **Простыми словами:** некоторые сайты блокируют «по-простому» — провайдер подсовывает неправильный адрес. Файл 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 и другие.
|
- **Готовые наборы** — отметьте нужные и нажмите «Сохранить и применить»: 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 — все отмеченные наборы и ваши записи будут удалены.
|
- **Готовые большие списки** — **GeoHide RU / EU / US** ([GeoHideDNS](https://github.com/Internet-Helper/GeoHideDNS)) или **dns.malw.link** для обхода гео-ограничений. ⚠ Полностью заменяют файл hosts — все отмеченные наборы и ваши записи будут удалены.
|
||||||
- **Восстановить hosts** — вернуть чистый файл, если что-то пошло не так.
|
- **Восстановить hosts** — вернуть чистый файл, если что-то пошло не так.
|
||||||
@@ -797,6 +971,17 @@ Web UI: http://192.168.1.1:7788
|
|||||||
|
|
||||||
Используются известные списки [HaGeZi](https://github.com/hagezi/dns-blocklists), они обновляются сами каждый день.
|
Используются известные списки [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`.
|
На базе `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 всё ставится само.
|
> **Кому нужен:** если у вас свой сервер или конфиг 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)). Если не получилось, панель подробно объяснит почему.
|
- **Установка** — нужные программы под точную версию вашей прошивки (сборки [2Grey/awg-openwrt](https://github.com/2Grey/awg-openwrt)). Если не получилось, панель подробно объяснит почему.
|
||||||
- **Список туннелей** — все туннели AmneziaWG (в том числе туннели Steer): работает ли, адрес, точка входа, трафик, когда была последняя связь, и **где используется** (в Steer, в Forkozz, «весь трафик роутера»).
|
- **Список туннелей** — все туннели AmneziaWG (в том числе туннели Steer): работает ли, адрес, точка входа, трафик, когда была последняя связь, и **где используется** (в Steer, в Forkozz, «весь трафик роутера»).
|
||||||
- **Проверить** — какой у туннеля внешний адрес и страна, есть ли потери и обрывы (если DPI рвёт туннель через пару секунд — панель скажет и посоветует другую точку входа или маску).
|
- **Проверить** — какой у туннеля внешний адрес и страна, есть ли потери и обрывы (если 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 секунды**:
|
**Вкладка «Обзор»** — обновляется каждые **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, который может проходить мимо обхода. Блокировка заставляет их вернуться на обычный способ, который обходится надёжно.
|
- **Блокировка QUIC** — *зачем:* браузеры всё чаще используют протокол QUIC, который может проходить мимо обхода. Блокировка заставляет их вернуться на обычный способ, который обходится надёжно.
|
||||||
- **IPv6 в Zapret** — *зачем:* если у вашего провайдера есть IPv6, без этой галочки часть трафика пойдёт мимо обхода.
|
- **IPv6 в Zapret** — *зачем:* если у вашего провайдера есть IPv6, без этой галочки часть трафика пойдёт мимо обхода.
|
||||||
- **Fix для Flow Offloading** — *зачем:* функция «ускорения» роутера пропускает пакеты в обход Zapret, и обход перестаёт работать. Фикс это исправляет.
|
- **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. Сделали копию → экспериментировали → что-то сломали → нажали «Восстановить» → всё как было.
|
> **Простыми словами:** «точка восстановления», как в 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 не трогаются.
|
- **Что сохраняется:** всё, что настроено через Zapret Manager — компоненты и список их пакетов с версиями, стратегии, Steer, Forkozz, AmneziaWG, DNS, блокировка рекламы, расписания, настройки самой панели, а также сеть, firewall, DHCP и hosts — целиком, как они есть сейчас. Wi-Fi, пароль роутера и остальные настройки OpenWrt не трогаются.
|
||||||
- **«Создать копию»** — занимает несколько секунд и ничего не перезапускает. Можно дать название, например «до экспериментов со Steer».
|
- **«Создать копию»** — занимает несколько секунд и ничего не перезапускает. Можно дать название, например «до экспериментов со Steer».
|
||||||
- **Копия перед рискованными действиями** (включено по умолчанию) — панель **сама** сохраняет копию перед установкой и удалением компонентов, полным удалением и обновлением панели. Хранятся 5 последних таких копий, старые удаляются сами.
|
- **Копия перед рискованными действиями** (включено по умолчанию) — панель **сама** сохраняет копию перед установкой и удалением компонентов, полным удалением и обновлением панели. Хранятся 5 последних таких копий, старые удаляются сами.
|
||||||
@@ -1029,6 +1243,22 @@ Web UI: http://192.168.1.1:7788
|
|||||||
|
|
||||||
**Правило простое:** начинайте с **Zapret** — он бесплатный, быстрый и решает большинство задач. Остальное добавляйте, только если что-то не заработало.
|
**Правило простое:** начинайте с **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** | Бесплатно, без серверов, без потери скорости. |
|
| Чтобы просто работали 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>
|
<details>
|
||||||
<summary><b>Файлы на роутере</b></summary>
|
<summary><b>Самые полезные методы</b></summary>
|
||||||
|
|
||||||
| Путь | Что это |
|
| Метод | Параметры | Что возвращает / делает |
|
||||||
|---|---|
|
|---|---|---|
|
||||||
| `/opt/zapret-manager-luci/backend.sh` | бэкенд: вся логика панели |
|
| `status` | — | Состояние Zapret/Zapret2: установлен, запущен, версия, текущая стратегия, флаги дополнений, идёт ли тест. |
|
||||||
| `/opt/zapret-manager-luci/netshift.uc` | ucode-модуль Forkozz |
|
| `health` | — | Сводка «светофора» для всех компонентов: `dots` (0 — не установлен, 1 — работает, 2 — ошибка, 3 — частично, 4 — выключен), плюс предупреждения (`flow_warn`, `ipv6_warn`, `reboot_hint`…). |
|
||||||
| `/opt/zapret-manager-luci/state/` | состояние панели (тема, кэши версий, автоподбор и т.д.) |
|
| `system_info` | — | Модель, архитектура, платформа, версия OpenWrt, ядро, флеш и `/tmp`, температура и загрузка ЦП, есть ли интернет и пинг. |
|
||||||
| `/opt/zapret-manager-luci/state/adblock/` | настройки, белый список и скачанные списки блокировки рекламы |
|
| `system_status` | — | QUIC, IPv6 в Zapret, режим Flow Offloading и поправки к нему, время и часовой пояс роутера. |
|
||||||
| `zm-adblock.conf` в папке настроек dnsmasq | собранный список блокировки (живёт в ОЗУ, после перезагрузки восстанавливается сторожем) |
|
| `versions` | `action` (`''` / `refresh`) | Установленные и последние версии компонентов, расписание проверки. |
|
||||||
| `/usr/libexec/rpcd/zapret-manager` | rpcd-плагин — объект `zapret-manager` в ubus |
|
| `zm_update_status` | — | Текущая и последняя версия самой панели. |
|
||||||
| `/usr/share/rpcd/acl.d/luci-app-zapret-manager.json` | права доступа |
|
| `steer_status`, `forkop_status`, `doh_status`, `adblock_status`, `awg_status`, `tg_status`, `tsc_status`… | — | Полное состояние соответствующего раздела. |
|
||||||
| `/usr/share/luci/menu.d/luci-app-zapret-manager.json` | пункт меню LuCI |
|
| `zapret_action` | `action`: `install` / `update` / `remove` / `start` / `restart` … | Управление Zapret. Долгие действия запускаются фоновым заданием. |
|
||||||
| `/www/luci-static/resources/view/zapret-manager/` | страницы LuCI |
|
| `job_status`, `log_tail` | `job` | Состояние и журнал фонового задания. |
|
||||||
| `/www/zm/`, `/www/zm-webui.html` | Web UI |
|
| `backup_list`, `backup_action` | `action`, `value` | Список резервных копий; создание, восстановление, удаление. |
|
||||||
| `/tmp/zapret-manager-luci/` | журналы и pid фоновых операций |
|
| `monitor`, `monitor_procs` | — | Срез `/proc` для Монитора ресурсов: ЦП по ядрам, память, сеть, датчики, процессы. |
|
||||||
| `/etc/zm-steer/`, `/etc/zm-awg/` | данные Steer и AmneziaWG |
|
| `multi` | `calls` | Пакетный вызов нескольких читающих методов (ниже). |
|
||||||
| `/opt/zapret-manager-luci/backups/` | резервные копии панели (`.zmb`) |
|
|
||||||
| `/usr/bin/zms`, `/usr/bin/zmw` | команды запуска консольной версии и переустановки панели |
|
Примеры из 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>
|
||||||
|
|
||||||
<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>
|
</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>
|
<details>
|
||||||
<summary><b>Сторож (раз в 2 минуты)</b></summary>
|
<summary><b>Что делает сторож (каждые 2 минуты)</b></summary>
|
||||||
|
|
||||||
«Дежурный», который сам чинит типичные поломки:
|
«Дежурный», который сам чинит типичные поломки. Если чинить нечего, выходит сразу и почти не нагружает роутер.
|
||||||
|
|
||||||
- поднимает службу **rpcd**, если она упала или зависла (иначе пропадает вход в LuCI);
|
- поднимает службу **rpcd**, если она упала или зависла (иначе пропадает вход в LuCI и Web UI);
|
||||||
- возвращает DNS роутера, если операция прервалась на полпути;
|
- возвращает DNS роутера, если операция прервалась на полпути;
|
||||||
- перезапускает **Forkozz**, если он включён, но не работает (с нарастающей паузой, чтобы не зациклиться), чинит мёртвые серверы и переключает DNS;
|
- перезапускает **Forkozz**, если он включён, но не работает (с нарастающей паузой, чтобы не зациклиться), чинит мёртвые серверы и переключает DNS;
|
||||||
- проверяет и чинит **VPN в Steer**;
|
- проверяет и чинит **VPN в Steer** и в его секциях;
|
||||||
- следит, чтобы туннели WARP не уходили на **российские узлы** Cloudflare;
|
- следит, чтобы туннели WARP не уходили на **российские узлы** Cloudflare;
|
||||||
- проверяет и чинит **VPN в секциях Steer**;
|
|
||||||
- поднимает упавшие **TG WS Proxy**;
|
- поднимает упавшие **TG WS Proxy**;
|
||||||
- возвращает **список блокировки рекламы** после перезагрузки;
|
- возвращает **список блокировки рекламы** после перезагрузки (список живёт в ОЗУ);
|
||||||
- обновляет адреса DNS провайдера для российских сайтов, если провайдер их сменил;
|
- обновляет адреса DNS провайдера для российских сайтов, если провайдер их сменил;
|
||||||
- переводит ядро steer 1.x на 2.x.
|
- переводит ядро steer 1.x на 2.x.
|
||||||
|
|
||||||
Сторожа можно выключить в **Система → Фоновые проверки**. У **Удалённого доступа** свой сторож — раз в минуту он возвращает настройки Tailscale на место.
|
Сторожа можно выключить в **Система → Фоновые проверки** (появится файл `state/watch.off`, и установщик при обновлении не вернёт задание в cron). У **Удалённого доступа** свой сторож — раз в минуту.
|
||||||
|
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
<details>
|
### Файлы и каталоги
|
||||||
<summary><b>«Не изменять» (#nochange) и большие тексты</b></summary>
|
|
||||||
|
|
||||||
- Строка `#nochange` в стратегии или списке запрещает панели их менять — ни при установке, ни при обновлении, ни в тестах. Переключатели «Не изменять» ставят и снимают её сами. *Зачем:* защита ваших ручных правок.
|
| Путь | Что это |
|
||||||
- Веб-сервер роутера принимает не больше 64 КБ за один запрос, поэтому большие тексты (hosts, списки, конфиги) отправляются частями и собираются на роутере. *Зачем:* иначе большие файлы не сохранились бы.
|
|---|---|
|
||||||
- После обновления панель сама сбрасывает кэш браузера. *Зачем:* не нужно ничего чистить вручную.
|
| `/opt/zapret-manager-luci/backend.sh` | бэкенд: вся логика панели; версия — в строке `ZM_VERSION=` |
|
||||||
- Всё, что панель скачивает, берётся из официальных источников — GitHub авторов проектов и репозиториев OpenWrt.
|
| `/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), начните с **Система → Системная информация → «Скопировать отчёт»** — в нём уже есть почти всё из таблицы выше.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||