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 на роутере.
«Модули ядра подсистемы Netfilter» нужны на ЛЮБОЙ прошивке Keenetic — по умолчанию они не предустановлены, и без них z2k не запустится. Их нужно доустановить в веб-интерфейсе Keenetic (раздел «Изменить набор компонентов»):
- «Модули ядра подсистемы Netfilter» — обязательно, на всех прошивках и роутерах.
- «Протокол IPv6» — нужен только на старых прошивках (и только если вы используете IPv6). На новых прошивках IPv6 уже включён по умолчанию, и такого пункта в списке может не быть.
На части прошивок пункт «Модули ядра подсистемы Netfilter» появляется в списке только после того, как выбран компонент «Протокол IPv6».
Подготовьте 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 уже установлен, но зависимости загрузить не удалось, обратитесь в группу проекта. Менять конфигурационные файлы вручную не требуется.
{ 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Выполните этот шаг на каждом компьютере с 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.
- После установки выберите в меню
[P]→[1]— установить веб-панель. - На устройстве в домашней сети откройте
http://ROUTER_IP:8088/, заменивROUTER_IPлокальным адресом роутера. - На «Дашборде» проверьте карточку «Состояние». Кнопки запуска, остановки и перезапуска находятся рядом, в «Управлении сервисом».
- Проверьте нужный сайт на устройстве за роутером. Автоподбору может потребоваться несколько попыток: если сайт не открылся сразу, повторите загрузку страницы.
Панель по умолчанию без пароля и доверяет домашней сети. Включить вход с учётными данными веб-интерфейса 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 | На этой платформе нет клиента туннеля — ограничение архитектуры |
- Откройте веб-панель → «Диагностика».
- В карточке «Сводка z2k-diag» нажмите «Скачать файл». Сохранится файл
z2k-diag-….txtс полным отчётом и логами. - Прикрепите файл к сообщению в 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