mirror of
https://github.com/okxlin/appstore.git
synced 2026-09-26 00:01:06 +00:00
71 lines
2.8 KiB
Markdown
71 lines
2.8 KiB
Markdown
# CPA Usage Keeper
|
|
|
|
## 应用简介
|
|
独立的 Cli-Proxy-API 用量追踪与展示服务。
|
|
|
|
英文说明：Standalone Cli-Proxy-API usage tracker.
|
|
|
|
## 部署说明
|
|
- 本应用使用 Docker Compose 在 1Panel 中部署。
|
|
- 应用分类：工具。
|
|
- 支持架构：amd64、arm64。
|
|
- 可选版本：`latest`、`1.11.3`。
|
|
- 安装后按应用表单中的端口访问 Web UI、SSH 或对应服务。
|
|
|
|
## 端口
|
|
| 变量 | 说明 | 默认值 | 必填 |
|
|
| --- | --- | --- | --- |
|
|
| PANEL_APP_PORT_HTTP | 端口 | 8080 | 是 |
|
|
|
|
## 数据持久化
|
|
| 变量 | 说明 | 默认值 | 必填 |
|
|
| --- | --- | --- | --- |
|
|
| APP_BASE_PATH | 子路径前缀 | - | 否 |
|
|
| APP_DATA_DIR | 数据目录 | ./data | 是 |
|
|
|
|
升级或迁移前，请在 1Panel 中备份上述数据目录。
|
|
|
|
## 配置项
|
|
| 变量 | 说明 | 默认值 | 必填 |
|
|
| --- | --- | --- | --- |
|
|
| CPA_BASE_URL | CPA 服务地址 | - | 是 |
|
|
| CPA_MANAGEMENT_KEY | CPA 管理密钥 | - | 是 |
|
|
| REDIS_QUEUE_ADDR | CPA Redis 地址 | - | 否 |
|
|
| AUTH_ENABLED | 启用登录保护 | false | 否 |
|
|
| LOGIN_PASSWORD | 登录密码 | - | 否 |
|
|
| LOG_LEVEL | 日志级别 | info | 否 |
|
|
| AUTH_SESSION_TTL | 登录会话时长 | 168h | 否 |
|
|
| REDIS_QUEUE_TLS | Redis TLS | false | 否 |
|
|
| REDIS_QUEUE_BATCH_SIZE | Redis 批次大小 | 1000 | 否 |
|
|
| REDIS_QUEUE_IDLE_INTERVAL | Redis 空闲间隔 | 1s | 否 |
|
|
|
|
## 使用说明
|
|
### 配置说明
|
|
|
|
| 变量 | 必填 | 默认值 | 说明 |
|
|
|------|------|--------|------|
|
|
| `CPA_BASE_URL` | 是 | - | CPA 服务地址 |
|
|
| `CPA_MANAGEMENT_KEY` | 是 | - | CPA management key |
|
|
| `AUTH_ENABLED` | 否 | `false` | 是否启用登录保护 |
|
|
| `LOGIN_PASSWORD` | 鉴权启用时必填 | - | 登录密码 |
|
|
| `AUTH_SESSION_TTL` | 否 | `168h` | 登录会话有效时长 |
|
|
| `REDIS_QUEUE_ADDR` | 否 | `CPA_BASE_URL` 主机名 + `8317` | CPA Redis 地址 |
|
|
| `REDIS_QUEUE_TLS` | 否 | `false` | Redis TLS 连接 |
|
|
| `REDIS_QUEUE_BATCH_SIZE` | 否 | `1000` | Redis 每次拉取批次大小 |
|
|
| `REDIS_QUEUE_IDLE_INTERVAL` | 否 | `1s` | Redis 空闲检查间隔 |
|
|
| `REQUEST_TIMEOUT` | 否 | `30s` | 请求 CPA 接口超时 |
|
|
| `TLS_SKIP_VERIFY` | 否 | `false` | 跳过 TLS 证书验证 |
|
|
| `APP_BASE_PATH` | 否 | - | 子路径部署前缀，例如 `/cpa` |
|
|
| `APP_DATA_DIR` | 否 | `./data` | 数据目录 |
|
|
| `TZ` | 否 | `Asia/Shanghai` | 时区 |
|
|
| `LOG_LEVEL` | 否 | `info` | 日志级别 |
|
|
| `LOG_FILE_ENABLED` | 否 | `true` | 是否写入持久化日志 |
|
|
| `LOG_RETENTION_DAYS` | 否 | `7` | 日志保留天数 |
|
|
| `BACKUP_ENABLED` | 否 | `true` | 是否启用 SQLite 备份 |
|
|
| `BACKUP_INTERVAL` | 否 | `24h` | 备份间隔 |
|
|
| `BACKUP_RETENTION_DAYS` | 否 | `7` | 备份保留天数 |
|
|
|
|
## 参考资料
|
|
- 官网: <https://github.com/Willxup/cpa-usage-keeper>
|
|
- 文档: <https://github.com/Willxup/cpa-usage-keeper/blob/main/README.md>
|