GitHub 直连

GitHub Direct is a lightweight application / Xposed (LibXposed) module designed specifically for the Android platform, aimed at resolving DNS pollution and SNI blocking issues when accessing GitHub (including code repositories, APIs, Raw files, static assets, etc.) from mainland China.

The entire project is developed with an ultra-minimalist architecture, and the release version of the APK is only about 40 KB.

Technical Details

This app combines various low-level Android system and networking technologies to achieve a high-speed direct connection solution without relying on bloated third-party libraries:

1. DNS over HTTPS (DoH) with Built-in Anti-Disconnection Fallback

- Traditional DNS queries on UDP port 53 are highly susceptible to hijacking and poisoning. This project uses DNS over HTTPS (DoH) combined with trusted DNS endpoints to obtain GitHub's true unblocked IP addresses. - When the DoH interface itself is filtered, the system triggers a fallback mechanism that automatically calls a set of clean, hardcoded (dynamically updatable) real GitHub server IPs within the app, ensuring addressing remains possible even in severely hostile network environments.

2. Dual-Track Network Bypass (VPN Service & Xposed Hook)

- VPN Mode Traffic Proxy: No root permission required. Uses Android's native VpnService to create a local virtual network interface. The app locally intercepts DNS resolution requests and handshake packets on specific ports (e.g., 443) sent by the device, performing transparent redirection to restore GitHub access for the entire device or specific apps. - Xposed (LibXposed) Mode: Injects the module into the process of the proxied app (e.g., the official GitHub Android client). The app hooks low-level network establishment flows such as UrlConnection or OkHttp, dynamically modifying the SNI (Server Name Indication) and Host Header before the TLS handshake. Since the traffic exhibits legitimate characteristics, it effectively penetrates Deep Packet Inspection (DPI).

3. Native Minimalist UI & Aggressive R8 Shrinking

- Zero Dependencies: Completely abandons bloated UI frameworks like Jetpack Compose or Material Components (which can be tens or even hundreds of megabytes). The interface is built with raw XML layouts and hand-coded SVG Vector Drawables, following the GitHub Primer design specification, delivering a smooth and native visual experience. - Aggressive R8 Optimization: Employs high-intensity code obfuscation, resource compression, and dead code elimination. During the release build phase, R8 completely strips away unused portions of the Kotlin standard library, ultimately compressing the app size down to an astonishing ~40 KB.

Usage Instructions

The app provides two operating modes, allowing you to choose based on your device environment:

Mode 1: Root-Free VPN Proxy Mode

Suitable for non-rooted standard devices. Routes traffic by creating a local virtual private network.

1. Download and install this app. 2. Open GitHub Direct. 3. Tap the "Enable Proxy" button on the home screen. 4. When the system "Network Connection Request" (VPN authorization) prompt appears, select Allow / OK. 5. Once the status changes to "Enabled" with a green indicator light, open your browser or other tools to smoothly access GitHub. 6. After use, return to the app and tap "Disable Proxy."

Mode 2: Xposed Framework Module Mode

Suitable for advanced users with rooted devices and LSPosed (or a LibXposed-compatible framework) installed. Provides a lower-level, seamless proxy experience.

1. Download and install this app. 2. Open the LSPosed manager, find GitHub Direct in the module list, and enable it. 3. In the module's Scope, select the apps for which you want to restore GitHub access (e.g., the official GitHub client, various third-party downloaders, etc.). 4. Force-stop the target apps or reboot the device. 5. Open this app to check whether "Module Status" shows "Activated." Open the target app to experience direct connectivity.

Built-in Diagnostic Tool

The app's main interface provides two troubleshooting buttons for conveniently testing the current device's connection to GitHub at any time:

- Test DNS: Resolves major GitHub domains via both DoH and the local anti-pollution IP list, printing detailed resolved IP results in the output log panel. - Test Connectivity: Establishes real Socket/ICMP connections to probe GitHub server connectivity and latency (in milliseconds).

License

Apache 2.0