diff --git a/readme.md b/readme.md index b150b6e..02257da 100644 --- a/readme.md +++ b/readme.md @@ -76,7 +76,13 @@ ### Нужно ли разбираться в сетях? -**Нет.** Один раз придётся ввести команду для установки (ниже подробно расписано, как), а дальше всё делается кнопками в браузере. У каждого переключателя есть подсказка «что делает и зачем». Самые важные вещи — например, подбор настроек под вашего провайдера — панель умеет делать **сама**. +**Нет.** На Windows установка — это **просто запустить файл** двойным щелчком (на других системах — вставить одну команду, ниже всё расписано). Дальше всё делается кнопками в браузере. У каждого переключателя есть подсказка «что делает и зачем». Самые важные вещи — например, подбор настроек под вашего провайдера — панель умеет делать **сама**. + +### ⚡ Самый короткий путь + +1. **Windows:** скачайте и запустите [`ZapretManager_Install.bat`](https://github.com/StressOzz/Zapret-Manager/releases/tag/ZapretManager_LuCI%2BWEB). Другие системы — [одна команда через SSH](#-установка). +2. Откройте в браузере **`http://192.168.1.1:7788`**, войдите с логином и паролем роутера. +3. Раздел **Zapret** → **«Установить и настроить»**. Готово. > [!TIP] > Если какие-то слова непонятны (DPI, VPN, DNS, прокси…) — загляните в [📚 Словарик](#-словарик). Там всё объяснено на пальцах. @@ -93,6 +99,7 @@ - [Первые шаги после установки](#-первые-шаги-после-установки) - [Какой инструмент выбрать](#-какой-инструмент-выбрать) - [Частые проблемы](#-частые-проблемы) +- [Вопросы новичков](#-вопросы-новичков) **Подробно о каждом разделе панели:** - [Два интерфейса: LuCI и Web UI](#️-два-интерфейса-luci-и-web-ui) @@ -173,13 +180,42 @@ ## 💻 Установка -Установка делается **один раз** и занимает пару минут. Дальше всё — в браузере. +Установка делается **один раз** и занимает пару минут. Дальше всё — в браузере. Есть два способа — выберите любой. -### Шаг 1. Узнайте адрес роутера +### 🟢 Способ 1. Для Windows — просто запустите файл (самый простой) + +Ничего вводить не нужно — ни команд, ни программ вроде PuTTY. + +1. Скачайте **`ZapretManager_Install.bat`** со страницы релиза: + 👉 **[Скачать установщик для Windows](https://github.com/StressOzz/Zapret-Manager/releases/tag/ZapretManager_LuCI%2BWEB)** (раздел **Assets** внизу страницы). +2. Компьютер должен быть подключён к роутеру (по Wi-Fi или кабелю). +3. **Дважды щёлкните** по скачанному файлу. +4. Установщик **сам найдёт роутер** в сети (или спросит его адрес), подключится к нему, а если на роутере стоит пароль — попросит его ввести (при вводе он не виден — это нормально). +5. Дальше роутер сам скачает и поставит последнюю версию Zapret Manager — ход установки видно в окне. В конце будет адрес панели — переходите к [Шагу 4](#шаг-4-откройте-панель). + +Работает на Windows 10 и 11. Всё в одном файле, после работы установщик сам убирает за собой временные файлы. + +> [!WARNING] +> **Антивирус или Windows может ругаться — это ложная тревога.** +> +> Внутри `.bat` спрятана маленькая программа для подключения к роутеру (`plink` из известного пакета PuTTY), и установщик её распаковывает и подключается по сети. Антивирусы не любят, когда скрипт так делает, поэтому могут предупредить, даже если вирусов нет. **Вирусов в файле нет**: это обычный текстовый скрипт — его можно открыть Блокнотом и посмотреть, что внутри. +> +> Что может появиться и что нажать: +> - **браузер** пишет «файл обычно не скачивают» → **«Сохранить»** / **«Всё равно сохранить»**; +> - синее окно **«Windows защитила ваш компьютер»** → **«Подробнее»** → **«Выполнить в любом случае»**; +> - **антивирус** удалил файл → добавьте его в исключения или ненадолго приостановите защиту на время установки. +> +> Скачивайте установщик **только со страницы релиза в этом репозитории** — не с чужих сайтов и не из пересланных файлов. + +### ⌨️ Способ 2. Через SSH (Windows, macOS, Linux, телефон) + +Подходит для любой системы и для тех, кто привык к командной строке. + +#### Шаг 1. Узнайте адрес роутера Чаще всего это **`192.168.1.1`**. Если не открывается — посмотрите адрес «шлюза» на компьютере или телефоне в настройках подключения к Wi-Fi. -### Шаг 2. Подключитесь к роутеру по SSH +#### Шаг 2. Подключитесь к роутеру по SSH SSH — это «командная строка роутера». Логин всегда **`root`**, пароль — **тот же, что от LuCI** (страницы настроек роутера). @@ -220,7 +256,7 @@ ssh root@192.168.1.1 Если всё получилось, вы увидите приветствие OpenWrt и строку вида `root@OpenWrt:~#`. -### Шаг 3. Вставьте команду установки +#### Шаг 3. Вставьте команду установки Скопируйте эту строку, вставьте в окно SSH (в Windows-терминале — **правой кнопкой мыши** или `Ctrl+V`) и нажмите **Enter**: @@ -234,6 +270,8 @@ sh <(wget -qO - https://raw.githubusercontent.com/StressOzz/Zapret-Manager/refs/ ### Шаг 4. Откройте панель +*(одинаково для обоих способов)* + В конце установщик напишет: ``` @@ -245,6 +283,11 @@ Web UI: http://192.168.1.1:7788 Откройте адрес **Web UI** в браузере и войдите с **тем же логином и паролем, что от роутера** (`root` и ваш пароль). Всё — панель готова. Теперь переходите к разделу [🏁 Первые шаги после установки](#-первые-шаги-после-установки). +> [!TIP] +> **Сохраните адрес панели в закладки** (`http://192.168.1.1:7788`). На телефоне его удобно добавить на главный экран: в браузере меню → «Добавить на главный экран» — панель будет открываться как приложение. +> +> Компьютер после установки можно выключать: всё работает **на самом роутере**, в том числе после его перезагрузки. + > [!IMPORTANT] > **Для некоторых стратегий Zapret на компьютере нужно один раз включить TCP timestamps.** Такие стратегии используют «метки времени» в пакетах; если на компьютере они выключены, стратегия не сработает. Телефонам и ТВ это не нужно. > @@ -811,6 +854,39 @@ Web UI: http://192.168.1.1:7788 +
+Панель выглядит «сломанной», кнопки не работают, страница пустая или старая — почистите кэш браузера + +*Почему:* браузер запоминает файлы страниц, чтобы открывать их быстрее. После обновления панели он может показывать **старые** файлы вперемешку с новыми — отсюда кривое оформление, пустые разделы, неработающие кнопки, ошибки вроде «метод не найден». Панель старается сбросить кэш сама, но иногда браузер упрямится. + +**Что сделать — от простого к надёжному:** + +1. **Жёсткое обновление страницы** (перезагрузка без кэша): + - Windows / Linux: **`Ctrl + F5`** или **`Ctrl + Shift + R`**; + - macOS: **`Cmd + Shift + R`**. +2. **Открыть в режиме «Инкогнито»** (`Ctrl + Shift + N` в Chrome/Edge, `Ctrl + Shift + P` в Firefox). Если там всё нормально — дело точно в кэше. +3. **Очистить кэш браузера:** + - Chrome / Edge / Яндекс: нажмите **`Ctrl + Shift + Delete`** → период **«Всё время»** → отметьте **«Изображения и другие файлы, сохранённые в кэше»** → **«Удалить данные»**; + - Firefox: **`Ctrl + Shift + Delete`** → **«Кэш»** → **«Удалить»**; + - Safari (Mac): меню **Safari → Настройки → Дополнения** → включить «Показывать меню Разработка», затем **Разработка → Очистить кэши**. +4. **На телефоне:** + - Android (Chrome): **⋮ → История → Удалить данные** → «Изображения и файлы в кэше»; + - iPhone (Safari): **Настройки → Safari → Очистить историю и данные**. + +После очистки откройте панель заново и войдите. Пароли и настройки на роутере от этого **не пропадают** — чистится только память браузера. + +
+ +
+Установщик .bat не находит роутер или не подключается + +- Проверьте, что компьютер подключён **к этому роутеру** (не к мобильному интернету и не через VPN — **выключите VPN на компьютере** на время установки). +- Если установщик спросит адрес — введите адрес роутера (обычно `192.168.1.1`; он должен открываться в браузере). +- Если файл исчез сразу после скачивания или не запускается — его удалил антивирус, см. предупреждение в разделе [Установка](#-установка). +- Не получается — используйте **Способ 2 (через SSH)**: результат тот же. + +
+
Не получается подключиться по SSH @@ -824,7 +900,7 @@ Web UI: http://192.168.1.1:7788
Страница пишет «Object not found» / «метод не найден» -*Почему:* служба роутера ещё не подхватила панель. Подождите пару минут — **сторож** исправит это сам. Или выполните в SSH: +*Почему:* служба роутера ещё не подхватила панель, или браузер показывает старые файлы. Сначала [почистите кэш браузера](#-частые-проблемы) и обновите страницу. Если не помогло — подождите пару минут, **сторож** исправит это сам. Или выполните в SSH: ```sh /etc/init.d/rpcd restart @@ -898,6 +974,75 @@ uci show uhttpd.zmweb --- +## 💬 Вопросы новичков + +
+Это платно? + +Нет. Zapret Manager бесплатный, как и Zapret, ByeTube, WARP, прокси для Telegram и блокировка рекламы. Платить придётся, только если вы сами решите подключить платную VPN-подписку — это необязательно. + +
+ +
+У меня обычный роутер (Keenetic, TP-Link, Asus, роутер от провайдера…) — подойдёт? + +Только если на нём стоит прошивка **OpenWrt**. На заводской прошивке панель работать не будет. Многие роутеры можно перепрошить на OpenWrt — поддерживается ли ваша модель, можно проверить в [списке устройств OpenWrt](https://openwrt.org/toh/start). Нужен обход только на компьютере с Windows — используйте **[ZapretOzz](https://github.com/StressOzz/ZapretOzz)**. + +
+ +
+Нужно ли что-то ставить на телефоны, компьютеры, телевизор? + +Нет — всё делает роутер. Две небольшие оговорки: +- прокси для Telegram нужно один раз добавить в сам Telegram (по ссылке или QR-коду из панели); +- если включаете Steer / Forkozz, на телефонах лучше выключить «Частный DNS» (см. [Частые проблемы](#-частые-проблемы)). + +
+ +
+Интернет станет медленнее? + +**Zapret, Zapret2 и ByeTube** — нет: трафик идёт напрямую, как обычно. **Steer, Forkozz, Mixomo** пускают через туннель **только выбранные сайты**, а остальное — напрямую; скорость этих сайтов зависит от сервера туннеля. + +
+ +
+Нужно ли держать компьютер включённым? Что будет после перезагрузки роутера? + +Компьютер нужен только для установки. Всё работает на роутере и **само запускается** после его перезагрузки или отключения света. + +
+ +
+Перестали работать банк, госуслуги или какой-то российский сайт + +Добавьте сайт в **исключения**: в Zapret — список «Исключения», в Forkozz — вкладка «Исключения». Такие сайты будут открываться как обычно, без обхода. + +
+ +
+Можно ли что-то сломать? + +Сломать роутер панелью очень трудно: прошивку она не трогает, а каждый компонент можно остановить или полностью удалить одной кнопкой. Опасные изменения (список рекламы, конфигурация Mihomo, sing-box) **проверяются заранее и откатываются сами**, если что-то пошло не так. Если запутались — удалите последний поставленный компонент и перезагрузите роутер. + +
+ +
+Как обновлять? Пропадут ли настройки? + +Когда выйдет новая версия, на Дашборде появится баннер — нажмите **«Обновить панель»**. Настройки всех компонентов сохраняются. После обновления, если страница выглядит странно, [почистите кэш браузера](#-частые-проблемы). + +
+ +
+Можно ли управлять с телефона? + +Да. Откройте `http://192.168.1.1:7788` в браузере телефона, подключённого к домашнему Wi-Fi. Панель подстраивается под маленький экран. + +
+ +--- + ## 🔗 Совместимость компонентов > **Простыми словами:** некоторые инструменты делают одну и ту же работу с одним и тем же трафиком. Если поставить их вместе, они будут «драться», и не заработает ни один. Поэтому панель **не даст** поставить несовместимое и объяснит почему.