CPA-Manager-Plus
一個自託管的 CPA / CLIProxyAPI 管理面板與 AI 閘道可觀測性儀表板,用於請求、使用量、成本、配額、失敗及帳戶健康狀況。
CPA-Manager-Plus 是什麼?
一個自託管的 CPA / CLIProxyAPI 管理面板與 AI 閘道可觀測性儀表板,用於請求、使用量、成本、配額、失敗及帳戶健康狀況。
CPA-Manager-Plus 概覽
這是什麼
CPA Manager Plus (CPAMP) 是一個自託管的 CPA / CLIProxyAPI 管理面板與 AI 閘道可觀測性儀表板,提供持續的請求歷史記錄、成本分析、帳戶健康檢查與自動化功能。
主要功能
- CPA 閘道管理:管理提供者設定(Gemini、Codex、Claude、Vertex、xAI、Devin、Muse/Meta、OpenAI 相容)、驗證檔案、OAuth 登入、API 金鑰、模型別名、優先順序、外掛、日誌與系統設定。
- 請求監控與故障診斷:將請求持久化儲存於本地 SQLite,可依帳戶/用戶端 API 金鑰搜尋,檢視狀態、延遲、Token、快取、追蹤與經過編輯的失敗證據。支援 JSONL 格式匯出/匯入請求歷史。
- 成本與用量分析:依模型、提供者、帳戶、憑證、API 金鑰、專案、頻道與時間範圍細分呼叫次數、Token、成本、延遲與失敗。從 models.dev 同步模型價格,並以 LiteLLM 與 OpenRouter 作為備援。
- 帳戶健康、配額與自動化:檢查 Codex 與 xAI 帳戶,讀取配額視窗、重置證據、憑證狀態、工作區狀態,並套用受控配額冷卻。將憑證失敗路由至帳戶動作佇列。
- 生產營運:以單一 Docker 容器或原生套件(Linux、macOS、Windows)執行,支援 amd64/arm64。可備份 SQLite 檔案與 data.key。無需帳戶註冊或遙測 SDK。
使用情境
- 診斷請求失敗原因:檢查失敗率、狀態碼、受影響的模型/帳戶與編輯後的證據。
- 追蹤成本流向:依模型、提供者、帳戶、API 金鑰、專案、頻道與時間範圍細分 Token 與預估成本。
- 監控帳戶與配額健康:檢視憑證狀態、配額視窗、重置證據,以及針對 Codex 與 xAI 帳戶的受控自動化。
快速開始
引導式全棧或僅 CPAMP 部署: bash curl -fsSLO https://raw.githubusercontent.com/seakee/CPA-Manager-Plus/main/bin/install-cpamp.sh bash install-cpamp.sh 不部署僅預覽: bash CPAMP_DRY_RUN=1 bash install-cpamp.sh 使用 Docker Compose 同時執行 CPA 與 CPAMP: ```yaml services: cli-proxy-api: image: eceasy/cli-proxy-api:latest restart: unless-stopped ports:
- '8317:8317' volumes:
- cpa-data:/app/data cpa-manager-plus: image: seakee/cpa-manager-plus:latest restart: unless-stopped ports:
- '18317:18317' volumes:
- cpa-manager-plus-data:/data volumes: cpa-data: cpa-manager-plus-data:
bash docker compose up -d開啟 `http://:18317/management.html`,從 Manager Server 日誌取得 CPAMP 管理金鑰,然後在設定中輸入 CPA URL 與 CPA 管理金鑰。 僅 CPAMP(若 CPA 已在執行):bash docker run -d --name cpa-manager-plus --restart unless-stopped -p 18317:18317 -v cpa-manager-plus-data:/data seakee/cpa-manager-plus:latest ``` 建議 CPA 版本:v7.3.4+。HTTP 用量佇列需要 v6.10.8+。
授權與價格
本專案採用 MIT 授權,為開源軟體。
內容整理自該專案公開的 README 與儲存庫資訊。