55 lines
3.2 KiB
Markdown
55 lines
3.2 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">
|
||
专为 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) 文件。
|