bigwo/test2/DEPLOY_BAOTA.md

# 宝塔面板部署指南 — BigWo 语音/文字聊天

> 域名: `demo.tensorgrove.com.cn`  
> 系统: TencentOS 4  
> 架构: Nginx + Node.js + MySQL

---

## 一、宝塔面板准备

### 1.1 安装必要软件（宝塔 → 软件商店）
- **Nginx**（一般已安装）
- **MySQL 5.7 / 8.0**
- **PM2 管理器**（软件商店搜索 "PM2"，一键安装）

### 1.2 安装 Node.js（PM2 管理器 → 设置 → Node 版本）
- 选择 **Node.js 20.x** 安装

---

## 二、上传项目文件

### 2.1 上传
宝塔 → 文件 → 进入 `/www/wwwroot/`，创建文件夹 `demo.tensorgrove.com.cn`

将本地 `test2` 项目中的以下内容上传到 `/www/wwwroot/demo.tensorgrove.com.cn/`：
```
demo.tensorgrove.com.cn/
├── client/        ← 整个前端目录
├── server/        ← 整个后端目录
└── ecosystem.config.js
```

> 可以用宝塔文件管理器直接上传压缩包，然后解压

### 2.2 安装依赖（宝塔 → 终端）

```bash
# 后端依赖
cd /www/wwwroot/demo.tensorgrove.com.cn/server
npm install --production
npm install mysql2

# 前端依赖 & 构建
cd /www/wwwroot/demo.tensorgrove.com.cn/client
npm install
npm run build
```

构建完成后 `client/dist/` 目录就是前端静态文件。

---

## 三、配置 MySQL

### 3.1 创建数据库
宝塔 → 数据库 → 添加数据库：
- 数据库名: `bigwo_chat`
- 用户名: `bigwo`
- 密码: 自己设置（记住）
- 权限: 本地服务器

### 3.2 修改 .env
编辑 `/www/wwwroot/demo.tensorgrove.com.cn/server/.env`，更新 MySQL 配置：

```env
MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USER=bigwo
MYSQL_PASSWORD=你设置的密码
MYSQL_DATABASE=bigwo_chat
```

**同时更新 FC 回调地址：**
```env
FC_SERVER_URL=https://demo.tensorgrove.com.cn/api/voice/fc_callback
```

---

## 四、宝塔添加站点

### 4.1 添加站点
宝塔 → 网站 → 添加站点：
- 域名: `demo.tensorgrove.com.cn`
- 根目录: `/www/wwwroot/demo.tensorgrove.com.cn/client/dist`
- PHP 版本: **纯静态**
- 数据库: 不创建（已在上一步创建）

### 4.2 申请 SSL 证书
网站 → `demo.tensorgrove.com.cn` → SSL → Let's Encrypt：
- 勾选域名 → 申请
- 开启 **强制 HTTPS**

### 4.3 配置 Nginx 反向代理
网站 → `demo.tensorgrove.com.cn` → 配置文件

找到 `server {}` 块，在已有的配置中**添加以下内容**（放在 `location / {}` 之前）：

```nginx
    # ===== 后端 API 反向代理 =====
    location /api/ {
        proxy_pass http://127.0.0.1:3012;
        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;

        # SSE 流式输出支持（文字聊天）
        proxy_set_header Connection '';
        proxy_buffering off;
        proxy_cache off;
        proxy_read_timeout 300s;
        proxy_send_timeout 300s;
    }

    # 静态资源长缓存
    location /assets/ {
        expires 1y;
        add_header Cache-Control "public, immutable";
    }
```

确保 `location / {}` 块中有 SPA 回退（宝塔默认没有，需手动加）：
```nginx
    location / {
        try_files $uri $uri/ /index.html;
    }
```

保存后点击 **保存** 按钮（宝塔会自动 reload Nginx）。

---

## 五、PM2 启动后端

### 方式 A：宝塔 PM2 管理器（推荐）
软件商店 → PM2 管理器 → 设置 → 添加项目：
- 项目路径: `/www/wwwroot/demo.tensorgrove.com.cn/server`
- 启动文件: `app.js`
- 项目名称: `demo.tensorgrove.com.cn-server`

### 方式 B：命令行
```bash
cd /www/wwwroot/demo.tensorgrove.com.cn
pm2 start ecosystem.config.js
pm2 save
pm2 startup
```

---

## 六、验证

### 6.1 检查后端
```bash
curl http://127.0.0.1:3012/api/voice/config
# 应返回 JSON 配置
```

### 6.2 检查前端
浏览器访问 `https://demo.tensorgrove.com.cn`

### 6.3 检查 API 代理
浏览器访问 `https://demo.tensorgrove.com.cn/api/voice/config`

### 6.4 检查 FC 回调
火山引擎 RTC 控制台的 FC 回调地址更新为：
```
https://demo.tensorgrove.com.cn/api/voice/fc_callback
```

---

## 七、常用运维命令

```bash
# 查看后端日志
pm2 logs demo.tensorgrove.com.cn-server

# 重启后端
pm2 restart demo.tensorgrove.com.cn-server

# 重新构建前端
cd /www/wwwroot/demo.tensorgrove.com.cn/client
npm run build

# 查看 Nginx 错误日志
tail -f /www/wwwlogs/demo.tensorgrove.com.cn.error.log
```

---

## 八、注意事项

1. **域名 DNS 解析**：确保 `demo.tensorgrove.com.cn` A 记录指向服务器公网 IP
2. **防火墙**：宝塔 → 安全 → 放行端口 80、443（一般默认已放行）
3. **端口 3012 不需要对外开放**，Nginx 内部转发即可
4. **FC_SERVER_URL** 必须改为 `https://demo.tensorgrove.com.cn/api/voice/fc_callback`（不再用 ngrok）
5. **MySQL 密码** 生产环境务必使用强密码