多站点 CLIProxyAPI / CPA-backend 配额总览面板。

• 在管理面板 /admin 中集中维护多个 CPA 站点
• 每个站点通过 地址 + 管理密钥 建立连接，Docker 部署下持久化保存到宿主机 data/site-connections.json（容器内路径 /app/.data/site-connections.json）
• 服务端并行抓取所有已启用站点的数据，并聚合成单个总览
• 公开页 / 展示最近一次成功聚合的快照
• 支持配额告警：飞书、Telegram、Qmsg、通用 Webhook

线上域名由宿主机 Nginx 站点配置决定。

npm install
SESSION_SECRET=dev-secret npm run dev

• 前端：http://localhost:4178
• 后端：http://localhost:4179

当前生产形态参考 vps-manager 中 new-api + nginx 的方式：

• 应用本体 使用 Docker Compose 运行
• 宿主机 Nginx 继续负责 80/443、证书和域名入口
• 宿主机 Nginx 将站点域名反代到 127.0.0.1:4179
• Docker 容器将 127.0.0.1:4179 映射到容器内应用端口 4179

cp .env.production.example .env.production
# 填写 SESSION_SECRET / ADMIN_PASSWORD 等配置

docker compose build
docker compose up -d

docker compose build
docker compose up -d

# 查看容器状态
docker compose ps

# 查看日志
docker compose logs -f app

# 重启应用
docker compose restart app

# 停止服务
docker compose down

首次访问 /admin 后，直接在页面中新增站点即可，无需再通过登录态注入单个 CPA 凭据。

Docker Compose 默认将宿主机目录 ./data 挂载到容器内 /app/.data，因此以下文件会保留：

• data/site-connections.json
  • 保存站点地址、管理密钥、启用状态
• data/alert-config.json
  • 保存告警渠道、Webhook/Token、规则配置

以下状态仍是内存级，容器重启后会丢失：

• 管理后台登录会话
• usage / quota 缓存
• 最近一次公开快照 publicOverview

这意味着重启后需要重新登录，首次请求会重新预热缓存，公开页在调度器或手动刷新前可能暂时没有快照。

• Dockerfile
• docker-compose.yml
• deploy/cpas.nginx.conf.example（宿主机 Nginx 站点配置示例）
• .env.production.example

• 站点保存时会先调用 CPA 管理 API 校验地址和管理密钥
• 聚合总览允许部分站点失败，失败信息会显示在站点状态卡片中
• 定时器会持续刷新公开快照，并基于聚合结果触发告警
• 生产证书和 80/443 入口由宿主机 Nginx 管理，不在 Docker 容器中重复维护

本项目由 AiCarrox 维护