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>
114 lines
2.1 KiB
Markdown
114 lines
2.1 KiB
Markdown
# 部署指南
|
|
|
|
## 前置要求
|
|
|
|
- Docker 20.10+
|
|
- Docker Compose 2.0+
|
|
- 已备案的域名
|
|
- 域名已解析到服务器 IP
|
|
|
|
## 快速部署
|
|
|
|
### 1. 上传项目到服务器
|
|
|
|
```bash
|
|
scp -r company-celebration2 user@your-server:/opt/
|
|
```
|
|
|
|
### 2. 配置环境变量
|
|
|
|
复制环境变量模板并配置：
|
|
|
|
```bash
|
|
cp .env.example .env
|
|
```
|
|
|
|
编辑 `.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` 替换为你的实际域名：
|
|
|
|
```bash
|
|
cd /opt/company-celebration2
|
|
sed -i 's/your-domain.com/你的域名/g' deploy/Caddyfile
|
|
```
|
|
|
|
同时更新邮箱地址（用于 SSL 证书通知）：
|
|
```bash
|
|
sed -i 's/your-email@example.com/你的邮箱/g' deploy/Caddyfile
|
|
```
|
|
|
|
### 4. 构建并启动
|
|
|
|
```bash
|
|
docker-compose up -d --build
|
|
```
|
|
|
|
Caddy 会自动申请和管理 SSL 证书，无需手动配置。
|
|
|
|
### 5. 查看日志
|
|
|
|
```bash
|
|
docker-compose logs -f
|
|
```
|
|
|
|
## 访问地址
|
|
|
|
| 端点 | 地址 |
|
|
|------|------|
|
|
| 手机端 | https://your-domain.com/ |
|
|
| 大屏端 | https://your-domain.com/screen |
|
|
| 导演控制台 | https://your-domain.com/screen/admin/director-console |
|
|
|
|
## 常用命令
|
|
|
|
```bash
|
|
# 停止服务
|
|
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 语法简单易懂
|
|
|
|
## 故障排查
|
|
|
|
### 证书申请失败
|
|
|
|
确保：
|
|
1. 域名已正确解析到服务器 IP
|
|
2. 服务器 80 和 443 端口已开放
|
|
3. 域名已完成 ICP 备案
|
|
|
|
### 查看证书状态
|
|
|
|
```bash
|
|
docker-compose exec caddy caddy list-certificates
|
|
```
|