远程中继：手机用上电脑的 API

远程中继是什么

不少姊妹在电脑上跑着自己的 API 服务：本地反向代理、one-api / new-api 这类聚合面板，或者 Ollama、LM Studio 里的本地模型。这些服务的地址通常长这样：http://127.0.0.1:3000/v1，一个只有你电脑自己能访问的本地地址。

在电脑上用 KOA，直接把这个地址填进 API 页就行。但换到手机上就不通了：KOA 手机版是一个 HTTPS 网页，浏览器的安全机制不允许它访问 http:// 开头的本地地址；就算不在乎这条，手机和电脑不在同一个网络时也根本连不上。

远程中继就是为这件事准备的：你的电脑和 KOA 云端保持一条加密连接，手机把请求交给云端，云端转给你的电脑，由电脑访问本地 API 后把回复原路传回手机。手机在公司、在地铁、在另一个城市，都能用上家里电脑上的 API。

原理与隐私

一次对话的完整路线是：

手机 → KOA 云端 → 加密通道 → 你的电脑 → 本地 API，回复沿原路返回。

• 云端只转发，不存储：中继服务器不保存你的对话内容，转发完即丢。
• 本地 API 地址不离开电脑：手机端不知道也不需要知道你的本地地址，具体转发到哪里由电脑端自己决定。
• 身份靠同步账号验证：只有登录了同一个同步账号的手机才能使用你电脑的中继，其她人连不进来。
• 一个账号一台电脑：同一账号同时只有一台电脑在线做中继，新电脑连接会替换旧的。

开始前的准备

• 电脑端 KOA 启动器已登录同步账号，手机端 KOA 登录同一个账号。
• 电脑上的 API 服务本身工作正常。最简单的验证方式：在电脑端 KOA 里填这个地址能正常聊天。
• 使用中继期间电脑保持开机、启动器保持运行（本质上是你的电脑在替手机干活）。
• 中继走的是 KOA 云端，和手机端一样要云订阅。1.3.20 起老用户新用户都已经自动有一个月。

电脑端设置

1. 找到开关

   打开启动器的 API 页，找到「远程中继」区块，勾选「启用远程中继」。

2. 填本地 API 地址

   在「本地 API 地址」里填入你平时在电脑端 KOA 使用的那个地址，例如 http://127.0.0.1:3000/v1。照抄你在电脑上能正常聊天的填法，包括末尾的 /v1 之类的路径。

   空着也行，电脑会转发到它自己正在用的 API，状态那一行会写「留空，转发到本机在用的 API：」，后面跟着地址。

3. 确认已连接

   稍等片刻，开关下方状态显示「已连接」就绪。之后每次开机启动器会自动恢复连接，不用再管。

   状态写着「已断开，正在重连…」，是电脑和云端的连接断了，它在自己连。电脑睡一觉醒来，两分钟内会自己连回去，不用重启 KOA。

手机端设置

1. 确认电脑在线

   手机端 KOA 主页点「更多设置」→「API 配置」，找到「通过我的电脑」卡片。它平时是收起来的，点一下展开，确认状态显示「电脑在线」。

2. 填 API 密钥（按需）

   这一栏叫「API 密钥（留空则由电脑提供）」。电脑上转发的就是它自己在用的那个 API，留空就行，电脑会带上自己那边的 Key。本地服务要密钥、电脑上又没填过的，才在这里填。

3. 选模型并启用

   在「聊天模型」（或「快速模型」）的「使用预设」下拉里选择「通过我的电脑」，点「获取」拉取模型列表，选好模型后「保存」。也可以直接在「通过我的电脑」卡片里获取模型后点「启用」，一键切换聊天模型。

之后手机上的对话就会经由你的电脑访问本地 API 了，流式回复、模型切换都和直连一样用。

常见问题