59 lines
3.8 KiB
Markdown
59 lines
3.8 KiB
Markdown
<p align="center">
|
|
<img src="art/logo.png" width="128" height="128" alt="Tailscale Manager Logo" />
|
|
</p>
|
|
|
|
<h1 align="center">Tailscale Manager</h1>
|
|
|
|
<p align="center">
|
|
A native Tailscale daemon & state manager designed specifically for Android (Root) environments
|
|
</p>
|
|
|
|
<p align="center">
|
|
<img src="https://img.shields.io/badge/Platform-Android-3DDC84?style=flat-square&logo=android&logoColor=white" alt="Platform" />
|
|
<img src="https://img.shields.io/badge/Language-Kotlin-7F52FF?style=flat-square&logo=kotlin&logoColor=white" alt="Language" />
|
|
<img src="https://img.shields.io/badge/UI-Jetpack%20Compose%20%2F%20Material%203-4285F4?style=flat-square&logo=jetpackcompose&logoColor=white" alt="UI" />
|
|
<br>
|
|
<img src="https://img.shields.io/badge/Privacy-Local%20Only-00C853?style=flat-square" alt="Privacy" />
|
|
<img src="https://img.shields.io/badge/License-GPL--3.0-2196F3?style=flat-square" alt="License" />
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="README.md">简体中文</a> | <b>English</b>
|
|
</p>
|
|
|
|
---
|
|
|
|
Tailscale Manager is an Android client and module manager built for rooted devices (KernelSU / APatch / Magisk). By deploying the official Tailscale daemon directly as a native Linux process, it bypasses Android's `VpnService` overhead and single-VPN slot limitations, delivering line-rate wireguard throughput and a true native mesh network experience.
|
|
|
|
---
|
|
|
|
## Core Architecture & Implementation
|
|
|
|
### 1. Native Linux Daemon & Network Auto-Healing
|
|
- **Pure Linux Tunneling**: Deploys the official `tailscaled` daemon binary directly into the system module directory. It interacts with the Linux kernel `tun` driver and kernel routing tables without touching Android `VpnService`, reserving the system VPN slot for other tools.
|
|
- **Dynamic Network Auto-Healing**: Actively listens to network interface changes (Wi-Fi, cellular, and proxy routing transitions) to dynamically refresh routing rules, eliminating network deadlocks and dropped connections.
|
|
- **System-Wide CLI Integration**: Automatically registers global symlinks at `/data/adb/ksu/bin/tailscale`, allowing direct access to the official Tailscale CLI from Termux or any root shell.
|
|
|
|
### 2. Root IPC Bridge & Control Dispatch
|
|
- **Unix Domain Socket Bridge**: Communicates with the background `tailscaled.sock` via a high-performance Root bridge layer to sync device status, Tailscale IP, and active exit nodes in real time.
|
|
- **Comprehensive Feature Set**:
|
|
- Browser-guided OAuth device authentication and seamless multi-account profile switching.
|
|
- Exit node selection, local network access (LAN access) toggle, and run-as-exit-node advertisement.
|
|
- Live route diagnostics and latency ping probing across tailnet devices and DERP relays.
|
|
- Real-time device hostname modification with instant UI reflection.
|
|
- Full control over Tailscale MagicDNS, inbound connection rules (Shields Up), and subnet routing preferences.
|
|
|
|
### 3. Modern Jetpack Compose UI & Internationalization
|
|
- **Jetpack Compose & Material 3**: Built entirely with declarative UI architecture, deeply integrated with Android Material You dynamic wallpaper theming, custom color palettes, and seamless dark/light mode switching.
|
|
- **Strict i18n Standard**: All UI strings are extracted into localization resources with zero hardcoded text, offering complete native support for Simplified Chinese and English.
|
|
|
|
### 4. Lifecycle Verification & Update Pipeline
|
|
- **Sequential Startup Flow**: Performs a fluid startup check sequence: `Root Permission Check` → `App Update Check` → `Module Component Sync Check`.
|
|
- **Suppression & Manual Triggers**: Supports version-specific suppression ("Don't show again") during startup, while retaining instant manual update check actions on the Dashboard module card and the About screen.
|
|
|
|
---
|
|
|
|
## License
|
|
|
|
This project is licensed under the **GNU General Public License v3.0 (GPL-3.0)**. See the [LICENSE](LICENSE) file for details.
|