CPA Manager Plus : un panneau d'administration et d'observabilité auto-hébergé pour CPA / CLIProxyAPI
Un panneau de gestion CPA/CLIProxyAPI auto-hébergé et un tableau de bord d'observabilité de la passerelle AI pour les demandes, l'utilisation, le coût, le quota, les échecs et l'état du compte.
En bref
- De quoi s’agit-il ?
- Un panneau qui gère les fournisseurs CPA, les identifiants et les quotas, et conserve l'historique des requêtes, l'analyse des coûts et la santé des comptes dans le stockage local.
- À qui s’adresse-t-il ?
- CPA Manager Plus ajoute un historique persistant des requêtes, une analyse des coûts et une inspection de la santé des comptes à un déploiement CPA, le tout stocké dans des fichiers locaux et publié sous licence MIT. Ce n'est pas un proxy en soi, mais une couche d'administration et d'observabilité pour CPA / CLIProxyAPI.
- Puis-je l’utiliser commercialement ?
- Oui. MIT est une licence permissive : vous pouvez utiliser, modifier et vendre un logiciel qui en dépend, à condition de conserver les mentions de droit d’auteur et de licence.
- Est-il encore maintenu ?
- Oui. Les derniers commits datent d’il y a 1 jour.
- En quel langage est-il écrit ?
- Principalement TypeScript, d’après les statistiques de langage de GitHub.
Ces réponses reposent sur les données GitHub du projet (dernière synchronisation le 14 septembre 2026) et sur notre analyse. Elles ne constituent pas un avis juridique.
ANALYSE OPEN SOURCE APPROFONDIE
Un panneau auto-hébergé pour CPA / CLIProxyAPI
CPA Manager Plus est un panneau auto-hébergé pour CPA / CLIProxyAPI. Il gère les fournisseurs, les identifiants, OAuth, les plugins et la configuration, et conserve l'historique des requêtes, l'analyse des coûts et l'automatisation des comptes dans le stockage local. Le README le présente comme un moyen de répondre aux questions sur les échecs de requêtes, la répartition des coûts et la santé des comptes et des quotas. Ce n'est pas un proxy de remplacement ; il ne transmet pas lui-même le trafic de modèles.
Panneau léger versus mode complet
Le README décrit trois façons de gérer l'interface d'administration CPA. Le centre d'administration officiel CLI Proxy API est maintenu par le projet CPA. Le panneau léger CPAMP remplace l'interface officielle sur le même port, :8317, sans ajouter un autre service ou une base de données. Le mode complet CPAMP exécute un serveur Manager séparé sur :18317 et ajoute l'historique des requêtes, l'analyse des coûts, l'inspection et l'automatisation. La documentation compare les options dans un guide sur le choix d'un panneau.
Configuration des fournisseurs, surveillance des requêtes et analyse des coûts
Le panneau gère les configurations des fournisseurs CPA pour Gemini, Codex, Claude, Vertex, xAI et les fournisseurs compatibles OpenAI. Il maintient les fichiers d'authentification, les connexions OAuth, les clés API, les alias de modèles, les priorités, les plugins, les journaux et les paramètres système. Il peut importer les exports OAuth officiels Sub2API OpenAI et diviser plusieurs comptes en fichiers d'authentification CPA Codex séparés. Pour la surveillance, il persiste les requêtes de la file d'attente d'utilisation CPA dans SQLite local et permet de rechercher par compte, clé API client et vues de requêtes en temps réel. Les preuves d'échec sont expurgées, donc les corps d'échec bruts ne sont pas exposés. L'historique des requêtes peut être exporté et importé en JSONL. L'analyse des coûts décompose les appels, les jetons, les coûts, la latence et les échecs par modèle, fournisseur, compte, identifiant, clé API, projet, canal et plage de temps. Les prix des modèles sont synchronisés d'abord depuis models.dev, avec des replis LiteLLM et OpenRouter et des surcharges locales.
Santé des comptes, quotas et récupération automatisée
Le panneau inspecte les comptes Codex et xAI localement ou selon un calendrier du serveur Manager. Il lit les fenêtres de quota, les preuves de réinitialisation, l'état des identifiants, l'état de l'espace de travail et les signaux de santé spécifiques au fournisseur lorsqu'ils sont disponibles. Il peut appliquer des périodes de refroidissement de quota contrôlées et acheminer les échecs d'identifiants vers une file d'actions de compte pour examen et récupération. Le README pointe vers des pages de démo distinctes pour l'inspection des comptes et les fichiers d'authentification.
Déploiement et première configuration
Le démarrage rapide propose un script d'installation guidé qui prend en charge le déploiement complet ou CPAMP uniquement. Vous pouvez prévisualiser l'installateur avec CPAMP_DRY_RUN=1. Pour une configuration Docker Compose, l'exemple exécute CPA et CPA Manager Plus comme deux services, exposant CPA sur 8317 et le serveur Manager sur 18317. Après le démarrage, ouvrez http://<host>:18317/management.html, récupérez la clé d'administration CPAMP dans le journal du serveur Manager, puis saisissez l'URL CPA et la clé d'administration CPA. Le README recommande la version CPA v7.1.39+ et note que la file d'attente d'utilisation HTTP nécessite v6.10.8+.
Stockage des données, confidentialité et chiffrement
CPA Manager Plus stocke l'historique des requêtes, la configuration, les prix des modèles, l'historique d'inspection et l'état d'automatisation dans des fichiers locaux. Le README déclare qu'il ne communique pas à distance, n'inclut pas de SDK d'analyse et ne nécessite pas d'enregistrement de compte. Les appels externes sont limités à la passerelle CPA et aux intégrations que vous configurez ou déclenchez explicitement, comme OAuth, les vérifications de fournisseurs, les versions de plugins et la synchronisation des prix des modèles. Les clés d'administration CPA sont chiffrées avant la persistance SQLite ; les sauvegardes nécessitent les fichiers SQLite et data.key. Les API normales et les exports JSONL exposent des résumés d'échec expurgés, jamais les corps d'échec bruts ou le JSON brut stocké. Le projet est destiné au trafic et aux identifiants que vous êtes autorisé à opérer.
Développement, publication et licence
Le dépôt est écrit en TypeScript, avec un serveur Manager en Go dans apps/manager-server. Les commandes de développement incluent npm install, npm run dev, type-check, lint, test et build, ainsi que go test et go vet pour le serveur Manager. Le processus de publication construit un fichier unique apps/web/dist/index.html et l'intègre dans les paquets natifs. Les notes de version sont validées avant de pousser une balise stricte vX.Y.Z ou de pré-version. Le projet est publié sous licence MIT, copyright 2026 Seakee. La licence accorde la permission d'utiliser, copier, modifier, fusionner, publier, distribuer, sous-licencier et vendre des copies. Elle décline toute garantie et responsabilité ; le README ne décrit aucune garantie de support ou de sécurité supplémentaire.
Conclusion éditoriale
CPA Manager Plus ajoute un historique persistant des requêtes, une analyse des coûts et une inspection de la santé des comptes à un déploiement CPA, le tout stocké dans des fichiers locaux et publié sous licence MIT. Ce n'est pas un proxy en soi, mais une couche d'administration et d'observabilité pour CPA / CLIProxyAPI.
Notes de la communauté