CLIProxyAPI 服务器部署笔记

CPA = CLIProxyAPI,把 Gemini CLI / ChatGPT Codex / Claude Code / Antigravity 等 OAuth 登录的 AI 工具封装成统一的 OpenAI/Gemini/Claude 兼容 API,方便在自己的服务器上长期使用。

本笔记基于 2026-05 在腾讯云 OpenCloudOS(x86_64)上的实际部署整理。

目录

文件内容
01-overview.md概念、整体架构、端口与目录约定
02-server-prep.md服务器准备、Docker 安装
03-deploy-cpa.md部署 CLIProxyAPI 容器
04-mihomo-proxy.md用 mihomo (Clash.Meta) 解决境内出口问题
05-oauth-login.md登录 ChatGPT / Gemini / Claude 的 OAuth 流程
06-management-panel.md管理面板访问与离线部署
07-client-usage.md客户端如何调用 CPA
08-config-reference.mdconfig.yaml 关键字段速查
09-troubleshooting.md常见错误与解决方案
10-security.md安全加固清单

快速链接

快速回顾(TL;DR)

  1. 服务器装 Docker → 起 CLIProxyAPI 容器(03
  2. 国内 VPS 起 mihomo 容器,订阅切到美国节点(04
  3. CPA 的 proxy-url 指向 mihomo(03 §配置代理)
  4. 本地 SSH 端口转发后做 OAuth 登录(05
  5. 浏览器访问管理面板验收(06
  6. 客户端用 OpenAI 兼容协议调用 :831707