ProxyDroid：Android 全局代理工具

项目简介

ProxyDroid 是一款 Android 全局代理应用，采用以 VPN 为核心的架构。它通过注册 VpnService 在 TUN 设备上捕获 IP 数据包，并在用户态把 TCP/UDP 流量转换成上游代理连接，因此不需要 root，也不依赖 iptables 或 redsocks。

应用已发布到 Google Play：https://play.google.com/store/apps/details?id=org.proxydroid

主要功能

• 全局代理：把设备流量统一转发到上游 SOCKS5 或 HTTP 代理。
• 免 root 的 VPN 模式：基于 Android VpnService API，在受支持的 Android 版本上均可运行。
• Rust tun2socks：数据包到套接字的桥接层位于 app/src/main/rust/proxydroid-tun2socks，基于 netstack-smoltcp，通过 JNI 从 Kotlin 调用。
• 按应用绕过：使用 VpnService 的 addDisallowedApplication API 把指定应用排除在隧道之外。
• 多种上游协议：SOCKS5（可选用户名/密码认证）、HTTP CONNECT（可选 Basic 认证）。
• Compose 界面：设置与状态页面用 Jetpack Compose + Material 3 编写。

安装与使用

普通用户可从 Google Play 安装使用。

开发者从源码构建时，需要准备：

• JDK 17（Gradle 8.x 不接受 JDK 21+）
• 安装 compileSdk 36 的 Android SDK
• Android NDK 25.1.8937393、CMake 3.22.1
• Rust stable 工具链及 Android 目标：aarch64-linux-android、armv7-linux-androideabi、i686-linux-android、x86_64-linux-android

命令行构建：

./gradlew assembleDebug      # 产物在 app/build/outputs/apk/debug/
./gradlew assembleRelease    # 需要签名配置

release 签名是可选的。可在 local.properties 中提供：

KEYSTORE_PATH=/absolute/path/to/keystore.jks
KEYSTORE_PASSWORD=...
KEY_ALIAS=...
KEY_PASSWORD=...

若未配置，release 变体将构建为未签名 APK。也可以用 Android Studio 打开项目根目录，等 Gradle 同步完成后执行 Build > Make Project，Cargo 会作为 cargoBuild 的一部分运行，并把 JNI 库合并进 APK。

注意事项

• 最低支持 minSdk 24（Android 7.0），targetSdk / compileSdk 为 36（Android 16）。
• 支持的 ABI：armeabi-v7a、arm64-v8a、x86、x86_64。
• AGP 固定为 8.1.2、Kotlin 为 1.9.10，版本集中写在 gradle/libs.versions.toml；升级 AGP 前需确认与 rust-android-gradle 0.9.6 的 mergeJniLibFolders 重复资源问题。
• 项目内仍保留 iptables 时代的 cpp/libevent、cpp/redsocks 目录，计划在后续重构中移除，redsocks 路径已不再从 Kotlin 调用。
• 项目使用 GPLv3 许可证。

---

本作品整理自 GitHub 开源项目 madeye/proxydroid，原作者 @madeye。中文介绍由 AI 根据项目 README 整理，以原仓库为准。