Important
Данный материал подготовлен в научно-технических целях. Использование предоставленных материалов в целях отличных от ознакомления может являться нарушением действующего законодательства. Автор не несет ответственности за неправомерное использование данного материала.
Warning
Вы пользуетесь этой инструкцией на свой страх и риск!
Автор не несёт ответственности за порчу оборудования и программного обеспечения, проблемы с доступом и потенцией. Подразумевается, что вы понимаете, что вы делаете.
Веб-интерфейс для обхода блокировок на роутерах с Entware (Keenetic) и OpenWrt. Объединяет в одном окне:
- nfqws2 (zapret2) — обход DPI «на месте», без туннеля;
- туннели AmneziaWG / sing-box / mihomo — когда ресурс заблокирован по IP и нужен прокси/VPN;
- WARP/MASQUE (usque) — бесплатный Cloudflare WARP поверх HTTPS/QUIC, выручает там, где WARP по WireGuard уже режется;
- запасные каналы без своего сервера — Opera Proxy (SurfEasy) и Telegram Tunnel (локальный MTProto-прокси);
- единый слой маршрутизации «назначение → метод» поверх всего этого: для каждого домена/списка/подсети вы выбираете, через что пустить трафик, с резервной цепочкой и автопереключением при сбое.
Тёмная/светлая тема и режим «эксперт» (переключатели в подвале бокового меню), мобильная адаптация, SPA на vanilla JS + лёгкий Python/Bottle-бэкенд. Работает как на роутере с ~20 МБ RAM, так и на обычном Linux-ПК / VPS (в т.ч. с одной сетевой картой).
📘 Для разработчиков — архитектура, модули, REST API, сборка пакетов и соглашения вынесены в отдельный документ: CoderManual.md.
- Кому это нужно
- Установка
- Первый запуск и быстрый старт
- Разделы интерфейса — подробно
- Главная
- Обход DPI: Движок обхода, Управление, Стратегии, Подбор
- Движок обхода: nfqws2 или geneva_c
- Маршрутизация (единый слой)
- Мастер настройки
- Генератор конфигов (WARP и Proton VPN)
- AmneziaWG
- WARP/MASQUE (usque)
- Opera Proxy
- Telegram Tunnel
- sing-box
- mihomo
- Мониторинг и оптимизация туннелей
- Списки, домены, IP, блобы, Lua, hosts, DNS для доменов
- Диагностика, логи, обновления, автозапуск, агент, настройки
- Управление через ИИ (MCP)
- Управление из консоли (CLI)
- Обновление и удаление
- Откуда что качается (ресурсы)
- Заимствования и благодарности
- Лицензия
- У вас роутер Keenetic (с Entware/OPKG) или OpenWrt 22.03+, и часть сайтов/сервисов не открывается из-за DPI или блокировки по IP.
- …либо обычный Linux-ПК / VPS (даже с одной сетевой картой): GUI определит окружение и в локальном режиме завернёт исходящий трафик самой машины, не ломая входящие SSH/веб.
- Хотите точечный обход: YouTube/Discord/Instagram — через обход или туннель, остальное — напрямую, без потери скорости.
- Не хотите ковыряться в командной строке — нужен веб-интерфейс с подсказками, диагностикой и автоподбором рабочих настроек.
Требования:
| Параметр | Значение |
|---|---|
| Python | 3.8+ (рекомендуется 3.11; python3-light в Entware) |
| Зависимости | модули Python из репозитория (python3-urllib, -openssl, -codecs, -yaml, -sqlite3 и др. — пакет ставит их сам); веб-фреймворк Bottle встроен (vendor/bottle.py) |
| RAM | ~20–25 МБ |
| Flash | ~19 МБ в распакованном виде (каталоги стратегий, списки, тесты; пакет .ipk заметно меньше) + Python |
| Архитектуры | mipsel, mips, arm64, armv7, x86_64, riscv64 |
Keenetic (Entware):
opkg update
opkg install ca-certificates wget-ssl
opkg remove wget-nossl
wget -O zapret-gui-keenetic.ipk https://github.com/avatarDD/zapret-gui/releases/latest/download/zapret-gui-keenetic.ipk
opkg install ./zapret-gui-keenetic.ipk
/opt/etc/init.d/S99zapret-gui startДругие роутеры с Entware (ASUS, Xiaomi, GL.iNet и т.п.):
opkg update
opkg install ca-certificates wget-ssl
opkg remove wget-nossl
wget -O zapret-gui-entware.ipk https://github.com/avatarDD/zapret-gui/releases/latest/download/zapret-gui-entware.ipk
opkg install ./zapret-gui-entware.ipk
/opt/etc/init.d/S99zapret-gui startOpenWrt 24.10 и старее — opkg:
opkg update
wget -O zapret-gui-openwrt.ipk https://github.com/avatarDD/zapret-gui/releases/latest/download/zapret-gui-openwrt.ipk
opkg install ./zapret-gui-openwrt.ipk
/etc/init.d/zapret-gui enable
/etc/init.d/zapret-gui startОдной строкой (то же самое, удобно скопировать в SSH):
opkg update && wget -O zapret-gui-openwrt.ipk https://github.com/avatarDD/zapret-gui/releases/latest/download/zapret-gui-openwrt.ipk && opkg install ./zapret-gui-openwrt.ipk && /etc/init.d/zapret-gui enable && /etc/init.d/zapret-gui startOpenWrt 25.12+ и SNAPSHOT — apk:
apk update
wget -O zapret-gui-openwrt.apk https://github.com/avatarDD/zapret-gui/releases/latest/download/zapret-gui-openwrt.apk
apk add --allow-untrusted ./zapret-gui-openwrt.apk
/etc/init.d/zapret-gui enable
/etc/init.d/zapret-gui startОдной строкой (то же самое, удобно скопировать в SSH):
apk update && wget -O zapret-gui-openwrt.apk https://github.com/avatarDD/zapret-gui/releases/latest/download/zapret-gui-openwrt.apk && apk add --allow-untrusted ./zapret-gui-openwrt.apk && /etc/init.d/zapret-gui enable && /etc/init.d/zapret-gui startНа свежем Entware сначала
wget-ssl. В Entware по умолчанию стоитwget-nossl(или busybox-wget) — без поддержки HTTPS. Ссылки на GitHub начинаются сhttps://, и такойwgetотвечаетwget: not an http or ftp url: https://…. Поэтому в инструкции для Keenetic и других Entware-роутеров перед скачиванием стоятopkg install ca-certificates wget-sslиopkg remove wget-nossl: первый пакет даёт корневые сертификаты, второй —wgetс TLS, аwget-nosslубираем, чтобы вPATHне остался старый бинарь. Еслиwget-nosslу вас не стоял,opkg removeпросто ответит, что удалять нечего. На OpenWrtwget(uclient-fetch) умеет HTTPS из коробки, этот шаг не нужен. То же касается и автоустановки скриптом (вариант 2):wget -O - https://…безwget-sslупадёт той же ошибкой.Сначала
opkg update(илиapk update). Зависимости пакета —python3-lightи модули Python — ставятся из репозитория Entware/OpenWrt, а opkg берёт их имена и версии из локального индекса. Если индекс давно не обновлялся, opkg попытается скачать версию, которой в репозитории уже нет, и установка оборвётся ошибкой видаFailed to download http://bin.entware.net/…/python3-base_3.11.10-1_….ipk… HTTP/1.1 404 Not Found/Perhaps you need to run 'opkg update'?. Лечится ровно тем, что подсказывает opkg:opkg updateи повторитьopkg install. Версию Python пакет не закрепляет — подойдёт та, что сейчас лежит в репозитории.Какой пакет ваш. OpenWrt перешёл с opkg на apk не в 24.10, а в 25.12 (5 марта 2026) — до этого apk был только в main/SNAPSHOT. Релиз 24.10 остаётся на opkg: в его release notes прямо сказано «OpenWrt 24.10 uses OPKG only, APK packages are not supported. Only main branch was changed to APK». Поэтому на 24.10 нужен
.ipk, а не.apk. Проверить надёжнее, чем по номеру версии:command -v apk || command -v opkg.Пакет
.apkне подписан ключами репозитория, поэтому нужен флаг--allow-untrusted(обычная практика для локальных.apk), а имя файла — с./, чтобы apk взял именно файл, а не искал пакет в репозитории. Уopkg installто же правило про./.
-O <имя>уwgetобязателен: ссылкаreleases/latest/download/…— это редирект, иwgetбез-Oможет сохранить файл под именем, полученным из конечного URL, — тогда следующая строка не найдёт./zapret-gui-openwrt.apk(или.ipk).В однострочнике команды соединены через
&&, а не;: если скачивание не удалось, установка не начнётся. С;apk всё равно пытался поставить недокачанный файл и выдавал сбивающее с толку./zapret-gui-openwrt.apk (no such package)вместо честной ошибки wget.
enableиstartпакет делает сам в post-install, так что обычно они не нужны — но выполнить их повторно безвредно, а если сопровождающий скрипт у вас не отработал, именно они и включают автозапуск и поднимают GUI.
Linux (tar.gz):
wget https://github.com/avatarDD/zapret-gui/releases/latest/download/zapret-gui-linux.tar.gz
tar xzf zapret-gui-linux.tar.gz && cd zapret-gui
python3 app.py --host 0.0.0.0 --port 8080На Entware (Keenetic и др.) сначала нужен wget с HTTPS — см. примечание
к варианту 1:
opkg update
opkg install ca-certificates wget-ssl
opkg remove wget-nosslПотом сам скрипт:
wget -O - https://raw.githubusercontent.com/avatarDD/zapret-gui/main/install.sh | shСкрипт сам определит платформу, поставит зависимости и запустит GUI.
Если установка падает с
not foundилиNo such file or directory, хотя файл на месте — почти наверняка у скрипта появились виндовые переводы строк (CRLF). Тогда ядро пытается запустить интерпретатор/bin/sh\r, которого нет. Так бывает, когда файл скачали браузером на Windows, отредактировали в блокноте или склонировали репозиторий сcore.autocrlf=true. Лечится одним из двух способов:sh install.sh # запуск через sh игнорирует шебанг sed -i 's/\r$//' install.sh # либо убрать CR из файлаСпособ из примера выше (
wget -O - … | sh) этой проблеме не подвержен.
cd /opt && git clone https://github.com/avatarDD/zapret-gui.git && cd zapret-gui
opkg update && opkg install python3-light
python3 app.py --host 0.0.0.0 --port 8080Bottle ставить не нужно — он встроен (
vendor/bottle.py) и подключается автоматически, когда системного нет.
Бинарники (nfqws2, sing-box, mihomo, amneziawg) и обновления самого GUI можно ставить в обход недоступного GitHub:
- Зеркало / локальная папка — задайте
ZAPRET_GUI_MIRROR, либоinstall.mirrorв Настройках, либо путьfile://…. - Транспорт скачивания — в разделах установки селект «Качать через»: напрямую, либо через уже поднятый AWG-туннель / sing-box / mihomo (запрос к GitHub идёт через обход). Работает и для nfqws2, и для кнопки «Обновить GUI».
- Локальный файл — скачайте релиз на компьютер и загрузите бинарь через GUI («Установить из локального файла…»).
- Выбор версии — по умолчанию последняя, но можно поставить любую из списка релизов (в т.ч. откатиться на более старую).
Подробности по зеркалу — в разделе Настройки.
Откройте в браузере http://<IP-роутера>:8080.
Самый простой путь — «Мастер настройки» (меню VPN и маршрутизация → Мастер настройки). Пять вопросов: какая программа (AmneziaWG, WARP/MASQUE, sing-box, mihomo) → установить её → где взять сервер (бесплатный Cloudflare WARP или Proton VPN, ссылка/подписка, готовый конфиг) → что пускать через VPN (нужные сервисы вроде YouTube и Telegram, выбранные устройства, всё или «ничего, настрою сам») → «Запустить». Мастер сам сохранит конфиг, поднимет туннель, включит автозапуск и создаст маршрут — его потом видно и можно поправить на странице Маршрутизация.
Сценарий А — «просто открыть YouTube/Discord без VPN» (обход DPI):
- Zapret2 → нажмите «Установить» (скачает бинарь nfqws2 с GitHub).
- Подбор стратегий → запустите автоперебор: GUI сам найдёт рабочую стратегию обхода для ваших сервисов.
- Примените найденную стратегию (или зайдите в Стратегии и выберите вручную) → Управление → «Запустить».
- Автозапуск → включите, чтобы работало после перезагрузки роутера.
Сценарий Б — «ресурс заблокирован по IP, нужен туннель»:
- Поднимите туннель: AmneziaWG (в т.ч. Cloudflare WARP), WARP/MASQUE (тот же WARP, но по HTTPS/QUIC — когда WireGuard режется), sing-box или mihomo (см. разделы ниже).
- Списки маршрутизации → добавьте готовый список доменов (например, YouTube) или создайте свой.
- У списка нажмите «Подключить к маршруту» → выберите туннель → «Создать маршрут». Готово: эти домены пойдут в туннель, остальное — напрямую. Ещё проще — Маршрутизация → «Маршрут по шагам».
Сценарий В — «и то, и другое с автопереключением»: в Маршрутизации «Маршрут по шагам» на шаге «Надёжность» предложит запасной путь и проверку доступности; в полной форме («+ Вручную», режим эксперта) можно задать целую цепочку fallback'ов. Фоновая проверка включается в панели «Настройки» («Проверять доступность») — система сама переключится на рабочий способ, если основной «упадёт».
Меню слева сгруппировано: Обход DPI, VPN и маршрутизация, Списки и данные, Диагностика, Система. Почти у каждой страницы есть кнопка «?» с примерами. Галка «эксперт» внизу меню показывает продвинутые поля по всему интерфейсу; без неё новичок видит только необходимое. Ссылка «Простое меню» под списком разделов оставляет главное: обход (управление, стратегии, подбор), VPN (мастер, генератор, маршрутизация), списки, диагностику и систему; остальное — по «Все разделы…».
Обзор состояния: статус nfqws2, текущая стратегия, автозапуск, система, установлен ли zapret2; карточки туннелей (AmneziaWG, WARP/MASQUE, sing-box, mihomo, Opera Proxy, Telegram — показываются те, что установлены) и мониторинга (Мониторинг DNS, Healthcheck). Блок «Быстрые действия» (Запустить/Остановить/Перезапустить) и лента последних событий (логи в реальном времени).
Сверху — «Кратко»: одна строка «всё ли работает» (nfqws2 запущен, стратегия выбрана, автозапуск, нет ли рядом другого обходчика, открываются ли сайты из мониторинга) и ссылки на то, что поправить. Поле «Сайт не открывается?» ведёт в «Диагностику» и сразу показывает, куда пойдёт этот сайт. Блоки ниже свёрнуты, итог — в заголовке; блок с проблемой раскрывается сам. Кнопка «Подробно» раскрывает всё (запоминается в браузере).
Обход DPI работает без туннеля: движок перехватывает исходящие пакеты и «ломает» работу DPI (фрагментация TLS ClientHello, fake-пакеты, desync), чтобы блокировка по SNI/домену не срабатывала. Движков два — nfqws2 (zapret2) и geneva_c, работает один.
Раздел устроен по задачам, а движок — вкладка внутри задачи:
| Пункт меню | Что там | nfqws2 | geneva_c |
|---|---|---|---|
| Движок обхода | какой движок работает, переключение | ✓ | ✓ |
| Управление | запуск, остановка, телеметрия | вкладка «nfqws2» | вкладка «geneva_c»: счётчики, рабочая стратегия, установка и обновление |
| Стратегии | выбор стратегии | каталог стратегий | библиотека Geneva |
| Подбор стратегий | найти рабочую стратегию | вкладки «nfqws2: …» | вкладка «geneva_c: генетический» |
Без явного выбора открывается вкладка движка, который работает сейчас. Ниже — подробности по nfqws2, про geneva_c — в отдельном разделе.
Старт/стоп/рестарт демона, мониторинг процесса (PID, аптайм), превью итоговой команды запуска.
GUI видит nfqws2 и тогда, когда его поднял не он, а автозапуск — после перезагрузки роутера это штатный случай. Такой процесс подписан «запущен автозапуском»: он реальный, «Стоп» его останавливает, а аптайм у него закономерно больше времени жизни самой веб-сессии.
Стратегия — это набор аргументов nfqws2 (профилей). Здесь:
-
список встроенных и пользовательских стратегий. По умолчанию показаны готовые наборы (применяются как есть), сгруппированные по назначению: сайты и видео (TLS), HTTP, QUIC, голос и игры, комплексные. Приёмы — строительные блоки подбора — вынесены в отдельный фильтр; применённый напрямую приём ограничивается своим трафиком на портах перехвата. Вместо меток каталога (
recommendedстояла у четверти стратегий и ничего не выделяла) — бейджи «Помогала у вас» (из памяти подбора), «Авто-подбор», «Осторожно», «Для игр»; под названием — область действия («TLS · TCP 80, 443»), редкие действия — в меню «⋯»; -
редактор: создаёте стратегию из профилей, каждый профиль = набор приёмов desync для своего фильтра (TCP 443, HTTP 80, QUIC и т.д.);

