CPA Usage Keeper: Nutzungsdaten von CLIProxyAPI belastbar auswerten

Ein Dashboard, das CLIProxyAPI-Nutzung speichert

CPA Usage Keeper ist eine eigenständige Go-Anwendung, die eine Verbindung zu einer CLIProxyAPI-Instanz (CPA) herstellt und Nutzungsdaten in SQLite speichert. Es ruft CPA-Konfigurations- und Anmeldedaten ab und stellt dann ein Web-Dashboard für Nutzung, Kosten, Anforderungsgesundheit, Kontingente und Modell-/API-Statistiken bereit. Das Repository enthält ein React- und TypeScript-Frontend unter web/ und ein Go-Backend unter cmd/server und internal/. Das README beschreibt das Projekt mit dem Slogan „Every flow leaves a trace", was seiner Rolle als dauerhafte Aufzeichnung der CPA-Aktivität entspricht.

Was das Dashboard verfolgt und anzeigt

Laut README zeichnet der Tracker Anfragen, Token, Kosten, Cache-Nutzung, Erfolgsrate, RPM/TPM und Latenz auf, mit Filtern für Zeitbereich, Modell, API-Schlüssel, Quelle und Ergebnis. Es unterstützt auch die Inspektion und den Export von Ereignissen auf Anforderungsebene mit konfigurierbaren Tabellenspalten. Die Analyseansichten umfassen Nutzungstrends, Kostenstruktur, Modell-/API-Schlüssel-/AI-Anbieter-Mix, stündliche Heatmaps und Latenzdiagnose. Es gibt einen Überwachungsbereich für Auth Files und AI Providers, einschließlich Gesundheitsprüfung und Kontingentaktualisierung. Optional können Benutzer an Community-Rankings teilnehmen, nach Gesamtpunktzahl, Tokens, Anfragen, Cache-Rate, durchschnittlicher TTFT/Latenz oder Spitzen-TPM/RPM.

Bereitstellungsoptionen und der empfohlene Weg

Docker Compose ist die empfohlene Bereitstellungsmethode. Das Repository bietet Vorlagen für einen vollständigen Stack, der CPA und Keeper zusammen ausführt, und einen Nur-Keeper-Stack, wenn CPA bereits vorhanden ist. Beide unterstützen linux/amd64 und linux/arm64. Für bestehende CPA-Bereitstellungen, die die Docker-CLI bevorzugen, wird ein docker run-Beispiel angegeben. Auf macOS wird Homebrew mit einem Tap und Dienst empfohlen. Linux-Binärdateien für amd64 und arm64 sind in den Releases verfügbar, und eine systemd-Dienstvorlage ist enthalten. Windows-Binärdateien für amd64 und arm64 sind ebenfalls verfügbar. Der Anmeldeschutz ist standardmäßig aktiviert, daher sollte LOGIN_PASSWORD vor dem Start festgelegt werden.

Wichtige Konfigurationsvariablen

Zwei Variablen sind erforderlich: CPA_BASE_URL, die serverseitige CPA-Adresse, und CPA_MANAGEMENT_KEY, mit der CPA-Verwaltungs-APIs gelesen werden. Für den Webzugriff steuern APP_HOST und APP_PORT die Listen-Adresse und den Port (Standard 8080), und APP_BASE_PATH ermöglicht ein Unterpfad-Präfix. CPA_PUBLIC_URL legt die öffentliche CPA-URL für den Zurück-Link und das CPAMC-Frame-Vertrauen fest. Der Anmeldeschutz verwendet AUTH_ENABLED (Standard true), LOGIN_PASSWORD und AUTH_SESSION_TTL. Zeitzone und Anforderungsverhalten werden mit TZ, REQUEST_TIMEOUT und TLS_SKIP_VERIFY festgelegt. Zu den Speicher- und Sicherungseinstellungen gehören WORK_DIR, LOG_LEVEL, BACKUP_ENABLED, BACKUP_INTERVAL und BACKUP_RETENTION_DAYS. Das README sagt, dass die meisten anderen Einstellungen ihre Standardwerte behalten können.

Hinweise zu Sicherheit und Datenverarbeitung

Das README weist darauf hin, dass Browser-APIs schlüsselähnliche Felder redigieren, aber die SQLite-Datenbank und ihre unverschlüsselten Sicherungen enthalten Originaldaten. Die Authentifizierung ist standardmäßig aktiviert. Wenn sie explizit deaktiviert wird, muss der Zugriff an der Bereitstellungsgrenze eingeschränkt und öffentliches HTTPS an einem Reverse-Proxy beendet werden. Login-Sitzungshashes bleiben in SQLite erhalten, bis zum Abmelden oder Ablauf der TTL. Für die CPAMC-Einbettung wird eine separate Einbettungssitzung verwendet. Redis-Inbox-Nachrichten werden nach Erfolg bis zum aktuellen Tag oder nach Fehler 7 Tage lang aufbewahrt. Während der täglichen Wartung werden rohe usage_events, die älter als 90 lokale Kalendertage sind, in die dauerhaft aufbewahrte Kalt-Tabelle usage_events_archive verschoben.

Lizenz · willxup cpa usage keeper

Das Projekt ist unter der MIT-Lizenz lizenziert, mit Urheberrecht bei Will (2026). Die Lizenz gewährt das Recht, Kopien der Software zu verwenden, zu kopieren, zu modifizieren, zu fusionieren, zu veröffentlichen, zu verteilen, zu unterlizenzieren und zu verkaufen, unter der Bedingung, dass der Urheberrechtshinweis und der Genehmigungshinweis enthalten sind. Die Software wird „wie besehen" bereitgestellt, ohne jegliche ausdrückliche oder stillschweigende Gewährleistung. Das README enthält keine zusätzlichen Garantie- oder Unterstützungszusagen. Diese Einordnung bleibt an den belegten Repository-Angaben: Der konkrete Einstieg erfolgt über die im README genannte Installation, die dort aufgeführten Dateien und die dokumentierten Konfigurationsschlüssel. Für den Betrieb sind Abhängigkeiten, Ausgabeformat, Rechte und Fehlerverhalten am eigenen Beispiel zu kontrollieren. Die Release-Seite zeigt den dokumentierten Entwicklungsstand, ersetzt aber keine Prüfung der passenden Version. Bei Änderungen sollte der Test mit einer kleinen Eingabe beginnen, damit Logs, erzeugte Dateien und Rückgabecodes eindeutig zugeordnet werden können. Erst wenn dieser Ablauf mit dem Projektnamen, dem angegebenen Befehl und der vorgesehenen Umgebung reproduzierbar ist, lässt sich der Umfang des Einsatzes sachlich festlegen.

Redaktionelles Fazit

CPA Usage Keeper ist ein fokussierter Begleiter für CLIProxyAPI, der Nutzungsdaten persistent speichert und über ein Web-Dashboard darstellt. Die Bereitstellung reicht von Docker Compose bis hin zu nativen Binärdateien. Für eine Entscheidung sollten die im README genannten Einstiegspunkte, Abhängigkeiten und Grenzen dieses Projekts am konkreten Einsatzfall geprüft werden.

Offizielle Quellen

1. Official README
2. Project repository
3. Release notes