starred/CPA-Dashboard
1
0
Fork 0
mirror of https://github.com/dongshuyan/CPA-Dashboard.git synced 2026-04-26 06:15:55 +03:00
Code Issues Projects Releases Packages Wiki Activity
Dashboard For CLIProxyAPI
33 commits 1 branch 0 tags 3 MiB
Find a file
Exact
dongshuyan 4d5bf0fb0c fix: normalize auth-dir path separators on Windows 
os.path.expanduser("~/.cli-proxy-api") produces mixed slashes on
Windows (e.g. C:\Users\Admin/.cli-proxy-api). Wrap with normpath
to ensure consistent OS-native separators on all platforms.

Made-with: Cursor
2026-03-06 21:49:26 +08:00
pics Add Windows native support with auto-detection 2026-03-01 21:31:42 +08:00
templates fix: 统一配额刷新代理配置，并放宽 token 失效判定 2026-03-02 16:26:07 +08:00
.gitignore sync: add gpt-5.4 to codex model list, add build example script 2026-03-06 18:06:43 +08:00
app.py fix: 统一配额刷新代理配置，并放宽 token 失效判定 2026-03-02 16:26:07 +08:00
config.py fix: normalize auth-dir path separators on Windows 2026-03-06 21:49:26 +08:00
quota_service.py sync: add gpt-5.4 to codex model list, add build example script 2026-03-06 18:06:43 +08:00
README.md fix: iterdir 替代 glob 避免 Linux 大小写漏文件；config 增加 CPA_AUTH_DIR；api/config 增加调试信息 2026-03-02 00:10:17 +08:00
requirements.txt Add Windows native support with auto-detection 2026-03-01 21:31:42 +08:00
start-linux.sh fix: 恢复 shell 脚本可执行权限，修复 log_dir 为空时的 makedirs 2026-03-01 22:54:21 +08:00
start-windows.ps1 Add Windows native support with auto-detection 2026-03-01 21:31:42 +08:00
start-wsl.sh fix: 恢复 shell 脚本可执行权限，修复 log_dir 为空时的 makedirs 2026-03-01 22:54:21 +08:00
start.sh sync: add gpt-5.4 to codex model list, add build example script 2026-03-06 18:06:43 +08:00
update_and_build-example.sh sync: add gpt-5.4 to codex model list, add build example script 2026-03-06 18:06:43 +08:00

README.md

CPA-Dashboard

CLIProxyAPI 控制面板 - 服务管理与账户监控 Web 界面。

功能概览

服务控制

  • 启动 / 停止 / 重启 CLIProxyAPI 服务
  • 实时查看服务运行状态（PID、运行目录等）
  • 查看运行日志（支持语法高亮、自动刷新）
  • 清除日志文件

账户管理

  • 显示所有账户列表（Antigravity、Gemini、Claude、Codex、Qwen、iFlow、Kimi、AI Studio、Vertex 等）
  • 显示会员等级（ULTRA/PRO/FREE）及账户状态（活跃 / 需要重新登录）
  • 显示每个模型的配额百分比及重置倒计时（Antigravity 实时配额）；其他类型显示静态支持的模型列表
  • 配额缓存持久化（重启后保留）
  • 刷新配额：单个账户刷新 / 批量并行刷新所有账户（并行度可配置，默认 4）；刷新时会校验账号是否仍有效
  • Codex 鉴权：刷新 Codex 账户时除 OAuth 刷新外，会请求 Codex Models API；若返回 401 则标记为「需要重新登录」，更准确
  • 筛选：
    • 类型：全部、Antigravity、Gemini、Claude、Codex、ULTRA、PRO
    • 状态：可勾选「仅显示需要重新登录的账户」，与类型组合（如：Codex + 仅显示需要重新登录 → 只显示需重新登录的 Codex 账户）
  • 批量删除：勾选「仅显示需要重新登录的账户」后，显示「批量删除需要重新登录的账户」按钮，带二次确认，可一键删除当前列表中的失效账户
  • 添加账户：通过 OAuth 登录添加新账户（支持 Antigravity / Gemini / Codex / Claude / Qwen / iFlow / Kimi）
  • 删除账户：删除指定账户（带确认对话框）

安装

pip install -r requirements.txt

使用

方式一：直接运行

python app.py

方式二：通过启动脚本

# macOS / 通用
./start.sh

# Linux（优先使用 $HOME/cliproxyapi，可设置 CLIPROXYAPI_DIR 覆盖）
./start-linux.sh

方式三：Windows 10/11 原生启动

powershell -NoProfile -ExecutionPolicy Bypass -File .\start-windows.ps1

仅做环境检查（不启动服务）：

powershell -NoProfile -ExecutionPolicy Bypass -File .\start-windows.ps1 -CheckOnly

强制重装依赖：

powershell -NoProfile -ExecutionPolicy Bypass -File .\start-windows.ps1 -ReinstallDeps

说明：

  • 该脚本会自动创建 venv、安装依赖并启动 app.py。
  • 支持 Windows 10/11 原生运行（不依赖 WSL）。
  • 会自动探测 CLIProxyAPI 配置目录，优先级为：CLIPROXYAPI_DIR → %USERPROFILE%\\cliproxyapi → ..\\CLIProxyAPI。
  • 如已手动设置 CPA_CONFIG_PATH，则优先使用你设置的路径。
  • 启动后默认访问 http://127.0.0.1:5000。
  • 启动日志文件：start-windows-last.log。

默认访问 http://127.0.0.1:5000

配置

