Android 安装详解（手机 App）
手机端安装四步：下载 APK → 允许「未知来源」→ 安装 → 扫电脑端二维码。扫码 = 登录 + 配对 + 连接，一次完成。
iOS 暂不支持。
一、下载 APK
下载地址：【占位：官网下载页 / Releases 链接，待发布】（文件名形如 DevAnyWhere_x.x.x.apk，以实际发布版本为准）。
二、允许「未知来源」安装
APK 不经过应用商店分发，安装前需要授权。规则只有一条：给你用来打开 APK 的那个 App（浏览器 / 文件管理器 / 微信等）授予「安装未知应用」权限。各品牌典型路径：
| 品牌 / 系统 | 典型路径 |
|---|---|
| 小米 / 红米（MIUI、澎湃OS） | 设置 → 密码与安全 → 特殊权限设置 → 安装未知应用 |
| 华为（HarmonyOS / EMUI） | 设置 → 安全 → 更多安全设置 → 安装外部来源应用 |
| 荣耀（MagicOS） | 设置 → 安全 → 更多安全设置 → 安装外部来源应用 |
| OPPO / 一加（ColorOS） | 设置 → 密码与安全 → 系统安全 → 安装外部来源应用 |
| vivo / iQOO（OriginOS / Funtouch） | 设置 → 安全 → 更多安全设置 → 安装未知应用 |
| 三星（One UI） | 设置 → 生物识别和安全性 → 安装未知应用 |
| 原生 Android / Pixel | 设置 → 应用 → 特殊应用权限 → 安装未知应用 |
菜单名称随系统版本略有差异，以手机实际为准；多数系统在「设置」里直接搜索「未知」也能定位到该开关。安装完成后可以把该授权关掉，不影响已安装的 App。
三、安装并打开
- 用浏览器下载 APK 后点按安装（或在文件管理器中找到它）。
- 打开 DevAnyWhere App。
四、扫码接入（登录 + 配对 + 连接一次完成）
- 电脑端先完成安装与连接（见 macOS 安装详解 或 快速上手），屏幕上会显示 dva2 配对二维码（120 秒内有效）。
- 手机 App 扫码——扫码即完成登录 + 配对 + 连接，无需手输任何配置。
- 首次连接时系统会弹出 VPN 连接请求，请允许（组网所需，只有虚拟网段流量进隧道）。
若账号尚未核销邀请码，手机会弹阻断页「请先在电脑端核销邀请码」。核销只发生在电脑端（桌面 App 或 CLI）：回电脑端完成核销后，在阻断页重新扫码即可。
五、进入控制台
连接成功后进入控制台——即 CloudCLI 界面，你看到的就是自己电脑上的 Claude Code，可以直接下达指令、查看输出。
六、状态灯（五态）
| 灯 | 含义 |
|---|---|
| P2P 直连（深绿，最快） | |
| 中继模式（浅绿，同样通畅，走转发；多数场景几分钟后自动升级深绿） | |
| 连接中… / 等待电脑上线（黄；电脑端未连接或未开机时出现） | |
| 未连接（灰） |
七、保活与常驻通知
- App 通过前台服务 + 常驻通知保活，对抗国产 ROM 的后台冻结——请不要划掉通知或强行停止 App，否则隧道会被系统杀掉。
- 手机上已有其他 VPN 时会冲突（Android 同时只允许一个 VPN），先关闭其他 VPN 再连接。
八、设置页
- 可查看连接信息、退出登录。
九、遇到问题（自查表）
| 现象 | 自查 |
|---|---|
| 扫码后弹阻断页 | 账号未核销邀请码：回电脑端核销后重新扫码 |
| 二维码扫不出来 / 提示过期 | 二维码 120 秒有效：电脑端重新点「连接」（CLI 跑 devanywhere mobile）重新出码 |
| 一直黄色「等待电脑上线」 | 电脑端是否已点「连接」、电脑是否休眠断网 |
| 一直浅绿（中继） | 属预期，正常可用；多数场景几分钟后自动升级深绿 P2P |
| 连接后频繁断开 | 是否有其他 VPN 在运行；是否清理了后台 / 划掉了常驻通知 |
卸载见 卸载指引。