QCC Plus 部署指南

服务器信息

测试服务器

• IP: 43.156.77.170
• 用户: ubuntu
• SSH 密钥: ~/.ssh/qcc_deploy
• 端口: 8001
• 容器名: qcctestproxy

生产服务器

• IP: 43.156.77.170
• 用户: ubuntu
• SSH 密钥: ~/.ssh/qcc_deploy
• 端口: 8000
• 容器名: qccprodproxy

自动部署到测试环境

# 1. 确认在 test 分支
git checkout test

# 2. 提交代码
git add .
git commit -m "fix: 描述修复内容"

# 3. 推送触发自动部署
git push origin test

# GitHub Actions 会自动：
# - 构建前端
# - 构建 Docker 镜像
# - 部署到测试服务器（端口 8001）
# - 执行健康检查

快速操作命令

连接服务器

ssh -i ~/.ssh/qcc_deploy [email protected]

查看日志

# 测试环境
ssh -i ~/.ssh/qcc_deploy [email protected] "docker logs qcc_test_proxy -f"

# 生产环境
ssh -i ~/.ssh/qcc_deploy [email protected] "docker logs qcc_prod_proxy -f"

查看容器状态

ssh -i ~/.ssh/qcc_deploy [email protected] "docker ps -a"

重启服务

ssh -i ~/.ssh/qcc_deploy [email protected] "docker restart qcc_test_proxy"

进入容器

ssh -i ~/.ssh/qcc_deploy [email protected] "docker exec -it qcc_test_proxy sh"

查看最近错误日志

ssh -i ~/.ssh/qcc_deploy [email protected] "docker logs qcc_test_proxy --tail 100 2>&1 | grep -i 'error\|failed\|panic'"

快速启动方式

npm 全局安装（推荐）

npm install -g @qccplus/cli
qccplus start

Docker 部署

docker compose up -d

从源码运行

UPSTREAM_BASE_URL=https://api.anthropic.com \
UPSTREAM_API_KEY=sk-ant-your-key \
go run ./cmd/cccli proxy

默认凭证（仅内存模式）

安全警告: 生产环境必须修改默认密码与密钥！

环境变量速查

部署架构

本地开发环境
    ↓ git push origin test
GitHub (test 分支)
    ↓ GitHub Actions 触发
测试服务器 (43.156.77.170:8001)
    ├── 拉取代码
    ├── 构建镜像
    ├── 重启容器
    └── 健康检查

安全提醒

• ✅ 使用 SSH 密钥而非密码认证
• ⚠️ 定期更换 SSH 密钥
• ⚠️ 不要将服务器 IP 硬编码到公开代码中
• ⚠️ 使用环境变量管理敏感配置