配置 CliProxyAPI (CPA) 以反代 Gemini

本文最后更新于 2026年9月4日 晚上

前言

之前刷知乎的时候就看到有人说可以通过某种手段反代出 Gemini 的 API，搭配上闲鱼满天飞的低价 Gemini Pro 账号 / 代充可以爽蹬。

然后这两天又水群看到有人提到 CPA 这个名词，开始问 GPT 这是什么甚至没问出来 xD，直接问才知道是 Cli Proxy API。

查了一下需要在服务器上部署，于是下面带来简单的教程。

在服务器上安装

CPA 的官方文档写得极其垃圾（不适合人类阅读），所以尽量 Agent 代劳就行了。

我直接抛给 Agent 这样的 Prompt：

要求：

  • 按当前官方文档安装 (https://help.router-for.me/cn/introduction/quick-start.html)，优先使用官方 Linux 一键安装脚本（curl -fsSL https://raw.githubusercontent.com/router-for-me/cliproxyapi-installer/refs/heads/master/cliproxyapi-installer| bash）。
  • 配置为 systemd 服务并开机自启。
  • CPA 监听 127.0.0.1:8317，不要直接暴露公网。
  • 配置文件和 OAuth 凭据要持久化。
  • 先帮我配置 Gemini CLI / Google OAuth 登录。
  • OAuth 完成后，用 /v1/models 和一次实际 Gemini 请求验证 CPA 正常工作。
  • 不要安装 New API、Sub2API 或其他无关组件。
  • 不要破坏服务器现有服务。

执行前先检查系统、已有 CPA、8317 端口和 systemd 状态。需要我打开 OAuth 链接操作时再停下来告诉我。

等就行了）

注意，我这里使用的是 Linux 系统，对于别的系统的用户，请查看文档调整安装方式）

（不过都服务器了，真有人用 Windows Server 吗）

访问 WebUI

可以通过 http://127.0.0.1:8317/management.html 访问 CPA 的 WebUI 界面，但是我们首先需要配置密码：

打开编辑器编辑 ~/cliproxyapi/config.yaml 文件，找到这一块：

remote-management:
  allow-remote: false
  secret-key: "这里填刚生成的密钥"
  disable-control-panel: false

然后，连接 SSH 隧道：

ssh -N -L 8317:127.0.0.1:8317 tencent-lighthouse

在本地浏览器就可以访问了。

设置 OAuth

673

在这里配置登录，根据后面的指示操作即可

——本应如此，但是遇到了问题，因为我服务器忘记挂梯子了）

所以开了个新回话，安装了 Mihomo 内核以及其 WebUI（MetacubeX），配置一下网络代理（不推荐在服务器上开启系统代理 or TUN，可能会影响 SSH 性能）：

638

在这里输入即可，7890 是 Mihomo 内核的端口。

然后再配置就可以了。

使用 API

导入认证文件之后就可以用 API 了，就是上一张截图下半部分那里的 key。

但是这里又是 CPA 的垃圾文档发力了，我怎么看都没找到 URL 是什么，这到底是 OpenAI 还是 A\ 的。

问了下 LLM 得到答案，不过鬼知道为什么，反正能用：

Provider: OpenAI / OpenAI Compatible
Base URL: http://127.0.0.1:8317/v1
API Key: "YOUR API KEY"

会提供 Model List，是目前可用的所有模型。总之是可以用了。

说实话有点简陋，无法做到「限制对于特定 key 的 model list」。解决方案是前面套一个 API 网管比如 new-api。