手机里的 MCP Server 如何免费实现端到端加密隧道:Arc Tunnel 原理详解
手机里的 MCP Server 如何免费实现端到端加密隧道:Arc Tunnel 原理详解
android-remote-control-mcp 是一个运行在手机上的 MCP Server,让 AI 能直接控制你的安卓设备——而它内置的 Arc Tunnel(免费端到端加密隧道) 无需任何账号,就能为这台手机 MCP Server 生成一个公网 HTTPS 地址,且隧道服务只能看到密文。
为什么手机上的 MCP Server 需要隧道 🌐
这个项目的 MCP Server 跑在手机里,通过 Streamable HTTP 端点 /mcp 对外提供"读屏幕、点击、输入、下载文件"等能力。默认它只监听本机地址。
但很多真实场景必须跨网络连接它:
- 把 Claude / ChatGPT 接入手机作为自定义连接器(要求公网 HTTPS 地址)
- 人在外地,想指挥家里的手机完成操作
- CI 或无头设备上自动化调用
没有端口转发的家庭/移动网络里,反向隧道就是标准解法。项目提供了三种隧道:
| 隧道 | 账号 | 公网 URL 形态 | 能否看到你的流量 |
|---|---|---|---|
| Arc Tunnel(默认) | 不需要 | https://<name>.d.arc-tunnel.io |
❌ 只转发密文 |
| Cloudflare Quick Tunnel | 不需要 | *.trycloudflare.com |
✅ 在 CDN 终结 TLS |
| ngrok | 需要 authtoken | 随机或自定义域名 | ✅ 在中继终结 TLS |
关键差异就在最后一列:Arc Tunnel 是唯一做到"端到端加密"的——因为 TLS 在手机上终结,中间的隧道节点只负责搬运它读不懂的字节。
下面这张图展示了这个 MCP Server 在公网 AI 客户端(左侧 Claude 网页)与手机(右侧)之间工作的样子,隧道正是让左右两边能对话的桥梁:
Arc Tunnel 核心原理:密文中继 + 回拨拼接 🔐
理解 Arc Tunnel,先记住一句话:隧道服务器只是"密文搬运工"。整个数据路径分三段:
公网客户端 ──TLS──▶ 隧道边缘节点 ──只转发密文──▶ 你的手机 ◀──TLS──▶ 本地 MCP Server
(Claude/ChatGPT) (d.arc-tunnel.io) (ArcTunnelProvider) (127.0.0.1:随机端口)
- 公网客户端(比如 Claude)连接
https://<name>.d.arc-tunnel.io; - 隧道边缘把这次连接"挂起",通过一条常驻的出站控制流通知手机:有一个新连接来了;
- 手机收到
OPEN指令后反向回拨(dial-back)自己本地的 TLS 监听端口,并用一次性 token 校验身份; - 之后隧道节点和手机之间做字节级拼接(splice)——双向搬运原始字节,直到任一方断开。
也就是说:手机全程主动出站,不需要开放任何入站端口;公网客户端到手机之间的 TLS 握手与加解密全部由手机自己完成。隧道节点自始至终只见过密文。
相关源码:
- 回拨连接与升级:ArcTunnelDialBack.kt
- 双向字节拼接:ArcTunnelSplice.kt
- 控制流主循环:ArcTunnelControl.kt
控制流本身是一条出站的 mTLS HTTP/2 长连接(POST /api/v1/control),承载 PING/PONG 心跳、OPEN(新连接通知)和 RENEW_NUDGE(提醒续期证书)。断线后按 1s→16s 指数退避自动重连。
注册:硬件密钥证明 + 公网可信证书 📝
第一次开启 Arc Tunnel(约 10–30 秒),手机会完成一次两阶段注册,逻辑在 ArcTunnelEnroller.kt:
阶段 1 — 证明"你是这台设备"
手机在安全芯片(AndroidKeyStore)里生成一把 EC 身份密钥,把**硬件认证链(attestation chain)**和密钥 CSR 发给 enroll.arc-tunnel.io。服务端验证硬件签名后,颁发一张临时的 mTLS 身份证书。没有对应硬件认证能力的设备,服务端会直接拒绝并给出原因。
阶段 2 — 申请公网可信证书
- 为这个"名字"生成一把固定 TLS 私钥(只生成一次,之后每次续期复用);
- 对目标域名
<name>.d.arc-tunnel.io完成 ACME 域名验证(tls-alpn-01,由隧道服务端代答挑战); - 从 Let's Encrypt / Google Trust Services / ZeroSSL 拿到公开 CA 签发的证书——所以浏览器访问这个 URL 时,锁标志和证书链都是可信的。
注册得到的名字与证书保存在 App 私有目录(私钥只进 AndroidKeyStore),下次启动直接"恢复身份",证书过期则只走续期,不会重新注册。这套幂等逻辑在 ArcTunnelEnrollmentFlow.kt 的 enrollOrResume 中:
有可用身份 → 直接恢复;证书过期 → 仅续发;什么都没有 → 全新两阶段注册。
手机自管证书:续期、换证与 CT 监控 🛡️
因为 TLS 在手机上终结,"管好自己这张证书"就成了手机端的责任,项目为此做了不少工程设计:
- 续期:控制流上的
RENEW_NUDGE或本地定时检查触发续发;每次续发会换一把全新的身份密钥(重新走硬件证明),而 TLS 密钥保持不变,保证公网证书身份稳定; - 换证策略:新证书就绪后只重启本地 TLS 监听器(控制连接不断),并等"没有活动回拨会话"的瞬间换端口复用,最大限度不掐断正在进行的工具调用;
- Certificate Transparency 监控(默认开启):定期用 CT 日志 API 核对"你这个域名最近签发的证书,公钥是不是你手里这把"。一旦发现同名证书被签给了别的公钥,会弹通知 + 首页横幅,建议你点 URL 旁的刷新图标重新注册一个新名字。实现见 ArcTunnelCtMonitor.kt。
启用步骤:三步拿到公网地址 🚀
- 打开 App → Settings → Tunnel,开启 Remote Access(Arc Tunnel 是默认隧道,无需账号);
- 首次会弹窗提示"注册约需 10–30 秒",点 Continue 等待完成;
- 点击 Start Server,在 Server 页复制公网地址
https://<name>.d.arc-tunnel.io,在客户端里拼接/mcp即可连接。
无头/自动化场景也可以完全走 ADB 完成注册,例如在 CONFIGURE 广播里带上 --ez arc_tunnel_enroll true,细节见 README.md 的 "Headless Setup via ADB" 章节。
配好隧道后,Claude 网页就能这样直接指挥你的手机查机票(下方动图为项目内置演示):
对比与取舍:Arc Tunnel 适合谁 ⚖️
选 Arc Tunnel(默认)如果:
- 不想注册任何账号、不想要第三方看到明文流量
- 需要固定公网域名(
<name>.d.arc-tunnel.io稳定不变),方便反复对接 Claude/ChatGPT 连接器 - 想要 CT 监控这种"证书被冒签"的额外防护
选 Cloudflare / ngrok 如果:
- 更信任大厂的 CDN 生态,或需要 ngrok 的自定义域名
- 能接受 TLS 在对方边缘终结(流量对隧道方可见)
安全提醒 ⚠️
端到端加密保护的是传输链路,不等于免除你本地的责任:
- 公网 URL 本身要当作敏感信息保管,只在可信网络分享;
- 开启 OAuth(默认已开启)后,每个客户端连接都要在手机上核对 2 位验证码批准;
- 用完即停:隧道和服务器都关掉;
- 建议保持 Bearer Token + OAuth 双重认证,不要把服务指向存有敏感数据的设备。
延伸阅读 📚
- 完整架构与启动时序:docs/ARCHITECTURE.md
- Arc Tunnel 的设计决策全记录(38 个实现文件的设计来源):docs/plans/66_arc_tunnel_provider_20261019064908.md
- 隧道提供者总览与设置参考:README.md
- Arc Tunnel 全部实现代码:services/tunnel/arctunnel/

