CLIProxyAPI Web控制面板：CPA-Dashboard，告别繁琐CLI操作

对于使用 CLIProxyAPI 的开发者和用户而言，日常的管理工作常常需要在命令行、配置文件和多个浏览器标签页之间反复切换——查看服务状态、监控账户配额、处理失效的登录凭证，这些操作不仅繁琐，还容易出错。如果你也对此感到困扰，那么 CPA-Dashboard 正是为你准备的解决方案。它是一个功能强大的 Web 控制面板，为 CLIProxyAPI 提供了直观、集成的服务管理与账户监控界面，将复杂操作简化为几次点击，让管理工作变得前所未有的简单高效。

项目地址：https://github.com/dongshuyan/CPA-Dashboard

核心功能一览

CPA-Dashboard 的核心功能主要围绕两大模块展开：服务控制和账户管理。

一、服务控制：全面掌控服务状态

通过 CPA-Dashboard，你可以完全告别命令行，轻松掌控 CLIProxyAPI 服务的整个生命周期。

• 一键式服务操作：提供清晰的“启动”、“停止”、“重启”按钮，操作直观，无需记忆命令。
• 实时状态监控：面板清晰展示服务的当前运行状态（运行中/已停止），并提供进程ID（PID）、服务运行目录、日志文件路径等关键信息。
• 强大的日志查看器：
  • 内置日志查看功能，支持语法高亮，让日志信息更易阅读。
  • 支持自动刷新，实时追踪服务输出，调试问题更方便。
  • 提供“跳转到底部”和“一键清除日志”功能，极大提升了维护效率。

二、账户管理：精细化监控与操作

这是 CPA-Dashboard 最核心和强大的功能模块，为你提供对所有接入账户的全面、精细化服务管理能力。

• 多平台账户集中管理：统一展示所有已添加的账户，支持 Antigravity, Gemini, Claude, Codex, Qwen, iFlow, Kimi, AI Studio, Vertex 等主流平台。
• 账户信息一目了然：
  • 显示每个账户的会员等级（如 ULTRA/PRO/FREE）。
  • 明确标记账户状态为“活跃”或“需要重新登录”。
  • 实时配额展示：对于 Antigravity 账户，可实时显示各模型的使用配额百分比及重置倒计时。其他类型账户则会展示其支持的静态模型列表。
  • 配额缓存：刷新后的配额数据会进行持久化存储，即使重启 Dashboard 服务，数据也不会丢失。
• 高效的配额刷新机制：
  • 支持单个账户独立刷新。
  • 支持批量并行刷新所有账户，大幅提升效率。并发数默认为4，你可以根据需求调整，以平衡刷新速度和对上游API的压力。
  • 刷新时会自动校验账户凭证（Token）的有效性，确保状态准确。
  • 智能Codex鉴权：在刷新 Codex 账户时，除了标准的 OAuth 刷新流程，还会额外请求其 Models API。如果返回 401 错误，系统会自动将该账户标记为“需要重新登录”，判断更为精准。
• 强大的筛选与批量操作：
  • 按类型筛选：可快速筛选出 Antigravity、Gemini、Claude、Codex 等特定类型的账户，或仅显示 ULTRA、PRO 等高等级会员账户。
  • 按状态筛选：勾选“仅显示需要重新登录的账户”，可以快速定位所有登录凭证已失效的账户。此筛选条件可与类型筛选组合使用，实现更精细的查找（例如，找出所有“需要重新登录的 Codex 账户”）。
  • 批量删除：在筛选出所有“需要重新登录的账户”后，界面会出现“批量删除”按钮，并伴有二次确认提示，可一键清理所有失效账户，保持列表整洁。
• 便捷的账户添加与删除：
  • 通过标准 OAuth 流程添加新账户，支持 Antigravity, Gemini, Codex, Claude, Qwen, iFlow, Kimi 等多种平台。
  • 可删除指定账户，操作前提供确认对话框，有效防止误操作。

快速上手指南

安装

安装过程非常简单，只需一行命令即可完成所有依赖的安装：

pip install -r requirements.txt

启动方式

CPA-Dashboard 提供了多种启动方式，以适应不同操作系统和使用习惯。

1. 直接运行 (通用)

python app.py

2. 使用启动脚本 (macOS / Linux)

