【开源-持续更新】CliproxyAPI的简洁管理面板：支持webui端登录，显示配额，账号有效性判断，批量删除
- 内容介绍
- 文章标签
- 相关推荐
repo链接如下，持续更新中
GitHub - dongshuyan/CPA-Dashboard: Dashboard For CLIProxyAPI
Dashboard For CLIProxyAPI
欢迎start
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
默认访问 http://127.0.0.1:5000
配置
程序会自动从环境变量或父目录查找 config.yaml 读取配置：
-
port- CLIProxyAPI 端口 -
auth-dir- 认证文件目录
环境变量：
| 变量 | 说明 | 默认值 |
|------|------|--------|
| CPA_CONFIG_PATH | config.yaml 绝对路径 | 自动查找 |
| 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 |
运行模式
-
本地模式（默认）：直接读取 auth 目录中的 JSON 文件
-
API 模式：设置
CPA_MANAGEMENT_KEY后通过 Management API 获取数据
界面说明
基本界面
基本界面1467×1098 231 KB
顶部导航：服务控制、账户管理、使用说明。账户管理页包含统计概览、类型/状态筛选、账户卡片与操作按钮。
服务控制
P12918×1662 454 KB
-
服务状态：实时显示 CLIProxyAPI 运行状态（绿色=运行，红色=停止），含 PID、服务目录、日志路径
-
服务控制： 启动 / 停止 / 重启
-
运行日志：自动刷新开关、手动刷新、跳转底部、清除日志
账户管理
P22930×1622 503 KB
-
统计概览：总账户数、Antigravity 数、ULTRA/PRO 会员数
-
类型筛选：全部、Antigravity、Gemini、Claude、Codex、ULTRA、PRO
-
状态筛选：勾选「 仅显示需要重新登录的账户」可与类型组合；勾选后显示「批量删除需要重新登录的账户 (N)」按钮
-
账户卡片：邮箱、类型标签、会员等级、状态（活跃 / 需要重新登录）、配额信息（或静态模型列表）、刷新 / 删除按钮
刷新配额与鉴别需要重新登录
刷新配额以及鉴别需要重新登录账户1448×1114 266 KB
-
点击「刷新所有配额」会批量刷新并校验各账号 token；Codex 会额外请求 Models API，401 则标记为需要重新登录
-
勾选「仅显示需要重新登录的账户」可查看并批量删除失效账号（带二次确认）
添加账户（OAuth 登录）
登录账户11408×1304 68.1 KB
选择 Provider（共 7 个：Antigravity、Gemini CLI、Codex、Claude、Qwen、iFlow、Kimi）后启动 OAuth。认证链接会出现在「认证链接」框或命令行输出中，复制到浏览器打开即可；Qwen、Kimi 为设备码流程，链接会自动填入上方认证链接框。部分流程需在终端按提示输入（如项目 ID、回调 URL 等）。
登录账户2704×1054 84.3 KB
认证成功后账户会出现在列表中，可在此处刷新配额或删除。
添加账户支持的 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 示例）
P32922×1660 336 KB
-
连接信息：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/ 环境变量指定）
--【壹】--：
支持下佬的分享
--【贰】--：
这也太强了吧！要是能纯前端就好了！
--【叁】--：
支持……批量太好了
--【肆】--：
感谢，这是大家都在用的一款吗？还是新项目？
--【伍】--：
是的，就是js能不能检查？
--【陆】--：
感谢大佬开源!
--【柒】--：
cliproxyapi是原来的2api的repo很多人都在用
我这个webui的repo就是给这个2api做了一个webui，目前也有不少人在用，也跟着原repo在同步更新
--【捌】--：
感谢大佬！
--【玖】--：
前排支持
--【拾】--：
那这个项目是咋部署的呀大佬，我有点没看懂
--【拾壹】--：
这个本质就是一个webui，只要cliproxyapi你配置好。
我这个webuiclone下来之后，mac直接./start.sh就可以了
linux ./start-linux.sh就可以了
--【拾贰】--： sauterne:
刷新配额：单个账户刷新 / 批量并行刷新所有账户（并行度 4）；刷新时会校验账号是否仍有效
我稍微改了一下，支持自己配置并行度
类似这样来运行
export CPA_QUOTA_REFRESH_CONCURRENCY=8
python app.py
# 或使用启动脚本时
CPA_QUOTA_REFRESH_CONCURRENCY=8 ./start.sh
--【拾叁】--：
感谢佬友！
--【拾肆】--：
高级，存书签了，有空琢磨下
--【拾伍】--：
感谢感谢佬
--【拾陆】--：
肯定不能没有后台的，毕竟还有登录，启动cliproxyapi等功能呢
--【拾柒】--：
啥叫纯前端，不要python吗？
--【拾捌】--：
额 我不太会用docker，所以没搞。可以让AI搓一个，不过我也没发测试不知道AI搓的会不会有错误
--【拾玖】--：
有docker不
repo链接如下，持续更新中
GitHub - dongshuyan/CPA-Dashboard: Dashboard For CLIProxyAPI
Dashboard For CLIProxyAPI
欢迎start
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
默认访问 http://127.0.0.1:5000
配置
程序会自动从环境变量或父目录查找 config.yaml 读取配置：
-
port- CLIProxyAPI 端口 -
auth-dir- 认证文件目录
环境变量：
| 变量 | 说明 | 默认值 |
|------|------|--------|
| CPA_CONFIG_PATH | config.yaml 绝对路径 | 自动查找 |
| 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 |
运行模式
-
本地模式（默认）：直接读取 auth 目录中的 JSON 文件
-
API 模式：设置
CPA_MANAGEMENT_KEY后通过 Management API 获取数据
界面说明
基本界面
基本界面1467×1098 231 KB
顶部导航：服务控制、账户管理、使用说明。账户管理页包含统计概览、类型/状态筛选、账户卡片与操作按钮。
服务控制
P12918×1662 454 KB
-
服务状态：实时显示 CLIProxyAPI 运行状态（绿色=运行，红色=停止），含 PID、服务目录、日志路径
-
服务控制： 启动 / 停止 / 重启
-
运行日志：自动刷新开关、手动刷新、跳转底部、清除日志
账户管理
P22930×1622 503 KB
-
统计概览：总账户数、Antigravity 数、ULTRA/PRO 会员数
-
类型筛选：全部、Antigravity、Gemini、Claude、Codex、ULTRA、PRO
-
状态筛选：勾选「 仅显示需要重新登录的账户」可与类型组合；勾选后显示「批量删除需要重新登录的账户 (N)」按钮
-
账户卡片：邮箱、类型标签、会员等级、状态（活跃 / 需要重新登录）、配额信息（或静态模型列表）、刷新 / 删除按钮
刷新配额与鉴别需要重新登录
刷新配额以及鉴别需要重新登录账户1448×1114 266 KB
-
点击「刷新所有配额」会批量刷新并校验各账号 token；Codex 会额外请求 Models API，401 则标记为需要重新登录
-
勾选「仅显示需要重新登录的账户」可查看并批量删除失效账号（带二次确认）
添加账户（OAuth 登录）
登录账户11408×1304 68.1 KB
选择 Provider（共 7 个：Antigravity、Gemini CLI、Codex、Claude、Qwen、iFlow、Kimi）后启动 OAuth。认证链接会出现在「认证链接」框或命令行输出中，复制到浏览器打开即可；Qwen、Kimi 为设备码流程，链接会自动填入上方认证链接框。部分流程需在终端按提示输入（如项目 ID、回调 URL 等）。
登录账户2704×1054 84.3 KB
认证成功后账户会出现在列表中，可在此处刷新配额或删除。
添加账户支持的 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 示例）
P32922×1660 336 KB
-
连接信息：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/ 环境变量指定）
--【壹】--：
支持下佬的分享
--【贰】--：
这也太强了吧！要是能纯前端就好了！
--【叁】--：
支持……批量太好了
--【肆】--：
感谢，这是大家都在用的一款吗？还是新项目？
--【伍】--：
是的，就是js能不能检查？
--【陆】--：
感谢大佬开源!
--【柒】--：
cliproxyapi是原来的2api的repo很多人都在用
我这个webui的repo就是给这个2api做了一个webui，目前也有不少人在用，也跟着原repo在同步更新
--【捌】--：
感谢大佬！
--【玖】--：
前排支持
--【拾】--：
那这个项目是咋部署的呀大佬，我有点没看懂
--【拾壹】--：
这个本质就是一个webui，只要cliproxyapi你配置好。
我这个webuiclone下来之后，mac直接./start.sh就可以了
linux ./start-linux.sh就可以了
--【拾贰】--： sauterne:
刷新配额：单个账户刷新 / 批量并行刷新所有账户（并行度 4）；刷新时会校验账号是否仍有效
我稍微改了一下，支持自己配置并行度
类似这样来运行
export CPA_QUOTA_REFRESH_CONCURRENCY=8
python app.py
# 或使用启动脚本时
CPA_QUOTA_REFRESH_CONCURRENCY=8 ./start.sh
--【拾叁】--：
感谢佬友！
--【拾肆】--：
高级，存书签了，有空琢磨下
--【拾伍】--：
感谢感谢佬
--【拾陆】--：
肯定不能没有后台的，毕竟还有登录，启动cliproxyapi等功能呢
--【拾柒】--：
啥叫纯前端，不要python吗？
--【拾捌】--：
额 我不太会用docker，所以没搞。可以让AI搓一个，不过我也没发测试不知道AI搓的会不会有错误
--【拾玖】--：
有docker不