mirror of
https://github.com/dovecoteescapee/ByeDPIAndroid.git
synced 2024-12-22 14:26:22 +00:00
94 lines
2.9 KiB
Markdown
94 lines
2.9 KiB
Markdown
# ByeDPI for Android
|
|
|
|
**English** | [Русский](README-ru.md)
|
|
|
|
<div style="text-align: center;">
|
|
<img src=".github/images/logo.svg" width="100%" height="200px">
|
|
</div>
|
|
|
|
---
|
|
|
|
Android application that runs a local VPN service to bypass DPI (Deep Packet Inspection) and censorship.
|
|
|
|
The application locally runs [ByeDPI](https://github.com/hufrea/byedpi) and redirects all traffic through it.
|
|
|
|
## Installation
|
|
|
|
[<img src="https://github.com/machiav3lli/oandbackupx/blob/034b226cea5c1b30eb4f6a6f313e4dadcbb0ece4/badge_github.png"
|
|
alt="Get it on GitHub"
|
|
height="80">](https://github.com/dovecoteescapee/ByeDPIAndroid/releases)
|
|
|
|
### Or use Obtainium
|
|
|
|
1. Install [Obtainium](https://github.com/ImranR98/Obtainium?tab=readme-ov-file#installation)
|
|
2. Add the app by URL:
|
|
`https://github.com/dovecoteescapee/ByeDPIAndroid`
|
|
|
|
## Settings
|
|
|
|
To bypass some blocks, you may need to change the settings. More about the various settings can be found in the [ByeDPI documentation](https://github.com/hufrea/byedpi#readme-ov-file).
|
|
|
|
## FAQ
|
|
|
|
### Is this a virus?
|
|
|
|
No. [Discussion of the problem](https://github.com/dovecoteescapee/ByeDPIAndroid/issues/61).
|
|
|
|
### I can't configure it. What to do?
|
|
|
|
You can ask for help in [discussion](https://github.com/dovecoteescapee/ByeDPIAndroid/discussions).
|
|
|
|
### How to get updates?
|
|
|
|
Use [Obtainium](#or-use-obtainium).
|
|
|
|
### Is this a VPN?
|
|
|
|
No. The application uses the VPN mode on Android to redirect traffic, but does not send anything to a remote server. It does not encrypt traffic and does not hide your IP address.
|
|
|
|
### What data does the application collect?
|
|
|
|
None. The application does not send any data to a remote server. All traffic is processed on the device.
|
|
|
|
### Are there any for other platforms?
|
|
|
|
For Windows, there is [GoodByeDPI](https://github.com/ValdikSS/GoodbyeDPI), and for Linux and macOS [zapret](https://github.com/bol-van/zapret). Also, you can use the original [ByeDPI](https://github.com/hufrea/byedpi) to run a similar proxy on Windows, Linux, or macOS.
|
|
|
|
[Other similar projects](https://github.com/ValdikSS/GoodbyeDPI?tab=readme-ov-file#similar-projects)
|
|
|
|
### What is DPI?
|
|
|
|
DPI (Deep Packet Inspection) is a technology for analyzing and filtering traffic. It is used by providers and government agencies to block sites and services.
|
|
|
|
## Dependencies
|
|
|
|
- [ByeDPI](https://github.com/hufrea/byedpi)
|
|
- [Tun2Socks](https://github.com/xjasonlyu/tun2socks)
|
|
|
|
## Building
|
|
|
|
For building the application, you need:
|
|
|
|
1. JDK 8 or later
|
|
2. Android SDK
|
|
3. Android NDK
|
|
4. Go 1.22 or later
|
|
5. CMake 3.22.1 or later
|
|
|
|
To build the application:
|
|
|
|
1. Install gomobile:
|
|
```bash
|
|
go install golang.org/x/mobile/cmd/gomobile@latest
|
|
gomobile init
|
|
```
|
|
2. Clone the repository with submodules:
|
|
```bash
|
|
git clone --recurse-submodules
|
|
```
|
|
3. Run the build script from the root of the repository:
|
|
```bash
|
|
./gradlew assembleRelease
|
|
```
|
|
4. The APK will be in `app/build/outputs/apk/release/`
|