프로젝트 소개

CPA Manager Plus(CPAMP)는 CPA / CLIProxyAPI 게이트웨이용 자체 호스팅 관리 패널이자 관측 대시보드입니다. 프록시를 대체하는 것이 아니라 CPA를 통과하는 트래픽을 관리하고 관찰하며, 모델 트래픽 자체를 전달하지는 않습니다. 핵심 기능 게이트웨이 관리: Gemini, Codex, Claude, Vertex, xAI, Devin, Muse / Meta 및 OpenAI 호환 엔드포인트를 포함한 CPA 제공자를 구성합니다. 인증 파일, OAuth 로그인, API 키, 모델 별칭, 우선순위, 플러그인, 로그, 시스템 설정을 유지 관리합니다. 공식 Sub2API OpenAI OAuth 내보내기를 가져오고 여러 계정을 별도의 CPA Codex 인증 파일로 분할할 수 있습니다. 요청 모니터링 및 장애 진단: CPA 사용량 큐의 요청은 로컬 SQLite에 영구 저장되며 계정, 클라이언트 API 키 또는 실시간 보기로 검색할 수 있습니다. 상태, 지연 시간, 토큰, 캐시, 추적 및 편집 처리된 장애 증거를 검사할 수 있으며, 기록은 JSONL로 내보내거나 가져올 수 있습니다. 비용 및 사용량 분석: 호출, 토큰, 비용, 지연 시간, 장애를 모델, 제공자, 계정, 자격 증명, API 키, 프로젝트, 채널, 시간 범위별로 분류할 수 있으며, 입력, 출력, 추론, 캐시, 서비스 등급, 장문 컨텍스트 가격 체계를 포함합니다. 모델 가격은 models.dev에서 동기화되며 LiteLLM 및 OpenRouter 폴백과 로컬 재정의를 지원합니다. 계정 상태, 할당량 및 자동화: Codex 및 xAI 계정을 로컬에서 또는 Manager Server 일정에 따라 검사하여 할당량 창, 재설정 증거, 자격 증명 및 작업 공간 상태를 읽을 수 있습니다. 제어된 할당량 쿨다운과 계정 작업 대기열이 검토 및 복구를 지원합니다. 배포 및 운영 Full Mode는 단일 Docker 컨테이너 또는 amd64/arm64용 네이티브 Linux, macOS, Windows 패키지로 실행되며 CPA와 함께 실행할 수 있습니다. 경량 패널 모드는 추가 서비스를 추가하지 않고 포트 8317에서 공식 CPA UI를 대체합니다. 전체 스택은 포트 18317에서 패널을 노출합니다. 설치 스크립트는 안내 배포, 드라이런 미리보기, 업그레이드, 복구, 관리자 키 복구를 지원합니다. 요청 기록, 구성, 자동화 상태, 모델 가격은 로컬 파일에 유지됩니다. 암호화된 CPA 관리 키를 보존하려면 SQLite 파일을 data.key와 함께 백업해야 합니다. 읽기 전용 루트 파일 시스템 또는 비루트 설정에는 쓰기 가능한 임시 디렉터리와 데이터베이스 파일이 필요합니다. 개인정보 보호 및 보안 이 프로젝트는 외부로 전화를 걸지 않고, 분석 SDK를 포함하지 않으며, 계정 등록을 요구하지 않는다고 명시합니다. 외부 호출은 CPA 게이트웨이와 사용자가 구성하거나 트리거하는 통합(예: OAuth, 제공자 점검, 플러그인 릴리스, 모델 가격 동기화)으로 제한됩니다. 관리 키는 SQLite 저장 전에 암호화되며, 일반 API 및 JSONL 내보내기는 원시 장애 본문 대신 편집 처리된 장애 요약을 노출합니다. 운영자가 관리 권한을 가진 트래픽과 자격 증명을 대상으로 합니다. 개발 및 릴리스 웹 앱은 dev, type-check, lint, test, build, docs용 npm 스크립트로 빌드됩니다. Manager Server는 Go 기반이며 go test, 레이스 테스트, vet을 사용합니다. 릴리스는 단일 파일 management.html, 네이티브 패키지, linux/amd64 및 linux/arm64용 Docker 이미지를 생성하며, 검증되고 직렬화된 릴리스 프로세스를 따릅니다. MIT 라이선스로 제공됩니다.