Tailscale Manager Logo

Tailscale Manager

A native Tailscale daemon & state manager designed specifically for Android (Root) environments

Platform Language UI
Privacy License

简体中文 | English

--- 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.