# 部署指南

## 前置要求

- 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
```