nzapret

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 16 Open GitHub ↗

Android DPI-bypass module for Magisk and KernelSU powered by nfqws2, nztg, iptables, CLI and WebUI.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<b>Русский</b> | <a href="README.en.md">English</a>

# 🚀 nzapret by nikitos4683

**DPI-bypass модуль для Android (Magisk / KernelSU)**

![Android](https://img.shields.io/badge/Platform-Android-2ea44f?style=for-the-badge)
![Root](https://img.shields.io/badge/Root-Magisk%20%7C%20KernelSU-1f6feb?style=for-the-badge)
![Engine](https://img.shields.io/badge/Engine-nfqws2%20%7C%20nztg-f59e0b?style=for-the-badge)
![UI](https://img.shields.io/badge/UI-KernelSU%20WebUI-8b5cf6?style=for-the-badge)
![Version](https://img.shields.io/badge/Version-v3.2.0-blue?style=for-the-badge)

</div>

---

**nzapret** — автономный и легковесный модуль для Android-устройств с root-доступом. Модуль работает **на базе [zapret2](https://github.com/bol-van/zapret2)**, используя локальный движок `nfqws2` и правила `iptables`/`ip6tables` для обхода DPI, а также встроенный прокси `nztg` для разблокировки Telegram.

Бинарники `nfqws2`, пейлоады и списки маршрутизации взяты из оригинального апстрима, прокси-сервер `nztg` собран на базе собственной Go-реализации, а весь код обвязки написан с нуля под Android — с удобным Web-интерфейсом и без лишнего мусора в системе.

---

## 📌 Содержание

- [✨ Ключевые возможности](#-ключевые-возможности)
- [🚧 Ограничения и известные проблемы](#-ограничения-и-известные-проблемы)
- [🚀 Быстрый старт](#-быстрый-старт)
- [🏗 Архитектура и структура](#-архитектура-и-структура)
- [🛠 Сборка модуля](#-сборка-модуля)
- [📄 Лицензия](#-лицензия)

---

## ✨ Ключевые возможности

- **Встроенный WebUI:** Удобный и красивый графический интерфейс прямо в менеджере модулей KernelSU.
- **Мощный CLI:** Полное управление модулем через терминал.
- **Умный роутинг:** Перехват трафика в цепочках `OUTPUT` и `FORWARD` для IPv4 и IPv6.
- **Авто-стек IPv4/IPv6:** Модуль сам поднимает перехват для IPv4 и, если работает `ip6tables`, для IPv6 — без ручного выбора режима.
- **Обход Telegram:** Встроенный локальный MTProto-прокси (`nztgproxy`) с мостом через WebSocket и Cloudflare-фолбэком, управляемый из той же кнопки Старт.
- **Управление Private DNS:** Автоматическая инициализация DNS и возможность переключения провайдера из WebUI/CLI.
- **Персональный `list-user`:** Собственный список доменов пользователя, редактируемый напрямую из интерфейса.
- **VPN-совместимость:** Поддержка совместной работы с большинством популярных VPN-клиентов.
- **Автономность:** Модуль использует локальные данные и не требует сети при загрузке.

<details>
<summary>⚙️ Подробная логика работы сети, DNS и Telegram (для гиков)</summary>

- **Сетевой стек:** Модуль всегда поднимает перехват DPI для IPv4, а для IPv6 — когда на устройстве работает `ip6tables` (таблица mangle). Отдельного выбора режима нет и он не нужен: холостые IPv6-правила ничего не стоят при отсутствии IPv6-трафика и уже готовы защитить IPv6, который поднимается позже (после загрузки или при смене Wi-Fi/сотовой сети). Это исключает старую проблему, когда в «режиме только IPv4» трафик (например, YouTube или Instagram) уходил по IPv6 мимо обхода и попадал под DPI.
- **Private DNS:** Инициализируется один раз при первом старте службы. Если в системе уже настроен валидный сторонний DNS-провайдер в режиме "Имя хоста", он сохраняется. В остальных случаях (режимы "Отключено", "Авто" или пусто) принудительно выставляется значение по умолчанию — `xbox-dns.ru` (необходимо для обхода DNS-блокировок ИИ-сервисов вроде ChatGPT, Gemini и др.). Ручные изменения DNS через CLI или WebUI фиксируются и не сбрасываются при последующих запусках.
- **Telegram-прокси (nztgproxy):** Локальный MTProto-прокси, написанный на Go (статический, CGO-free бинарник `nztg`). Он принимает входящие MTProto-соединения от клиента Telegram, декодирует обфусцированное рукопожатие (handshake) и транслирует (бриджит) трафик до оригинальных датацентров Telegram поверх протокола WSS (WebSocket-over-TLS) для обхода DPI-блокировок по IP-адресам. Поддерживает прямой TCP-откат, а также Cloudflare Worker / CDN fronting (CF-прокси) для маршрутизации трафика через сеть Cloudflare, если прямые адреса WebSocket-серверов Telegram заблокированы провайдером.

</details>

---

## 🚧 Ограничения и известные проблемы

> [!NOTE]
> **Telegram:** Модуль включает встроенный локальный MTProto-прокси (`nztgproxy`) для обхода блокировок Telegram. После старта модуля откройте вкладку **Telegram** в WebUI и нажмите **«Открыть в Telegram»** (или скопируйте ссылку/введите `127.0.0.1:1443` и Secret вручную). Если IP Telegram заблокированы провайдером, трафик автоматически идёт через Cloudflare-прокси. Если не грузятся медиа — уберите строку `2:149.154.167.220` в настройках датацентров.

> [!NOTE]
> **Баг WebUI в KernelSU:** Из-за особенностей менеджера KernelSU процессы `nfqws2` и `nztg`, запущенные *вручную* кнопкой **Start** из WebUI, могут завершаться системой после смахивания KernelSU из недавних приложений. В KernelSU-Next этот баг уже исправлен (см. issue [#1180](https://github.com/KernelSU-Next/KernelSU-Next/issues/1180))! Для обычного KernelSU рекомендуется использовать кнопку **Action** в списке модулей или команду `nzapret start` в терминале.

---

## 🚀 Быстрый старт

### 1. Установка
1. Скачайте готовый `ZIP-архив` со страницы релизов (Releases).
2. Прошейте стандартным способом через **Magisk** или **KernelSU**.
3. Перезагрузите устройство.
4. Откройте вкладку модулей в KernelSU для доступа к **WebUI**. *(Пользователям Magisk потребуется приложение [KsuWebUI](https://github.com/KOWX712/KsuWebUIStandalone) для работы с интерфейсом).*

### 2. Использование из терминала (CLI)
Для управления через CLI требуются root-права (`su`). Если команда `nzapret` не найдена в PATH, используйте полный путь: `/data/adb/modules/nzapret/system/bin/nzapret`.

> Служба Telegram запускается и останавливается вместе с модулем (`start`/`stop`/`restart`). Изменения настроек применяются после перезапуска.

---

## 🏗 Архитектура и структура

---

## 🛠 Сборка модуля

Если вы хотите собрать модуль самостоятельно, у вас в системе (Linux/WSL) должны быть установлены базовые утилиты: `bash`, `zip`, `sed`, `mktemp`.

Процесс сборки запускается всего одной командой:
```sh
bash build.sh
```
На выходе в корневой директории появится готовый к прошивке архив `nzapret-vX.Y.Z.zip`. Собирать можно прямо на устройстве (например, в Termux) или на ПК.

---

## 📄 Лицензия

Этот проект распространяется под лицензией [MIT](LICENSE). Подробную информацию можно найти в файле [LICENSE](LICENSE).

---

<div align="center">
  <b>🌍 Enjoy open Internet!</b>
</div>

nzapret

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README