180 lines
4.6 KiB
Markdown
180 lines
4.6 KiB
Markdown
|
# AI 克隆系统部署文档
|
|||
|
|
|
|||
|
|
本文档面向运维/交付人员，描述后端、管理端、uni-app/小程序的部署方式。
|
|||
|
|
|
|||
|
|
## 1. 部署拓扑（推荐）
|
|||
|
|
|
|||
|
|
- 后端（Spring Boot）部署在一台服务器（或容器）上，对外提供 HTTP API。
|
|||
|
|
- 管理端（`admin/dist`）部署为静态站点：
|
|||
|
|
- 方案 A：Nginx 提供静态文件（推荐）
|
|||
|
|
- 方案 B：`pm2 serve` 提供静态文件（简化，无 Nginx）
|
|||
|
|
- uni-app/小程序不直接部署在服务器上（小程序发布到对应平台），只需正确配置后端 API 地址。
|
|||
|
|
|
|||
|
|
## 2. 后端部署（Linux 服务器）
|
|||
|
|
|
|||
|
|
### 2.1 环境要求
|
|||
|
|
|
|||
|
|
- JDK：**8**（与 `ai-clone/pom.xml` 保持一致）
|
|||
|
|
- Maven：如需在服务器编译（推荐本地/CI 编译后上传 jar）
|
|||
|
|
- MySQL：8.x（或已有外部 MySQL）
|
|||
|
|
- 可选：FFmpeg（如视频合成链路依赖，需以实际实现为准）
|
|||
|
|
|
|||
|
|
### 2.2 配置准备
|
|||
|
|
|
|||
|
|
后端配置文件：`ai-clone/src/main/resources/application.properties`
|
|||
|
|
|
|||
|
|
部署前请将以下配置替换为生产值（建议通过外置配置或环境变量注入，避免明文进入代码仓库）：
|
|||
|
|
|
|||
|
|
- `dashscope.api.key`
|
|||
|
|
- `spring.datasource.*`
|
|||
|
|
- `wechat.mini.*`
|
|||
|
|
- `aliyun.sms.*`
|
|||
|
|
- `filehosting.local.path`、`filehosting.url.prefix`
|
|||
|
|
- `server.port`（默认 20002）
|
|||
|
|
|
|||
|
|
### 2.3 打包
|
|||
|
|
|
|||
|
|
在项目目录 `ai-clone/` 执行：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
mvn -U clean package
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
生成：`ai-clone/target/voice-cloning-1.0.0.jar`
|
|||
|
|
|
|||
|
|
### 2.4 运行
|
|||
|
|
|
|||
|
|
#### 方式 A：直接运行（适合临时）
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
java -jar voice-cloning-1.0.0.jar \
|
|||
|
|
--server.port=20002
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 方式 B：使用仓库脚本（示例）
|
|||
|
|
|
|||
|
|
仓库根目录提供了 `start.sh`（示例生产脚本），包含：
|
|||
|
|
|
|||
|
|
- 停止旧进程（PID 文件）
|
|||
|
|
- 释放端口
|
|||
|
|
- 创建目录（logs/static/temp/uploads 等）
|
|||
|
|
- `nohup java -jar ...` 后台启动
|
|||
|
|
|
|||
|
|
注意：`start.sh` 中 `PROJECT_DIR`、`PORT`、`JAVA_BIN`、`SPRING_PROFILE` 需要按你的服务器实际路径/Java 版本调整。
|
|||
|
|
|
|||
|
|
### 2.5 端口与防火墙
|
|||
|
|
|
|||
|
|
- 默认端口：`20002`
|
|||
|
|
- 需要在：
|
|||
|
|
- 服务器防火墙
|
|||
|
|
- 云厂商安全组
|
|||
|
|
放行对应 TCP 端口。
|
|||
|
|
|
|||
|
|
### 2.6 验证
|
|||
|
|
|
|||
|
|
- `GET http://<host>:20002/api/voice/health`
|
|||
|
|
|
|||
|
|
期望返回：`{"status":"ok", ...}`
|
|||
|
|
|
|||
|
|
## 3. 管理端部署（admin）
|
|||
|
|
|
|||
|
|
管理端现有详细文档：
|
|||
|
|
|
|||
|
|
- `admin/部署说明.md`
|
|||
|
|
- `admin/宝塔部署指南.md`
|
|||
|
|
|
|||
|
|
这里给出标准化流程（推荐 Nginx 方案）。
|
|||
|
|
|
|||
|
|
### 3.1 本地构建
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 进入管理端
|
|||
|
|
cd admin
|
|||
|
|
npm install
|
|||
|
|
npm run build
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
产物目录：`admin/dist/`
|
|||
|
|
|
|||
|
|
### 3.2 上传
|
|||
|
|
|
|||
|
|
将 `dist/` 上传到服务器站点目录，例如：
|
|||
|
|
|
|||
|
|
- `/www/wwwroot/fh.admin-ai.cloud/`
|
|||
|
|
|
|||
|
|
### 3.3 Nginx 配置（示例）
|
|||
|
|
|
|||
|
|
> 说明：端口/域名/路径按实际替换。
|
|||
|
|
|
|||
|
|
```nginx
|
|||
|
|
server {
|
|||
|
|
listen 80;
|
|||
|
|
server_name <admin-domain>;
|
|||
|
|
|
|||
|
|
root /www/wwwroot/<admin-site>/;
|
|||
|
|
index index.html;
|
|||
|
|
|
|||
|
|
gzip on;
|
|||
|
|
gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
|
|||
|
|
|
|||
|
|
location / {
|
|||
|
|
try_files $uri $uri/ /index.html;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
# 可选：同域名转发后端（避免跨域）
|
|||
|
|
location /api {
|
|||
|
|
proxy_pass http://127.0.0.1:20002;
|
|||
|
|
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;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3.4 配置管理端 API 地址
|
|||
|
|
|
|||
|
|
管理端使用 `.env.production` 指定 `VITE_API_BASE`，但该文件当前在仓库中可能被 `.gitignore` 忽略。
|
|||
|
|
|
|||
|
|
部署时请确认：
|
|||
|
|
|
|||
|
|
- `VITE_API_BASE=http(s)://<backend-host>:20002`
|
|||
|
|
|
|||
|
|
若采用 Nginx 同域 `/api` 反代，则可配置为相对路径：
|
|||
|
|
|
|||
|
|
- `VITE_API_BASE=/api`
|
|||
|
|
|
|||
|
|
## 4. uni-app / 小程序（frontend-ai）
|
|||
|
|
|
|||
|
|
### 4.1 API 地址配置
|
|||
|
|
|
|||
|
|
配置文件：`frontend-ai/config/api.js`
|
|||
|
|
|
|||
|
|
- 开发/生产环境的 `API_BASE` 可切换
|
|||
|
|
- 说明文档：`frontend-ai/config/README.md`
|
|||
|
|
|
|||
|
|
### 4.2 打包发布
|
|||
|
|
|
|||
|
|
按 uni-app / HBuilderX 的标准流程：
|
|||
|
|
|
|||
|
|
- 小程序：构建后上传微信公众平台审核发布
|
|||
|
|
- App：云打包/本地打包发布
|
|||
|
|
|
|||
|
|
服务器侧只需保证：
|
|||
|
|
|
|||
|
|
- 后端域名/端口可访问
|
|||
|
|
- HTTPS（如小程序要求）
|
|||
|
|
|
|||
|
|
## 5. 常见问题与排障
|
|||
|
|
|
|||
|
|
- **页面刷新 404（管理端 SPA）**
|
|||
|
|
- Nginx 需配置：`try_files $uri $uri/ /index.html;`
|
|||
|
|
- **API 请求失败**
|
|||
|
|
- 检查后端是否启动、端口是否放行、域名解析是否正确
|
|||
|
|
- 若跨域：检查后端 CORS 或通过 Nginx 反代统一域
|
|||
|
|
- **后端静态资源无法访问**
|
|||
|
|
- 检查 `spring.web.resources.static-locations`、`filehosting.local.path` 与服务器实际目录一致
|
|||
|
|
- **配置泄露风险**
|
|||
|
|
- 生产环境请移除/替换明文 Key、数据库密码，并通过环境变量或外置配置管理
|
|||
|
|
|