Files

55 lines
3.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<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) 文件。