# macOS 或通用 Linux 系统
./start.sh
# 专为 Linux 优化，优先使用 $HOME/cliproxyapi 目录
./start-linux.sh

3. Windows 10/11 原生启动 (推荐)
为 Windows 用户提供了功能强大的 PowerShell 脚本，它会自动处理 Python 虚拟环境创建、依赖安装和服务启动等步骤。

# 启动服务
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

该脚本会自动探测你系统中 CLIProxyAPI 的配置目录，并默认在 http://127.0.0.1:5000 启动 Web 控制面板。

启动成功后，直接在浏览器中访问 http://127.0.0.1:5000 即可开始使用。

灵活的配置选项

CPA-Dashboard 设计得非常灵活，它会自动查找并读取 CLIProxyAPI 主目录下的 config.yaml 配置文件。同时，它也支持通过环境变量进行配置，且环境变量的优先级更高。

关键配置项

• port: CLIProxyAPI 服务监听的端口。
• auth-dir: 认证文件（Token等）的存放目录。
• quota-refresh-concurrency: 批量刷新配额时的最大并发数（默认值为4，可设置范围为1-32）。你可以通过环境变量 CPA_QUOTA_REFRESH_CONCURRENCY 或在 config.yaml 中直接设置此参数。

环境变量一览

变量名	说明	默认值
CPA_CONFIG_PATH	config.yaml 的绝对路径	自动查找
CPA_AUTH_DIR	认证文件目录（覆盖 config 中的 auth-dir）	从 config 读取
CPA_SERVICE_DIR	CLIProxyAPI 服务主目录	从 config 路径推导
CPA_BINARY_NAME	CLIProxyAPI 可执行文件名	CLIProxyAPI
CPA_LOG_FILE	CLIProxyAPI 服务日志文件路径	cliproxyapi.log
CPA_MANAGEMENT_URL	CLIProxyAPI Management API 地址	http://127.0.0.1:{port}
CPA_MANAGEMENT_KEY	Management API 密钥	-
WEBUI_HOST	CPA-Dashboard WebUI 监听地址	127.0.0.1
WEBUI_PORT	CPA-Dashboard 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	同上

界面导览与核心操作

添加账户 (OAuth 登录)

在账户管理页面，点击“添加账户”按钮，从列表中选择相应的服务提供商（如 Antigravity、Gemini、Codex 等），系统便会启动对应的 OAuth 认证流程。

认证链接会清晰地显示在界面中央或命令行输出中。你只需复制该链接，在浏览器中打开并完成授权即可。

注意：如果你在远程服务器（如 VPS）上运行 CPA-Dashboard，需要在本地使用 SSH 端口转发（例如执行 ssh -L 51121:localhost:51121 user@server）才能在本机浏览器中顺利完成 OAuth 回调认证。

刷新配额与清理失效账户

点击账户管理页面的“刷新所有配额”按钮，Dashboard 会并行请求所有账户，更新配额信息并同步校验每个 Token 的有效性。对于凭证已失效的账户，系统会将其标记为“需要重新登录”。

接着，你只需勾选筛选栏的“仅显示需要重新登录的账户”，界面便会出现“批量删除”按钮（带有二次确认），从而一键清理所有失效账户，轻松保持账户列表的干净与有效。

使用说明 (API 示例)

CPA-Dashboard 还贴心地集成了“使用说明”页面。这里展示了连接你所管理的 CLIProxyAPI 实例所需的 Base URL、所有可用的 API Keys，并且提供了 cURL、Python requests、OpenAI SDK 等多种语言的调用示例。这对于开发者快速集成和测试 API 非常有帮助。

总结

CPA-Dashboard 是一个为 CLIProxyAPI 量身打造的管理利器。它通过一个直观、易用的 Web 界面，将原本分散在命令行和配置文件中的各类操作——服务启停、日志监控、多平台账户管理、配额刷新、失效账户清理——全部整合到了一起。这款工具显著降低了 CLIProxyAPI 的开源项目使用和维护门槛，无论你是个人开发者还是团队管理员，都能借助它大幅提升工作效率与管理体验。如果你正在寻找一种更优雅的方式来管理你的 AI API 网关，不妨试试 CPA-Dashboard。

欢迎在云栈社区分享你的使用经验或探讨更多技术实践。