Zapret2 для Android: Magisk/KernelSU/APatch-модуль и приложение для обхода DPI-блокировок YouTube, Discord и сайтов без VPN. https://wiki.zapret.moe/Zapret2/Zapret2
  • Kotlin 55.9%
  • Shell 37.4%
  • Lua 6.4%
  • Python 0.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
loop-uh 711c2693eb Keep a release's APK installable when it raises the contract
v2.3.0 raised the packaged lifecycle contract. Every installed app
validates a downloaded package against the contract it was built for,
so it rejected the release — and then deferred that release's APK
behind the module it had just rejected, on the rule that an app must
not run ahead of a module that never landed. That rule is right when
the package is suspect. Here the package was fine and the app was the
stale half, so the deferral removed the only in-app way out and left
sideloading the APK by hand as the sole path forward.

A raised contract is now recognized as its own outcome before the
generic invalid-package verdict, and it alone keeps the APK from being
deferred: the app beside that module is exactly what can read it. The
rejected module is dropped rather than staged, so nothing installs a
package this build cannot drive, and the message says the app is being
updated and the module update should be repeated afterwards instead of
claiming the package failed an integrity check.

Devices still on an app older than this cannot benefit from it — their
build already made this decision — and need the APK installed once by
hand.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-28 14:09:10 +03:00
.codex/skills/build-zapret2-locally Name the umask git archive itself applies to the snapshot 2026-07-25 17:27:34 +03:00
.github/workflows Restore upstream provenance verification inputs 2026-07-25 01:24:49 +03:00
android-app Keep a release's APK installable when it raises the contract 2026-07-28 14:09:10 +03:00
docs Publish the DNS hosts file from /data instead of the module tree 2026-07-28 00:56:30 +03:00
system/bin the big penis 2026-07-22 13:50:44 +03:00
tests Publish the DNS hosts file from /data instead of the module tree 2026-07-28 00:56:30 +03:00
tools Establish explicit semantic release versions 2026-07-23 22:53:53 +03:00
upstream 2.0.8 2026-07-24 19:32:25 +03:00
zapret2 Publish the DNS hosts file from /data instead of the module tree 2026-07-28 00:56:30 +03:00
.gitattributes lf 2026-07-22 14:35:10 +03:00
.gitignore fix 2026-07-24 21:04:33 +03:00
action.sh Release 2.0.9 with root-manager lifecycle recovery 2026-07-24 20:09:03 +03:00
build.sh Ship the boot-time hosts entry point in the module archive 2026-07-28 00:58:54 +03:00
customize.sh Publish the DNS hosts file from /data instead of the module tree 2026-07-28 00:56:30 +03:00
module.prop Keep a release's APK installable when it raises the contract 2026-07-28 14:09:10 +03:00
post-fs-data.sh Publish the DNS hosts file from /data instead of the module tree 2026-07-28 00:56:30 +03:00
service.sh Give the IPv6 ownership rule one home, and fix the sixth round 2026-07-25 05:14:53 +03:00
uninstall.sh Publish the DNS hosts file from /data instead of the module tree 2026-07-28 00:56:30 +03:00
update.json Keep a release's APK installable when it raises the contract 2026-07-28 14:09:10 +03:00
version.properties Keep a release's APK installable when it raises the contract 2026-07-28 14:09:10 +03:00

Zapret2 для Android

Последний релиз Всего скачиваний Звёзды на GitHub Последний коммит

Сборка Лицензия Upstream

Android 7.0+ ABI Root-доступ

Root-модуль для Magisk, KernelSU и APatch, предназначенный для обхода некоторых видов DPI-блокировок и замедления трафика на Android. Внутри используется nfqws2 с Lua-стратегиями, а приложение Zapret2 Control позволяет управлять модулем без терминала.

Интерфейс Zapret2 Control

Important

Zapret2 — не VPN. Он не меняет ваш IP-адрес, не скрывает трафик от провайдера и не добавляет шифрование. Модуль изменяет отдельные сетевые пакеты так, чтобы затруднить их распознавание DPI. Результат зависит от сети, провайдера и выбранной стратегии.

Что понадобится

  • Android 7.0 или новее;
  • устройство с процессором ARM или ARM64;
  • Magisk 20.4+, KernelSU или APatch с рабочим root-доступом;
  • ядро с поддержкой iptables и NFQUEUE;
  • приложение Zapret2 Control — необязательно, но рекомендуется.

Сборок для x86 и x86_64 нет.

Модуль обрабатывает трафик самого телефона. Устройства, подключённые к его точке доступа, обслуживаются отдельным переключателем Обход для точки доступа (по умолчанию выключен) — см. ниже.

Установка

1. Скачайте файлы

Откройте страницу последнего релиза и скачайте:

  • zapret2-magisk-v*.zip — универсальный root-модуль (историческое имя файла);
  • zapret2-control-v*.apk — приложение для управления;
  • файлы .sha256 — если хотите вручную проверить контрольные суммы.

Не распаковывайте ZIP.