程序会自动从环境变量或父目录查找 config.yaml 读取配置：

  • port - CLIProxyAPI 端口
  • auth-dir - 认证文件目录
  • quota-refresh-concurrency - 批量刷新配额时的并发数（见下方说明）

如何配置批量刷新并发数

点击「刷新所有配额」时，同时请求的账户数量由并发数控制（默认 4）。可按需调大以加快刷新，或调小以减轻对上游 API 的压力。

方式一：环境变量（推荐）

在启动 Dashboard 前设置：

# Linux / macOS
export CPA_QUOTA_REFRESH_CONCURRENCY=8
python app.py

# 或使用启动脚本时
CPA_QUOTA_REFRESH_CONCURRENCY=8 ./start.sh

方式二：config.yaml

在 CLIProxyAPI 使用的 config.yaml 中增加（与 port、auth-dir 等同级）：

quota-refresh-concurrency: 8
  • 有效范围：1–32，超出会自动限制在此区间。
  • 修改后需重启 Dashboard（若用 config.yaml）或刷新浏览器并重新进入账户页，新的并发数才会生效。

环境变量一览

变量 说明 默认值
CPA_CONFIG_PATH config.yaml 绝对路径 自动查找
CPA_AUTH_DIR 认证文件目录（覆盖 config 的 auth-dir） 从 config 读取
CPA_SERVICE_DIR CLIProxyAPI 服务目录 从 config 路径推导
CPA_BINARY_NAME 可执行文件名 CLIProxyAPI
CPA_LOG_FILE 日志文件路径 cliproxyapi.log
CPA_MANAGEMENT_URL Management API 地址 http://127.0.0.1:{port}
CPA_MANAGEMENT_KEY Management API 密钥 -
WEBUI_HOST WebUI 监听地址 127.0.0.1
WEBUI_PORT WebUI 端口 5000
CPA_QUOTA_REFRESH_CONCURRENCY 批量刷新配额并发数 4（范围 1–32）
CPA_ANTIGRAVITY_CLIENT_ID Antigravity OAuth Client ID（用于配额刷新） 未设置则 Antigravity 配额刷新不可用
CPA_ANTIGRAVITY_CLIENT_SECRET Antigravity OAuth Client Secret 同上

运行模式

  1. 本地模式（默认）：直接读取 auth 目录中的 JSON 文件
  2. API 模式：设置 CPA_MANAGEMENT_KEY 后通过 Management API 获取数据

界面说明

基本界面

基本界面

顶部导航：服务控制、账户管理、使用说明。账户管理页包含统计概览、类型/状态筛选、账户卡片与操作按钮。

服务控制

服务控制

  • 服务状态：实时显示 CLIProxyAPI 运行状态（绿色=运行，红色=停止），含 PID、服务目录、日志路径
  • 服务控制：🟢 启动 / 🟠 停止 / 🔵 重启
  • 运行日志：自动刷新开关、手动刷新、跳转底部、清除日志

账户管理

账户管理

  • 统计概览：总账户数、Antigravity 数、ULTRA/PRO 会员数
  • 类型筛选：全部、Antigravity、Gemini、Claude、Codex、ULTRA、PRO
  • 状态筛选：勾选「⚠️ 仅显示需要重新登录的账户」可与类型组合；勾选后显示「批量删除需要重新登录的账户 (N)」按钮
  • 账户卡片：邮箱、类型标签、会员等级、状态（活跃 / 需要重新登录）、配额信息（或静态模型列表）、刷新 / 删除按钮

刷新配额与鉴别需要重新登录

刷新配额以及鉴别需要重新登录账户

  • 点击「刷新所有配额」会批量刷新并校验各账号 token；Codex 会额外请求 Models API，401 则标记为需要重新登录
  • 勾选「仅显示需要重新登录的账户」可查看并批量删除失效账号（带二次确认）

添加账户（OAuth 登录）

登录账户1

选择 Provider（共 7 个：Antigravity、Gemini CLI、Codex、Claude、Qwen、iFlow、Kimi）后启动 OAuth。认证链接会出现在「认证链接」框或命令行输出中，复制到浏览器打开即可；Qwen、Kimi 为设备码流程，链接会自动填入上方认证链接框。部分流程需在终端按提示输入（如项目 ID、回调 URL 等）。

登录账户2

认证成功后账户会出现在列表中，可在此处刷新配额或删除。

添加账户支持的 Provider

Provider 说明 回调端口
Antigravity Google Antigravity 账户 51121
Gemini CLI Google Gemini CLI 账户 8085
Codex OpenAI Codex 账户 1455
Claude Anthropic Claude 账户 54545
Qwen 通义千问账户 设备码模式
iFlow iFlow 账户 55998
Kimi Moonshot Kimi 账户 设备码模式

远程服务器：需 SSH 端口转发后再在本地浏览器完成 OAuth，例如：

ssh -L 51121:localhost:51121 user@server

使用说明（API 示例）

使用说明

  • 连接信息：Base URL、API Key、可用 Keys 数量
  • 所有 API Keys：列表与复制
  • 示例：cURL、Python requests、OpenAI SDK、流式请求等，可直接复制使用

注意

  • 配额：仅 Antigravity 支持实时配额（模型别名与 CLIProxyAPI 一致）；其余类型（Gemini/Codex/Claude/Qwen/iFlow/Kimi/AI Studio/Vertex）显示静态模型列表，与 CLIProxyAPI internal/registry/model_definitions_static_data.go 同步
  • 服务控制：需正确配置 CPA_SERVICE_DIR（或通过 start-linux.sh / 环境变量指定）