CPA One-Click Installer

本仓库只负责把本地 CLIProxyAPI + CPA-X + Codex OAuth 回调中继 打包成一个可直接运行的安装包。

合规边界很明确：

• 只支持你自己使用自己的账号登录
• 不包含自动注册、接码、验证码接管或批量授权
• 默认全部绑定到本机 127.0.0.1

你会得到什么

• install.sh：一键拉取上游、装依赖、编译二进制、生成本地配置
• bin/start-cpa.sh：启动 CLIProxyAPI 和 CPA-X
• bin/stop-cpa.sh：停止本地服务
• bin/status-cpa.sh：检查配置、进程和 HTTP 健康状态
• bin/login-codex.sh：启动一次性 OAuth 回调中继，辅助你完成 Codex 账户登录

默认地址

• CLIProxyAPI 管理地址：http://127.0.0.1:8317
• CPA-X 面板地址：http://127.0.0.1:8080
• Codex OAuth 本地回调中继端口：1455

一键开始

git clone <your-repo-url>
cd cpa-one-click-installer
./install.sh
./bin/start-cpa.sh
./bin/login-codex.sh
./bin/status-cpa.sh

看到 cliproxy_models_ok: True 和 cpax_http_ok: True，说明本地服务已经起来了。

安装器会做什么

./install.sh 实际会调用 scripts/bootstrap.py，自动完成下面这些动作：

1. 检查 git、go、python3
2. 拉取或更新 CLIProxyAPI 和 CPA-X
3. 给 CPA-X 建 .venv 并安装 requirements.txt
4. 编译 cliproxyapi 到本地 runtime
5. 生成本地 config.yaml 和 cpax.env

默认 runtime 根目录：

~/.codex/cpa-runtime

常用命令

./install.sh
./bin/start-cpa.sh
./bin/stop-cpa.sh
./bin/status-cpa.sh
./bin/logs-cpa.sh all
./bin/logs-cpa.sh cliproxy
./bin/logs-cpa.sh cpax
./bin/login-codex.sh --help

目录说明

~/.codex/cpa-runtime/
├── bin/          # 编译后的 cliproxyapi
├── env/          # 生成的 cpax.env
├── logs/         # cliproxy 和 cpax 日志
├── run/          # pid 文件
├── state/        # 本地认证状态
└── upstream/     # 拉取下来的 CLIProxyAPI / CPA-X

可选参数

./install.sh --runtime-root ~/.codex/my-cpa-runtime
./install.sh --skip-update
./install.sh --overwrite-config
./install.sh --management-port 18317 --panel-port 18080

如果默认 8317 或 8080 被占用，直接改端口重装即可：

./install.sh --management-port 18317 --panel-port 18080 --overwrite-config
CPA_RUNTIME_ROOT="$HOME/.codex/cpa-runtime" ./bin/start-cpa.sh
CPA_RUNTIME_ROOT="$HOME/.codex/cpa-runtime" ./bin/status-cpa.sh
CPA_RUNTIME_ROOT="$HOME/.codex/cpa-runtime" ./bin/login-codex.sh

进一步说明

• 快速上手：docs/quickstart.md
• 常见问题：docs/faq.md

依赖要求

• macOS
• git
• go
• python3

安全提醒

• 不要把生成的 cpax.env、管理 key、models key 发给任何人
• 不要把 runtime 目录公开同步到公共仓库
• 如果你要换机器，建议重新跑一次安装并重新生成本地配置