# madeye/proxydroid architecture

> Architecture diagram of the GitHub repository madeye/proxydroid, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/madeye/proxydroid
- Repository: https://github.com/madeye/proxydroid

## Overview

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: [`app/src/main/rust/proxydroid-tun2socks/src/tun2socks.rs`](https://github.com/madeye/proxydroid/blob/master/app/src/main/rust/proxydroid-tun2socks/src/tun2socks.rs) (TUN packet forwarding), [`app/src/main/java/org/proxydroid/ui/MainScreen.kt`](https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/ui/MainScreen.kt) (Settings UI), [`app/src/main/java/org/proxydroid/ProxyDroid.kt`](https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/ProxyDroid.kt) (Main activity), [`app/src/main/java/org/proxydroid/utils/ProxyController.kt`](https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/utils/ProxyController.kt) (VPN controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_settings["Profiles &amp; Settings"]
  node_ui["Settings UI<br/>[MainScreen.kt]"]
  node_viewmodel["Profile view model<br/>[MainViewModel.kt]"]
  node_profile["Profile model<br/>[Profile.kt]"]
  node_bypasslist["Address bypass editor"]
  node_appmanager["App selector<br/>[AppManager.kt]"]
  node_constraints["Bypass presets<br/>[Constraints.kt]"]
end

subgraph group_android["Android VPN Runtime"]
  node_activity["Main activity<br/>[ProxyDroid.kt]"]
  node_controller["VPN controller<br/>[ProxyController.kt]"]
  node_vpn["VPN service"]
  node_state["Runtime status<br/>[Utils.kt]"]
  node_tunhelper["JNI bridge helper<br/>[Tun2SocksHelper.kt]"]
end

subgraph group_bridge["Packet Proxy Bridge"]
  node_tun["TUN packet forwarding<br/>[tun2socks.rs]"]
end

subgraph group_support["DNS &amp; Support"]
  node_dns["DNS-over-HTTPS<br/>[doh_client.rs]"]
  node_dnstable[("DNS cache table<br/>[dns_table.rs]")]
  node_logging["Bridge logging<br/>[logging.rs]"]
  node_protect["Socket protection<br/>[protect.rs]"]
end

node_user(("Device user"))
node_upstream(("Proxy endpoint"))

node_user -->|"configures"| node_ui
node_ui -->|"edits profiles"| node_viewmodel
node_viewmodel -->|"loads and updates"| node_profile
node_ui -->|"opens selector"| node_appmanager
node_ui -->|"opens editor"| node_bypasslist
node_bypasslist -->|"uses presets"| node_constraints
node_user -->|"starts connection"| node_activity
node_activity -->|"reads profile state"| node_viewmodel
node_activity -->|"builds service extras"| node_controller
node_controller -->|"serializes settings"| node_profile
node_controller -->|"starts or stops"| node_vpn
node_vpn -->|"launches bridge"| node_tunhelper
node_vpn -.->|"updates status"| node_state
node_activity -->|"observes status"| node_state
node_tunhelper -.->|"invokes JNI"| node_tun
node_tun -->|"forwards TCP flows"| node_upstream
node_tun -->|"resolves DNS"| node_dns
node_dns -->|"tunnels requests"| node_upstream
node_tun -->|"updates DNS records"| node_dnstable
node_tun -->|"logs bridge events"| node_logging
node_protect -->|"logs protection"| node_logging

click node_ui "https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/ui/MainScreen.kt"
click node_viewmodel "https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/ui/MainViewModel.kt"
click node_profile "https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/Profile.kt"
click node_bypasslist "https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/BypassListActivity.kt"
click node_appmanager "https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/AppManager.kt"
click node_constraints "https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/utils/Constraints.kt"
click node_activity "https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/ProxyDroid.kt"
click node_controller "https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/utils/ProxyController.kt"
click node_vpn "https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/ProxyDroidVpnService.kt"
click node_state "https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/utils/Utils.kt"
click node_tunhelper "https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/utils/Tun2SocksHelper.kt"
click node_tun "https://github.com/madeye/proxydroid/blob/master/app/src/main/rust/proxydroid-tun2socks/src/tun2socks.rs"
click node_dns "https://github.com/madeye/proxydroid/blob/master/app/src/main/rust/proxydroid-tun2socks/src/doh_client.rs"
click node_dnstable "https://github.com/madeye/proxydroid/blob/master/app/src/main/rust/proxydroid-tun2socks/src/dns_table.rs"
click node_logging "https://github.com/madeye/proxydroid/blob/master/app/src/main/rust/proxydroid-tun2socks/src/logging.rs"
click node_protect "https://github.com/madeye/proxydroid/blob/master/app/src/main/rust/proxydroid-tun2socks/src/protect.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_ui,node_viewmodel,node_profile,node_bypasslist,node_appmanager,node_constraints,node_user toneBlue
class node_activity,node_controller,node_vpn,node_state,node_tunhelper toneAmber
class node_tun toneMint
class node_dns,node_dnstable,node_logging,node_protect toneRose
class node_upstream toneIndigo
```

## Components

### Profiles & Settings

- [Settings UI](https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/ui/MainScreen.kt): `app/src/main/java/org/proxydroid/ui/MainScreen.kt`
- [Profile view model](https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/ui/MainViewModel.kt): `app/src/main/java/org/proxydroid/ui/MainViewModel.kt`
- [Profile model](https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/Profile.kt): `app/src/main/java/org/proxydroid/Profile.kt`
- [Address bypass editor](https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/BypassListActivity.kt): `app/src/main/java/org/proxydroid/BypassListActivity.kt`
- [App selector](https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/AppManager.kt): `app/src/main/java/org/proxydroid/AppManager.kt`
- [Bypass presets](https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/utils/Constraints.kt): `app/src/main/java/org/proxydroid/utils/Constraints.kt`

### Android VPN Runtime

- [Main activity](https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/ProxyDroid.kt): `app/src/main/java/org/proxydroid/ProxyDroid.kt`
- [VPN controller](https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/utils/ProxyController.kt): `app/src/main/java/org/proxydroid/utils/ProxyController.kt`
- [VPN service](https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/ProxyDroidVpnService.kt): `app/src/main/java/org/proxydroid/ProxyDroidVpnService.kt`
- [Runtime status](https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/utils/Utils.kt): `app/src/main/java/org/proxydroid/utils/Utils.kt`
- [JNI bridge helper](https://github.com/madeye/proxydroid/blob/master/app/src/main/java/org/proxydroid/utils/Tun2SocksHelper.kt): `app/src/main/java/org/proxydroid/utils/Tun2SocksHelper.kt`

### Packet Proxy Bridge

- [TUN packet forwarding](https://github.com/madeye/proxydroid/blob/master/app/src/main/rust/proxydroid-tun2socks/src/tun2socks.rs): `app/src/main/rust/proxydroid-tun2socks/src/tun2socks.rs`

### DNS & Support

- [DNS-over-HTTPS](https://github.com/madeye/proxydroid/blob/master/app/src/main/rust/proxydroid-tun2socks/src/doh_client.rs): `app/src/main/rust/proxydroid-tun2socks/src/doh_client.rs`
- [DNS cache table](https://github.com/madeye/proxydroid/blob/master/app/src/main/rust/proxydroid-tun2socks/src/dns_table.rs): `app/src/main/rust/proxydroid-tun2socks/src/dns_table.rs`
- [Bridge logging](https://github.com/madeye/proxydroid/blob/master/app/src/main/rust/proxydroid-tun2socks/src/logging.rs): `app/src/main/rust/proxydroid-tun2socks/src/logging.rs`
- [Socket protection](https://github.com/madeye/proxydroid/blob/master/app/src/main/rust/proxydroid-tun2socks/src/protect.rs): `app/src/main/rust/proxydroid-tun2socks/src/protect.rs`

### Other components

- **Device user**
- **Proxy endpoint**

## Connections

- Device user → Settings UI: configures (evidence: `README.md`)
- Settings UI → Profile view model: edits profiles (evidence: `app/src/main/java/org/proxydroid/ProxyDroid.kt`)
- Profile view model → Profile model: loads and updates (evidence: `app/src/main/java/org/proxydroid/ui/MainViewModel.kt`)
- Settings UI → App selector: opens selector (evidence: `app/src/main/java/org/proxydroid/ui/MainScreen.kt`)
- Settings UI → Address bypass editor: opens editor (evidence: `app/src/main/java/org/proxydroid/ui/MainScreen.kt`)
- Address bypass editor → Bypass presets: uses presets (evidence: `app/src/main/java/org/proxydroid/BypassListActivity.kt`)
- Device user → Main activity: starts connection (evidence: `app/src/main/java/org/proxydroid/ProxyDroid.kt`)
- Main activity → Profile view model: reads profile state (evidence: `app/src/main/java/org/proxydroid/ProxyDroid.kt`)
- Main activity → VPN controller: builds service extras (evidence: `app/src/main/java/org/proxydroid/ProxyDroid.kt`)
- VPN controller → Profile model: serializes settings (evidence: `app/src/main/java/org/proxydroid/utils/ProxyController.kt`)
- VPN controller → VPN service: starts or stops (evidence: `app/src/main/java/org/proxydroid/utils/ProxyController.kt`)
- VPN service → JNI bridge helper: launches bridge (evidence: `app/src/main/java/org/proxydroid/ProxyDroidVpnService.kt`)
- VPN service → Runtime status: updates status (evidence: `app/src/main/java/org/proxydroid/ProxyDroidVpnService.kt`)
- Main activity → Runtime status: observes status (evidence: `app/src/main/java/org/proxydroid/ProxyDroid.kt`)
- JNI bridge helper → TUN packet forwarding: invokes JNI (evidence: `README.md`)
- TUN packet forwarding → Proxy endpoint: forwards TCP flows (evidence: `README.md`)
- TUN packet forwarding → DNS-over-HTTPS: resolves DNS (evidence: `app/src/main/rust/proxydroid-tun2socks/src/tun2socks.rs`)
- DNS-over-HTTPS → Proxy endpoint: tunnels requests (evidence: `app/src/main/rust/proxydroid-tun2socks/src/doh_client.rs`)
- TUN packet forwarding → DNS cache table: updates DNS records (evidence: `app/src/main/rust/proxydroid-tun2socks/src/tun2socks.rs`)
- TUN packet forwarding → Bridge logging: logs bridge events (evidence: `app/src/main/rust/proxydroid-tun2socks/src/tun2socks.rs`)
- Socket protection → Bridge logging: logs protection (evidence: `app/src/main/rust/proxydroid-tun2socks/src/protect.rs`)
