# ByeDPI for Android

[English](README.md) | **Русский**

<div style="text-align: center;">
  <img src=".github/images/logo.svg" width="100%" height="200px">
</div>

---

Приложение для Android, которое запускает локальный VPN-сервис для обхода DPI (Deep Packet Inspection) и цензуры.

Приложение локально запускает SOCKS5-прокси [ByeDPI](https://github.com/hufrea/byedpi) и перенаправляет весь трафик через него.

## Установка

[<img src="https://github.com/machiav3lli/oandbackupx/blob/034b226cea5c1b30eb4f6a6f313e4dadcbb0ece4/badge_github.png"
    alt="Скачать с GitHub"
    height="80">](https://github.com/dovecoteescapee/ByeDPIAndroid/releases)

### Или используйте Obtainium

1. Установите [Obtainium](https://github.com/ImranR98/Obtainium?tab=readme-ov-file#installation)
2. Добавьте приложение по URL:  
   `https://github.com/dovecoteescapee/ByeDPIAndroid`

## Настройки

Для обхода некоторых блокировок может потребоваться изменить настройки. Подробнее о различных настройках можно прочитать в [документации ByeDPI](https://github.com/hufrea/byedpi#readme-ov-file).

## FAQ

### У меня не получается настроить. Что делать?

Вы можете попросить помощи в [discussion](https://github.com/dovecoteescapee/ByeDPIAndroid/discussions).

### Приложение требует root-права?

Нет. Все функции приложения работают без root-прав.

### Как получать обновления?

Используйте [Obtainium](#или-используйте-obtainium).

### Это VPN?

Нет. Приложение использует VPN-режим на Android для перенаправления трафика, но не передает ничего на удаленный сервер. Оно не шифрует трафик и не скрывает ваш IP-адрес.

### Какие данные собирает приложение?

Никакие. Приложения не отправляет никакие данные на удаленный сервер. Весь трафик обрабатывается на устройстве.

### Как использовать ByeDPI вместе с AdGuard?

1. Запустите ByeDPI в режиме прокси.
2. Добавьте ByeDPI в исключения AdGuard на вкладке "Управление приложениями".
3. В настройках AdGuard укажите прокси:

   ```plaintext
   Тип прокси: SOCKS5
   Хост: 127.0.0.1
   Порт: 1080 (по умолчанию)
   ```

### А есть для других платформ?

Для Windows существует [GoodByeDPI](https://github.com/ValdikSS/GoodbyeDPI), а для Linux и macOS [zapret](https://github.com/bol-van/zapret). Также, вы можете использовать оригинальный [ByeDPI](https://github.com/hufrea/byedpi) для запуска аналогичного прокси на Windows, Linux или macOS.

[Другие аналоги](https://github.com/ValdikSS/GoodbyeDPI?tab=readme-ov-file#similar-projects)

### Что такое DPI?

DPI (Deep Packet Inspection) - это технология для анализа и фильтрации трафика. Она используется провайдерами и государственными органами для блокировки сайтов и сервисов.

## Зависимости

- [ByeDPI](https://github.com/hufrea/byedpi)
- [hev-socks5-tunnel](https://github.com/heiher/hev-socks5-tunnel)

## Сборка

Для сборки приложения требуется:

1. JDK 8 или новее
2. Android SDK
3. Android NDK
4. CMake 3.22.1 или новее

Сборка приложения:

1. Клонируйте репозиторий с подмодулями:
   ```bash 
   git clone --recurse-submodules
   ```
2. Запустите скрипт сборки из корня репозитория:
   ```bash
   ./gradlew assembleRelease`
   ```
3. APK будет лежать в `app/build/outputs/apk/release/`