How wresource/hxmy-proxy works
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: ProxyServerRepository.kt Proxy runtime · ui Product screens · RuleEngine.kt Rule engine · OutboundConnector.kt Outbound connector
Components 24
Android app
- App entry
app/src/main/java/com/mzstd/hxmyproxy/MainActivity.kt - Product screens
app/src/main/java/com/mzstd/hxmyproxy/ui - UI state
app/src/main/java/com/mzstd/hxmyproxy/ui/MainViewModel.kt - Foreground service
app/src/main/java/com/mzstd/hxmyproxy/service/ProxyForegroundService.kt
Proxy gateway
- Proxy runtime
app/src/main/java/com/mzstd/hxmyproxy/data/repository/ProxyServerRepository.kt - HTTP proxy
app/src/main/java/com/mzstd/hxmyproxy/core/proxy/HttpProxyServer.kt - SOCKS5 proxy
app/src/main/java/com/mzstd/hxmyproxy/core/proxy/Socks5ProxyServer.kt - PAC service
app/src/main/java/com/mzstd/hxmyproxy/core/proxy/PacServer.kt - NIO relay
app/src/main/java/com/mzstd/hxmyproxy/core/proxy/NioRelayReactor.kt - Outbound connector
app/src/main/java/com/mzstd/hxmyproxy/core/proxy/OutboundConnector.kt - Network selection
app/src/main/java/com/mzstd/hxmyproxy/core/network/UnderlyingNetworkProvider.kt
Rules and settings
- Settings store
app/src/main/java/com/mzstd/hxmyproxy/data/repository/SettingsRepository.kt - Rule entries
app/src/main/java/com/mzstd/hxmyproxy/core/model/RuleEntry.kt - Rule repository
app/src/main/java/com/mzstd/hxmyproxy/data/repository/RuleRepository.kt - Built-in catalog
app/src/main/java/com/mzstd/hxmyproxy/core/rules/RuleCatalog.kt - Rule engine
app/src/main/java/com/mzstd/hxmyproxy/core/rules/RuleEngine.kt
Monitoring
- Traffic history
app/src/main/java/com/mzstd/hxmyproxy/core/stats/TrafficHistoryStore.kt - Endpoint history
app/src/main/java/com/mzstd/hxmyproxy/data/repository/EndpointHistoryRepository.kt - Structured events
app/src/main/java/com/mzstd/hxmyproxy/core/log/Ev.kt - Local log files
app/src/main/java/com/mzstd/hxmyproxy/core/log/FileLog.kt
Other components
- Phone operator
- LAN clients
- Phone uplink
- System VPN
Connections 31
- Phone operator → App entry: opens app
app/src/main/java/com/mzstd/hxmyproxy/MainActivity.kt - App entry → Product screens: shows
app/src/main/java/com/mzstd/hxmyproxy/MainActivity.kt - Product screens → UI state: edits settings
app/src/main/java/com/mzstd/hxmyproxy/ui/dashboard/DashboardScreen.kt - UI state → Settings store: updates
app/src/main/java/com/mzstd/hxmyproxy/ui/MainViewModel.kt - Settings store → Foreground service: configures
app/src/main/java/com/mzstd/hxmyproxy/service/ProxyForegroundService.kt - Phone operator → Foreground service: starts sharing
app/src/main/java/com/mzstd/hxmyproxy/service/ProxyForegroundService.kt - Foreground service → Proxy runtime: starts runtime
app/src/main/java/com/mzstd/hxmyproxy/service/ProxyForegroundService.kt - Proxy runtime → HTTP proxy: registers server
app/src/main/java/com/mzstd/hxmyproxy/data/repository/ProxyServerRepository.kt - Proxy runtime → SOCKS5 proxy: registers server
README.md - Proxy runtime → PAC service: registers server
README.md - LAN clients → HTTP proxy: sends requests
README.md - LAN clients → SOCKS5 proxy: sends requests
README.md - LAN clients → PAC service: fetches configuration
README.md - HTTP proxy → Rule engine: checks target
README.md - SOCKS5 proxy → Rule engine: checks target
README.md - Rule engine → Outbound connector: selects route
README.md - Proxy runtime → Rule engine: rebuilds rules
app/src/main/java/com/mzstd/hxmyproxy/data/repository/ProxyServerRepository.kt - Rule repository → Rule engine: builds snapshot
app/src/main/java/com/mzstd/hxmyproxy/data/repository/RuleRepository.kt - Rule repository → Built-in catalog: loads groups
app/src/main/java/com/mzstd/hxmyproxy/data/repository/RuleRepository.kt - Product screens → Rule repository: edits rules
app/src/main/java/com/mzstd/hxmyproxy/ui/rules/RuleSetManagerScreen.kt - Settings store → Rule entries: persists rules
app/src/main/java/com/mzstd/hxmyproxy/data/repository/SettingsRepository.kt - Outbound connector → Network selection: binds egress
- Outbound connector → Phone uplink: relays outbound
README.md - Outbound connector → System VPN: may use tunnel
README.md - HTTP proxy → NIO relay: relays streams
- Proxy runtime → Traffic history: records usage
app/src/main/java/com/mzstd/hxmyproxy/data/repository/ProxyServerRepository.kt - Product screens → Traffic history: views usage
README.md - Product screens → Endpoint history: views endpoints
README.md - Proxy runtime → Structured events: emits events
app/src/main/java/com/mzstd/hxmyproxy/data/repository/ProxyServerRepository.kt - Structured events → Local log files: writes logs
app/src/main/java/com/mzstd/hxmyproxy/core/log/Ev.kt - Product screens → Local log files: views diagnostics
README.md