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 libcurl curl coreutils-sort grep gzip ipset iptables kmod_ndms xtables-addons_legacy openssl-utilВ списке явно указаны и libcurl, и curl. В Entware зависимость curl от libcurl задана без версии. Если библиотека уже установлена, opkg install curl может обновить только саму утилиту и оставить старую библиотеку.
Перед скачиванием установщика проверьте, что curl запускается вместе с библиотекой Entware.
LD_BIND_NOW=1 curl --versionЕсли появляется undefined symbol: curl_multi_get_offt, загрузчик нашёл библиотеку libcurl, в которой нет нужной функции. Даже если OPKG пишет, что curl уже обновлён, переустановите оба пакета из актуального индекса Entware и повторите проверку.
opkg update && opkg --force-reinstall install libcurl curl && LD_BIND_NOW=1 curl --versionПродолжайте установку, когда команда выведет версии curl и libcurl. Если ошибка сохранилась, для диагностики пришлите вывод command -v curl, opkg list-installed | grep -E '^(libcurl|curl) ' и, если доступна команда ldd, вывод ldd "$(command -v curl)" | grep libcurl.
Если Entware не устанавливается или загрузка пакетов зависает
У части провайдеров сервер пакетов Entware (bin.entware.net) обрывает загрузку на первых десятках килобайт, и opkg висит без конца. Возьмите пакеты через зеркало на узле проекта z2k — оно отдаёт только bin.entware.net и больше ничего:
sed -i 's|http://bin.entware.net|http://85.192.60.175/entware|g' /opt/etc/opkg.conf
sed -i 's|http://213.176.74.63/entware|http://85.192.60.175/entware|g' /opt/etc/opkg.conf
opkg update &&
opkg install libcurl curl coreutils-sort grep gzip ipset iptables kmod_ndms xtables-addons_legacy openssl-util
sed -i 's|http://85.192.60.175/entware|http://bin.entware.net|g' /opt/etc/opkg.confПоследняя строка возвращает основной сервер в настройки opkg.
Сам установщик z2k ставит и обновляет пакеты через узел и без этого шага.
Стороннее зеркало вместо узла подойдёт, только если у вас стоит полноценный wget (пакет wget-ssl): встроенный в Entware busybox wget не умеет https, а по http зеркало ему отказывает.
sed -i 's|http://bin.entware.net|https://mirrors.bfsu.edu.cn/entware|g' /opt/etc/opkg.conf
opkg updateВернуть основной сервер: sed -i 's|https://mirrors.bfsu.edu.cn/entware|http://bin.entware.net|g' /opt/etc/opkg.conf
Официальный установщик Entware во время установки сам качает пакеты с того же bin.entware.net, поэтому на таких линиях установка обрывается. Для этого случая есть офлайн-установщики: официальный установщик с пакетами внутри, сеть при установке не нужна. Архивы для всех архитектур, инструкция и контрольные суммы — в репозитории entware-offline.
{ /opt/bin/curl --resolve raw.githubusercontent.com:443:85.192.60.175 -fsSL https://raw.githubusercontent.com/necronicle/z2k/z2k-enhanced/z2k.sh || /opt/bin/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 остаются. Подробнее — что удаляется.
Если после удаления остались процессы nfqws или nfqws2 либо сетевые правила zapret, используйте скрипт полной зачистки.
Перед запуском сохраните нужные настройки и списки вне роутера. Скрипт сразу останавливает процессы, снимает сетевые правила, включая все очереди NFQUEUE в базовых цепочках, и полностью удаляет /opt/zapret и /opt/zapret2, резервные копии zapret и ключ устройства WARP. Это затрагивает и отдельно установленный zapret.
Выполните в терминале Entware на роутере:
{ curl --resolve raw.githubusercontent.com:443:85.192.60.175 -fsSL https://raw.githubusercontent.com/necronicle/z2k/z2k-enhanced/z2k_cleanup.sh || curl -fsSL https://raw.githubusercontent.com/necronicle/z2k/z2k-enhanced/z2k_cleanup.sh; } | sh| Документ | Что внутри |
|---|---|
| Руководство пользователя | Панель, диагностика и выгрузка отчёта, 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 · WanTBeeR · Kurdt_Kobain
MIT