# AI 语音面试系统 - 部署文档

> 更新日期: 2026-01-21
> 状态: ✅ 已部署

## 一、服务器信息

| 项目 | 值 |
|------|-----|
| 服务器 IP | 47.107.172.23 |
| SSH 用户名 | root |
| SSH 密码 | Nj861021 |
| 宝塔面板 | http://47.107.172.23:8888/ |
| 宝塔 API Token | PKdfnaInQL0P5ghB8SvwbrGcIpXWaEvq |
| 域名解析 | *.ai.ireborn.com.cn → 47.107.172.23 |
| 测试域名 | *.test.ai.ireborn.com.cn |

## 二、部署地址 (已上线)

| 服务 | 地址 | 状态 |
|------|------|------|
| 用户端 | http://interview.test.ai.ireborn.com.cn | ✅ |
| 管理后台 | http://interview.test.ai.ireborn.com.cn/admin | ✅ |
| 后端 API | http://interview.test.ai.ireborn.com.cn/api/health | ✅ |
| 文件服务 | https://files.test.ai.ireborn.com.cn | ✅ |

> ⚠️ 当前为简化版后端，完整功能代码需要手动上传后重新构建

## 三、Docker 部署

### 3.1 目录结构

```
/www/wwwroot/ai-interview/
├── deploy/
│   ├── docker-compose.yml
│   ├── Dockerfile.frontend
│   ├── Dockerfile.backend
│   ├── nginx/
│   │   └── frontend.conf
│   └── .env
├── frontend/
├── backend/
└── uploads/
```

### 3.2 环境变量配置

创建 `/www/wwwroot/ai-interview/deploy/.env`:

```bash
# Coze 配置
COZE_PAT_TOKEN=pat_nd1wU47WyPS9GCIyJ1clnH8h1WOQXGrYELX8w73TnSZaYbFdYD4swIhzcETBUbfT
COZE_BOT_ID=7595113005181386792

# 工作流 ID
COZE_WORKFLOW_A_ID=7597357422713798710
COZE_WORKFLOW_C_ID=7597376294612107318

# 文件服务器
FILE_SERVER_URL=https://files.test.ai.ireborn.com.cn
FILE_SERVER_TOKEN=ai_interview_2026_secret
```

### 3.3 部署命令

```bash
cd /www/wwwroot/ai-interview/deploy

# 构建并启动
docker-compose up -d --build

# 查看日志
docker-compose logs -f

# 停止服务
docker-compose down

# 重启服务
docker-compose restart
```

### 3.4 端口映射

| 服务 | 容器端口 | 宿主机端口 |
|------|----------|------------|
| Frontend | 80 | 3000 |
| Backend | 8000 | 8000 |

## 四、Nginx 反向代理配置

### 4.1 前端 + API 合并 (推荐)

域名: `interview.test.ai.ireborn.com.cn`

```nginx
server {
    listen 80;
    listen 443 ssl http2;
    server_name interview.test.ai.ireborn.com.cn;

    # SSL 证书 (宝塔自动配置)
    ssl_certificate /www/server/panel/vhost/cert/interview.test.ai.ireborn.com.cn/fullchain.pem;
    ssl_certificate_key /www/server/panel/vhost/cert/interview.test.ai.ireborn.com.cn/privkey.pem;

    # 前端
    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # API 代理 (前端容器内部已处理，此处可选)
    location /api/ {
        proxy_pass http://127.0.0.1:8000/api/;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_read_timeout 120s;
    }
}
```

### 4.2 独立 API 域名 (可选)

域名: `interview-api.test.ai.ireborn.com.cn`

```nginx
server {
    listen 80;
    listen 443 ssl http2;
    server_name interview-api.test.ai.ireborn.com.cn;

    ssl_certificate /www/server/panel/vhost/cert/interview-api.test.ai.ireborn.com.cn/fullchain.pem;
    ssl_certificate_key /www/server/panel/vhost/cert/interview-api.test.ai.ireborn.com.cn/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 120s;
        proxy_connect_timeout 120s;
        
        # CORS
        add_header Access-Control-Allow-Origin *;
        add_header Access-Control-Allow-Methods 'GET, POST, PUT, DELETE, OPTIONS';
        add_header Access-Control-Allow-Headers 'DNT,X-Mx-ReqToken,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization';
    }
}
```

## 五、更新部署

```bash
cd /www/wwwroot/ai-interview

# 拉取最新代码
git pull origin main

# 重新构建并部署
cd deploy
docker-compose down
docker-compose up -d --build

# 查看状态
docker-compose ps
```

## 六、故障排查

### 6.1 查看容器日志

```bash
# 前端日志
docker logs ai-interview-frontend

# 后端日志
docker logs ai-interview-backend
```

### 6.2 进入容器调试

```bash
# 进入后端容器
docker exec -it ai-interview-backend /bin/sh

# 进入前端容器
docker exec -it ai-interview-frontend /bin/sh
```

### 6.3 常见问题

| 问题 | 解决方案 |
|------|----------|
| 前端白屏 | 检查 nginx 配置，确保 `try_files` 指向 index.html |
| API 404 | 检查 proxy_pass 地址和端口 |
| CORS 错误 | 在 nginx 添加 CORS 头 |
| 环境变量无效 | 确认 .env 文件存在且格式正确 |
