# wresource/hxmy-proxy architecture

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

- Interactive diagram: https://gitdiagram.com/wresource/hxmy-proxy
- Repository: https://github.com/wresource/hxmy-proxy

## Overview

hxmy proxy turns an Android phone into a local HTTP/HTTPS CONNECT, SOCKS5, and PAC gateway for nearby devices. The main workflow is: configure sharing and egress, start the foreground service, accept client connections, decide whether each target is proxied, direct-routed, or blocked, then relay permitted traffic and expose status and diagnostics. Rules, traffic history, settings backup, and monitoring are supporting product branches. Runtime wiring beyond the excerpts is represented only where the README documents it; unsampled implementation details are not inferred.

Main entry points: [`app/src/main/java/com/mzstd/hxmyproxy/data/repository/ProxyServerRepository.kt`](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/data/repository/ProxyServerRepository.kt) (Proxy runtime), [`app/src/main/java/com/mzstd/hxmyproxy/ui`](https://github.com/wresource/hxmy-proxy/tree/master/app/src/main/java/com/mzstd/hxmyproxy/ui) (Product screens), [`app/src/main/java/com/mzstd/hxmyproxy/core/rules/RuleEngine.kt`](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/rules/RuleEngine.kt) (Rule engine), [`app/src/main/java/com/mzstd/hxmyproxy/core/proxy/OutboundConnector.kt`](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/proxy/OutboundConnector.kt) (Outbound connector)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Android app"]
  node_activity["App entry<br/>[MainActivity.kt]"]
  node_screens["Product screens"]
  node_viewmodel["UI state<br/>[MainViewModel.kt]"]
  node_service["Foreground service"]
end

subgraph group_gateway["Proxy gateway"]
  node_proxyrepo["Proxy runtime"]
  node_http["HTTP proxy<br/>[HttpProxyServer.kt]"]
  node_socks["SOCKS5 proxy"]
  node_pac["PAC service<br/>[PacServer.kt]"]
  node_relay["NIO relay<br/>[NioRelayReactor.kt]"]
  node_connector["Outbound connector"]
  node_network["Network selection"]
end

subgraph group_policy["Rules and settings"]
  node_settings[("Settings store")]
  node_ruledata["Rule entries<br/>[RuleEntry.kt]"]
  node_rulesrepo["Rule repository<br/>[RuleRepository.kt]"]
  node_catalog["Built-in catalog<br/>[RuleCatalog.kt]"]
  node_ruleengine["Rule engine<br/>[RuleEngine.kt]"]
end

subgraph group_observability["Monitoring"]
  node_history[("Traffic history")]
  node_endpointhistory[("Endpoint history")]
  node_evlog["Structured events<br/>[Ev.kt]"]
  node_filelog[("Local log files<br/>[FileLog.kt]")]
end

node_operator(("Phone operator"))
node_clients(("LAN clients"))
node_uplink(("Phone uplink"))
node_vpn(("System VPN"))

node_operator -->|"opens app"| node_activity
node_activity -->|"shows"| node_screens
node_screens -->|"edits settings"| node_viewmodel
node_viewmodel -->|"updates"| node_settings
node_settings -->|"configures"| node_service
node_operator -->|"starts sharing"| node_service
node_service -->|"starts runtime"| node_proxyrepo
node_proxyrepo -->|"registers server"| node_http
node_proxyrepo -->|"registers server"| node_socks
node_proxyrepo -->|"registers server"| node_pac
node_clients -->|"sends requests"| node_http
node_clients -->|"sends requests"| node_socks
node_clients -->|"fetches configuration"| node_pac
node_http -->|"checks target"| node_ruleengine
node_socks -->|"checks target"| node_ruleengine
node_ruleengine -->|"selects route"| node_connector
node_proxyrepo -->|"rebuilds rules"| node_ruleengine
node_rulesrepo -->|"builds snapshot"| node_ruleengine
node_rulesrepo -->|"loads groups"| node_catalog
node_screens -->|"edits rules"| node_rulesrepo
node_settings -->|"persists rules"| node_ruledata
node_connector -.->|"binds egress"| node_network
node_connector -->|"relays outbound"| node_uplink
node_connector -->|"may use tunnel"| node_vpn
node_http -.->|"relays streams"| node_relay
node_proxyrepo -->|"records usage"| node_history
node_screens -->|"views usage"| node_history
node_screens -->|"views endpoints"| node_endpointhistory
node_proxyrepo -->|"emits events"| node_evlog
node_evlog -.->|"writes logs"| node_filelog
node_screens -->|"views diagnostics"| node_filelog

click node_activity "https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/MainActivity.kt"
click node_screens "https://github.com/wresource/hxmy-proxy/tree/master/app/src/main/java/com/mzstd/hxmyproxy/ui"
click node_viewmodel "https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/ui/MainViewModel.kt"
click node_service "https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/service/ProxyForegroundService.kt"
click node_settings "https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/data/repository/SettingsRepository.kt"
click node_ruledata "https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/model/RuleEntry.kt"
click node_rulesrepo "https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/data/repository/RuleRepository.kt"
click node_catalog "https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/rules/RuleCatalog.kt"
click node_ruleengine "https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/rules/RuleEngine.kt"
click node_proxyrepo "https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/data/repository/ProxyServerRepository.kt"
click node_http "https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/proxy/HttpProxyServer.kt"
click node_socks "https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/proxy/Socks5ProxyServer.kt"
click node_pac "https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/proxy/PacServer.kt"
click node_relay "https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/proxy/NioRelayReactor.kt"
click node_connector "https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/proxy/OutboundConnector.kt"
click node_network "https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/network/UnderlyingNetworkProvider.kt"
click node_history "https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/stats/TrafficHistoryStore.kt"
click node_endpointhistory "https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/data/repository/EndpointHistoryRepository.kt"
click node_evlog "https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/log/Ev.kt"
click node_filelog "https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/log/FileLog.kt"

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_activity,node_screens,node_viewmodel,node_service,node_clients toneBlue
class node_proxyrepo,node_http,node_socks,node_pac,node_relay,node_connector,node_network toneAmber
class node_settings,node_ruledata,node_rulesrepo,node_catalog,node_ruleengine toneMint
class node_history,node_endpointhistory,node_evlog,node_filelog toneRose
class node_operator,node_uplink,node_vpn toneIndigo
```

## Components

### Android app

- [App entry](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/MainActivity.kt): `app/src/main/java/com/mzstd/hxmyproxy/MainActivity.kt`
- [Product screens](https://github.com/wresource/hxmy-proxy/tree/master/app/src/main/java/com/mzstd/hxmyproxy/ui): `app/src/main/java/com/mzstd/hxmyproxy/ui`
- [UI state](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/ui/MainViewModel.kt): `app/src/main/java/com/mzstd/hxmyproxy/ui/MainViewModel.kt`
- [Foreground service](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/service/ProxyForegroundService.kt): `app/src/main/java/com/mzstd/hxmyproxy/service/ProxyForegroundService.kt`

### Proxy gateway

- [Proxy runtime](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/data/repository/ProxyServerRepository.kt): `app/src/main/java/com/mzstd/hxmyproxy/data/repository/ProxyServerRepository.kt`
- [HTTP proxy](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/proxy/HttpProxyServer.kt): `app/src/main/java/com/mzstd/hxmyproxy/core/proxy/HttpProxyServer.kt`
- [SOCKS5 proxy](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/proxy/Socks5ProxyServer.kt): `app/src/main/java/com/mzstd/hxmyproxy/core/proxy/Socks5ProxyServer.kt`
- [PAC service](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/proxy/PacServer.kt): `app/src/main/java/com/mzstd/hxmyproxy/core/proxy/PacServer.kt`
- [NIO relay](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/proxy/NioRelayReactor.kt): `app/src/main/java/com/mzstd/hxmyproxy/core/proxy/NioRelayReactor.kt`
- [Outbound connector](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/proxy/OutboundConnector.kt): `app/src/main/java/com/mzstd/hxmyproxy/core/proxy/OutboundConnector.kt`
- [Network selection](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/network/UnderlyingNetworkProvider.kt): `app/src/main/java/com/mzstd/hxmyproxy/core/network/UnderlyingNetworkProvider.kt`

### Rules and settings

- [Settings store](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/data/repository/SettingsRepository.kt): `app/src/main/java/com/mzstd/hxmyproxy/data/repository/SettingsRepository.kt`
- [Rule entries](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/model/RuleEntry.kt): `app/src/main/java/com/mzstd/hxmyproxy/core/model/RuleEntry.kt`
- [Rule repository](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/data/repository/RuleRepository.kt): `app/src/main/java/com/mzstd/hxmyproxy/data/repository/RuleRepository.kt`
- [Built-in catalog](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/rules/RuleCatalog.kt): `app/src/main/java/com/mzstd/hxmyproxy/core/rules/RuleCatalog.kt`
- [Rule engine](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/rules/RuleEngine.kt): `app/src/main/java/com/mzstd/hxmyproxy/core/rules/RuleEngine.kt`

### Monitoring

- [Traffic history](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/stats/TrafficHistoryStore.kt): `app/src/main/java/com/mzstd/hxmyproxy/core/stats/TrafficHistoryStore.kt`
- [Endpoint history](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/data/repository/EndpointHistoryRepository.kt): `app/src/main/java/com/mzstd/hxmyproxy/data/repository/EndpointHistoryRepository.kt`
- [Structured events](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/log/Ev.kt): `app/src/main/java/com/mzstd/hxmyproxy/core/log/Ev.kt`
- [Local log files](https://github.com/wresource/hxmy-proxy/blob/master/app/src/main/java/com/mzstd/hxmyproxy/core/log/FileLog.kt): `app/src/main/java/com/mzstd/hxmyproxy/core/log/FileLog.kt`

### Other components

- **Phone operator**
- **LAN clients**
- **Phone uplink**
- **System VPN**

## Connections

- Phone operator → App entry: opens app (evidence: `app/src/main/java/com/mzstd/hxmyproxy/MainActivity.kt`)
- App entry → Product screens: shows (evidence: `app/src/main/java/com/mzstd/hxmyproxy/MainActivity.kt`)
- Product screens → UI state: edits settings (evidence: `app/src/main/java/com/mzstd/hxmyproxy/ui/dashboard/DashboardScreen.kt`)
- UI state → Settings store: updates (evidence: `app/src/main/java/com/mzstd/hxmyproxy/ui/MainViewModel.kt`)
- Settings store → Foreground service: configures (evidence: `app/src/main/java/com/mzstd/hxmyproxy/service/ProxyForegroundService.kt`)
- Phone operator → Foreground service: starts sharing (evidence: `app/src/main/java/com/mzstd/hxmyproxy/service/ProxyForegroundService.kt`)
- Foreground service → Proxy runtime: starts runtime (evidence: `app/src/main/java/com/mzstd/hxmyproxy/service/ProxyForegroundService.kt`)
- Proxy runtime → HTTP proxy: registers server (evidence: `app/src/main/java/com/mzstd/hxmyproxy/data/repository/ProxyServerRepository.kt`)
- Proxy runtime → SOCKS5 proxy: registers server (evidence: `README.md`)
- Proxy runtime → PAC service: registers server (evidence: `README.md`)
- LAN clients → HTTP proxy: sends requests (evidence: `README.md`)
- LAN clients → SOCKS5 proxy: sends requests (evidence: `README.md`)
- LAN clients → PAC service: fetches configuration (evidence: `README.md`)
- HTTP proxy → Rule engine: checks target (evidence: `README.md`)
- SOCKS5 proxy → Rule engine: checks target (evidence: `README.md`)
- Rule engine → Outbound connector: selects route (evidence: `README.md`)
- Proxy runtime → Rule engine: rebuilds rules (evidence: `app/src/main/java/com/mzstd/hxmyproxy/data/repository/ProxyServerRepository.kt`)
- Rule repository → Rule engine: builds snapshot (evidence: `app/src/main/java/com/mzstd/hxmyproxy/data/repository/RuleRepository.kt`)
- Rule repository → Built-in catalog: loads groups (evidence: `app/src/main/java/com/mzstd/hxmyproxy/data/repository/RuleRepository.kt`)
- Product screens → Rule repository: edits rules (evidence: `app/src/main/java/com/mzstd/hxmyproxy/ui/rules/RuleSetManagerScreen.kt`)
- Settings store → Rule entries: persists rules (evidence: `app/src/main/java/com/mzstd/hxmyproxy/data/repository/SettingsRepository.kt`)
- Outbound connector → Network selection: binds egress
- Outbound connector → Phone uplink: relays outbound (evidence: `README.md`)
- Outbound connector → System VPN: may use tunnel (evidence: `README.md`)
- HTTP proxy → NIO relay: relays streams
- Proxy runtime → Traffic history: records usage (evidence: `app/src/main/java/com/mzstd/hxmyproxy/data/repository/ProxyServerRepository.kt`)
- Product screens → Traffic history: views usage (evidence: `README.md`)
- Product screens → Endpoint history: views endpoints (evidence: `README.md`)
- Proxy runtime → Structured events: emits events (evidence: `app/src/main/java/com/mzstd/hxmyproxy/data/repository/ProxyServerRepository.kt`)
- Structured events → Local log files: writes logs (evidence: `app/src/main/java/com/mzstd/hxmyproxy/core/log/Ev.kt`)
- Product screens → Local log files: views diagnostics (evidence: `README.md`)
