远程中继：手机用上电脑的 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 里填这个地址能正常聊天。
• 使用中继期间电脑保持开机、启动器保持运行（本质上是你的电脑在替手机干活）。

电脑端设置

1. 找到开关

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

2. 填本地 API 地址

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

3. 确认已连接

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

手机端设置

1. 确认电脑在线

   打开手机端 KOA 的「API 配置」页，找到「通过我的电脑」卡片，确认状态显示「电脑在线」。

2. 填 API 密钥（按需）

   如果电脑上的 API 服务需要密钥，在卡片的「API 密钥」栏填入；服务不需要鉴权就留空。

3. 选模型并启用

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

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

常见问题