2. Установите модуль

  1. Откройте Magisk, KernelSU Manager или APatch Manager.
  2. Перейдите в МодулиУстановить из хранилища.
  3. Выберите zapret2-magisk-v*.zip.
  4. Дождитесь завершения установки и перезагрузите устройство.

Устанавливайте ZIP только из работающей системы через root-менеджер. Прошивка через TWRP или другое recovery не поддерживается ни одним из трёх режимов.

Для KernelSU 3.x заранее установите metamodule, если нужны команды zapret2-* в /system/bin или системный hosts-оверлей: KernelSU делегирует монтирование каталога system/ metamodule. Сам сервис, приложение и iptables/NFQUEUE не зависят от подмены файлов /system.

3. Установите приложение

  1. Откройте zapret2-control-v*.apk.
  2. При необходимости разрешите установку из этого источника.
  3. Запустите Zapret2 Control и предоставьте ему root-доступ через активный root-менеджер.

Приложение необязательно: модуль может работать самостоятельно и запускаться при загрузке Android.

Первый запуск

  1. Откройте в приложении раздел Управление.
  2. Убедитесь, что root-доступ и модуль определены, а служба запущена.
  3. Проверьте нужный сайт или приложение.
  4. Если обход не работает, выберите другой готовый набор в разделе Наборы.

По умолчанию используется Default v1 (game filter).txt. Универсальной стратегии для всех провайдеров нет, поэтому иногда нужно попробовать несколько вариантов.

Для QUIC/HTTP3 может понадобиться отдельная UDP-стратегия. Если сервис работает нестабильно, временное отключение QUIC в нём или браузере также поможет понять, связан ли сбой с UDP.

Обход для точки доступа

По умолчанию модуль обрабатывает только трафик самого телефона: правила стоят на локальных цепочках OUTPUT и INPUT, а пакеты подключённых к точке доступа устройств проходят через FORWARD и их не встречают.

Переключатель УправлениеОбход для точки доступа добавляет те же цепочки ещё и в FORWARD, поэтому трафик клиентов точки доступа обрабатывается теми же правилами и той же стратегией. Новых правил при этом не появляется: запрос клиента — это то же исходное направление соединения с портом сервера в получателе, а ответ — то же обратное направление с портом сервера в источнике.

Что нужно учитывать:

  • переключение перезапускает службу: топология публикуется при старте, поэтому соединения на несколько секунд прерываются;
  • нагрузка растёт — через очередь проходит трафик всех подключённых устройств;
  • на Android 11 и новее работает аппаратная и eBPF-разгрузка тетеринга. Она обходит netfilter для уже установленных потоков, поэтому часть трафика может не попасть в очередь. Обходу это обычно не мешает, так как nfqws2 работает с первыми пакетами соединения, но при нестабильном результате разгрузку стоит отключить: settings put global tether_offload_disabled 1 и повторное включение точки доступа.

Наборы, профили и стратегии

  • Набор — полный TXT-файл с конфигурацией запуска.
  • Профиль — часть набора для определённого трафика или сервиса.
  • Стратегия — последовательность действий nfqws2, применяемая внутри профиля.
  • --skip — отключает профиль, не удаляя его.

Обычный порядок настройки:

  1. Выберите готовый вариант в разделе Наборы.
  2. Если нужна точная настройка, откройте Профили.
  3. Выберите другую стратегию для нужного профиля или отключите ненужный профиль.
  4. Сохраните изменения — приложение проверит конфигурацию и применит её через перезапуск службы.

В редакторе набора можно посмотреть итоговые аргументы запуска до сохранения. Некорректные или неподдерживаемые параметры отклоняются до запуска nfqws2.

Подробный формат описан в PRESET_PROFILE_STRATEGY_CONTRACT_RU.md.

Возможности приложения

Раздел Что в нём находится
Управление Состояние модуля и службы, запуск, остановка, автозапуск, обход для точки доступа, обновления и восстановление
Профили Включение профилей и выбор стратегий
Наборы Выбор и редактирование полных TXT-конфигураций
Списки хостов Просмотр, импорт и редактирование списков
Редактор хостов Управление системным hosts-оверлеем
Управление DNS Выбор DNS-набора и служб
Журналы Логи и диагностические данные
О приложении Версии, ссылки и сведения о лицензии

Обновление

Через Zapret2 Control

  1. Откройте УправлениеПроверить обновления.
  2. Просмотрите версию и состав обновления.
  3. Нажмите Обновить.
  4. Подтвердите установку APK в системном установщике, если он откроется.
  5. Перезагрузите устройство, если обновлялся root-модуль.

Приложение проверяет контрольные суммы, подпись APK и структуру ZIP до установки. Для установки оно автоматически выбирает официальный backend активной среды: magisk --install-module, ksud module install или apd module install. Новая версия сначала помещается в /data/adb/modules_update/zapret2 и становится активной только после перезагрузки.

Вручную

Скачайте новый релиз, установите ZIP через свой root-менеджер, APK — поверх текущего приложения, затем перезагрузите устройство.

Warning

Обновление модуля устанавливает чистое содержимое нового релиза. Изменённые настройки, пользовательские наборы, списки хостов и Lua-файлы из текущей установки автоматически не переносятся. Сохраните нужные данные заранее.

