Skip to content
necroniclePublic

About

Zapret 2 for keenetic

Resources

Contributing

Security policy

Stars

363 stars

Watchers

7 watching

Forks

Latest commit

 

History

2,147 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

z2k — Zapret2 для Keenetic

z2k — инструментарий на базе zapret2 для исследования сетевых протоколов и систем анализа трафика на роутерах Keenetic с Entware. Включает автоматический подбор параметров обработки пакетов, сетевую диагностику и веб-панель.

Данный проект предназначен для исследования сетевых протоколов и изучения работы систем анализа трафика. Используется исключительно в учебных целях.

Telegram: вопросы и помощь · Руководство пользователя · Технический справочник

Возможности

  • Сайты, YouTube и Discord. Готовые списки доменов и стратегии для TCP и QUIC. Автоподбор запоминает найденные варианты между перезапусками.
  • Telegram. Прозрачное подключение для устройств в сети без настройки приложения; включается при установке или в меню [T]. На Realtek Lexra недоступно.
  • Игровой режим WARP. Раздельная маршрутизация трафика игр и сервисов через туннель. Устанавливается по желанию; игры и устройства выбираются в панели.
  • Свои домены и исключения. Можно выбрать домены для обработки и исключить отдельные домены, адреса и подсети.
  • Веб-панель. Статус, настройки, диагностика, обновление и удаление. Работает без загрузки ресурсов из интернета.
  • IPv4 и IPv6. Поддержка обоих семейств адресов; ограничения отдельных режимов описаны в руководстве.

Движок — zapret2 v1.0.7 в сборке z2k, основанной на bol-van/zapret2. Он устанавливается и обновляется вместе с z2k, компиляция на роутере не нужна.

Перед установкой

Понадобятся роутер Keenetic, установленный Entware и доступ к его терминалу. Подготовка USB-накопителя и обязательных компонентов прошивки описана ниже. На каждом Windows-компьютере обязательно включите TCP timestamps — шаг 4.

На Realtek Lexra работает обработка пакетов, но недоступны Telegram, детектор и проверка подписи обновлений: для этой разновидности MIPS нет сборок компонентов на Go. Подробнее — ограничения Lexra.

Поддерживаемые архитектуры

Архитектура определяется автоматически. Поддерживаются все платформы из zapret2 openwrt-embedded:

Архитектура Роутеры
arm64 / aarch64 Keenetic Hero, Ultra, Giga, Hopper и другие на ARM Cortex-A
arm Более старые модели на ARM
mipsel Keenetic на MT7621 (Extra, Start, Air и др.)
mips MIPS с порядком байтов big-endian
mips64 MIPS64 (big-endian)
mips64el MIPS64 (little-endian)
lexra Realtek Lexra — обработка пакетов работает, но без Telegram, детектора и проверки подписи (почему)
x86 / x86_64 x86-роутеры и виртуальные машины
riscv64 RISC-V
ppc PowerPC

Установка

Команды ниже выполняются в терминале Entware на роутере.

1. Компоненты Keenetic

«Модули ядра подсистемы Netfilter» нужны на ЛЮБОЙ прошивке Keenetic — по умолчанию они не предустановлены, и без них z2k не запустится. Их нужно доустановить в веб-интерфейсе Keenetic (раздел «Изменить набор компонентов»):

  1. «Модули ядра подсистемы Netfilter» — обязательно, на всех прошивках и роутерах.
  2. «Протокол IPv6» — нужен только на старых прошивках (и только если вы используете IPv6). На новых прошивках IPv6 уже включён по умолчанию, и такого пункта в списке может не быть.

На части прошивок пункт «Модули ядра подсистемы Netfilter» появляется в списке только после того, как выбран компонент «Протокол IPv6».

2. Entware и зависимости

Подготовьте USB-накопитель и установите Entware по официальной инструкции Keenetic: https://help.keenetic.com/hc/ru/articles/360021214160

После установки Entware выполните обновление индекса пакетов и установите зависимости:

opkg update
opkg install coreutils-sort curl grep gzip ipset iptables kmod_ndms xtables-addons_legacy openssl-util
Если Entware не устанавливается или загрузка пакетов зависает

Если сервер пакетов Entware недоступен из вашей сети, воспользуйтесь офлайн-установщиком Entware: пакеты уже находятся внутри архива. В репозитории есть варианты для разных архитектур, инструкция и контрольные суммы.

Если Entware уже установлен, но зависимости загрузить не удалось, обратитесь в группу проекта. Менять конфигурационные файлы вручную не требуется.

3. Установка z2k

