feat: Initial release of Tailscale Manager

This commit is contained in:
LZX committed 2026-11-08 14:50:04 +08:00
commit 17a0fd9367
82 files changed
+7572

No files matched your search

+54
View File
@@ -0,0 +1,54 @@
<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">
专为 Android (Root) 平台设计的原生 Tailscale 守护进程与状态管理工具
</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">
<b>简体中文</b> | <a href="README_EN.md">English</a>
</p>
---
## 核心实现架构
### 1. 原生底层守护进程与路由自愈
- **纯原生 Linux 隧道**:将官方编译的 `tailscaled` 守护程序部署于系统模块目录,直接调用 Linux 内核 `tun` 驱动与系统路由表,不依赖 Android `VpnService`,保留系统自带 VPN 槽位给其他工具使用。
- **切网自愈机制**:后台监听网络接口事件(Wi-Fi、蜂窝网络及代理环境切换),动态更新路由规则,防止网络死锁与链路中断。
- **全局终端 CLI 支持**:自动注册全局系统软链接至 `/data/adb/ksu/bin/tailscale`,支持在 Termux 或任意终端中直接使用官方原生 CLI 命令行进行高级网络调试。
### 2. Root 交互与 IPC 通信控制
- **Unix Domain Socket 桥接**:通过 Root 调度桥接层与后台 `tailscaled.sock` 守护套接字进行通信,实时同步设备在线状态、Tailscale IP 及当前出口节点配置。
- **完整功能闭环**:
- 浏览器引导式 OAuth 设备授权与多账号平滑切换。
- 出口节点(Exit Node)选择、局域网访问(LAN Access)与出口节点广播配置。
- 节点列表延迟与 DERP 中继路径连通性实时探测(Ping)。
- 设备主机名(Hostname)修改与实时双向同步。
- Tailscale DNS、入站连接(Shields Up)及子网路由偏好管理。
### 3. 现代化界面与国际化设计
- **Jetpack Compose & Material 3**:采用声明式 UI 架构,深度适配 Material You 动态色彩壁纸取色系统,并提供精选主题色与明暗模式自由切换。
- **全站国际化(i18n)规范**:严格分离字符串资源,无任何写死文本,原生支持简体中文与英文多语言环境。
### 4. 自动化检测与更新流
- **生命周期检测序列**:启动时按序流式执行「Root 授权检测」→「应用版本更新」→「模块组件同步检测」。
- **版本静默与抑制机制**:支持针对特定更新版本进行抑制设置(不再提醒),并在仪表盘模块卡片和关于页面保留手动即时检测入口。
---
## 开源协议
本项目基于 **GNU General Public License v3.0 (GPL-3.0)** 协议开源。详细条款请参阅 [LICENSE](LICENSE) 文件。