Подробнее об обновлении, восстановлении и удалении: USER_OPERATIONS_RU.md.

Если обход не работает

Проверяйте по порядку:

  1. В разделе Управление убедитесь, что служба запущена без ошибок.
  2. Попробуйте другой готовый набор.
  3. Проверьте, что нужный профиль не отключён через --skip.
  4. Для QUIC/HTTP3 попробуйте набор с UDP-стратегией.
  5. Временно отключите AdGuard, NetGuard, AFWall+ и другие программы, которые изменяют firewall или перенаправляют трафик.
  6. Сравните работу через Wi-Fi и мобильную сеть: у них могут быть разные DPI и подходящие стратегии.
  7. Откройте Журналы, сохраните диагностику и приложите её к сообщению об ошибке.

Служба не запускается

Чаще всего причина — отсутствие обязательных возможностей ядра или firewall. Для IPv4 нужны iptables, iptables-restore, NFQUEUE с --queue-bypass, а также модули multiport и mark. Поддержка connbytes желательна, но не обязательна. Если IPv6-бэкенд недоступен, IPv6-трафик не перехватывается.

Точный порядок проверки устройства описан в tests/device/README.md.

Интернет стал медленнее

Отключите ненужные профили через --skip и оставьте только те TCP/UDP-фильтры, которые действительно нужны. Затем перезапустите службу и проверьте ещё раз.

Команды терминала

Для ручного управления из Termux или adb shell:

# Состояние
su -c zapret2-status

# Запуск
su -c zapret2-start

# Остановка
su -c zapret2-stop

# Перезапуск
su -c zapret2-restart

# Журнал Android
su -c "logcat -s Zapret2"

На KernelSU команды zapret2-* требуют metamodule, который монтирует system/. Без него используйте Zapret2 Control или запускайте скрипты из каталога модуля.

Совместимость root-менеджеров

Архитектура следует общему контракту трёх проектов:

  • module scripts получают свой корень через MODDIR=${0%/*};
  • installer использует переданный root-менеджером MODPATH;
  • активная и ожидающая перезагрузки генерации находятся соответственно в /data/adb/modules/zapret2 и /data/adb/modules_update/zapret2;
  • встроенное обновление выбирает installer backend, а не изменяет активное дерево самостоятельно.

Это соответствует официальным руководствам Magisk, KernelSU и APatch.

Другие root-менеджеры могут оказаться ZIP-совместимыми, но не заявлены как поддерживаемые, пока у них нет проверенного installer API и совместимого контракта modules/modules_update.

Как это работает

  1. iptables направляет подходящие TCP/UDP-пакеты в очередь NFQUEUE.
  2. nfqws2 получает их в пользовательском пространстве.
  3. Lua-стратегия изменяет порядок, разбиение или содержимое отдельных пакетов.
  4. Пакеты возвращаются в сетевой стек Android и отправляются напрямую, без стороннего VPN-сервера.

Перехватываются только порты, которые нужны включённым профилям активного набора.

Каждая релизная сборка получает последний стабильный релиз исходного bol-van/zapret2, проверяет архив и контрольные суммы, а затем записывает точную версию исходного кода в пакет.

Частые вопросы

Работает ли Zapret2 в любой сети?

Нет гарантии. Результат зависит от провайдера, используемого DPI, протокола и стратегии. Один набор может работать в мобильной сети и не работать через Wi-Fi.

Скрывает ли модуль мой IP-адрес?

Нет. Соединение идёт напрямую к сайту, поэтому ваш обычный публичный IP-адрес не меняется.

Шифрует ли Zapret2 трафик?

Нет. Шифрование определяется самим приложением или протоколом, например HTTPS. Zapret2 не создаёт дополнительный зашифрованный туннель.

Работает ли он вместе с VPN или сетевым фильтром?

Иногда, но совместимость не гарантируется. VPN, блокировщики рекламы и firewall- приложения могут использовать те же сетевые таблицы и конфликтовать с модулем.

Где получить подробную диагностику?

В разделе Журналы приложения или с помощью zapret2-status. Расширенные эксплуатационные инструкции находятся в USER_OPERATIONS_RU.md, включая раздел «Модуль не запускается и не останавливается». Устройство модуля и принципы, по которым он принимает решения, описаны в ARCHITECTURE_2_2.md.

Благодарности

  • bol-van/zapret2 — исходный проект, nfqws2 и Lua-стратегии;
  • участникам сообщества — за тестирование наборов и устройств.

Лицензия

Материалы, на которые правообладатели проекта вправе выдать лицензию, распространяются строго на условиях GNU Affero General Public License v3 (AGPL-3.0-only). Покрываемые производные нельзя распространять под закрытой или иной несовместимой лицензией; для них должны выполняться требования AGPL о доступе к соответствующему исходному коду.

Сторонние компоненты, включая загружаемые материалы bol-van/zapret2, не перелицензируются этим проектом. Точная область действия лицензии и правила использования товарных знаков описаны в политике лицензирования.