MasterAliDns/android-native/README.md

Android Native Slice

This folder contains a separate Kotlin/Android rewrite scaffold for running a local proxy on Android.

What works in this first slice:

• Foreground service
• Local HTTP proxy listener
• Local SOCKS5 listener
• CONNECT tunneling
• Plain HTTP proxying with request-line rewrite
• JSON config editor in the app

Current limits:

• This is not yet a full port of the Python domain-fronting logic.
• No MITM CA handling on Android.
• No Apps Script relay or Google-fronted TLS transport yet.
• No UDP associate for SOCKS5.

How to use:

1. Open android-native in Android Studio.
2. Let Android Studio sync Gradle files.
3. Run the app on a device or emulator.
4. Edit the JSON config if needed.
5. Start the service and point your browser/app to 127.0.0.1:8085 or 127.0.0.1:1080.

Suggested next steps if you want this to become the real Android version:

• Port the domain_fronter.py transport layer to Kotlin
• Add a real config model for apps_script, domain_fronting, and google_fronting
• Add log streaming in the UI
• Add optional VpnService mode for device-wide capture