安装与网络方案

移动端配对前，先把桌面端的 7420 端口暴露成一个公网可访问的地址。

系统要求

项目	要求
桌面端	智码 AICoder v6.1.2 及以上（推荐，手机端全部功能可用）；基础的看输出、发消息、配对 v3.5.2+ 即可；驱动远程 SSH 会话需 v5.4.0+，给聊天模式会话发消息需 v5.9.0+
移动端	Android 8.0+（API 26+）
手机	摄像头（扫码可选；不可用则手动 PIN）
网络	桌面与手机不在同一局域网时需要内网穿透

iOS 暂未发布。

下载 APK

最新版本：v0.9.2

渠道	下载链接
Cloudflare R2（主）	AICoder-mobile-v0.9.2.apk
GitHub 存档	AICoder-mobile-v0.9.2.apk

各历史版本的下载链接见下载页与更新日志。

侧载分发提示

Android 系统默认拦截「未知来源安装」，需要在系统设置中单独允许该浏览器/文件管理器安装应用。 APK ≈ 19 MB。

从旧版升级

v0.3.6 及之后的版本使用同一套发布签名（v0.7.0 除外，见下方提示），直接覆盖安装即可。仍在 v0.1.0 ~ v0.3.5 的用户首次升级需要卸载旧版重装一次（一次性，之后都能正常覆盖）。

还在用 v0.7.0 的请先卸载再装

v0.7.0 当时误用了临时调试签名出包，与之前、之后各版的正式签名都不一致，在它上面覆盖安装会被系统拒绝（提示签名不一致 / 安装失败）。

处理办法：先卸载 v0.7.0，再安装最新版。卸载会清掉 App 里已配对的桌面，装好后按配对桌面重新配对即可。v0.7.1 及其他版本不受影响，可直接覆盖升级。

安装步骤

用手机浏览器扫码下载 APK
打开 APK，系统提示「是否允许此应用来源安装」，前往设置打开
返回安装界面，点击「安装」
安装完成后打开「智码 AICoder」（橙色图标）

检查新版本

App 启动时会自动检查一次新版本；也可以在「我的 → 检查更新」手动查询。发现新版会提示你去下载页，新版本需要手动下载 APK 覆盖安装。

想确认自己装的是哪个版本：以「我的」页最底部显示的版本号为准。较早版本「我的 → 关于」页里的版本号是写死的（一直显示 v0.1），对不上不用在意；v0.9.1 起「关于」页已改为显示安装包的真实版本号。

网络方案：自行配置反向代理

桌面端的 axum 网关默认监听 127.0.0.1:7420。你需要自行用任意一种内网穿透 / 反向代理方案，把这个端口暴露成公网可访问的地址，然后把地址填到桌面端「远程访问 → 公网访问地址」字段。

   手机端 App                  你的反向代理 / 穿透通道                桌面端
  ┌──────────┐   HTTPS/WSS   ┌─────────────────────────┐  TCP    ┌──────────────┐
  │  React   │ ────────────▶ │ frp / cloudflared /     │ ──────▶ │ axum gateway │
  │   SPA    │ ◀──────────── │ Tailscale / nginx /...  │         │ 127.0.0.1    │
  └──────────┘               └─────────────────────────┘         │   :7420      │
                                                                 └──────────────┘

同一个网关也给公网 AI 用

配好公网地址、启动网关后，claude.ai 网页版等云端 AI 也能经这个网关连到你的电脑干活，不用另开端口，见远程接入（公网 AI）。

桌面端不再内置 frpc

v3.5.2 起，桌面端不再内嵌 frpc 子进程（避免国内杀软对 frp 二进制的误报触发隔离）。你只需要选一种自己熟悉的工具部署好反向代理，桌面端 App 只关心一个公网地址。

第一步：桌面端开启远程访问

桌面 App 顶栏 → 设置 → 远程访问
公网访问地址：填你配好的反代入口完整 URL
- 示例：https://api.example.com
- 示例：https://xxx.trycloudflare.com
- 示例：https://machine.tail-xxxx.ts.net
监听端口默认 7420，反代要把流量转到这个端口
点 「启动」，等到状态变绿
可选：勾选 「下次自动启动」 —— 下次开 App 自动恢复运行

验证连通性

桌面端启动后，用任意浏览器（含手机端）打开：

https://<你的公网地址>/api/v1/ping

应返回：

{ "ok": true, "version": "6.2.1", "service": "tauri-cc-remote" }

其中 version 是你桌面端的版本号，可顺手确认桌面端是否满足上面的版本要求。

如果返回非 JSON 或 5xx：

反代是否在跑？
反代是否把目标设为本机 7420 端口？
防火墙 / 安全组是否放行？
WebSocket 是否被拦截？（部分反代默认不转发 Upgrade 头，需配置）

下一步

配对桌面 — 桌面在跑了，扫码 5 秒搞定配对

方案	适合场景	备注
frp（fatedier/frp）	自有 VPS / 第三方 frps 服务	经典选择；客户端 frpc 需自己装并配置 `local_ip = 127.0.0.1, local_port = 7420`
Cloudflare Tunnel	有域名 + 想白嫖	`cloudflared tunnel --url http://localhost:7420`，零端口暴露
Tailscale Funnel	Tailscale 用户	启用 Funnel 后 `https://machine-name.tail-xxxx.ts.net/` 直接可用
nginx 反代	已有公网服务器 + 域名	`proxy_pass http://内网穿透/127.0.0.1:7420`