# 部署指南

## 方式一：Docker 部署（推荐）

### 1. 构建镜像

```bash
docker build -t ai-video-assistant-web ./web
```

### 2. 运行容器

```bash
docker run -d \
  --name ai-assistant-web \
  -p 3000:80 \
  ai-video-assistant-web
```

### 3. 使用 Docker Compose

```yaml
version: '3.8'

services:
  web:
    build: ./web
    ports:
      - "3000:80"
    environment:
      - VITE_API_URL=http://api:8080
```

运行：
```bash
docker-compose up -d
```

## 方式二：Nginx 部署

### 1. 构建前端

```bash
cd web
npm run build
```

### 2. 配置 Nginx

```nginx
server {
    listen 80;
    server_name your-domain.com;
    root /var/www/ai-assistant/dist;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    location /api {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}
```

### 3. 启动 Nginx

```bash
sudo nginx -t
sudo systemctl reload nginx
```

## 环境变量配置

| 变量 | 说明 | 默认值 |
|------|------|--------|
| VITE_API_URL | 后端 API 地址 | http://localhost:8080 |
| VITE_GEMINI_API_KEY | Gemini API Key | - |

## 验证部署

1. 访问 http://your-domain.com
2. 检查页面是否正常加载
3. 验证各功能模块是否可用

## 故障排查

| 问题 | 解决方案 |
|------|---------|
| 页面空白 | 检查浏览器控制台错误 |
| API 请求失败 | 确认 VITE_API_URL 配置正确 |
| 静态资源 404 | 检查 nginx try_files 配置 |