How madeye/proxydroid works
ProxyDroid is an Android VPN-based proxy client. Users configure and select a profile in the Compose UI, grant VPN consent, and start a VpnService that establishes a TUN interface and launches the Rust packet-to-proxy bridge; the bridge forwards traffic through the configured upstream. The README also documents per-app bypass and SOCKS5/HTTP CONNECT support. Several service, view-model, and Rust modules are indexed but only partly sampled; uncertain internal links are omitted rather than inferred.
Main entry points: tun2socks.rs TUN packet forwarding · MainScreen.kt Settings UI · ProxyDroid.kt Main activity · ProxyController.kt VPN controller
Components 18
Profiles & Settings
- Settings UI
app/src/main/java/org/proxydroid/ui/MainScreen.kt - Profile view model
app/src/main/java/org/proxydroid/ui/MainViewModel.kt - Profile model
app/src/main/java/org/proxydroid/Profile.kt - Address bypass editor
app/src/main/java/org/proxydroid/BypassListActivity.kt - App selector
app/src/main/java/org/proxydroid/AppManager.kt - Bypass presets
app/src/main/java/org/proxydroid/utils/Constraints.kt
Android VPN Runtime
- Main activity
app/src/main/java/org/proxydroid/ProxyDroid.kt - VPN controller
app/src/main/java/org/proxydroid/utils/ProxyController.kt - VPN service
app/src/main/java/org/proxydroid/ProxyDroidVpnService.kt - Runtime status
app/src/main/java/org/proxydroid/utils/Utils.kt - JNI bridge helper
app/src/main/java/org/proxydroid/utils/Tun2SocksHelper.kt
Packet Proxy Bridge
- TUN packet forwarding
app/src/main/rust/proxydroid-tun2socks/src/tun2socks.rs
DNS & Support
- DNS-over-HTTPS
app/src/main/rust/proxydroid-tun2socks/src/doh_client.rs - DNS cache table
app/src/main/rust/proxydroid-tun2socks/src/dns_table.rs - Bridge logging
app/src/main/rust/proxydroid-tun2socks/src/logging.rs - Socket protection
app/src/main/rust/proxydroid-tun2socks/src/protect.rs
Other components
- Device user
- Proxy endpoint
Connections 21
- Device user → Settings UI: configures
README.md - Settings UI → Profile view model: edits profiles
app/src/main/java/org/proxydroid/ProxyDroid.kt - Profile view model → Profile model: loads and updates
app/src/main/java/org/proxydroid/ui/MainViewModel.kt - Settings UI → App selector: opens selector
app/src/main/java/org/proxydroid/ui/MainScreen.kt - Settings UI → Address bypass editor: opens editor
app/src/main/java/org/proxydroid/ui/MainScreen.kt - Address bypass editor → Bypass presets: uses presets
app/src/main/java/org/proxydroid/BypassListActivity.kt - Device user → Main activity: starts connection
app/src/main/java/org/proxydroid/ProxyDroid.kt - Main activity → Profile view model: reads profile state
app/src/main/java/org/proxydroid/ProxyDroid.kt - Main activity → VPN controller: builds service extras
app/src/main/java/org/proxydroid/ProxyDroid.kt - VPN controller → Profile model: serializes settings
app/src/main/java/org/proxydroid/utils/ProxyController.kt - VPN controller → VPN service: starts or stops
app/src/main/java/org/proxydroid/utils/ProxyController.kt - VPN service → JNI bridge helper: launches bridge
app/src/main/java/org/proxydroid/ProxyDroidVpnService.kt - VPN service → Runtime status: updates status
app/src/main/java/org/proxydroid/ProxyDroidVpnService.kt - Main activity → Runtime status: observes status
app/src/main/java/org/proxydroid/ProxyDroid.kt - JNI bridge helper → TUN packet forwarding: invokes JNI
README.md - TUN packet forwarding → Proxy endpoint: forwards TCP flows
README.md - TUN packet forwarding → DNS-over-HTTPS: resolves DNS
app/src/main/rust/proxydroid-tun2socks/src/tun2socks.rs - DNS-over-HTTPS → Proxy endpoint: tunnels requests
app/src/main/rust/proxydroid-tun2socks/src/doh_client.rs - TUN packet forwarding → DNS cache table: updates DNS records
app/src/main/rust/proxydroid-tun2socks/src/tun2socks.rs - TUN packet forwarding → Bridge logging: logs bridge events
app/src/main/rust/proxydroid-tun2socks/src/tun2socks.rs - Socket protection → Bridge logging: logs protection
app/src/main/rust/proxydroid-tun2socks/src/protect.rs