{ curl --resolve raw.githubusercontent.com:443:85.192.60.175 -fsSL https://raw.githubusercontent.com/necronicle/z2k/z2k-enhanced/z2k.sh || curl -fsSL https://raw.githubusercontent.com/necronicle/z2k/z2k-enhanced/z2k.sh; } | sh

4. Windows: обязательно включить TCP timestamps

Выполните этот шаг на каждом компьютере с Windows, который будет использовать z2k. Это обязательная часть установки для Windows, даже если сайты пока открываются.

На самом Windows-компьютере откройте командную строку от имени администратора и выполните:

netsh interface tcp set global timestamps=enabled

Часть поставляемых стратегий использует метки времени TCP в тестовых пакетах. Поэтому включение TCP timestamps входит в обязательную подготовку Windows-устройств.

Как отменить настройку при отказе от использования z2k

В командной строке Windows от имени администратора:

netsh interface tcp set global timestamps=disabled

Это отключает TCP timestamps. Не выполняйте эту команду в рамках установки z2k.

Первый запуск и веб-панель

  1. После установки выберите в меню [P] → [1] — установить веб-панель.
  2. На устройстве в домашней сети откройте http://ROUTER_IP:8088/, заменив ROUTER_IP локальным адресом роутера.
  3. На «Дашборде» проверьте карточку «Состояние». Кнопки запуска, остановки и перезапуска находятся рядом, в «Управлении сервисом».
  4. Проверьте нужный сайт на устройстве за роутером. Автоподбору может потребоваться несколько попыток: если сайт не открылся сразу, повторите загрузку страницы.

Панель по умолчанию без пароля и доверяет домашней сети. Включить вход с учётными данными веб-интерфейса Keenetic можно в меню [P] → [6]. Панель работает по HTTP; подробности — вход по паролю.

Дальше всё настраивается в панели:

Задача Где настроить
Добавить домен для обработки «Доп. домены» — формат и правила
Убрать сайт или адрес из обработки «Исключения» — домены, IP и подсети
Проверить сайт и получить сводку «Диагностика» — доступные проверки
Посмотреть или закрепить стратегию «Стратегии» — автоподбор и ручной выбор
Включить туннель для игр «WARP»: установить, выбрать игры и включить — подробнее
Изменить сетевые режимы «Режимы» — помощь с видео YouTube

Списки доменов обновляются ежедневно в 04:00, проверка обрыва на 16 КБ запускается в 03:30. Пользовательские домены сохраняются при обновлении списков.

Если что-то не работает

Симптом Что сделать
Сайт не открылся сразу после установки Повторите загрузку несколько раз: автоподбору нужны попытки соединения. Если не помогло — проверьте домен в «Диагностике»
Не открывается отдельный сайт Проверьте, есть ли он в списках; добавьте его в «Доп. домены», если его там нет
Без z2k сервис работал, а с ним перестал Добавьте его в «Исключения»: сайт — по домену, камеру или приложение без видимого имени — по адресу сервиса
На iPhone или Mac работает, на Windows зависает Проверьте, выполнен ли обязательный шаг установки для Windows
YouTube открывается, но видео не начинается Проверьте режимы видео; при проблемах с QUIC попробуйте «YouTube без QUIC» — подробнее
Страница обрывается после первых 15–16 КБ На дашборде запустите проверку «Обрыв на 16 КБ» — как работает проверка
Telegram не работает на Realtek Lexra На этой платформе нет клиента туннеля — ограничение архитектуры

Обратиться за помощью

  1. Откройте веб-панель → «Диагностика».
  2. В карточке «Сводка z2k-diag» нажмите «Скачать файл». Сохранится файл z2k-diag-….txt с полным отчётом и логами.
  3. Прикрепите файл к сообщению в Telegram-группе @zapret2keenetic. Укажите модель роутера, провайдера, проблемный сайт и устройство, на котором он не открывается.

Кнопка «Копировать» в той же карточке даёт краткую сводку. Для разбора проблемы предпочтителен файл: в нём есть полные логи.

Обновление и удаление

Обновить z2k: откройте «Дашборд» веб-панели. Если доступна новая версия, в баннере обновления нажмите «Обновить». Кнопка «Проверить» или «Проверить ещё раз» запрашивает список версий заново.

При установке файлы загружаются по тегу выбранного выпуска, чтобы версии не смешивались. Свои домены и строки стратегий сохраняются. О проверке подлинности — подпись обновлений.

Если обычное обновление не загружается, используйте команду из раздела установки. Она же открывает меню, если z2k уже установлен.

Удалить z2k: откройте карточку «Удаление z2k» внизу дашборда и нажмите «Удалить z2k». Панель покажет последствия и попросит набрать УДАЛИТЬ для подтверждения. Удаление стирает настройки, списки, подобранные стратегии и резервные копии. Пакеты Entware и ключ WARP остаются. Подробнее — что удаляется.

Документация

Документ Что внутри
Руководство пользователя Панель, диагностика и выгрузка отчёта, Telegram, WARP, YouTube, свои домены и стратегии, удаление, подписи обновлений
Технический справочник Профили и стратегии, автоподбор, детекция неудач, ClientHello, TTL, обрыв на 16 КБ, структура файлов
ARCHITECTURE.md Устройство модулей, зависимости и сохранение состояния при обновлении
CONTRIBUTING.md Правила изменения кода, BusyBox ash и MIPS
RELEASING.md Подготовка и публикация релиза, каналы доставки и откат
SECURITY.md Модель угроз и границы защиты

Поддержать проект

  • TON: UQA6Y6Mf1Qge2dVSl3_vSqb29SKrhI8VgJtoRBjgp08oB8QY
  • USDT (ERC20): 0xA1D6d7d339f05C1560ecAF0c5CB8c4dc80Dc46A9
  • USDT (TRC20): TVtWDryrowtb4MYGGtA8Q2yCAei4VFh5g5

♥ Спасибо за поддержку

Проект развивается благодаря вам.

SupWgeneral · Alexey · Jet_sk_ya · Suharik39 · ZyaK<- · Алексей Стрельцов
Diman86RUS · Alex · GRM · Dez · hoaxx · Mansurchick
Dkarloff - SEO отец · KIBERPANK · olmer2002 · TiaMax · Denis · Mega Man
TheGreatYogo · logistik77 · b11d11 · BloodKnife39 · SIGogelon · yozh
Altaec · DIDIQ Rawa · GregMSK · Кожевников · bootnet · ewgen911
cmfifty · Ret80 · Шулепов Александр · Андрюшка · Marshmalick · Mustang
Роман Борисович · zelenewruan · Den

Лицензия

MIT

About

Zapret 2 for keenetic

Resources

Contributing

Security policy

Stars

363 stars

Watchers

7 watching

Forks

Releases

Packages

Contributors

Languages