Qcc Plus

qcc_plus

qcc_plus 是一个面向 Claude Code CLI 的多租户代理服务，提供账号隔离、节点管理、自动故障切换、React 管理后台、监控大屏、通知、Cloudflare Tunnel 和 npm/Docker 分发能力。

核心能力

- 多租户账号隔离，按 proxy_api_key 路由到账号独立节点池
- 多节点管理，支持权重优先、禁用、激活、自动故障切换
- 健康检查支持 cli、api、head 三种模式
- React 19 + TypeScript + Vite 管理界面
- 监控大屏、分享监控页、WebSocket 实时推送
- 模型定价、使用量汇总、请求日志、模型恢复跟踪
- 通知渠道和订阅管理
- Cloudflare Tunnel 集成
- npm CLI、Docker 镜像、源码三种使用方式

运行模式

- 默认存储不是内存模式，而是本地 SQLite。
- 未设置 PROXY_MYSQL_DSN 时，服务会默认使用 ~/.qccplus/qccplus.db。
- 可通过 PROXY_SQLITE_PATH 指定 SQLite 文件路径。
- 设置 PROXY_MYSQL_DSN 后切换到 MySQL。
- 启动时会自动创建管理员账号 admin/admin123。
- 默认普通账号不会自动创建；首次启动后需要登录管理后台手动创建账号和节点。

快速开始

npm 安装

访问管理界面：http://localhost:8000/admin

首次登录：

- 管理员账号：admin
- 管理员密码：admin123

Docker 本地体验

上面的 docker compose up -d 仅适合本地开发 / 快速体验。

正式测试环境或生产环境部署，请统一使用 scripts/deploy-server.sh test / scripts/deploy-server.sh prod，由脚本负责代码同步、前端构建和 docker compose 重建。

源码运行

最小可用流程

1. 登录 http://localhost:8000/admin
2. 使用 admin/admin123 登录
3. 创建一个普通账号，例如 team-alpha
4. 为该账号添加至少一个节点
5. 使用该账号的 proxy_api_key 调用 /v1/messages

示例：

常用命令

关键环境变量

基础

账号与安全

健康检查

Cloudflare Tunnel

主要路由

前端

- /login
- /admin/dashboard
- /admin/accounts
- /admin/nodes
- /admin/monitor
- /admin/monitor-shares
- /admin/settings
- /settings
- /admin/notifications
- /admin/claude-config
- /admin/pricing
- /admin/usage
- /admin/request-logs
- /admin/model-recovery
- /admin/tunnel
- /changelog
- /monitor/share/:token

后端

- POST /login
- POST /logout
- GET /version
- POST /v1/messages
- GET|POST|PUT|DELETE /admin/api/accounts
- GET|POST|PUT|DELETE /admin/api/nodes
- GET|PUT /admin/api/config
- POST /admin/api/nodes/activate
- POST /admin/api/nodes/disable
- POST /admin/api/nodes/enable
- GET|PUT /admin/api/tunnel
- POST /admin/api/tunnel/start
- POST /admin/api/tunnel/stop
- GET /admin/api/tunnel/zones
- GET…