这个项目能做什么
CPA Manager Plus(CPAMP)是一个面向 CPA / CLIProxyAPI 网关的自托管管理面板与可观测性仪表盘。它并非替代代理:它管理和观测流经 CPA 的流量,自身不转发模型流量。
核心能力
网关管理:配置 CPA 提供商,包括 Gemini、Codex、Claude、Vertex、xAI、Devin、Muse / Meta 以及 OpenAI 兼容端点;维护认证文件、OAuth 登录、API 密钥、模型别名、优先级、插件、日志和系统设置。它可以导入官方 Sub2API OpenAI OAuth 导出文件,并将多个账号拆分为独立的 CPA Codex 认证文件。
请求监控与故障诊断:来自 CPA 用量队列的请求会持久化到本地 SQLite,可按账号、客户端 API 密钥或实时视图进行搜索。状态、延迟、token、缓存、trace 以及脱敏后的失败证据均可检查;历史记录可以导出或导入为 JSONL。
成本与用量分析:调用、token、成本、延迟和失败可按模型、提供商、账号、凭据、API 密钥、项目、渠道和时间范围进行细分,包括输入、输出、推理、缓存、服务层级和长上下文定价语义。模型价格从 models.dev 同步,并以 LiteLLM 和 OpenRouter 作为回退,同时支持本地覆盖。
账号健康、配额与自动化:Codex 和 xAI 账号可在本地或按 Manager Server 计划进行检查,读取配额窗口、重置证据、凭据和工作区状态。受控的配额冷却和账号操作队列支持审查与恢复。
部署与运维
完整模式以单个 Docker 容器或适用于 amd64/arm64 的原生 Linux、macOS 或 Windows 软件包运行,并可与 CPA 并行运行。轻量面板模式在端口 8317 上替代官方 CPA UI,而无需增加另一个服务。完整栈在端口 18317 上暴露面板。安装脚本支持引导式部署、试运行预览、升级、修复和管理员密钥恢复。请求历史、配置、自动化状态和模型价格保存在本地文件中;SQLite 文件必须与 data.key 一起备份,以保留加密的 CPA Management Keys。只读根文件系统或非 root 环境需要可写的临时目录和数据库文件。
隐私与安全
该项目声明不会回传数据、不包含分析 SDK,也不要求账号注册。外部调用仅限于用户配置或触发的 CPA 网关和集成,例如 OAuth、提供商检查、插件发布和模型价格同步。管理密钥在持久化到 SQLite 之前会被加密,常规 API 和 JSONL 导出仅暴露脱敏后的失败摘要,而非原始失败正文。它旨在用于操作者有权管理的流量和凭据。
开发与发布
Web 应用使用 npm 脚本进行开发、类型检查、lint、测试、构建和文档生成;Manager Server 基于 Go,使用 go test、race 测试和 vet。发布流程会生成单文件 management.html、原生软件包以及适用于 linux/amd64 和 linux/arm64 的 Docker 镜像,并采用经过验证的串行发布流程。基于 MIT 许可证授权。
评论
0 人表达喜爱 · 满10人后显示 Deer Point
登录后参与讨论。