b53e732ffa
- README.md: update scan login section to reflect WeChat OAuth flow - DEPLOY.md: add WeChat environment variables configuration - 联调测试方案.md: update test case A01 for new login flow Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2.1 KiB
2.1 KiB
部署指南
前置要求
- Docker 20.10+
- Docker Compose 2.0+
- 已备案的域名
- 域名已解析到服务器 IP
快速部署
1. 上传项目到服务器
scp -r company-celebration2 user@your-server:/opt/
2. 配置环境变量
复制环境变量模板并配置：
cp .env.example .env
编辑 .env 文件，配置微信开放平台参数：
# 微信开放平台配置（必填）
WECHAT_APP_ID=your_app_id
WECHAT_APP_SECRET=your_app_secret
WECHAT_REDIRECT_URI=https://your-domain.com/api/wechat/callback
注意：需要在微信开放平台配置授权回调域名（只填域名，不含路径）
3. 配置域名
编辑 deploy/Caddyfile，将 your-domain.com 替换为你的实际域名：
cd /opt/company-celebration2
sed -i 's/your-domain.com/你的域名/g' deploy/Caddyfile
同时更新邮箱地址（用于 SSL 证书通知）：
sed -i 's/your-email@example.com/你的邮箱/g' deploy/Caddyfile
4. 构建并启动
docker-compose up -d --build
Caddy 会自动申请和管理 SSL 证书，无需手动配置。
5. 查看日志
docker-compose logs -f
访问地址
| 端点 | 地址 |
|---|---|
| 手机端 | https://your-domain.com/ |
| 大屏端 | https://your-domain.com/screen |
| 导演控制台 | https://your-domain.com/screen/admin/director-console |
常用命令
# 停止服务
docker-compose down
# 重启服务
docker-compose restart
# 查看状态
docker-compose ps
# 清理重建
docker-compose down -v
docker-compose up -d --build
# 查看 Caddy 日志
docker-compose logs caddy
Caddy 优势
- 自动 HTTPS: 自动申请和续期 Let's Encrypt 证书
- 零配置 SSL: 无需手动管理证书文件
- HTTP/2 & HTTP/3: 默认启用现代协议
- 简洁配置: Caddyfile 语法简单易懂
故障排查
证书申请失败
确保：
- 域名已正确解析到服务器 IP
- 服务器 80 和 443 端口已开放
- 域名已完成 ICP 备案
查看证书状态
docker-compose exec caddy caddy list-certificates