CPA Manager Plus
프록시 요청과 비용, 계정 상태를 남겨 보는 관리 패널
docker run -d --name cpa-manager-plus -p 18317:18317 -v cpa-manager-plus-data:/data seakee/cpa-manager-plus:latestCLIProxyAPI 를 운영할 때 요청과 사용량, 비용, 할당량, 실패, 계정 상태를 한 화면에서 보는 자체 호스팅 관리 패널입니다. 왜 요청이 실패하는지 실패율과 상태 코드, 영향받은 모델과 계정을 민감한 값을 가린 기록으로 확인하고, 비용이 어디로 가는지 모델과 제공자, 계정, 키, 프로젝트, 기간별로 쪼개 봅니다. 자격 증명 상태와 할당량 구간, 초기화 근거를 검토하고 일부 계정은 자동화된 조치를 겁니다. 원래 관리 화면을 대체하는 가벼운 모드와 기록을 오래 남기는 전체 모드 두 가지로 배포합니다.
판단
이럴 때 씁니다
- 프록시를 통해 나가는 요청의 실패 원인을 추적해야 할 때
- 모델과 계정별로 비용을 쪼개 봐야 할 때
- 자격 증명 할당량과 상태를 주기적으로 확인해야 할 때
이럴 땐 쓰지 마세요
- 해당 프록시를 쓰지 않으면 소용이 없습니다
- 가벼운 모드만 필요하면 기록 저장용 서비스는 과합니다
- 기록에 요청 정보가 남으므로 보관 정책이 필요합니다
차별점
- 요청 기록을 지속 저장해 실패 원인을 나중에 추적합니다.
- 비용을 모델과 제공자, 계정, 키, 프로젝트, 기간별로 쪼갭니다.
- 자격 증명 할당량 구간과 초기화 근거를 함께 보여 줍니다.
- 기존 관리 화면을 대체하는 가벼운 모드가 있어 서비스를 늘리지 않아도 됩니다.
워크플로
- 01설치 스크립트나 컴포즈로 띄웁니다.
- 02관리 화면에 접속합니다.
- 03로그에서 관리자 키를 꺼냅니다.
- 04프록시 주소와 관리 키를 넣어 연결합니다.
- 05요청 기록과 비용 분해, 자격 증명 상태를 확인합니다.
주요 명령
| 명령 | 설명 |
|---|---|
bash install-cpamp.sh | 전체 또는 패널만 배포하는 설치 스크립트입니다. |
CPAMP_DRY_RUN=1 bash install-cpamp.sh | 실제 배포 없이 무엇을 할지 미리 봅니다. |
docker compose up -d | 프록시와 패널을 함께 띄웁니다. |
함정
설치 전에 확인하세요
- 관리자 키가 서버 로그에 찍힙니다. 처음에 꺼내 보관하지 않으면 복구 절차를 밟아야 합니다.
- 권장 프록시 판이 명시돼 있습니다. 사용량 대기열 기능은 그보다 낮은 판에서 동작하지 않습니다.
- 가벼운 모드는 기존 관리 화면을 대체하고 전체 모드는 별도 서비스로 뜹니다. 어느 쪽을 쓸지 먼저 정해야 합니다.
- 요청 기록을 오래 남기는 것이 목적입니다. 민감한 값은 가려 저장하지만 보관 기간과 접근 권한은 직접 정해야 합니다.
비교
프록시 자체 관리 화면은 설정과 상태 확인에 초점이 있습니다. 이쪽은 그 위에 관측을 얹어서 실패와 비용을 시간 축으로 추적하게 만듭니다. 운영을 오래 할수록 이 기록이 판단 근거가 되므로, 프록시를 실제 업무에 쓰고 있다면 붙일 값이 있습니다.
최근 변경
계정 할당량 정보를 찾아보기 쉽게 바꾸고 과거 사용량 표시를 정리했습니다. 키 분석 필터와 인증 자격 증명 동기화, 할당량 수명 주기 경계 문제도 함께 고쳐졌습니다.