-
Превью — показывает финальную командную строку перед применением;
-
«Вставить из буфера» (или Ctrl+V на странице) принимает и чужой профиль: конфиг zapret2 (
NFQWS2_OPT="…"), конфиг nfqws2-keenetic (NFQWS_ARGS,NFQWS_ARGS_QUIC,NFQWS_EXTRA_ARGS) или строкуnfqws2 …. Пути к lua, блобам и спискам переносятся на ваши (@lua/,@bin/,lists/), опции движка (--qnum,--user,--pidfile…) и маркеры<HOSTLIST>убираются, списки изNFQWS_EXTRA_ARGSдописываются к каждому профилю. Над редактором — что поменяно и чего не хватает (файла блоба, списка, интерфейса WAN); стратегии nfqws v1 (--dpi-desync) не переводятся — только предупреждение. Сохраняете вы, после проверки; -
доступны стратегии из INI-каталогов (
basic/advanced/direct/builtin). Каталоги приезжают вместе со сборкой GUI и обновляются вместе с ней — отдельной кнопки «обновить каталоги» нет (источник, из которого они тянулись, закрыт, см. Откуда что качается). -
в каталоге есть стратегии экосистемы nfqws2-keenetic: дефолт пакета nfqws2-keenetic (circular из трёх приёмов), а также подтверждённые участниками его чата профили — DoT/DoH для публичных резолверов, YouTube (TLS + QUIC), голос Discord, игра Wardogs (UDP 4192). Стратегию из того чата можно вставить как есть: имена блобов
tls_clienthello,quic_initial,stun,stun2,tls_sochi,game_udp,discord_udpGUI знает и объявит сам. -
стратегии nfqws-menu: 27 полных пресетов «nfqws-menu · …» — порты всех
general (ALT…),FAKE TLS AUTO…,SIMPLE FAKE…,EXPиз zapret-discord-youtube 1.10.3 на nfqws2 и личные конфиги участников чата nfqws2-keenetic (MartinBacker, Uvvi2, eduncey, hardcorp74, krushaaa). Их приёмы, которых в каталоге ещё не было, — в подборе отдельно (TLS, HTTP, QUIC, голос Discord); повторы по эффективным аргументам не добавлены. Многие из них маскируют фейк через TCP timestamps (tcp_ts): на Windows-клиенте их надо включить (netsh interface tcp set global timestamps=enabled). -
если профиль стратегии ловит порт, которого нет в перехвате («Настройки → nfqws → TCP/UDP-порты»), firewall допишет его сам и скажет об этом в журнале: например, DoT — TCP 853, Wardogs — UDP 4192, пресеты nfqws2-keenetic — TCP 1984 и UDP 590-600, 1400. Переключатель «Добавлять порты стратегии» это выключает — тогда журнал только назовёт порт, а без него в настройках профиль не увидит ни одного пакета.
Пример: создать стратегию → добавить профиль для tcp/443 с приёмом
multisplit + fake → Превью → Сохранить → Применить.
«Применить с проверкой» (меню «⋯» у стратегии) — для стратегии, в которой не уверены. GUI проверяет сайты мониторинга (те же, что у авто-починки: сервисы и свои домены), применяет стратегию и через несколько секунд проверяет снова. Если движок упал или перестало открываться всё, что открывалось, — прежняя возвращается сразу. Иначе сверху на любой странице висит плашка с итогом проверки и отсчётом: «Всё работает» оставляет стратегию и запоминает это состояние как рабочее, «Откатить» или три минуты без ответа — возвращают прежнюю (файлы, движок, автозапуск). Ожидание переживает перезапуск GUI и перезагрузку роутера.
Автоподбор по мониторингу («Стратегии → Авто-починка → Настройки»).
Когда сайт из мониторинга перестаёт открываться, GUI сам запускает
подбор стратегии для него — в песочнице (второй nfqws2, обход остальной
сети не трогается; без песочницы автоподбор не запускается), кандидаты
из памяти подбора — первыми. Режимы: «подобрать и предложить» — сверху
мониторинга появится находка с кнопкой «Применить с проверкой» (и
уведомление, если включены); «подобрать и применить» — стратегия
применяется сама и остаётся, только если сайт открылся и ничего из
открывавшегося не перестало, иначе откатывается сразу. Найденная
стратегия заменяет текущую целиком, поэтому сама она применяется, только
если текущая — один профиль; иначе приходит предложение. Один сайт — не чаще раза в 6 часов
(healthcheck.autopick.min_interval_h).
На странице «Управление» — карточка «Расписание по устройствам»: в заданные часы и дни выбранные устройства идут мимо nfqws2 (обход для них выключен), остальные — с обходом всегда. Пример: детские смартфоны и телевизор днём без обхода (YouTube через zapret у них не открывается), вечером — как у всех.
- Устройство — IP, подсеть или MAC. Лучше MAC: он переводится в текущие IPv4/IPv6-адреса по таблице соседей, так что смена адреса по DHCP и IPv6 устройства учитываются. Выбрать можно и из списка устройств сети — тогда в правиле оно подписано «Имя (MAC)», и имя сохраняется, даже когда устройство выключено.
- Окно
22:00–07:00идёт через полночь (относится к дню начала),00:00–00:00— весь день. - Уже открытое соединение не обрывается: правило действует на новые соединения. Видео, начатое до окна, может доиграть.
- Время берётся с роутера, текущее показано в карточке. Если оно не
совпадает с местным (в Entware часовой пояс часто не задан, и это UTC),
в режиме эксперта задайте сдвиг, например
+03:00. - Расписанием управляет работающий GUI (проверка раз в 30 секунд; если прошивка сбросила правила firewall, они возвращаются на следующем проверочном цикле). Работает и с iptables, и с nftables.
Настройки — firewall.device_schedule (enabled, tz_offset, rules).
Как в nfqws2-keenetic, обход можно ограничить устройствами одной
политики доступа Keenetic («Приоритеты подключений → Политики доступа
в интернет»): имя политики — в «Настройки → Firewall → Политика доступа
Keenetic» (firewall.keenetic_policy). Обход будет только для её устройств,
а с переключателем «исключить её устройства» — для всех, кроме них.
Политики с таким именем нет — обход для всех, в журнале предупреждение.
Работает с iptables (Keenetic), действует и для автозапуска.
nfqws.fastpath_workaround (по умолчанию auto) передаёт nfqws2 опцию
--fastpath-workaround сборки nfqws2-keenetic: на роутерах с аппаратным
ускорителем (известный случай — Keenetic KN-1011, MT7621) поток уходит
мимо NFQUEUE, пока nfqws2 собирает длинный ClientHello, и стратегия на
TLS не срабатывает. Штатный nfqws2 этой опции не знает — тогда GUI её не
передаёт.
Разгрузка ускорителя PPE (firewall.ppe_deoffload, по умолчанию
auto). Аппаратный ускоритель Keenetic (MediaTek PPE) забирает поток
мимо netfilter после первых пакетов, и nfqws2 не видит ответов, повторов
и RST. Если в прошивке есть цель PPE, GUI ставит штатные для NDM правила
-j PPE -m connskip --connskip N на порты перехвата: исходящее — в
mangle PREROUTING и FORWARD, ответное — в FORWARD. Первые N пакетов
(сумма окон перехвата с запасом, не меньше 30) каждого соединения идут
через процессор, дальше поток снова ускоряется — скорость загрузок не
меняется. Чужие -j PPE (NDM, z2k) не трогаются. Работает с первых
пакетов: уже привязанный к ускорителю поток правило не отвязывает. Приём
из d2k.
Клиенты VPN (firewall.skip_routed_marks). Если WAN не задан и не
найден (перехват на всех интерфейсах), устройства, которых Keenetic или
единый слой ведёт правилом ip rule в другой выход (VPN, туннель),
идут мимо очереди: иначе nfqws2 отправил бы их фейки и разрезанные
сегменты в WAN мимо туннеля. С известным WAN такие пакеты в очередь и
так не попадают.
Пробы GUI мимо обхода (nfqws.desync_mark_probe). Свои проверки GUI
метит SO_MARK, и firewall пускает их мимо очереди. Поэтому замер «как
без обхода» (baseline эксперимента, сравнение «с обходом и без») больше
не выключает обход у всей домашней сети на время проверки.
Автоматический перебор стратегий против ваших целей — раздел из четырёх вкладок: три перебора для nfqws2 и генетический подбор geneva_c (он описан ниже):
- nfqws2: blockcheck2.sh — штатный скрипт zapret2 «как есть», с потоковой телеметрией; эталон. Найденные рабочие приёмы показываются кликабельными бейджами по мере проверки.
- Несколько доменов — тот же
blockcheck2.sh, клонированный с правками для списка доменов (по одному на строку):- домены проверяются параллельно — копиями скрипта, до 4 сразу («Одновременно доменов»; 1 — по очереди). Домены с общими IP-адресами идут одной копией: перехват blockcheck2 матчит по адресу, и две копии на одном IP мешали бы друг другу;
- «Хватит рабочих на тест» (по умолчанию 3): набрав столько
стратегий, у которых успешны все попытки (
REPEATS=3 → 3/3), проверка бросает остальные варианты этого теста и переходит к следующему тесту или домену — не перебирает тысячи вариантов ради уже найденного; - на время проверки обход GUI снимается и потом возвращается;
- в конце — «Собрать стратегию»: одна стратегия на все домены,
профили по HTTP / TLS / QUIC с
--hostlist-domains, склеенные через--new. Варианты сборки: минимум профилей (приём, сработавший у нескольких доменов, берёт их одним профилем), свой профиль каждому домену, выбор приёма вручную или все сочетания (каждое — отдельная стратегия; их можно разом сохранить и сравнить подбором). Клон собирается из установленногоblockcheck2.shпри каждом запуске; если апстрим изменит скрипт так, что правку некуда вставить, вкладка скажет об этом и не запустится.
- nfqws2: по каталогу — наш перебор: ранжирует приёмы от простых к
сложным, найденное применяется в один клик (стратегия сохраняется в
«Мои стратегии», её помнит и автозапуск). Как он работает:
- обход сети на время подбора не выключается: кандидаты
проверяются во втором экземпляре nfqws2 на своей очереди, и в неё
уходят только пробы самого подбора (по метке на их соединениях).
Устройства в сети всё это время работают со своей стратегией. Нужен
root и известный тип firewall; иначе подбор идёт по-старому — с
остановкой обхода, и страница прямо об этом пишет. Выключается
настройкой
scan.isolated=off; - «Проверять несколько разом (быстрее)» — пачка стратегий
поднимается в одном nfqws2 песочницы, каждая своим профилем, и
проверяется параллельно. Сколько разом — по памяти роутера, перед
каждой пачкой: 128 МБ — до 5, 256 МБ — до 10, больше — до 15. Каждая
находка пачки сразу перепроверяется по одной: 15 соединений к сайту
разом иногда путают оборудование провайдера. Нужен nfqws2 1.0.5+
(
--filter-mark); по умолчанию выключено, насовсем — настройкойscan.parallel(autoили число); - «Сначала стратегии сообщества для моего провайдера» — до 8
стратегий, которые сработали у абонентов вашего провайдера, из
открытой базы по номерам AS (zemidala/nfqws2-strategies, база
nfqws2-ui). Свежие (подтверждённые за 60 дней) и открывавшие этот сайт
или его сеть — первыми; «не сработала» у большинства — не пробуются;
из базы берутся только шаги
--lua-desyncбез путей к файлам. Провайдер определяется по внешнему адресу через RIPEstat (номер можно вписать сам —community.asn), поэтому по умолчанию выключено. У результатов — «Поделиться» (своя находка), «Подтвердить» и «Не сработала» (взятая из базы): откроется заполненная форма issue на GitHub, что в ней уйдёт — видно заранее, отправляете вы сами. Карточка «Стратегии сообщества» внизу показывает, что база знает о вашем провайдере; - «Свою — вставить текст из чата» в списке «Сколько стратегий
пробовать»: вставьте стратегию как есть — в кавычках, с подписью,
целой командой
nfqws2 …илиNFQWS2_OPT=…. Каждая часть (через--newили пустую строку) — отдельный кандидат, до 10; берутся только шаги--lua-desync, а порты и списки подбор подставит под ваш сайт сам. «Проверить текст» до запуска покажет, что пойдёт в подбор, а что отброшено и почему: неизвестная функция, необъявленный блоб, часть для другого протокола, стратегия nfqws v1 (--dpi-desync); - «Уточнить лучшую попытку» — когда рабочих нет: берётся
стратегия, продвинувшаяся дальше всех (например, прошла TLS и
оборвалась на 16 КБ), и перебираются параметры её фейка — способ
обмануть DPI (
tcp_md5,tcp_seq,badsum,ip_autottl…), число повторов до 20, подставное имя сайта и настоящий ClientHello (tls_client_hello_clone) вместо заготовки; до 20 вариантов в той же песочнице. «Искать вариант полегче» — для рабочей: без лишних шагов, с меньшим числом повторов; - «Обрыв на 16 КБ по сетям хостингов» (карточка внизу) — проба ~20
сетей (Hetzner, OVH, Cloudflare, DigitalOcean, Contabo, Oracle…) без
обхода: где загрузка обрывается на 16–20 КБ, в песочнице подбирается
имя для фейка (
hostfakesplitс подставным именем, фейк с подменой SNI), которое обрыв снимает — 3 загрузки из 3, до 15 минут на всё. Находки идут в подбор первыми, а «Применить для сети» ставит приём профилем только на адреса этой сети (IP-списокasn<номер>из RIPEstat) поверх текущей стратегии — через «Применить с проверкой». Нужна песочница; - сначала сайт проверяется без обхода — открытый и так подбирать незачем;
- TCP проверяется скачиванием 64 КБ (блокировки часто пропускают первые 16–20 КБ и рвут связь), UDP для QUIC/HTTP3 — настоящим QUIC-приветствием с именем сайта, как у браузера, голос Discord — STUN;
- «Когда остановиться» — обычно хватает трёх рабочих; «Искать дальше» продолжит с того же места;
- прерванный подбор не теряется: прогресс и найденные стратегии
хранятся рядом с настройками (
state/scan/resume.json), поэтому после перезагрузки роутера или GUI появляется кнопка «Продолжить прерванный подбор» — перебор пойдёт с той же стратегии, найденные останутся; - перепроверка лучших: находки проверяются ещё пару раз, бейдж
«Проверена 3/3» — прошла все, «Прошла 2/3» — работает через раз,
сработавшая однажды отсеивается (настройки
scan.confirm_top/scan.confirm_repeats); - память: что помогло, запоминается для вашей сети и в следующий раз проверяется первым («Уже работала у вас»);
- почему остальные стратегии не подошли — сводкой обычными словами;
- «Нужны метки TCP» — у стратегии фейк маскируется только через
tcp_ts. Подбор идёт с роутера, а он шлёт временные метки TCP; Windows по умолчанию их не шлёт, и на компьютере с Windows такая стратегия не сработает (белая страница, «соединение прервано»). Включите метки в командной строке от имени администратора:netsh interface tcp set global timestamps=enabled. На Linux, Android, macOS и iOS они включены.
- обход сети на время подбора не выключается: кандидаты
проверяются во втором экземпляре nfqws2 на своей очереди, и в неё
уходят только пробы самого подбора (по метке на их соединениях).
Устройства в сети всё это время работают со своей стратегией. Нужен
root и известный тип firewall; иначе подбор идёт по-старому — с
остановкой обхода, и страница прямо об этом пишет. Выключается
настройкой
Подбор — не диагностика: «что и как заблокировано» показывает раздел Диагностика блокировок.
Меню Диагностика → Диагностика блокировок (раньше — BlockCheck в
группе «Обход DPI»). Раздел из двух вкладок с общей пробой и общей таксономией вердиктов
(core/testers/probe.py), поэтому один и тот же обрыв в обеих называется
одинаково:
- Тест доступности — разовый прогон по списку доменов и
классификация типа блокировки: различает блок на уровне IP
(TCP-connect не проходит → нужен туннель) и DPI/SNI (TCP ок,
рвётся TLS → поможет zapret). Поле
remediationподсказывает способ:zapret/tunnel/dns. Есть детект троттлинга YouTube, QUIC-блока, traceroute до точки обрыва. По целям, где TLS не прошёл, тест задаёт DPI три вопроса (приём d2k): ClientHello целиком → тот же ClientHello, разрезанный после первого байта → чужое имя на тот же адрес. Ответ уточняет итог: «хватит разреза» (multisplit/ multidisorder), «нужен фейк» (режут по SNI в любом куске), «режут адрес» (поможет только туннель), «режут ответ TLS 1.2», «имя подменяется локально» (роутер/AdGuard). Выключаетсяblockcheck.differential. Блок на 16-20 КБ проверяется в обе стороны: кроме скачивания — отправка (15 запросов по одному соединению с мусорным заголовком). Ответ DNS роутера сверяется с защищённым DNS (DoH Google, Cloudflare, запасной — Яндекс). Если общих адресов нет, тест проверяет соединение: адрес роутера не открывается, а адрес из DoH открывается — значит, DNS выдаёт закрытый адрес (подмена или блок одного узла), и поможет другой DNS (DoH/DoT), а не стратегия и не туннель. Разные, но открывающиеся адреса — это CDN, не подмена. Публичную заглушку провайдера, которая принимает соединение, так не отличить — её ловит TLS-проверка. - Мониторинг DNS (бывш. Block Detector) — фоновой детектор: сам находит домены из живых DNS-запросов клиентов (лог dnsmasq / AdGuard / AF_PACKET), проверяет их по цепочке DNS → TCP:443 → TLS → HTTP и может складывать заблокированные в именованный список. Локальные имена и адреса внутренней сети не проверяются; «не резолвится» попадает в список, только если домен знает публичный DoH (иначе это фильтр рекламы или опечатка). По умолчанию выключен.
Первая вкладка отвечает «как сломано», вторая — «что сломано»; кнопка «Разобрать» в мониторинге открывает домен на вкладке теста.
Обходить DPI на роутере можно одним из двух движков. Выбор — на странице Обход DPI → Движок обхода: нажмите на плитку нужного движка и подтвердите. Работает всегда ровно один: второй останавливается, его автозапуск выключается, а стратегия и прогресс подбора сохраняются, так что вернуться можно в один клик.
- nfqws2 (zapret2) — основной движок: каталог стратегий, подбор, домены и IP-списки. Всё, что описано в разделе выше.
- geneva_c — порт на C Geneva (Genetic Evasion). Стратегии — это деревья действий над пакетами: дублировать, фрагментировать, подменить поле TCP/IP, отбросить. Главное — генетический подбор: geneva сам выводит стратегию под вашего провайдера, проверяя её на заблокированном сайте. Стратегии geneva и nfqws2 разные и друг в друга не переводятся.
Где что у geneva_c:
- Установка и обновление — «Управление → geneva_c», кнопка
«Установить» («Обновить до …», когда закреплённый релиз новее)
ставит бинарник из официального релиза avatarDD/geneva_c (сверка
sha256) в
/opt/usr/bin/geneva. Версия и закреплённый релиз видны и на странице «Обновления», кнопка там ведёт сюда же. - Телеметрия движка («Управление → geneva_c») — запущен ли, вердикт простыми словами («работает: стратегия срабатывает», «трафик есть, но стратегия не срабатывает», «трафика нет»), счётчики пакетов, сколько изменено и отброшено, ошибки, срабатывание каждого дерева стратегии и лента событий. Если система пересоберёт firewall и правила geneva пропадут, движок перезапустится сам.
- Рабочая стратегия — вставьте свою или нажмите «Сделать рабочей» у найденной или библиотечной. Живой движок меняет её на лету.
- Подбор стратегии («Подбор стратегий → geneva_c: генетический») — сайт, который у вас заблокирован, проба (TLS, HTTP или полная загрузка HTTPS) и размер: быстрый, обычный, глубокий. На время подбора обход ставится на паузу, иначе проба прошла бы через него, а после — возвращается. Видно поколение N из M, проходит ли сайт без обхода, лучшая стратегия и последние проверки. Прогресс сохраняется: «Остановить» или перезагрузка роутера не теряют поиск — кнопка «Продолжить» доведёт его с того же поколения, «Ещё поколений» продолжит законченный. Все оценки копятся в базе и не повторяются.
- Библиотека («Стратегии → geneva_c») — стратегии из исследования Geneva с фильтром по стране и тесту; укажите сайт, отметьте несколько и нажмите «Проверить выбранные на моей сети».
- Настройки («Управление → geneva_c», режим «эксперт») — порты, протокол, интерфейс, firewall (nft/iptables), автозапуск.
Где хранится: <каталог настроек>/state/geneva/ — рабочая стратегия,
checkpoint поиска, база оценок и итог подбора; переключения движков —
state/engines.json. Правила firewall geneva снимает при любом
выходе; при аварийной остановке GUI снимает их сам (geneva fw down).
Управление через ИИ: инструменты bypass_engine_status,
bypass_engine_set, geneva_* (см. MCP).
Карточка «Авто» стоит первой в разделе «Обход DPI» и на вкладке «Управление → geneva_c». Включите и больше ничего не настраивайте. zapret-gui сам следит за трафиком через роутер — устройств в сети и самого роутера — и сам находит заблокированное любого вида: сайты (TCP и QUIC), DNS, WireGuard, OpenVPN, DHT торрентов, любые серверы по адресу и порту.
Как это работает:
- Замечает. Раз в 15 секунд смотрит таблицу соединений ядра (conntrack): какие соединения не устанавливаются, обрываются сбросом, зависают без ответа или на 16 КБ. Нужен учёт пакетов conntrack — режим включает его сам на время работы.
- Проверяет. Прежде чем что-то менять, повторяет запрос сам, мимо любого обхода: сайт — полной загрузкой страницы, остальное — повтором первых пакетов программы. Открылось — это не блокировка. Не устанавливается само соединение — блокировка по адресу, пакетами её не обойти (нужен туннель), режим скажет об этом и не будет мучить сервис.
- Подбирает. Сначала проверяет до 12 известных стратегий сразу, несколькими потоками; не помогло — запускает генетический подбор geneva. Прогресс сохраняется: следующий подбор того же сервиса продолжит с прошлого места. С geneva_c 1.2 и новее каждую стратегию проверяет сам zapret-gui, без запуска отдельной программы на каждую проверку: подбор на роутере заметно быстрее, а оценка точнее.
- Применяет только к этому сервису. Каждая найденная стратегия работает отдельным процессом и получает только трафик своих адресов и портов (и только первые пакеты соединения) — остальной интернет идёт как шёл.
- Следит. Если обход перестал работать, сервис проверяется заново и при необходимости получает новую стратегию. Не нашлось ничего — повторная попытка через час, потом реже (до раза в сутки).
На карточке видно, что режим делает сейчас, сводку, сервисы с проблемой
или обходом (галочка «показать все» — все), у каждого — состояние,
причина и стратегия, кнопка «Сбросить» (забыть сервис и начать
наблюдение заново), а ниже — работающие стратегии со счётчиками и журнал.
Всё сохраняется (state/geneva/auto.json) и включается снова после
перезагрузки роутера.
Что важно знать:
- Режим работает только на движке geneva_c: при включении, если обход шёл через nfqws2, он спросит подтверждение и переключит движок. Пока «Авто» включён, geneva с одной стратегией и ручной подбор недоступны; переключение на nfqws2 выключает режим.
- Нужно: geneva_c, conntrack (
/proc/net/nf_conntrackили пакетconntrack), для iptables —ipsetиiptables-mod-conntrack-extra. Чего не хватает — карточка скажет, что поставить. tcpdump необязателен: без него протокол «неизвестных» серверов не определяется, и они проверяются только по своему трафику. - Блокировку по IP режим не обходит: такие сервисы направляйте в туннель (единый слой маршрутизации).
- Ускорение NAT мешает. С программной или аппаратной разгрузкой потоков (OpenWrt: «Сеть → Межсетевой экран → Разгрузка потоков»; Keenetic: аппаратный NAT) соединения устройств после установки идут мимо firewall, и стратегия их не видит: обход будет работать только для самого роутера. Карточка предупредит об этом, а внизу неё есть переключатель «Ускорение NAT роутера»: выключение и обратное включение с подтверждением (OpenWrt — разгрузка потоков в firewall, Keenetic — программный и аппаратный PPE). Включение возвращает то, что было до выключения.
- Имена сайтов. Пока режим включён, роутер слушает DNS-ответы и имя сайта в начале TLS/HTTP-соединения (фильтр в ядре, в память, на диск и наружу ничего не уходит), поэтому в списке сайты видны по домену, а не «TCP ip:443». Имя QUIC — только из DNS.
- Туннели и прокси тоже под защитой. Если провайдер блокирует само
подключение роутера к серверу AmneziaWG, WireGuard, sing-box, mihomo или
usque, «Авто» найдёт стратегию и для него — как для сайта. Такие сервисы
подписаны «Туннель: …». Отключить — флажок «Защищать туннели и прокси
zapret-gui» внизу карточки «Авто» (
geneva.auto.help_tunnels). Трафик внутри туннелей режим не трогает никогда. Адреса серверов, которые наблюдать не нужно (например, прокси в режиме TPROXY), — в поле «Не наблюдать адреса серверов» там же (geneva.auto.exclude). - IPv6 и оверлейные сети. Настройка «Отключить IPv6» (раздел
nfqws2, общая для движков) действует и на «Авто»: при ней IPv6-соединения
не наблюдаются и обход для них не подбирается. Сеть Yggdrasil
(
0200::/7) режим не наблюдает никогда: это зашифрованный оверлей поверх интернета, а не сайты, и DPI его не видит. - Стартовый набор. Сразу после установки подбор начинается со
стратегий, которые уже сработали на сетях российских провайдеров (TCP:
[TCP:flags:PA]-fragment{tcp:34:True:17}-| \/иfragment{tcp:-1:False}, UDP/QUIC/STUN —duplicate(tamper{UDP:load:corrupt})): большинство сайтов получают обход без генетического поиска. Не сработали — дальше шаблоны и подбор. - Подбор перебирает всё известное: сначала стратегии, проверенные в
вашей сети и импортированные, потом все шаблоны и библиотека Geneva,
затем генетический подбор; каждый круг — параллельно
(
geneva.auto.workers). Сервисы «не найдено» подбираются снова через 1–24 ч и сразу, как только найдётся новая рабочая стратегия. - Вкладка «Стратегии → geneva_c» показывает только стратегии, которые работают в вашей сети: какие держат обход в «Авто» (и для каких сервисов) и какие нашёл ручной подбор. «Экспорт» сохраняет их файлом для обмена (без адресов устройств), «Импорт» принимает такой файл или текст со стратегией на строку. Библиотека исследований Geneva — ниже, в свёрнутом блоке «справочно».
- Настройки — внизу карточки «Авто»: «Проверок одновременно при
подборе» (
geneva.auto.workers, по умолчанию 4, до 8; больше — быстрее подбор, но выше нагрузка на процессор роутера) и «Стратегий одновременно» (geneva.auto.max_groups, 4, до 8). - Через ИИ:
geneva_auto_status,geneva_auto_enable(с подтверждением),geneva_auto_disable,geneva_auto_reset.
Центральная страница. Таблица правил «назначение → метод».
Новичкам — кнопка «Маршрут по шагам». Четыре шага: что пускать (сайты и сервисы — YouTube, Telegram, ChatGPT…, свои адреса или списки — либо устройства целиком) → через что (работающий туннель, обход DPI или напрямую; неподходящие варианты погашены с объяснением) → надёжность (запасной путь и проверка доступности) → создать.
Страница разложена по смыслу: сверху — «Маршрут по шагам», «+ Вручную» (полная форма), «Диагностика» и меню «Ещё» (применить все, сбросить лишнее, экспорт/импорт; в режиме эксперта — низкоуровневые операции). Ниже — только предупреждения, которые требуют действия, затем свёрнутая панель «Настройки» со сводкой в заголовке (как работают маршруты по доменам — dnsmasq / Keenetic / DNS-перехват, фоновая проверка доступности, kill-switch) и список маршрутов. Галочки и массовые действия, кнопка «Применить» в строке и статистика DNS-перехвата видны в режиме эксперта. Возможности для ручной настройки:
- Назначение — домены, CIDR, именованный список, geosite/geoip.
- Метод —
direct(напрямую),nfqws2(обход DPI),awg:<iface>/warp:<iface>(WARP/MASQUE) /singbox:<iface>/mihomo:<iface>(туннель). - Резервная цепочка (fallback) — если primary деградирует, трафик уходит на следующий метод.
- Мониторинг + автопереключение — TLS-проба назначения; при падении успешности ниже порога метод переключается автоматически (с гистерезисом и cooldown, без «дёрганья»).
- «Подобрать» — для деградировавшего nfqws2-маршрута запускает подбор стратегии прямо отсюда.
- Шаблоны доменов — кроме обычного домена (с поддоменами) можно
писать wildcard (
cdn*.example.com,r?---sn-*.googlevideo.com) и regex (regexp:^api[0-9]+\.example\.com$). Шаблон заранее не разрезолвить — работает при включённом перехвате DNS. - Работа со многими маршрутами — галочки в таблице и панель
массовых действий (включить, выключить, сменить метод, удалить,
экспорт выбранных); экспорт/импорт маршрутов файлом (импорт —
выборочно, копией или с заменой); баннер пересечений — один и тот
же домен, домен и его поддомен, вложенные подсети или один список в
нескольких маршрутах. В форме: «Вставить список» раскладывает
смешанный текст (домены, IP/подсети,
geosite:,geoip:) по полям, несохранённые правки видны, Ctrl+S сохраняет. Домены и подсети проверяются при сохранении — опечатка возвращается ошибкой в форму. - Перехват DNS (Keenetic без dnsmasq) — по UDP и TCP; правило на CDN-домен срабатывает и тогда, когда клиент спросил другое имя, а ответ пришёл CNAME'ом на него; IPv6-адреса доменов маршрутов клиенту не отдаются (туннели WARP/AWG часто без IPv6 — иначе трафик пошёл бы по IPv6 мимо туннеля; переключатель рядом с кнопкой перехвата).
- IP доменов истекают сами. Запись в наборе живёт TTL из DNS плюс
час (
routing.set_ttl) и продлевается, пока домен на неё указывает: набор не копит чужие адреса CDN, а уже открытые соединения не рвутся. - Правила возвращаются сами. Keenetic пересобирает firewall при
переподключении WAN и смене политик и сносит при этом чужие правила;
хук
netfilter.dтеперь возвращает и правила маршрутизации (маркировку доменов, masquerade, DSCP, перехват DNS). Поднялся интерфейс sing-box, mihomo или WARP — его маршруты применяются сразу, без «Переприменить». - «Диагностика» — если маршрут есть, а сайт всё равно не открывается.
Кнопка проверяет по шагам цепочку каждого маршрута: интерфейс поднят →
правила ядра на месте → набор адресов наполнен → контрольный адрес
уходит в туннель, а для sing-box ещё и сам движок: запущен ли конфиг
с этим TUN и пропустит ли его стек TCP. Первый ✗ в отчёте — место
поломки; отчёт можно скопировать и приложить к issue. То же из консоли:
python3 -m core.routing.doctor.
Пример: youtube.com, googlevideo.com → singbox:proxy с fallback
nfqws2; включить мониторинг — если прокси ляжет, домены автоматически
переедут на обход DPI.
Туннели WireGuard / AmneziaWG поверх роутера + точечная маршрутизация в них. Сам пункт AmneziaWG открывает обзор: статус интерфейсов/пиров, up/down, handshake, трафик (sparkline), автозапуск, «переподключать при плохом соединении» (watchdog: handshake-age + активная проба через туннель). Подменю:
- Конфиги — редактор
.confсо всеми AWG-полями (Jc,Jmin,Jmax,S1/S2,H1…H4,I), импорт текстом/файлом, экспорт. - WARP — Cloudflare WARP: импорт готового конфига, WARP-in-WARP (два WARP друг над другом); генерация новых конфигов — в Генераторе конфигов.
- AWG-правила — та же страница Маршрутизации с фильтром «Через: AWG» (правила одни — единый слой).
- Установка — детект окружения, недостающие пакеты (например,
OpkgTun на Keenetic), установка бинарников
amneziawg-go/-tools(скачиваются из наших Releases, проверка sha256).
Возможности маршрутизации в туннель — по: CIDR, доменам (через
dnsmasq+ipset/nftset), устройствам (по IP/MAC), DSCP-меткам (QoS).
В устройствах можно указать и целую подсеть — 192.168.1.0/24:
тогда в туннель уходят все её клиенты, а трафик внутри локальной сети и
трафик самого роутера остаются локальными (иначе роутер уехал бы в
туннель вместе с ними и пропал из сети).
VPN и маршрутизация → Мастер настройки — VPN «под ключ» для тех, кто не хочет разбираться. Пять шагов:
- Программа — AmneziaWG (рекомендуем), WARP/MASQUE (если WireGuard режут), sing-box или mihomo (для своих серверов по ссылке/подписке).
- Установка — если программы ещё нет, мастер скачает и поставит её (через «Авто» — при блокировке GitHub через работающий обход).
- Сервер — бесплатный Cloudflare WARP, бесплатный Proton VPN (или свой конфиг Proton), ссылка/подписка, готовый конфиг или уже сохранённый. У вставленного текста — проверка синтаксиса.
- Что пускать — сервисы (YouTube, Telegram, ChatGPT…), свои сайты и списки, выбранные устройства, все устройства или «ничего, настрою сам».
- Запуск — одной кнопкой: сохранить конфиг (для sing-box/mihomo — новый, с TUN-интерфейсом), поднять туннель, включить автозапуск и создать маршрут единого слоя. Итог — по шагам ✅/❌; если маршрут сохранился, но не применился, мастер ведёт в «Маршрутизация → Диагностика», а не предлагает повтор с нуля.
На страницах AmneziaWG, WARP/MASQUE, sing-box и mihomo есть плашка «Настроить по шагам» — она открывает этот мастер для нужной программы.
Бесплатный VPN-доступ без сторонних сайтов — аналог warp-generation и proton-generation, но прямо на роутере, с конфигами сразу под AmneziaWG, WARP/MASQUE (usque), sing-box и mihomo:
- Cloudflare WARP по WireGuard/AmneziaWG — роутер сам регистрирует устройство в Cloudflare (ключ создаётся на роутере), добавляет маскировку AmneziaWG: мусорные пакеты и «сигнатуру» I1 — QUIC-подключение к российскому сайту, DNS-запрос или начало SIP-звонка. Можно взять случайный адрес и порт Cloudflare, DNS, IPv6, WARP+ ключ.
- Cloudflare WARP по MASQUE — для usque и mihomo (у mihomo — автопереключение H3 ↔ H2).
- Proton VPN — бесплатные серверы с выбором страны и нагрузки. Сессию и серверы даёт сервис proton-generation, но ключ WireGuard создаётся на роутере и сервису не передаётся. Запасной путь — «Мой конфиг Proton»: если сервис не отвечает или отказывает (например, Cloudflare 1010 — тогда мастер переключится на этот вариант сам), скачайте WireGuard-конфиг в аккаунте Proton (account.protonvpn.com → «Загрузки» → «Конфигурации WireGuard», бесплатный тариф подходит) и вставьте его — генератор соберёт из него AmneziaWG с маскировкой, sing-box и mihomo. Кнопка «Открыть аккаунт Proton ↗» ведёт прямо на страницу загрузок, скачанный файл можно перетащить на поле — проверка запустится сама. (Забрать файл с сайта Proton автоматически нельзя: браузер не даёт одной странице читать другую, а у Proton нет способа вернуть конфиг на роутер.) То же есть в «Мастере настройки».
- Проверка синтаксиса — кнопка «Проверить» у каждого готового конфига
и у вставленного текста, а также в списках конфигов AmneziaWG (обзор и
редактор), WARP/MASQUE, sing-box (список и редактор — проверяет
несохранённый текст) и mihomo. Сначала встроенный разбор, а если
программа установлена — она сама (
sing-box check,mihomo -t), и её вердикт главный. Итог — в окне поверх страницы. Ничего не сохраняет. В MCP —vpngen_check. - Если Cloudflare или сервис заблокирован — «Как дойти: Авто»: сначала напрямую, при блокировке — через уже работающий AWG/sing-box/mihomo (или выберите обход явно). Для WARP есть и запасной источник — сервис warp-generation (тогда ключ создаёт сервис, об этом сказано в интерфейсе).
Одна генерация = одно устройство WARP/Proton: можно сохранить конфиги под
несколько программ, но держать запущенным одновременно стоит только один.
sing-box не умеет маскировку AmneziaWG и MASQUE — для него конфиг
обычный WireGuard. Генератор доступен и модели через MCP
(vpngen_generate, vpngen_proton_servers, vpngen_check).
Тот же бесплатный Cloudflare WARP, но по протоколу MASQUE (CONNECT-IP, RFC 9484) поверх HTTP/3 на 443 — а не по WireGuard. Для DPI трафик выглядит обычным HTTPS, поэтому режим выручает там, где WARP по WireGuard уже режется или закрыт UDP/51820. Свой сервер и подписка не нужны.
Бинарник usque собираем сами
(как amneziawg-go и sing-box): релизы usque-bin-v*, sha256 сверяется
по manifest.json релиза. Есть сборки под mipsel/mips/aarch64/armv7 и
x86_64 — то есть usque ставится и на обычный Linux-ПК/VPS.
- Установка — детект бинарника, архитектуры и
/dev/net/tun, установка и обновление пакета. Без модуля TUN туннель не поднимется (kmod-tun). - Сессия — либо регистрация нового устройства в Cloudflare прямо из
GUI, либо импорт готового
config.jsonот usque (перенос сессии с другого устройства без плодения устройств в аккаунте). - Регистрация через обход — если провайдер режет сам
api.cloudflareclient.com(ошибкаTLS handshake timeout), в окне регистрации выберите «Регистрировать через»: уже поднятый AWG-туннель либо sing-box/mihomo. Тот же список, что и «Качать через» на странице установки. - Запуск — туннель поднимается как интерфейс
usque0,usque1, … (уже существующие профили с именемopkgtunNего сохраняют); адреса из сессии и MTU 1280 GUI назначает сам. - Транспорт —
Performance(H3/QUIC, по умолчанию),Restricted(H2 поверх TCP:443 — когда UDP/443 зарезан),Auto. - SNI-маскировка, режим отладки (буфер лога 40 → 500 строк), watchdog (проба трафиком через сам туннель + перезапуск) и автозапуск после перезагрузки.
- WARP-in-WARP — MASQUE+MASQUE, MASQUE+AWG, AWG+MASQUE.
Дальше трафик заворачивается в туннель на странице Маршрутизация
(warp:usque0) — по доменам, CIDR или устройствам.
Конфиг AmneziaWG сюда не подойдёт, и это не ограничение GUI. usque говорит по MASQUE, а не по WireGuard, и ключи у них разных алгоритмов (X25519 против ECDSA P-256) — пересчитать одно в другое нельзя. Сессия берётся только регистрацией или импортом
config.jsonсамого usque.
«Туннель запущен» ≠ «WARP подключён». usque устанавливает соединение лениво — только при первом исходящем пакете, уже после старта. Поэтому при зарезанном QUIC туннель поднимается нормально, а трафик не идёт; в «Полном логе» это видно как
Failed to connect tunnel: … no recent network activity. Лечится переключением транспорта наRestricted; watchdog делает это сам, если выбран профильAuto.
Локальный HTTP/SOCKS5-прокси через Opera VPN (SurfEasy) — бесплатный запасной канал на случай, когда своего сервера и подписки нет. Аккаунт не нужен и настраивать нечего: клиент сам регистрирует анонимное устройство в API SurfEasy, от вас — только регион (EU / AS / AM) и кнопка «Запустить».
- Статус — PID, фактический bind и отдельный признак «порт отвечает»: живой процесс ещё не значит рабочий прокси (клиент может крутиться, не сумев зарегистрироваться в API).
- Bind — по умолчанию
127.0.0.1:18080, то есть прокси виден только самому роутеру. Чтобы отдать его в LAN —0.0.0.0:18080(порт станет доступен всей локальной сети, ставьте осознанно). IPv6 — в скобках:[::1]:18080. - Режим — HTTP-прокси (по умолчанию) или SOCKS5.
- Proxy bypass — что не заворачивать в прокси:
*.local,192.168.0.0/16. - Fake SNI — маскировка SNI при обращении к инфраструктуре SurfEasy.
- Verbosity (10 Debug … 60 Silent), «режим отладки» и кнопка «Лог» — хвост вывода клиента хранится в памяти (60 строк, в отладке 600) и включает причину неудачного старта, например занятый порт.
- «Автозапуск и watchdog» — одна галка: и подъём после перезагрузки, и перезапуск, если процесс упал либо перестал принимать соединения.
- «Обновить список стран» — отдельная кнопка, а не автообновление: каждый такой запрос — это новая регистрация устройства в API SurfEasy.
Настройки применяются при следующем запуске: после «Сохранить» — «Остановить» → «Запустить».
Opera Proxy — локальный прокси, а не метод единого слоя
маршрутизации: прозрачно трафик он не заворачивает. Пропишите
127.0.0.1:18080 в браузере/приложении либо направьте трафик на этот порт
через redsocks/tproxy.
Это чужая VPN-инфраструктура Opera с бесплатным анонимным доступом: скорость и доступность не гарантированы, а для чувствительного трафика лучше свой сервер (sing-box / AmneziaWG).
Бинарник. Ставится кнопками «Установить opera-proxy» / «Обновить до
последней версии» прямо на странице. Источник — наша сборка из
исходников Alexey71/opera-proxy:
релизы opera-bin-* этого репозитория, у каждого — manifest.json с
sha256 каждой сборки, и хэш сверяется строго (не совпал — установка
прерывается, как у остальных бинарников). Файл кладётся в
/opt/usr/bin/opera-proxy. Поддержаны aarch64, x86_64, mipsel, mips и
armv7; на других архитектурах установка откажет с явным сообщением.
Если нашей сборки нет — запасной источник: релизы самого Alexey71
(закреплённая версия v1.31.0). Выход новых версий отслеживает раздел
«Обновления». Наружу сам клиент ходит в API SurfEasy
(api2.sec-tunnel.com) и на прокси-узлы *.sec-tunnel.com.
Локальный MTProto-прокси на роутере для обхода блокировки Telegram.
Приложение Telegram подключается к роутеру по ссылке tg://proxy, а
исходящее соединение заворачивается в WSS и (по выбору) уходит через
Cloudflare — это лечит именно блокировку по диапазону IP датацентров
Telegram, а не только точечный DPI. VPS не нужен: прокси и клиент — в
одной домашней сети, белый IP не требуется.
Движков два:
- tg-ws-proxy-go — основной. Управляется через свой init.d-скрипт
(
start/stop/status), конфиг —/opt/etc/tg-ws-proxy/config.conf(на OpenWrt/etc/tg-ws-proxy/), секрет отдельно вsecret.confс правами0600. - tg-mtproxy-client — резервный, relay-based. Нужен на случай, если
ляжет вся инфраструктура Cloudflare разом (у основного движка это общая
точка отказа). Требует адрес релея (
wss://…) — он сохраняется после первого удачного запуска.
Как выходить на датацентр Telegram — переключатель из пяти режимов:
| Режим | Что происходит |
|---|---|
| Прямое подключение | Соединение идёт на IP датацентра (поле «DC IP»). Работает, только если провайдер не режет диапазон целиком. |
| Cloudflare community | Публичный пул доменов апстрима. Быстро начать, но пул общий — может быть перегружен или заблокирован. |
| Cloudflare custom domain / Worker | Свой домен за «оранжевым облаком» или бесплатный *.workers.dev. Заполняется что-то одно. |
| Hybrid | Сначала напрямую, затем Cloudflare-фоллбэк (--cfproxy-priority=false). |
| Через существующий WARP-туннель | CIDR датацентров Telegram (список с core.telegram.org/resources/cidr.txt) заворачиваются в уже поднятый AWG+WARP или MASQUE+WARP через единый слой маршрутизации. |
Остальное на странице: порт и адрес прослушивания (bind — он же
подставляется в ссылку tg://proxy), fake-TLS домен (режим ee,
маскирует входящее соединение клиента к роутеру — на исходящий WSS не
влияет), профиль соединений (stealth 1/32 · balanced 2/64 · low
latency 4/128), автозапуск при старте роутера, готовая ссылка
подключения с кнопкой «Копировать» и смена secret (с подтверждением:
все выданные ранее ссылки перестанут работать).
Настройки пишутся в config.conf, работающий процесс их не перечитывает
— после «Сохранить» нажмите «Перезапустить».
Если задан свой CF-домен, GUI дополнительно заводит для него авто-маршрут
nfqws2в едином слое — чтобы стратегия десинхронизации применялась и к WSS-соединению до Cloudflare. Для community-пула так сделать нельзя: домен выбирает сам бинарник во время работы, и заранее он неизвестен.
Режим «через WARP-туннель» и CF-домен — разные failure domain, но первый делит инфраструктуру с вашим общим VPN: упадёт WARP — исчезнет и обход Telegram. Для отказоустойчивости держите оба способа переключаемыми.
Текущий upstream tg-ws-proxy-go использует
InsecureSkipVerifyдля исходящего WSS — GUI не прячет это ограничение, строгая TLS-проверка требует обновлённого апстрим-бинарника.
Бинарник. Ставится кнопкой «Установить tg-ws-proxy» прямо на
странице. GUI берёт релиз 0.9.3
spatiumstas/tg-ws-proxy-go
(форк Flowseal/tg-ws-proxy под
встраиваемые устройства). Версия закреплена намеренно: начиная с v1.0
апстрим стал настольным приложением (Windows/macOS/Linux) и пакетов для
роутеров больше не выпускает. Качается готовый пакет, а не голый
бинарник, и ставится штатным пакетным менеджером, поэтому вместе с ним
приезжает init.d-скрипт S99tg-ws-proxy:
- Entware —
.ipkдля aarch64, armv7, mips, mipsel →opkg --force-reinstall install; - OpenWrt с apk (25.12+/SNAPSHOT) —
.apkдля aarch64, x86_64, arm_cortex-a7, arm_cortex-a9, mips, mipsel →apk add --allow-untrusted.
Роутерных пакетов под opkg-сборки OpenWrt (≤ 24.10) апстрим не выпускает —
там берётся Entware'ская .ipk (то есть нужен установленный Entware).
Ваши config.conf и secret.conf при обновлении сохраняются — апстрим
объявляет их conffiles, — а сам пакет после установки перезапускает
сервис. Если нужная версия уже стоит, скачивания не будет («уже
актуальная версия»).
Про проверку целостности. Для известной нам версии (
0.9.3) в манифест зашит sha256 каждой сборки — не совпал, установка прерывается; нет хэша под вашу архитектуру у этой же версии — установка тоже не начнётся (fail-closed, как у остальных бинарников). Для более новой версии фиксированного хэша быть не может, а файла контрольных сумм апстрим не публикует, поэтому целостность держится на HTTPS к GitHub — GUI прямо сообщает об этом после установки и пишет в лог. Нужна только строгая проверка — ставьте0.9.3вручную черезopkg install.
Community-пул CF-доменов тянется отдельно, уже самим бинарником, из
raw.githubusercontent.com/Flowseal/tg-ws-proxy/…/cfproxy-domains.txt.
Резервный tg-mtproxy-client панель ищет по путям
/opt/usr/bin/tg-mtproxy-client и /opt/sbin/tg-mtproxy-client; если
его там нет — так и пишет. Сам бинарник собираем мы (тег
tgproto-bin-v*): у апстрима в релизах нет aarch64 и armv7, из-за чего
на массовых aarch64-Keenetic резервный движок было не поставить вообще.
Устроен он иначе, чем основной: это не MTProto-прокси, а прозрачный
форвардер — ссылки tg://proxy у него нет. Трафик к датацентрам
Telegram заворачивается на его порт правилом REDIRECT, которое GUI
ставит и снимает сам вместе с запуском/остановкой движка. Релей и его
secret заданы по умолчанию (публичный релей); свои — в полях «Relay» и
«Secret релея», пустое поле возвращает значение по умолчанию.
Режим «через WARP-туннель» (выше) и резервный движок взаимоисключающи: REDIRECT перехватывает пакеты раньше, чем принимается решение о маршруте, поэтому включить оба сразу нельзя — GUI об этом скажет.
Универсальный прокси-движок. Подменю Конфиги, Прокси и Установка. Возможности:
- Инстансы — несколько конфигов, up/down/restart, валидация через
sing-box check. - Прокси — таблица серверов выбранного конфига: имя, тип, адрес,
задержка, трафик; мультивыбор, сортировка, тест, копирование/вставка
ссылок, активация сервера (пишется в selector конфига, при работающем
инстансе — с предложением перезапуска), кнопка «Убрать битые» для
серверов, на которых sing-box не стартует. Учёт трафика включается
баннером (нужен
clash_api). - Конструктор/Редактор — собрать outbound (VLESS/VMess/Trojan/SS/ Hysteria2/TUIC) через форму или править JSON напрямую.
- Импорт — вставить ключи
vmess:///vless:///trojan:///ss:///hysteria2:///tuic://или URL подписки. - Подписки — сохранённый URL обновляется по таймеру; outbound'ы оборачиваются в urltest — sing-box сам пингует серверы и бесшовно переключается на живой с минимальной задержкой (если сервер «упал», трафик мгновенно идёт через другой, без рестарта). Если URL вернул пусто — текущие серверы не затираются.
- Пул серверов — слияние множества публичных источников (свалки
бесплатных ключей) в один конфиг
server-pool: дедуп, потолок числа серверов, last-good кэш, обёртка в urltest. Источники редактируются; есть рекомендованные пресеты. - Тестер серверов — проверяет каждый сервер: быстрый TCP-отсев мёртвых + e2e-замер задержки через движок до крупного облака (Cloudflare/Amazon). Показывает статус каждого сервера (жив/мёртв + ms). Опция «фильтр живых» при сборке пула отсеивает мусор.
- TUN-интерфейс для маршрутизации — карточка «TUN-интерфейс» на
дашборде добавляет в конфиг TUN-инбаунд, и он становится целью
маршрутов (
singbox:<iface>). Нужен модуль TUN в ядре (инструкция — на странице установки) и стек gvisor: system-стек безauto_routeне пропускает TCP — UDP и DNS идут, а сайты и Telegram не открываются. Наши сборки sing-box содержат gvisor; если сборка без него, GUI предупредит. - Прозрачное проксирование — режимы TProxy / Redirect / Hybrid с выбором области: LAN-клиенты (роутер форвардит сеть) или Эта машина — локальный режим для ПК/VPS с одной сетевухой (заворачивается только исходящий трафик самого хоста, без разрыва входящих SSH/веб). DNS-hijack, anti-leak IPv6.
Пример (бесплатные серверы за минуту): sing-box → вкладка «Пул
серверов» → добавить пресеты → включить «фильтр живых» → «Собрать пул
сейчас» → запустить инстанс server-pool. Дальше — «Тест серверов»,
чтобы видеть, что живо.
Движок Clash.Meta как альтернатива sing-box. Подменю Прокси и Установка:
- Установка — отдельный раздел (как у sing-box): окружение, версия «установлено / в релизе» (апстрим MetaCubeX/mihomo), установка/ обновление/удаление с прогрессом, выбор версии и транспорта скачивания.
- Инстансы — несколько конфигов, up/down/restart, валидация через
mihomo -t, YAML-редактор (парсится готовым clash-YAML-парсером). - Прокси-таблица (паритет с sing-box) — серверы из секции
proxiesс задержкой и трафиком, мультивыбор, сортировка, тест, активация выбранного, импорт/экспортvless:///vmess:///ss:///… ссылок, переключение узла через external-controller (Clash API), режим отладки.
Доменный/прозрачный роутинг mihomo идёт через единый слой маршрутизации и TUN (см. раздел «Маршрутизация»).
Два раздела, общие для всех движков (AWG, WARP/MASQUE, sing-box, mihomo).
Живые графики по каждому туннельному интерфейсу: трафик rx/tx, скорости, latency и throughput. Удобно, чтобы отличить «туннель поднят» от «через туннель реально идёт трафик» — классический случай, когда handshake есть, а данных нет.
MTU/PMTU, безопасные нижние границы TCP/QUIC-буферов и (опционально) BBR.
Три профиля — low_latency / balanced / throughput — и полный откат
к исходным значениям одной кнопкой.
Новичкам — мастер вверху страницы: «Что важнее» (баланс, отклик или
скорость) → «Применить» ко всем туннелям сразу, с кнопкой «Вернуть как
было». Тонкая настройка по каждому туннелю — в блоке «Для опытных».
Туннели, которые запустил не GUI: init-скрипты Entware (S51usque,
S99sing-box, S99mihomo, S99amneziawg, S52awg-opkgtun0…), ручной
запуск, чужие установщики. Раньше GUI про такие процессы молчал и писал
«остановлен», а они работали параллельно, занимали имена интерфейсов и
поднимались после перезагрузки. Теперь страница показывает чужие процессы
(интерфейс, конфиг, каким скриптом запущен), чужие init-скрипты движков и
конфликты имён — когда на один интерфейс (opkgtun0) претендуют два
сервиса; на «Главной» об этом есть пункт.
Сам GUI чужое не трогает — только по кнопке:
- «Передать GUI» — конфиг копируется в профиль GUI с тем же именем
интерфейса (маршруты
warp:opkgtun0остаются рабочими), чужой процесс гасится, его скрипт отключается, туннель поднимается силами GUI и получает автозапуск GUI. Не поднялся — чужой скрипт включается и запускается обратно. Для usque, sing-box, mihomo, AmneziaWG и Opera Proxy. - «Остановить и отключить» скрипт — на Entware снимается бит
исполнения (файл остаётся, «Вернуть автозапуск» восстанавливает прежнее
состояние), на OpenWrt — штатный
disable. Если обновление пакета вернёт автозапуск, GUI отключит его снова. - Режим «туннелями владеет только GUI» — отключать любые найденные чужие скрипты движков и останавливать чужие процессы (раз в минуту и при старте GUI).
Когда usque ставится из запасного источника (пакет usque-keenetic), его
собственный S51usque GUI отключает сразу: пакет нужен только ради
бинарника. «Удалить» на странице установки usque удаляет и этот пакет.
Скрипт пакета tg-ws-proxy не трогается никогда — через него GUI и ведёт
Telegram-прокси.
Именованные списки доменов и IP/CIDR — общий «строительный материал» для единого слоя и nfqws2-hostlist'ов. Возможности:
- Готовые списки — подборки доменов от сообщества (YouTube, Meta, X, Discord, Telegram, «вся заблокировка в РФ»; источник itdoginfo/allow-domains) добавляются одним кликом и обновляются по таймеру. У Telegram, Discord, Meta и X вместе с доменами приезжают подсети сервиса (IPv4 и IPv6): их приложения ходят на серверы по IP, мимо DNS, и маршрут по одним доменам заворачивал бы сайт, но не приложение. Ваши ручные правки при обновлении сохраняются, пустой ответ сервера не затирает текущее содержимое. Можно добавить свой URL.
- У каждого списка видно, к каким маршрутам он подключён; у неподключённого — кнопка «Подключить к маршруту» с выбором метода.
- Маршруты, которые берут домены из списка, переприменяются сами, когда список меняется: правка, автообновление, автодобавление детектора.
- Ручное создание/редактирование, импорт текстом (в том числе hosts-файлы: «0.0.0.0 домен» даёт домен, а не 0.0.0.0 в CIDR).
Hostlist'ы для фильтрации nfqws2 с нормализацией. Запись example.com
автоматически покрывает и поддомены; ^example.com — только сам домен.
*.example.com приводится к example.com (nfqws2 не понимает масок),
кириллица — к punycode. Подписка по URL (в окне «Импорт»): список
обновляется сам с заданным интервалом, ручные правки сохраняются, пустой
или ошибочный ответ источника список не затирает.
«Проверить списки» — все хостлисты разом: маски *., URL и www.
вместо домена, повторы, поддомены, уже покрытые родителем, одна запись в
нескольких списках и главное — сайт и в обходе, и в исключениях
(исключение побеждает, и «я же добавил сайт» не работает). Видно, какие
списки читает активная стратегия и как (обход или исключения).
«Исправить» чистит список, нераспознанные строки не удаляет.
IP-адреса и подсети; загрузка по ASN (автоматически тянет диапазоны автономной системы) и подписка по URL с автообновлением (как у доменов). На OpenWrt — nftset, на Entware — ipset.
Бинарные данные для fake-пакетов: hex-редактор, генерация fake TLS/HTTP
ClientHello для приёмов desync. Колонка «В стратегии» показывает, как
сослаться на блоб: blob=tls_google для системного файла, blob=<имя>
для своего; --blob= GUI объявит сам. Имя своего блоба — латиница, цифры
и «_» (иначе nfqws2 не запустится).
Управление .lua-скриптами nfqws2 (продвинутые сценарии desync).
Управление /etc/hosts с пресетами (например, фиксированные IP для
обхода DNS-блокировок).
Правила «этот домен резолвить через этот DNS» — когда провайдер подменяет
ответы только для части имён, а менять системный резолвер целиком не
хочется. Работает через dnsmasq (server=/домен/IP, обычный DNS на порт
53), применяется сразу при добавлении и удалении правила; из консоли —
zapret-gui dns-routing {list|apply}.
Раздел про само устройство и окружение (почему именно заблокирован конкретный сайт — в Диагностике блокировок):
- «Сервисы» — светофор доступности (ping / HTTP(S) / DNS). У упавшей
карточки есть кнопка «Разобрать»: она открывает «Диагностику
блокировок» с хостами этого сервиса. Список сервисов общий для обоих
разделов (
core/targets.py); - ручные проверки ping / HTTP(S) / DNS по произвольному адресу;
- статус firewall;
- «Конфликты и окружение» — находит сторонние процессы nfqws/tpws, другие обходчики DPI (youtubeUnblock — и как модуль ядра, b4, byedpi, DPITunnel, SpoofDPI: они правят те же пакеты, что nfqws2, о них предупреждает и красная плашка на главной) и предупреждает о co-установленных системах обхода (getdomains / XKeen / podkop / HydraRoute / Xray / redsocks), которые спорят с единым слоем и прозрачным проксированием. Каждое предупреждение — с пояснением, почему конфликтует. Отдельно опознаются сторонние сборки самого zapret (например z2k): они делят с нами движок и очередь NFQUEUE, поэтому у процесса пишется владелец и команда остановки, а после удаления такой сборки — оставшиеся init-скрипты и ndm-хуки, которые поднимают её движок обратно после перезагрузки. Наш собственный подбор стратегии (blockcheck/сканер) поднимает nfqws2 под собой — такие процессы конфликтом не считаются и показываются отдельной строкой;
- «Куда пойдёт сайт» — вводите домен и видите путь по слоям: запись в hosts, правило DNS, маршрут единого слоя (уйдёт ли сайт в туннель мимо nfqws2), в каких списках домен уже есть и какой профиль стратегии возьмёт HTTPS, QUIC и HTTP — с действиями и причиной, почему пропущены профили выше. Ничего не отправляет, кроме DNS-запроса. Автохостлист пополняется на ходу, поэтому «нет в автохостлисте» не значит «не попадёт»; ipset сверяется с адресами из DNS роутера;
- «Отчёт для помощи» — текст для вопроса в чате или issue: версии, состояние обхода и туннелей, стратегия и аргументы, имена списков, конфликты, предупреждения журнала. Без паролей, токенов, внешнего адреса и содержимого списков; имена сайтов скрыты, пока не отметите «показать». Никуда не отправляется — копируете вы;
- Самодиагностика — проверка зависимостей (python-модули вкл. Bottle,
системные утилиты), движков (zapret2/AWG/sing-box/mihomo),
конфигурации, сети + прогон юнит-тестов прямо на устройстве
(результат пишется в лог). Идёт с полосой прогресса и названием
текущего шага — на роутере прогон занимает минуты. Без браузера:
python3 -m core.selfcheck; - расширенная системная информация;
- «Обслуживание» (внизу страницы) — перезапуск демона zapret-gui и перезагрузка роутера целиком. Обе с подтверждением; после команды страница сама дожидается возвращения GUI и обновляется. Кнопка не показывается, если на этой системе выполнить действие нечем.
Журнал событий в реальном времени (SSE-поток). Логи держатся в RAM, на flash не пишутся.
Одна таблица по всем компонентам сразу: nfqws2, GUI, sing-box, mihomo,
AmneziaWG, usque, оба движка Telegram, opera-proxy — «установлено /
последнее / есть ли обновление», с кнопкой, ведущей на страницу установки
нужного компонента. Проверка идёт фоном по расписанию (интервал — в
«Настройках»), кнопка «Проверить обновления» запускает её вручную.
Обновление предлагается только для того, что реально установлено. Из
консоли — zapret-gui updates.
Самообновление GUI ставит архив выпуска (zapret-gui-linux.tar.gz)
только если он совпал с SHA256SUMS выпуска — это защита от битой или
обрезанной загрузки (подписи выпусков пока нет). Перед заменой файлов
сохраняется копия текущей версии: если после перезапуска GUI не отвечает
около двух минут, прежняя версия возвращается сама (gui.update_rollback),
а в статусе обновления появляется отметка об откате. Приём из
d2k.
Установка/обновление бинаря nfqws2 с GitHub (или зеркала). Здесь же — уведомление о доступной новой версии GUI и кнопка «Обновить GUI».
Генерация init-скрипта под платформу (Entware S99 / OpenWrt procd / systemd), чтобы nfqws2 и туннели поднимались после перезагрузки.
Износ постоянной памяти роутера и сколько на неё пишется — на любом роутере, без сторонних утилит.
- Износ. eMMC (GL.iNet Flint2, MT7986 и другие) — по данным самого
чипа:
life_time(шаг 10 %, отдельно SLC- и основная область) и расход резервных блоковpre_eol_info. NAND под UBI — сколько раз стёрт самый изношенный блок (max_ec) и плохие блоки; процент тут — оценка против ресурса NAND (по умолчанию 100 000 циклов для SLC, меняется в настройках). SSD/NVMe — черезsmartctl, если он стоит. SD-карты, USB-флешки и NOR износ не сообщают — раздел так и пишет. - Сколько записано. Сегодня, вчера, в среднем за сутки, этот и
прошлый месяц, график за 30 дней — по счётчику ядра
/proc/diskstats(учёт с момента установки этой версии). Для ext4/f2fs — ещё и «записано за всю жизнь ФС». У «сырого» NAND ядро счётчика байт не ведёт: вместо него показан рост числа стираний по дням. - Кто пишет больше всех — процессы по
/proc/<pid>/io. - Снизить запись. Профили «Обычный / Экономный / Максимальная
экономия» и отдельные рычаги: логи туннелей в ОЗУ (на Entware они
лежат в
/opt/var/log), журнал критичных событий и история изменений — вкл/выкл, как часто сохранять счётчики трафика прокси и статистику самого раздела, отложенная запись ядра (vm.dirty_*),noatime, интервал журнала ext4 (commit=), перенос системного журнала OpenWrt из файла на flash в ОЗУ. Цена отложенной записи честно подписана: при внезапной пропаже питания теряется до N секунд последних изменений. Статистика самого раздела пишется в ОЗУ, а на flash — раз в 6 часов и при штатной перезагрузке.
Локальная модель (LM Studio, Ollama) работает с роутером прямо отсюда: кнопка «подбери стратегию сам», те же инструменты, что у внешнего клиента по MCP, и видимый транскрипт каждого шага. Выключен по умолчанию, разрешения берёт у MCP — подробности в разделе «Встроенный агент».
Конфигурация GUI (порт), nfqws (порты TCP/UDP), firewall, зеркало
для бинарников, тумблер «единый nfqws2-hostlist», и Бэкап — выгрузка
всей конфигурации (полный settings.json: стратегия, автозапуск,
маршруты единого слоя, именованные/курируемые списки, подписки и пул
sing-box, зеркало; + пользовательские стратегии, конфиги sing-box/mihomo,
hostlist'ы) в один JSON-файл и восстановление из него. Тема интерфейса
хранится локально в браузере и в бэкап не входит.
«Настройки → Уведомления»: бот присылает в чат, когда сайт из мониторинга перестал или снова начал открываться, сторож перезапустил туннель (AWG, WARP/MASQUE, sing-box, mihomo, Opera Proxy), проверка стратегии её откатила, вышло обновление. Ненужное отключается галочками.
Создайте бота у @BotFather, вставьте токен, напишите боту что-нибудь и нажмите «Найти чат» — chat_id подставится сам. Если api.telegram.org закрыт напрямую, отправляйте через уже работающий туннель или прокси (тот же выбор, что у скачиваний) или свой HTTP-прокси. Сообщения, которые не ушли, ждут в очереди до суток и уходят, когда связь появится (в конце — время события). Токен в браузер и журнал не попадает.
«Система → История изменений» — версии settings.json, своих стратегий,
хостлистов и IP-списков: что поменялось (разница «было/стало»), когда и
кем — GUI, автообновление подписки или правка вне GUI (по ssh,
скриптом: файлы сверяются раз в 10 минут и при старте). Любую версию
можно вернуть, «Отменить последнее» откатывает последнее действие
целиком (одна кнопка могла записать несколько файлов). Если файл с тех
пор меняли ещё, отмена его не трогает и говорит об этом.
«Вернуть рабочее состояние» — все отслеживаемые файлы к моменту,
когда состояние отметили рабочим (подтверждением после «Применить с
проверкой» или кнопкой «Отметить текущее рабочим»), и движок с теми же
аргументами. Из settings.json возвращается только выбор стратегии:
пароли, разрешения MCP и прочие настройки, изменённые после, остаются.
Перед нажатием видно, какие файлы изменились с тех пор.
Хранится в <каталог конфигурации>/history/, сжато, до 20 версий на файл
и 8 МБ всего (history.max_mb); файлы крупнее 2 МБ не отслеживаются.
Секреты в разнице settings.json замаскированы. Выключить —
history.enabled: false.
Тема: тёмная/светлая — переключатель (☾/☀) в подвале бокового меню. Выбор запоминается в браузере и применяется мгновенно.
Режим «эксперт»: галка там же, в подвале меню. По умолчанию ВЫКЛ — продвинутые поля (NFQUEUE и метки, DSCP, debug, выбор архитектуры при установке, fallback-цепочки маршрутизации) скрыты; включите, чтобы их увидеть. Выбор тоже запоминается в браузере.
GUI умеет отдавать себя языковой модели: внутри него живёт MCP-сервер
(Model Context Protocol) на точке POST /api/mcp. Подключив к ней Claude
Desktop, Claude Code, LM Studio, Cline или VS Code, вы разговариваете с
роутером словами: «почему не открывается rutracker», «подбери стратегию
для YouTube», «сколько свободно места», «поставь htop», «перезапусти
dnsmasq». Модель сама читает статус, логи, стратегии и списки, запускает
пробы, применяет обход и откатывает его, если стало хуже.
По умолчанию всё выключено. Точка отвечает
401 MCP-сервер выключен, токен пуст, все двенадцать разрешений сняты. Пока вы не включили сервер руками и не выдали разрешения, ничего из описанного ниже не работает — и это сознательное состояние по умолчанию, а не недонастроенность.
Как это выглядит в работе — коротко:
Вы: Почему не открывается rutracker.org?
Модель: → system_status, nfqws_status движок остановлен, стратегия не выбрана
→ strategy_memory {domain} в этой сети для домена уже срабатывал
argv «…multisplit…» (3 удачи, 0 неудач)
→ probe_targets {domain} DNS в порядке, TCP открывается,
TLS-рукопожатие обрывается — похоже на DPI
Движок nfqws2 не запущен. Для rutracker.org здесь уже работала стратегия
X — применить её? (нужно разрешение control)
Страница «MCP-сервер» в боковом меню (группа «Система»):
- Тумблер «Включить» — после него точка начинает отвечать, но пускать ещё некого;
- «Сгенерировать токен» — значение показывается один раз,
скопируйте его сразу. Забыли —
zapret-gui mcp token showпо SSH или кнопка «Показать» на той же странице (факт показа уходит в журнал). «Сменить токен» выдаёт новый и обрывает всех подключённых клиентов; - Разрешения — двенадцать переключателей, у каждого написано, чем именно вы рискуете. Начните с пустого набора: чтение доступно всегда и переключателя не имеет.
Метка «действует» рядом с разрешением значит, что его инструменты
уже видны модели. «Не действует» — галка стоит, но не выполнена
зависимость (например, experiments без probes): под строкой написано,
что включить ещё. «Уже открыто разрешением …» — строка включена
заодно с другой (shell_full открывает и shell_readonly).
Там же — два переключателя транспорта. Основной (POST) — обычный путь всех клиентов; выключив его, вы закрываете точку для них, но не эту страницу: включить обратно можно отсюда же, а мост через ssh работает независимо. Старый SSE нужен клиентам, которые не умеют ничего другого.
Счётчик «инструментов доступно» меняется в тот же запрос: сняли галку — модель теряет инструменты сразу, без перезапуска GUI. Там же — журнал последних вызовов с кнопкой «Отменить последнее изменение».
Из консоли то же самое: zapret-gui mcp status (включён ли, где
слушает, что разрешено), zapret-gui mcp tools (что модель видит
сейчас), zapret-gui mcp call <tool> '<json>' (вызвать руками).
Разрешения выдаются под задачу, а не «на всякий случай»: снятая галка убирает инструменты из списка модели в тот же момент. Готовые наборы:
| Задача | Что включить | Что модель сможет |
|---|---|---|
| «Посмотри и объясни»: почему сайт не открывается, что с роутером, что значит настройка | ничего | 43 инструмента чтения: статус, логи, стратегии, каталоги, списки, настройки с описаниями. Изменить не может ничего — только предложить словами |
| То же, но с проверкой на деле | probes |
+ пробы доменов (DNS → TCP → TLS → HTTP), blockcheck, сканер, снифер. Трафик с роутера наружу заметен провайдеру |
| Подобрать стратегию и применить | control, strategies_write, probes, experiments |
+ прогон вариантов с замером и авто-откатом, применение и сохранение лучшей стратегии |
| Подкрутить настройки движка | config_write |
+ config_set по одному листу в разрешённых поддеревьях, с откатом mcp_undo_last |
| Пустить сайт через туннель | tunnels_write (+ control) |
+ конфиги и запуск AWG/sing-box/mihomo/usque, маршруты единого слоя |
| Разобраться с системой: место, память, службы | shell_readonly |
+ безопасный список команд, чтение файлов, список пакетов и служб |
| Поставить пакет, перезапустить службу | shell_full — на время задачи |
root: любая команда, запись файлов, пакеты. Потом — кнопка «Запретить shell немедленно» |
| Починить или доработать сам GUI | self_edit |
правка файлов GUI с проверками и авто-откатом (см. Самоправка) |
Набор со скриншота выше — «подобрать стратегию» плюс config_write —
публикует 85 инструментов из 127: read 43, control 8,
strategies_write 12, config_write 1, probes 13, experiments 7 и
mcp_undo_last, который появляется при любом разрешении на запись.
Адрес точки — http://<адрес-роутера>:<порт-GUI>/api/mcp, авторизация —
заголовок Authorization: Bearer <токен>. Транспорт — Streamable HTTP,
ревизия спецификации MCP — 2025-06-18 (клиенты на 2025-03-26 и
2024-11-05 тоже подключаются).
Claude Code:
claude mcp add --transport http zapret-gui \
http://192.168.1.1:8080/api/mcp \
--header "Authorization: Bearer <ваш-токен>"Claude Desktop и LM Studio — один и тот же формат mcpServers
(в LM Studio это mcp.json: Program → Install → Edit mcp.json):
{
"mcpServers": {
"zapret-gui": {
"url": "http://192.168.1.1:8080/api/mcp",
"headers": { "Authorization": "Bearer <ваш-токен>" }
}
}
}VS Code — .vscode/mcp.json; токена в файле нет намеренно, редактор
спросит его сам и не положит в репозиторий:
{
"inputs": [
{ "type": "promptString", "id": "zapret-token",
"description": "Токен MCP zapret-gui", "password": true }
],
"servers": {
"zapret-gui": {
"type": "http",
"url": "http://192.168.1.1:8080/api/mcp",
"headers": { "Authorization": "Bearer ${input:zapret-token}" }
}
}
}Без открытого порта и без токена — мост через ssh (канал даёт сам ssh, токен не нужен):
{
"mcpServers": {
"zapret-gui": {
"command": "ssh",
"args": ["router", "zapret-gui", "mcp", "--stdio"]
}
}
}Старый клиент, который умеет только SSE, — включите
mcp.transports.sse переключателем на странице и дайте ему
http://192.168.1.1:8080/api/mcp/sse с тем же заголовком
Authorization. Новым клиентам это не нужно: они ходят по
Streamable HTTP на основную точку.
У SSE есть и вторая причина его включить — живой статус вместо
опроса. На нём (и на stdio-мосте) работает подписка на ресурсы
(resources/subscribe): модель подписывается на zapret://state/jobs,
и сервер сам присылает notifications/resources/updated, как только
меняются цифры прогона — «проверено 12 из 40». Раньше это требовало
опроса в цикле: job_wait умеет дождаться КОНЦА операции, но живого
прогресса не даёт по построению. На основной точке (POST) канала для
уведомлений нет, и подписка там честно отвечает отказом с адресом
потока, а не молчаливым «принято». stdio-мост (ssh router zapret-gui mcp --stdio) подписку умеет сам, без SSE: рядом с чтением stdin в нём
работает поток-писатель, который присылает и обновления ресурсов, и
notifications/tools/list_changed, когда вы щёлкнули разрешение.
Готовые сниппеты с уже подставленным адресом (и токеном, если нажали «Показать») лежат на самой странице «MCP-сервер» — их можно скопировать кнопкой.
Точка — обычный JSON-RPC 2.0 поверх HTTP, поэтому проверить её можно до того, как настраивать клиента. Рукопожатие:
TOKEN=<ваш-токен>
curl -s http://192.168.1.1:8080/api/mcp \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
"protocolVersion":"2025-06-18","capabilities":{},
"clientInfo":{"name":"curl","version":"1"}}}'{"jsonrpc": "2.0", "id": 1, "result": {
"protocolVersion": "2025-06-18",
"capabilities": {"tools": {"listChanged": true}, "resources": {…}, "prompts": {…}, "logging": {}},
"serverInfo": {"name": "zapret-gui", "title": "Zapret GUI", "version": "0.25.15"},
"instructions": "…Tools available now: 82. Write permissions granted: config_write, control, experiments, probes, strategies_write…"}}Список инструментов — {"jsonrpc":"2.0","id":2,"method":"tools/list"},
вызов инструмента — tools/call. Например, изменить настройку (нужно
config_write):
curl -s http://192.168.1.1:8080/api/mcp \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{
"name":"config_set","arguments":{"path":"nfqws.tcp_pkt_out","value":30}}}'В ответе structuredContent — «было/стало» и адрес отката:
{
"ok": true, "path": "nfqws.tcp_pkt_out", "type": "integer",
"before": 20, "after": 30, "changed": true, "saved": true,
"undo": {"kind": "config", "target": "nfqws.tcp_pkt_out", "id": "a7d48c19d186"},
"hint": "записано в settings.json; откат — mcp_undo_last. Часть настроек движок читает при запуске: чтобы они начали действовать, стратегию нужно применить заново"
}Без разрешения тот же вызов не падает молча, а объясняет, чего не хватает, — модель передаст это вам:
{"ok": false, "error": "нет разрешения shell_readonly", "permission": "shell_readonly",
"hint": "включите разрешение «shell_readonly» в настройках MCP"}С самого роутера по SSH всё это делается без токена и без curl:
$ zapret-gui mcp status
=== MCP-сервер ===
состояние: включён
токен: задан
адрес: http://127.0.0.1:8080/api/mcp
bind: inherit
транспорты: http=вкл sse=выкл
инструментов: 95 из 140 доступны сейчас
read 47
control 10
strategies_write 12
…
разрешения:
✓ control вкл
· shell_full выкл
…
$ zapret-gui mcp call config_describe '{"path":"nfqws.tcp_pkt_out"}'
{
"ok": true,
"item": {
"path": "nfqws.tcp_pkt_out", "type": "integer", "default": 20, "value": 30,
"writable": true, "unit": "пакеты",
"text": "Сколько первых исходящих TCP-пакетов соединения отдавать в очередь. …",
"empty": "0 — ограничения нет, в очередь идут все исходящие пакеты соединения (заметная нагрузка на CPU роутера)"
}, …
}
$ zapret-gui mcp call mcp_undo_last '{}'
{
"ok": true, "reverted": true, "tool": "config_set",
"target": "nfqws.tcp_pkt_out", "restored": 20, "was": 30, …
}
zapret-gui mcp call идёт мимо HTTP и токена, но под теми же
разрешениями: вызов того, что не разрешено, получит тот же отказ.
Модель сама решает, какие инструменты звать, — ниже типичные цепочки, чтобы было понятно, чего ждать и какие разрешения понадобятся.
«Почему не открывается rutracker.org?» — хватает чтения, с
probes ответ точнее. Модель смотрит system_status и nfqws_status
(поднят ли движок, какая стратегия), strategy_memory (срабатывало ли
что-то на этом домене в этой сети), traffic_recent и
firewall_status (доходит ли трафик до движка вообще), logs_tail.
С probes — probe_targets: где именно рвётся соединение (DNS, TCP,
TLS, HTTP); dpi_classify — чем именно режут (хватит разреза, нужен
фейк или режут адрес); probe_compare — домен с обходом и без, вердикт
bypass_helps / no_difference / target_down / bypass_hurts. Если
движок работает, сторона «без обхода» меряется пробой с меткой мимо
очереди и движок не трогается; иначе он на время пробы переключается
(нужен ещё control) и возвращается как был.
Итог — объяснение и конкретное предложение, что включить.
«Подбери стратегию для YouTube и примени лучшую» — control,
strategies_write, probes, experiments. Модель начинает с
strategy_memory и catalog_search, собирает 3–5 вариантов,
запускает strategy_experiment_start и ждёт job_wait (без опроса в
цикле). Эксперимент меряет каждый вариант против baseline «без обхода»;
по strategy_experiment_result модель выбирает лучший и фиксирует его
strategy_experiment_commit. Не подтвердила вовремя — прогон
откатывается сам по таймеру, даже если роутер перезагрузили.
«Увеличь число исходящих TCP-пакетов в очередь до 30» → «верни как
было» — config_write. config_describe (что это за поле и в
каких единицах) → config_set → «было 20, стало 30»; на вторую
просьбу — mcp_undo_last. Ровно то, что в примере с curl выше.
«Пусти instagram.com через AWG» — tunnels_write. tunnels_status
(какой туннель поднят и жив) → unified_route_save (домен → метод
awg:<iface> и запасные) → unified_route_apply →
unified_route_status (каким методом маршрут работает сейчас).
«Сколько свободно места и кто ест память?» — shell_readonly.
shell_exec с df -h, free, ps из safe-списка — без оболочки,
конвейеров и записи.
«Поставь htop» / «перезапусти dnsmasq» — shell_full.
package_install, service_control restart. После задачи — «Запретить
shell немедленно».
Сервер отдаёт клиенту шесть сценариев (prompts/list): в Claude
Desktop и VS Code они видны как готовые команды, модель получает
выверенный порядок действий вместо импровизации.
| Сценарий | Аргументы | Что делает |
|---|---|---|
why_domain_blocked |
domain |
пробует домен, классифицирует поведение DPI, читает лог и называет метод обхода |
strategy_for_domain |
domain, protocol |
подбирает стратегию с замером: собрать, проверить, измерить, откатить |
router_health |
— | движки, туннели, ресурсы, свежие ошибки — и что из этого сломано |
route_domain_through_tunnel |
domain, method |
проверяет, что туннель поднят, создаёт маршрут и убеждается, что трафик пошёл туда |
see_what_left_the_router |
domain |
снимает дамп после движка и читает разобранные пакеты: TTL, SNI, разрезан ли ClientHello |
report_problem |
what |
отличает ошибку GUI от состояния сети и составляет черновик issue с местом в коде |
И девять справочников (resources/list, схема zapret://) —
модель читает их вместо того, чтобы гадать: zapret://docs/overview,
zapret://nfqws2/cli (живой nfqws2 -? этого устройства),
zapret://nfqws2/lua (карта функций --lua-desync),
zapret://skills/nfqws2, zapret://catalogs,
zapret://config/describe, zapret://state/current,
zapret://state/jobs, zapret://memory/strategies. Клиентам, которые
ресурсы не читают, то же самое отдаёт инструмент docs_get.
153 инструмента. Что из них видно клиенту — решают разрешения: невыданное не просто запрещено, оно не публикуется, и модель о нём не знает.
Чтение — всегда, отдельного разрешения нет (54):
| Инструменты | Про что |
|---|---|
system_status, nfqws_status, tunnels_status, diagnostics_run, connectivity_matrix |
что за устройство, что поднято, что сломано |
tunnel_log, tunnel_diagnostics |
лог движка туннеля (sing-box, mihomo, AWG, usque, Opera) и снимок AWG/sing-box/mihomo для разбора: процесс, память, автозапуск, контроллер; ключи под маской |
site_trace |
куда пойдёт сайт: hosts, DNS, единый слой, списки и профиль nfqws2 — без трафика |
quick_fix_check |
поломки, похожие на DPI: сбитые часы, мёртвый DNS роутера, пропавший интернет у провайдера, нет маршрута в интернет (сетевая часть — по probes) |
logs_tail, traffic_recent, firewall_status |
журнал, «дошёл ли трафик до движка», правила перехвата |
vpngen_options |
что умеет генератор конфигов WARP/Proton на этом устройстве |
vpngen_check |
проверить синтаксис конфига AWG/usque/sing-box/mihomo или конфига Proton, не сохраняя (встроенный разбор, затем сам движок, если установлен) |
strategy_list, strategy_get, strategy_state_list, catalog_search, nfqws_command_preview |
стратегии, каталоги и итоговая команда nfqws2 |
hostlists_list, hostlist_get, ipsets_list, lists_list, blobs_list, lua_functions_list |
списки доменов и IP, блобы, функции --lua-desync этого устройства |
config_get, config_describe, config_writable_paths |
настройки, что они значат и что из них можно менять |
docs_get |
встроенные справочники: живой nfqws2 -?, карта lua-функций, каталоги |
dpi_report, updates_check, audit_list |
последняя классификация DPI, обновления, журнал вызовов MCP |
scan_status, scan_results, blockcheck_status, blockcheck2_status, blockcheck2_output, healthcheck_status |
результаты тяжёлых прогонов (запуск — отдельное разрешение) |
job_wait |
дождаться конца долгой операции одним вызовом вместо опроса в цикле: скан, blockcheck, эксперимент, фоновая команда, снифер, сборка пула |
unified_route_list, unified_route_status |
маршруты единого слоя: что через какой туннель идёт и каким методом работает сейчас (failover мог переключить) |
known_good_status |
рабочая точка туннелей и маршрутов: совпадает ли с ней текущее, что поменялось, какая правка последней сломала сайты |
smart_detect_status |
автообнаружение блокировок: что ждёт подтверждения и что уже добавлено в списки |
device_quota_status |
дневные квоты времени устройств: сколько минут истрачено и осталось, кому интернет закрыт до полуночи |
strategy_memory |
что уже срабатывало на этом домене в этой сети: argv, счёт удач и неудач, давность записи |
bypass_engine_status, geneva_status, geneva_search_status |
какой движок обхода активен (nfqws2 или geneva_c), что сохранено у каждого для продолжения; движок geneva: стратегия, счётчики пакетов и срабатывания деревьев, лента событий; прогресс подбора geneva |
geneva_auto_status |
режим «Авто» geneva: найденные сервисы и их статус, работающие стратегии со счётчиками, текущий подбор, журнал |
geneva_library, geneva_check, geneva_db_top |
готовые стратегии Geneva, разбор стратегии geneva check, лучшее из базы оценок geneva |
issue_draft, issue_draft_list |
черновик issue об ошибке в самом GUI: модель описывает, что видела, сервер дописывает место в коде и команду воспроизведения (см. Если модель нашла ошибку в GUI) |
control — движок и перехват (17): nfqws_start, nfqws_stop,
nfqws_restart, nfqws_reload_lists (SIGHUP, без перезапуска),
strategy_apply, firewall_apply, firewall_remove, scan_apply,
quick_fix_apply (синхронизировать часы, перезапустить dnsmasq),
device_quota_grant (добавить устройству минут на сегодня),
bypass_engine_set (переключить обход между nfqws2 и geneva_c),
geneva_start, geneva_stop, geneva_set_strategy (сменить рабочую
стратегию geneva без перезапуска), geneva_auto_enable (включить режим
«Авто» — в два шага, с подтверждением), geneva_auto_disable,
geneva_auto_reset (забыть один сервис).
Интернет у клиентов на время пропадёт.
strategies_write — стратегии и списки (12): strategy_save,
strategy_delete, strategy_compose (описание → argv),
strategy_validate (прогон nfqws2 --intercept=0),
strategy_export_catalog (находка → секция каталога), hostlist_edit,
ipset_edit, blob_add, lua_script_save, lua_script_get,
lua_script_patch, lua_script_delete.
Может править и удалять ваши стратегии, хостлисты, ipset'ы и
lua-скрипты.
Lua-скрипты правятся на ходу: модель читает нужный кусок
(lua_script_get), меняет в нём одну строку (lua_script_patch —
замена точная и единственная, как в code_patch), проверяет синтаксис
и, если дать ей заодно control, сама перезапускает движок
(apply=true) — иначе правка лежит на диске и не действует, потому что
lua читается при старте.
config_write — настройки (2): config_set. Пишет по одному
листу и только в разрешённые поддеревья; пути к файлам, порт GUI,
бэкенд firewall и метки десинка не отдаются на запись никогда.
dns_autoselect — сделать лучший по замеру DNS-сервер сервером «auto»
для правил «домен → DNS» (откат — mcp_undo_last).
probes — трафик наружу (19): probe_targets, probe_compare
(домен с обходом и без), dpi_classify (чем режут: хватит ли разреза,
нужен ли фейк или режут адрес), scan_start, scan_stop, blockcheck_start,
blockcheck2_start, blockcheck2_stop, healthcheck_run,
traffic_capture_start, traffic_capture_status,
traffic_capture_result, traffic_capture_stop, dns_benchmark
(задержка и честность DNS-серверов по UDP, DoH и DoT), leak_check
(внешний IP напрямую и через туннели, резолверы роутера через bash.ws),
lan_probe (сайты с роутера и как клиент LAN — через временный netns в
мосту LAN; только OpenWrt и Linux), geneva_search_start,
geneva_search_stop (подбор стратегии geneva генетическим алгоритмом с
сохранением прогресса), geneva_eval_start (проверить готовые
стратегии Geneva на своей сети).
Это заметно провайдеру.
Снифер (traffic_capture_*) отвечает на вопрос, которого раньше не было
ни у кого, кроме владельца консоли: что ушло в сеть после nfqws2.
Короткий дамп на WAN-интерфейсе разбирается в поля — направление, флаги,
TTL, длина, SNI, — и по ним видно, разрезан ли ClientHello и уходят ли
fake-пакеты с укороченным TTL. Требует tcpdump на устройстве; argv
фиксирован, фильтр собирается из разобранных полей (никаких строк от
модели в командной строке), потолки на число пакетов и время — в
mcp.capture, файл дампа удаляется сразу после разбора.
experiments — подбор с обратной связью (7):
strategy_experiment_start, strategy_experiment_status,
strategy_experiment_result, strategy_experiment_commit,
strategy_experiment_rollback, strategy_experiment_stop,
strategy_experiment_history. Модель применяет варианты по
очереди, измеряет каждый, сравнивает с baseline «без обхода» и
возвращает состояние назад сама — у прогона есть таймер авто-отката,
и он переживает выключение питания. Разрешение не действует без
control и probes.
Эксперимент умеет снимать дамп трафика по окну каждого варианта
(capture: true, нужен tcpdump): в отчёт рядом с метриками ложится
сводка — какие TTL ушли, виден ли SNI открытым текстом, были ли RST. Это
превращает «вариант B хуже» в «у варианта B fake ушёл с TTL 1 и не дожил
до первого хопа», и подсказки по такому дампу выдаются автоматически.
Вторая половина той же картинки — lua-дамп самого движка
(lua_capture: true, скрипт zapret-pcap.lua, флаг --writable
выдаётся сам): что каждый профиль стратегии получил из очереди.
tcpdump видит, что ушло в сеть, и пустой дамп у него не отличает «пакет
не дошёл до стратегии» от «дошёл, но приём не справился»; lua-дамп
отличает. Пустой при поднятом движке — чинить надо фильтр профиля и
правила перехвата, а не приём, и подсказка об этом приходит сама.
--writable получает и любая ваша стратегия с --lua-desync=pcap:…:
файл с относительным именем ложится в /tmp/zapret-gui-writable.
Результаты прогонов не пропадают вместе с процессом GUI: что открыло
домен, закрытый без обхода, складывается в локальную память подбора
(файл рядом с settings.json) и читается обратно — инструментом
strategy_memory или ресурсом zapret://memory/strategies. Записи
разделены по сетям: метка сети считается локально (интерфейс, шлюз, блок
/16 своего WAN-адреса), в интернет за ней никто не ходит, и находка у
другого провайдера честно помечена как чужая. Смысл простой: следующий
разговор начинается с проверки известного, а не с перебора каталога
заново. Про домен, о котором записей нет, память подскажет, что
срабатывало у соседей по регистрируемому домену (family: для
rr5.googlevideo.com — находки на других *.googlevideo.com) —
по голосам за последние 30 дней, со свежими провалами против.
Удачную находку можно отдать обратно сообществу:
strategy_export_catalog (и кнопка «В каталог» на странице
«Стратегии») превращает argv в готовую секцию catalogs/*.txt,
проверенную нашим же парсером, — её остаётся вставить в файл и отправить
pull request. Файлы каталогов при этом не трогаются: их перезаписывает
установщик GUI, и локальная правка там потерялась бы при обновлении.
Любое разрешение на запись (1): mcp_undo_last — откат последнего
изменения по снимку с диска. Снимок переживает перезагрузку роутера.
shell_readonly — чтение системы (11): shell_exec,
shell_exec_async, shell_job_status, shell_job_output,
shell_job_stop, shell_confirm, file_read, file_list,
package_list, service_list, service_control (здесь — только
status).
shell_full — полный доступ (3): file_write, package_install,
package_remove; плюс снимает намордник с shell_exec и открывает
service_control start|stop|restart. Подробности — ниже.
dangerous (2): system_reboot — и только через двухшаговое
подтверждение; unified_reapply_all — сносит протухшие ip rule и
таблицы и раскладывает всю маршрутизацию заново.
self_edit — самоправка GUI (13): code_tree, code_read,
code_search, code_diff, code_check, code_test, code_history,
code_export_patch, code_write, code_patch, code_apply,
code_commit, code_rollback. Подробности — ниже.
tunnels_write — туннели, подписки и маршруты (16): tunnel_up,
tunnel_down, tunnel_restart, tunnel_config_get,
tunnel_config_save, subscription_refresh, pool_refresh,
unified_route_save, unified_route_delete, unified_route_apply,
known_good_promote, known_good_rollback (рабочая точка туннелей и
маршрутов: отметить текущее рабочим или вернуться к нему),
smart_detect_undo (отменить автодобавление домена в список),
vpngen_generate, vpngen_proton_servers (генератор конфигов WARP и
Proton: регистрирует устройство и сохраняет конфиги AWG/usque/sing-box/
mihomo; приватные ключи модели не показываются), tunnel_settings
(одинаковые для AWG/sing-box/mihomo режим отладки, лимит памяти Go и
автозапуск конфига).
Может править конфиги туннелей и поднимать их — трафик пойдёт через
указанный ею сервер. Маршрут единого слоя связывает домены (CIDR,
списки, geosite) с методом — direct, nfqws2, awg:<iface>,
singbox:<iface>, mihomo:<iface>, warp:<iface> — и цепочкой
запасных.
secrets — ответы без маскировки (0 инструментов): своих
инструментов не открывает. Обычно MCP заменяет всё, что похоже на ключ,
токен или пароль, на *** — это защита, но и помеха: прочитав конфиг с
*** вместо ключа и записав его обратно, модель этот ключ уничтожит.
С этим разрешением вызовы, у которых есть аргумент raw (file_read,
config_get, shell_exec, shell_job_output, tunnel_config_get),
по явному raw: true отдают значения как есть; заодно config_set
начинает принимать поля, похожие на секрет. Журнал вызовов
маскируется всегда — он остаётся на диске и переживает и вызов, и
разрешение. Без разрешения raw: true — это отказ, а не тихая
маскировка: иначе модель не узнает, что получила обрезанные данные.
self_edit_core — не отдельная дверь, а расширение self_edit на
защищённое ядро (авторизация, разрешения, сторож, конфиг).
Каждый вызов пишется в журнал на диске (mcp-audit.jsonl рядом с
settings.json): время, инструмент, итог, разрешение и аргументы —
с маской на секретах. Он виден внизу страницы «MCP-сервер» и в
консоли (zapret-gui mcp audit).
Итоги: ОК; ОТКАЗАНО — не хватило разрешения (в последней
колонке написано какого); АРГУМЕНТЫ — модель ошиблась в аргументах,
и сервер назвал допустимые (на скриншоте — logs_tail с
несуществующим lines: модель поправится сама по тексту ошибки).
Кнопка «Отменить последнее изменение» — то же, что mcp_undo_last:
подпись говорит, что именно откатится (config, стратегия, список,
файл). Снимки лежат на диске и переживают перезагрузку роутера;
повторное нажатие откатывает предыдущее изменение.
Модель, работающая с роутером, первой замечает, что инструмент упал или ответил не то, что обещает его описание. Такое больше не теряется.
- Падение инструмента оставляет след. Трассировка ложится в
mcp-crashes.jsonlрядом сsettings.json: файлы и строки кода GUI без путей установки, аргументы с маской на секретах. В ответ модели приходитcrash_idи подсказка составить отчёт. issue_draft— черновик issue. Модель пишет, что ожидала, что получила и какими шагами. Сервер дописывает то, что модель исказила бы: файл и строку обработчика, трассировку, команду воспроизведения (zapret-gui mcp call <инструмент> '<аргументы>'), версию GUI и движков, последние вызовы из журнала и строки лога вокруг ошибки. Одинаковые ошибки склеиваются в один черновик со счётчиком повторов.- Отправляете вы, а не модель. Черновики видны на странице
«MCP-сервер» в блоке «Черновики issue»: кнопка «Показать» открывает
текст, «Открыть на GitHub» — форму нового issue с уже заполненным
текстом в вашем браузере, под вашим аккаунтом. GitHub-токена на
роутере нет. В консоли то же самое:
zapret-gui mcp issues(list,show <id>,url <id>,crashes). - Домены и публичные адреса в черновике заменены метками
(
<домен-1>,<ip-1>): список сайтов, которые вы обходите, и WAN-адрес — личные данные. Модель может снять маску (include_targets=true), только если без конкретного домена ошибку не воспроизвести, — текст перед отправкой всё равно читаете вы. - «Сайт не открывается» — не ошибка GUI. Для этого есть
сценарии
why_domain_blockedиstrategy_for_domain; черновик issue пишется, когда сломан сам инструмент.
Сервер всегда отвечает JSON с полем error — первым делом прочитайте
его. Частые случаи:
| Ответ | Причина | Что сделать |
|---|---|---|
401 «MCP-сервер выключен» |
тумблер «Включить» снят | включить на странице «MCP-сервер» |
401 «Authorization: Bearer <токен> обязателен» |
клиент не шлёт заголовок | проверить headers в конфиге клиента |
401 «неверный MCP-токен» |
токен сменили («Ротировать») или скопировали не весь | взять новый: «Показать» или zapret-gui mcp token show |
403 «запрос по неизвестному имени хоста отклонён» |
заходите по имени, а не по IP (защита от DNS-rebinding) | ходить по IP или вписать имя в gui.allowed_hosts |
403 «Origin … не разрешён» |
запрос из браузера с чужого адреса | вписать адрес в gui.cors_origins |
403 «mcp.bind=local: доступ разрешён только с самого роутера» |
точка закрыта для сети | ssh-туннель или stdio-мост — либо mcp.bind = inherit |
503 «основной транспорт MCP выключен» |
снят переключатель «Основной транспорт (POST)» | включить его на той же странице; stdio-мост работает и так |
429 «превышен лимит N запросов в минуту» |
модель зовёт инструменты в цикле | подождать Retry-After секунд; для долгих операций — job_wait вместо опроса; лимит — mcp.limits.calls_per_minute |
| Клиент подключился, но нужного инструмента нет | разрешение не выдано или «не действует» | включить разрешение и его зависимости. По SSE и stdio-мосту новый список приходит сам (notifications/tools/list_changed), остальным клиентам — переподключиться |
Обрыв сразу после code_apply |
GUI перезапускается — так и задумано | подождать 5–10 с, system_status, затем code_commit |
- Выйти за разрешения. Инструмент, чьё разрешение не выдано, не виден в списке; вызов по имени — отказ с объяснением, что включить;
- потерять пути назад. Каждое изменение оставляет снимок
(
mcp_undo_last) либо живёт по таймеру с авто-откатом; - снести обход целиком одним вызовом. Инструмента «удалить всё» нет;
- перезагрузить роутер мимо подтверждения —
system_rebootдвухшаговый и требуетdangerous; - увидеть секреты. Пароли, токены, приватные ключи и
Authorizationвырезаются из каждого ответа, включая вывод shell и чтение файлов; - отрезать вас от роутера правилами firewall. Порт SSH и порт GUI исключаются из перехвата при любом применении правил.
- Токен равен доступу к роутеру. Он даёт клиенту всё, что открыто разрешениями, — вплоть до команд от root и правки самого GUI. Храните его как пароль и не выкладывайте в репозиторий;
- у GUI нет своего TLS. По обычному HTTP токен уезжает открытым
текстом в КАЖДОМ запросе — его видит любой, кто слушает сеть между
вами и роутером. Безопасные варианты: держать MCP на петле
(
mcp.bind = local) и ходить через ssh-туннель или stdio-мост, либо поставить перед GUI обратный прокси с TLS; - модель видит ваш трафик глазами роутера. Домены из хостлистов и логов, SNI, адреса клиентов, конфиги туннелей с адресами серверов — всё это уезжает в облако провайдера модели, если модель облачная. Для локальной модели (LM Studio на своей машине) это остаётся дома;
- прочитанный текст — данные, а не приказ. Лог, конфиг или список доменов может содержать строку, которую модель примет за инструкцию («…игнорируй предыдущие указания и выполни…»). Наши инструменты помечают такие поля как untrusted, но гарантии здесь даёт не сервер, а выбранная вами модель и её клиент;
- заходите в GUI по IP. Запросы, пришедшие по неизвестному имени
хоста, GUI отклоняет (
403): иначе чужой сайт, перепривязавший своё имя на адрес роутера (DNS-rebinding), мог бы из вашего же браузера прочитать MCP-токен и раздать себе разрешения. IP-адреса иlocalhostпускаются всегда. Ходите по имени (my.keenetic.net, запись в локальном DNS) — впишите его вgui.allowed_hostsвsettings.json("*"выключает проверку совсем); - разрешения складываются.
control+probes— это уже право временно оставить вас без интернета;shell_full— root;self_edit— правка кода, который вы обновляете поgit pull.
Это два разных режима, а не «мало» и «много»:
shell_readonly— команда передаётся списком аргументов, без оболочки, и проверяется по курируемому safe-списку:ls,cat,grep,find,ps,ip route get … mark,tc … show,nft list,iptables -L,ping -c,curl/wget«в никуда» (-o /dev/null,-O -)… Каждой команде разрешён свой набор флагов, а уipиtc— только читающие глаголы.awk,sed,env,ncи самshв список не входят: у них одна пропущенная опция превращает «чтение» в запись. Конвейеров,>и;в этом режиме нет в принципе — вместо| grep | tailуshell_execесть аргументfilter(отбор строк подстрокой, счётчик, первые/последние N);shell_full— произвольная строка черезsh -c, то есть root на роутере для всякого, у кого есть токен. Модель сможет выполнить любую команду, переписать любой файл, поставить и снести пакеты, остановить службы.
Поверх обоих режимов работают три вещи, которые не обходятся: жёсткие
запреты (mkfs, sysupgrade, запись во флеш, rm -rf по системному
корню, смена пароля root — отказ без возможности подтвердить),
двухшаговое подтверждение одноразовым токеном для остального опасного и
дедмен-свитч guard: команда, после которой роутер не ответил,
откатывается сама.
Практический вывод: shell_full стоит включать только для локальной
модели (LM Studio на вашей же машине) и только на время задачи. На
странице «MCP-сервер» есть кнопка «Запретить shell немедленно» — она
гасит оба переключателя, прибивает живые фоновые команды и отзывает
ожидающие подтверждения.
Shell и самоправка — разные двери. shell_full действует на всю
систему и файлы GUI тоже может переписать, но без проверок, снимков и
авто-отката. self_edit работает только в каталоге установки GUI,
команд не выполняет и каждую правку страхует (см. ниже). Одно другое не
включает: для правки GUI достаточно self_edit, и это безопаснее.
И отдельно: прочитанный лог или конфиг может содержать чужой текст.
Для модели это входные данные, и достаточно наивный клиент выполнит
«инструкцию» из файла. Это ещё одна причина не держать shell_full
включённым постоянно.
С разрешением self_edit модель читает и правит исходники
zapret-gui прямо на устройстве — чинит баг, добавляет поле на
страницу, ставит отладочный вывод. Как это устроено:
- Правки идут в staging, а не на диск:
code_write/code_patchничего не ломают, пока не вызванcode_apply; code_checkиcode_testпрогоняют разбор, импорт,make lintиpytestпо слепку — до применения;code_applyделает снимок, кладёт файлы на диск, поднимает сторожевой процесс и перезапускает GUI. Соединение при этом рвётся — это ожидаемо, клиент увидит обрыв;- Сторож — посторонний процесс на одной stdlib — ждёт, пока GUI
вернётся и правку подтвердят (
code_commit). Не вернулся или не подтвердили заcommit_ttl_sec(по умолчанию 5 минут) — сторож возвращает прежние файлы сам, без вашего участия; code_rollbackоткатывает вручную в любой момент,code_historyпоказывает снимки.
Защищённое ядро (авторизация, разрешения, сам сторож, конфиг) без
self_edit_core недоступно: иначе модель смогла бы снять с себя
ограничения. Выйти за каталог установки нельзя.
На странице видно, сколько правок ждёт применения (staging) и сколько
файлов уже изменено локально; у каждого снимка — «Показать diff» и
«Откатить». Типичный разговор: «на странице Opera Proxy не видно
страны — поправь» → code_search и code_read находят место →
code_patch кладёт правку в staging → code_check проверяет →
code_apply (соединение рвётся, GUI перезапускается) →
system_status → code_commit.
Локальные правки затрёт обновление GUI. Они живут только на устройстве. Перед обновлением выгрузите их одним диффом —
code_export_patch(или кнопка «Выгрузить патч» на странице MCP) — и заведите нормальный PR;updates_checkпредупреждает об этом отдельно, если незакоммиченные правки есть.
MCP решает задачу «пустить к роутеру внешнюю модель»: Claude Desktop, Cline, LM Studio на ноутбуке. Но у этого всегда есть цена — токен, открытый порт, чужой клиент. Часто нужно другое: открыть страницу, нажать кнопку и уйти пить чай, пока локальная модель перебирает варианты.
Страница «Агент» (группа «Система») — это клиент к любому
OpenAI-совместимому серверу: LM Studio (http://127.0.0.1:1234/v1),
Ollama (http://127.0.0.1:11434/v1), llama.cpp, vLLM. Модель отвечает
tool-call'ами, GUI зовёт те же самые инструменты, что отдаёт по MCP,
и показывает каждый шаг: что модель сказала, что позвала, с какими
аргументами и чем это кончилось.
Готовые задачи — кнопками: «подбери стратегию сам», «почему домен не
открывается», «проверь роутер целиком», «посмотри, что ушло в сеть».
Текст задачи берётся из тех же сценариев, что читает внешняя модель
через prompts/get, — второй копии порядка действий нет.
Что важно знать до включения:
- Это отдельный переключатель.
agent.enabledвыключен по умолчанию; MCP-сервер он не включает и не выключает, и наоборот; - своих прав у агента нет. Он ходит под теми же разрешениями
(
mcp.permissions), что внешняя модель: без них — только чтение и предложения словами. Выдают их там же, на странице «MCP-сервер», там же виден журнал всех вызовов — включая сделанные агентом; - инструментов отдаётся столько, сколько модель осилит. 127 объявлений — это больше пятнадцати тысяч токенов в каждом запросе, и локальная модель на 8B захлебнётся до первого вызова. По умолчанию отдаётся набор сценариев (~30 инструментов); «все доступные» — для тех, у кого модель большая;
- прогон конечен. Потолок шагов (
agent.max_steps, по умолчанию 12), потолок вызовов и кнопка «Остановить»; - к локальным адресам ходим мимо прокси. На роутере
HTTPS_PROXYобычно настроен на обход блокировок, и запрос к127.0.0.1через него не прошёл бы никогда; - приватность решает адрес. Модель на вашей машине означает, что домены, логи и конфиги остаются дома. Облачный OpenAI-совместимый адрес — нет.
Настройки — секция agent в settings.json: base_url, model,
api_key (локальным серверам не нужен), max_steps, timeout_sec,
temperature, tools, tool_result_chars. Ключ не показывается на
странице и не пишется в журнал — как токен MCP.
После установки доступна команда zapret-gui (по SSH, без браузера):
zapret-gui status # общий статус
zapret-gui nfqws {start|stop|restart|status}
zapret-gui strategy {list|apply <id>}
zapret-gui singbox {list|up|down|restart <name>}
zapret-gui mihomo {list|up|down|restart <name>}
zapret-gui opera {status|start|stop} # Opera Proxy: настройки берутся из GUI
zapret-gui usque {status|start <iface|name>|stop <iface>} # WARP/MASQUE
zapret-gui tgproxy {status|start|stop} # Telegram Tunnel
zapret-gui monitor # трафик по туннелям (RX/TX и скорости)
zapret-gui updates # проверить обновления всех движков
zapret-gui dns-routing {list|apply} # правила «домен → свой DNS»
zapret-gui mcp {status|tools|call|token|audit|code|issues} # MCP-сервер
zapret-gui mcp --stdio # MCP-клиент через ssh (stdio-мост)Из клона репозитория — напрямую: python3 app.py status.
zapret-gui mcp status показывает, включён ли MCP-сервер, по какому
адресу он доступен и что разрешено модели; mcp tools — что она видит
при текущих разрешениях, mcp call <tool> '<json>' — вызвать
инструмент руками. zapret-gui mcp token show печатает токен прямо
в терминал — иначе его не скопировать по SSH, но учтите: он
останется в истории shell и в буфере терминала. mcp token rotate
выдаёт новый токен и обрывает всех подключённых клиентов.
zapret-gui mcp --stdio поднимает мост «строка ↔ JSON-RPC»: клиент на
ноутбуке ходит в роутер через ssh router zapret-gui mcp --stdio, без
открытого наружу порта и без токена — канал даёт ssh.
# Обновление
opkg upgrade zapret-gui # через пакетный менеджер
./install.sh --update # скриптом
# либо кнопка «Обновить GUI» на странице Zapret2
# Удаление — способ зависит от того, КАК вы ставили GUI.Если ставили ipk/apk-пакетом (opkg install … / apk add …) — удаляйте
пакетным менеджером (имя пакета — zapret-gui, независимо от имени файла):
opkg remove zapret-gui # OpenWrt ≤24.10 и Entware/Keenetic
apk del zapret-gui # OpenWrt 25.12+ / SNAPSHOTЕсли ставили скриптом (wget -O - …/install.sh | sh) или вручную из
репозитория — пакета в opkg нет (opkg remove вернёт «No packages removed»),
и удалять надо скриптом uninstall.sh. Если репозиторий не склонирован —
скачайте скрипт и запустите:
wget -O /tmp/uninstall.sh https://raw.githubusercontent.com/avatarDD/zapret-gui/main/uninstall.sh
sh /tmp/uninstall.sh # конфиг сохраняется
sh /tmp/uninstall.sh --full # полное удаление (вместе с конфигом)
./uninstall.sh: not foundозначает, что скрипта нет в текущем каталоге — используйте командуwget …выше (она кладёт его в/tmp), либо перейдите в каталог клона репозитория.
Не уверены, каким способом ставили? Проверьте, знает ли opkg о пакете:
opkg list-installed | grep zapret-guiЕсли строка есть — удаляйте через opkg remove; если пусто — скриптом
uninstall.sh.
GUI сам по себе — это Python/JS-код; «тяжёлые» бинарники и списки
тянутся из внешних источников (все можно проксировать через зеркало
ZAPRET_GUI_MIRROR / file://):
| Что | Откуда | Где используется |
|---|---|---|
| nfqws2 (zapret2) | bol-van/zapret2 (Releases) | Страница Zapret2 |
| geneva (geneva_c) | avatarDD/geneva_c (Releases, закреплён v1.0.0, sha256 из SHA256SUMS релиза) |
Движок обхода → «Установить» |
| INI-каталоги стратегий | никуда не ходят — лежат в самой сборке GUI (catalogs/, пополняются из import/ при установке и обновлении) |
Стратегии / Подбор |
| sing-box | сборка в наших Releases (тег singbox-bin-*); upstream-код — SagerNet/sing-box |
sing-box → установка |
| mihomo (Clash.Meta) | MetaCubeX/mihomo (Releases) | mihomo → установка |
| amneziawg-go / -tools | сборка в наших Releases (тег awg-bin-go-X-tools-Y, sha256 из manifest.json) |
AmneziaWG → Установка |
| Cloudflare WARP | api.cloudflareclient.com |
Генератор конфигов, Мастер настройки, WARP/MASQUE |
| Proton VPN (бесплатные серверы) | сервис proton-generation (www.api-proton.workers.dev, адрес меняется в vpngen.proton_service); ключ создаётся на роутере |
Генератор конфигов, Мастер настройки |
| Сервисы-генераторы WARP (запасной источник) | *.warp-api.cfd (те же, что у warp-generation.github.io) |
Генератор конфигов → «Откуда брать ключи: сервис» |
| usque | сборка в наших Releases (тег usque-bin-v*, sha256 из manifest.json релиза); upstream-код — Diniboy1123/usque. Запасной источник — side-effect-tm/usque-keenetic |
WARP/MASQUE → «Установить» |
| Cloudflare WARP по MASQUE | consumer-masque.cloudflareclient.com + узлы WARP (443/udp, при Restricted — 443/tcp) |
WARP/MASQUE — регистрация сессии и сам трафик |
| opera-proxy | сборка в наших Releases (тег opera-bin-*, sha256 из manifest.json релиза); upstream-код — Alexey71/opera-proxy, он же запасной источник (v1.31.0) |
Opera Proxy → «Установить» |
| Opera VPN (SurfEasy) | api2.sec-tunnel.com + узлы *.sec-tunnel.com |
Opera Proxy — регистрация устройства, список стран, сам трафик |
tg-ws-proxy (пакет .ipk/.apk) |
spatiumstas/tg-ws-proxy-go (Releases, закреплён 0.9.3 — дальше апстрим настольный; sha256 сверяется) | Telegram Tunnel → «Установить» |
| tg-mtproxy-client (резервный движок Telegram) | сборка в наших Releases (тег tgproto-bin-v*, sha256 из manifest.json); upstream-код — necronicle/z2k (mtproxy-client/) |
Telegram Tunnel → резервный движок |
| Пул CF-доменов для Telegram | Flowseal/tg-ws-proxy (.github/cfproxy-domains.txt) |
Telegram Tunnel → режим «Cloudflare community» (тянет сам бинарник) |
| CIDR датацентров Telegram | core.telegram.org/resources/cidr.txt (выгрузка в import/lists/ipset-telegram.txt) |
Telegram Tunnel → режим «через WARP-туннель», списки IP |
| Курируемые списки доменов | itdoginfo/allow-domains | Списки → Готовые списки |
| Публичные серверы (пул) | Epodonios/v2ray-configs, ebrasha/free-v2ray-public-list, igareck/vpn-configs-for-russia, kort0881/vpn-vless-configs-russia | sing-box → Пул серверов (пресеты) |
| Проба тестера | cp.cloudflare.com / aws.amazon.com / www.gstatic.com (generate_204) |
sing-box → Тест серверов |
| IP по ASN | публичные ASN-реестры | IP-списки → загрузка по ASN |
Списки публичных серверов — это «свалки» бесплатных ключей: качество низкое, поэтому включайте «фильтр живых» и urltest. Подписки/серверы — на ваш риск; редактируйте список источников под себя.
Проект многое перенял (идеи и подходы, не код, если не указано иное) у сообщества:
- bol-van/zapret2 — основной инструмент обхода DPI (nfqws2).
- nfqws/nfqws2-keenetic —
firewall-обвязка автозапуска (цепочки
nfqws_pre/post/nat, метки MARK_PROCESSED/EXCLUDE, правила на оба направления, NAT для UDP, тюнинг conntrack) портирована из их init-скрипта; идеи интеграции с Keenetic. - rndnaame/nfqws-menu —
стратегии nfqws2 (
strategies/nfqws2, порты Flowseal zapret-discord-youtube и конфиги из чата nfqws2-keenetic) вcatalogs/builtin/nfqws_menu.txtиcatalogs/advanced/*_nfqws_menu.txt. youtubediscord/zapret— каталоги стратегий и winws2-пресеты, из которых собраны нашиcatalogs/. В августе 2026 репозиторий снят вместе со всей организацией (404), поэтому ссылки нет и обновлять каталоги оттуда больше нельзя; то, что успело приехать, живёт в сборке.- Shiperoid/YT-DPI — идеи диагностики: троттлинг, реальные CDN-шарды googlevideo, Deep Trace, QUIC, большой ClientHello.
- jameszeroX/XKeen — прозрачные режимы TProxy/Redirect/Hybrid, движок mihomo, DSCP-роутинг, CLI, оффлайн-зеркало, совместимость с политиками Keenetic.
- rcd27/blockcheckw (MIT) —
IP-блок vs DPI-блок +
remediation, ранжирование стратегий, методыtcpseg/oob, генератор стратегий «на лету». - itdoginfo/podkop + itdoginfo/allow-domains — идея курируемых списков доменов с автообновлением и selective-routing через sing-box.
- qzeleza/kvas — подход DNS/ipset-маршрутизации и суффикс-матчинг доменов.
- SagerNet/sing-box, MetaCubeX/mihomo, amnezia-vpn/amneziawg-go — движки туннелей.
- Alexey71/opera-proxy (MIT) — standalone-клиент Opera VPN (SurfEasy); GUI ставит его готовые сборки и управляет ими на странице «Opera Proxy».
- necronicle/d2k (MIT) — разгрузка
ускорителя PPE Keenetic (
-j PPE -m connskip), метка проб мимо очереди, исключение клиентовip rule, ICMP от TTL-фейков на QUIC, дифференциальные вопросы к DPI (разрез на 1 байте, контроль чужим именем), TX-лестница, семейства доменов, сверка обновления с SHA256SUMS и откат. - Bottle — микро-фреймворк бэкенда.
MIT © avatarDD.
Проект использует сторонние компоненты под их собственными лицензиями — см. Заимствования и благодарности.