跳转至

Android 接入

本文记录 AgentMeshOS Android 客户端接入自托管 Headscale/Tailnet 的已验证最小路径，以及当前仍需继续验收的边界。它只覆盖“先把手机作为 Android 网络成员接入”的正式步骤，不把 Android 直接写成 Linux Worker 或 Nomad Worker。

当前页面状态

  • 页面状态：已纳入正式导航
  • 内容状态：最小接入已验证，边缘能力与后台行为仍在继续验收
  • 适用对象：Android 手机或平板终端

节点角色定位

Android 后续定位为按需移动边缘能力节点，可在用户授权和受控任务协议下提供相机、传感器、位置、网络探测或设备端推理等能力；保留 Android 系统的设备不作为稳定通用 CPU Worker。跨平台角色与资源池边界见 节点角色与能力矩阵。

若一台手机硬件经逐机评估后运行完整 Linux ARM64 系统，并通过运行时、供电、散热、恢复与连续稳定性验收，可申请成为低优先级 Linux Worker 候选；这不是 Android Worker。每台设备的事实记录和试点门槛统一写入 Android 节点评估与试点台账。

当前统一边界

  • 控制面入口：https://mesh.yohan.fun
  • 当前 Tailnet 关键节点：
  • 主节点：agentmeshos-main / 100.64.0.1
  • 中继 / 公网出口候选：agentmeshos-worker-mm / 100.64.0.6
  • 公网 Nomad 入口：https://nomad.yohan.fun/ui/
  • 正式采集方向：Android 手机作为独立节点自行采集，最终由主节点直接接收或拉取；agentmeshos-office-windows 只保留 ADB 安装、恢复、刷机和故障排查用途，不进入正式数据链路。

已验证的最小接入路径

以下路径已在 2026-07-16 用 Redmi 3S（land，LineageOS 23.2 / Android 16）完成真实验证，适合作为后续 Android 手机接入的默认起点：

  1. 安装官方 Tailscale Android 客户端。
  2. 优先使用官方安装源；无 Google Play 服务的设备可使用官方 APK 本地安装或 ADB 安装。
  3. 打开 Tailscale App，进入 Settings -> Accounts。
  4. 进入右上角菜单，选择 Use an alternate server。
  5. 输入自托管控制面地址 https://mesh.yohan.fun。
  6. 在手机浏览器跳出的注册页获取 hskey-authreq-... 注册请求。
  7. 在主节点执行 headscale auth register --auth-id hskey-authreq-... --user agentmeshos 完成登记。
  8. 回到手机侧确认 Tailscale VPN 建立，并在控制面或状态页确认节点已上线。

本路径完成后，手机获得的是 Tailnet 网络成员身份，不是 Linux Worker、Nomad Worker 或长期后台算力授权。

当前已验证结果

  • Redmi 3S 已以节点名 redmi-3s 成功加入自托管 Headscale/Tailnet。
  • 已分配 Tailnet IPv4：100.64.0.8。
  • 已确认 Android 侧 tun0 VPN 建立，Tailnet DNS 为 100.100.100.100 / fd7a:115c:a1e0::53。
  • 已将 com.tailscale.ipn 加入设备省电白名单，减少 Doze 导致的断连概率。
  • 已验证过一版 ADB -> Office Windows -> 主节点只读导入 实验链路，可用于临时排障和字段对照；但它不是后续正式形态。
  • 已完成正式方向的第一版直推验收：手机本机通过 scripts/clients/agentmeshos-android-self-network-probe.sh 生成网络摘要，并直接推送到主节点 100.64.0.1:39120/api/android/probes/ingest；主节点接收后落盘到 /run/agentmeshos/android-network-probes/<node>.json，并可通过 /api/android/probes/redmi-3s 查询。
  • 当前验证只覆盖网络接入、基础在线和可恢复安装路径；未把该设备提升为 Worker。

当前待补项

  • 待验证标准 Android、LineageOS 与厂商定制系统的差异
  • 待验证锁屏、重启、Wi-Fi 切换、蜂窝切换和长时间待机后的在线表现
  • 待补手机端自采集脚本如何常驻、如何由主节点直接接收或拉取，以及失败重试策略
  • 待验证手机端 push-loop 连续运行、失败重试和长时间待机后的表现
  • 待补相机、定位、传感器、BLE 等 A1 级移动边缘能力的逐项授权与回收说明
  • 待补 Exit Node、DNS、局域网访问和故障排查的正式操作步骤
  • 待决定是否将 Android 网络探针运行时快照进一步汇总进 Status 首页；当前接收口和单节点查询入口先独立提供，不冒充“已并入总览卡片”。

写入原则

  • 未经真实验收的路径和设置不先写成正式步骤
  • 后续补充时继续沿用本页，不另起平行文档