How tokyoxpa3/5g-proxy-pro works
5G Proxy Pro is an Android app that shares the phone’s cellular connection through a LAN-only SOCKS5 proxy. The main workflow runs from user controls in the activity to the foreground service, which requests and maintains cellular connectivity and starts the native proxy; client traffic then crosses JNI to sockets bound to that network. The README also documents TCP, UDP, UDP-in-TCP, optional authentication, health recovery, and self-test/diagnostics. Some subsystem links are documented rather than visible in sampled implementation excerpts.
Main entry points: Socks5ProxyService.kt Proxy service · simple-socks5.c SOCKS5 engine · DebugActivity.kt Control UI · jni_bridge.c JNI bridge
Components 23
Android app
- Control UI
app/src/main/java/com/tokyoxpa3/androidproxy/DebugActivity.kt - Proxy service
app/src/main/java/com/tokyoxpa3/androidproxy/Socks5ProxyService.kt - Power permissions
app/src/main/java/com/tokyoxpa3/androidproxy/PowerPermissionHelper.kt
Cellular networking
- Cellular manager
app/src/main/java/com/tokyoxpa3/androidproxy/network/CellularNetworkManager.kt - Health classifier
app/src/main/java/com/tokyoxpa3/androidproxy/network/NetworkHealthClassifier.kt - LAN address discovery
app/src/main/java/com/tokyoxpa3/androidproxy/network/HotspotManager.kt - Public IP check
app/src/main/java/com/tokyoxpa3/androidproxy/network/PublicIPChecker.kt - DNS cache
app/src/main/java/com/tokyoxpa3/androidproxy/DnsCache.kt - Address racing
app/src/main/java/com/tokyoxpa3/androidproxy/HappyEyeballs.kt - IP literal check
app/src/main/java/com/tokyoxpa3/androidproxy/IpLiteral.kt
JNI and native proxy
- Native API
app/src/main/java/com/tokyoxpa3/androidproxy/NativeEngine.kt - JNI bridge
app/src/main/cpp/jni_bridge.c - SOCKS5 engine
app/src/main/cpp/simple-socks5.c - Protocol codec
app/src/main/cpp/socks5_protocol.c - TCP forwarding
app/src/main/cpp/conn_forward.c - Connection state
app/src/main/cpp/conn_state.c - UDP relay
app/src/main/cpp/udp_conn.c - UDP DNS support
app/src/main/cpp/udp_dns.c - Ghost cleanup
app/src/main/cpp/ghost_purge.c
Testing and diagnostics
- Proxy self-test
app/src/main/java/com/tokyoxpa3/androidproxy/SelfTest.kt - Test protocol
app/src/main/java/com/tokyoxpa3/androidproxy/Socks5ClientProtocol.kt
Other components
- Operator
- Internet targets
Connections 24
- Operator → Control UI: controls
- Control UI → Proxy service: starts and stops
app/src/main/java/com/tokyoxpa3/androidproxy/DebugActivity.kt - Control UI → Proxy self-test: runs
app/src/main/java/com/tokyoxpa3/androidproxy/DebugActivity.kt - Control UI → Power permissions: guides
app/src/main/java/com/tokyoxpa3/androidproxy/DebugActivity.kt - Proxy service → Cellular manager: requests network
app/src/main/java/com/tokyoxpa3/androidproxy/Socks5ProxyService.kt - Proxy service → Health classifier: classifies health
app/src/main/java/com/tokyoxpa3/androidproxy/Socks5ProxyService.kt - Proxy service → Native API: starts engine
app/src/main/java/com/tokyoxpa3/androidproxy/Socks5ProxyService.kt - Proxy service → LAN address discovery: discovers LAN
app/src/main/java/com/tokyoxpa3/androidproxy/DebugActivity.kt - Control UI → Public IP check: checks address
app/src/main/java/com/tokyoxpa3/androidproxy/DebugActivity.kt - Proxy service → DNS cache: uses cache
app/src/main/java/com/tokyoxpa3/androidproxy/Socks5ProxyService.kt - Proxy service → Address racing: orders addresses
app/src/main/java/com/tokyoxpa3/androidproxy/Socks5ProxyService.kt - Proxy service → IP literal check: checks host
app/src/main/java/com/tokyoxpa3/androidproxy/Socks5ProxyService.kt - Native API → JNI bridge: calls native
- JNI bridge → Native API: calls callbacks
app/src/main/cpp/jni_bridge.c - JNI bridge → SOCKS5 engine: dispatches
- SOCKS5 engine → Internet targets: relays traffic
- SOCKS5 engine → Protocol codec: uses codec
app/src/main/cpp/simple-socks5.c - SOCKS5 engine → TCP forwarding: uses forwarding
app/src/main/cpp/simple-socks5.c - SOCKS5 engine → Connection state: uses state
app/src/main/cpp/simple-socks5.c - SOCKS5 engine → UDP relay: starts relay
app/src/main/cpp/simple-socks5.c - SOCKS5 engine → UDP DNS support: uses DNS support
app/src/main/cpp/simple-socks5.c - SOCKS5 engine → Ghost cleanup: uses cleanup
app/src/main/cpp/simple-socks5.c - Proxy self-test → Test protocol: encodes requests
app/src/main/java/com/tokyoxpa3/androidproxy/SelfTest.kt - Proxy self-test → Proxy service: tests proxy path