Files
TailscaleManager/README.md
T

3.2 KiB
Raw Blame History

Tailscale Manager Logo

Tailscale Manager

专为 Android (Root) 平台设计的原生 Tailscale 守护进程与状态管理工具

Platform Language UI
Privacy License

简体中文 | English


核心实现架构

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 文件。