En
9d76e178de
- 更新 application-dev/test/prod.yml 环境配置 - 更新 V35 清理旧套餐表的迁移脚本 - 添加部署相关文档和脚本 - 移除 CLEAN_V10_FAILED.sql 临时文件
171 lines
3.0 KiB
Markdown
171 lines
3.0 KiB
Markdown
# 宝塔部署快速配置指南
|
||
|
||
## 第一次部署前，请在宝塔面板完成以下操作：
|
||
|
||
### 1. 安装基础服务
|
||
|
||
登录宝塔面板 → 软件商店 → 安装以下软件：
|
||
|
||
| 软件 | 版本 | 说明 |
|
||
|------|------|------|
|
||
| Nginx | 1.24+ | Web 服务器 |
|
||
| MySQL | 8.0+ | 数据库 |
|
||
| Redis | 7.x | 缓存 |
|
||
| Java | JDK 17 | 运行环境 |
|
||
|
||
### 2. 创建数据库
|
||
|
||
宝塔面板 → 数据库 → 添加：
|
||
|
||
```
|
||
数据库名：lesingle-edu-reading-platform
|
||
用户名：reading_platform
|
||
密码：[设置一个强密码，记下来]
|
||
权限：全部
|
||
```
|
||
|
||
### 3. 配置环境变量
|
||
|
||
复制配置文件模板：
|
||
|
||
```bash
|
||
cp .env.prod.template .env.prod
|
||
```
|
||
|
||
编辑 `.env.prod`，填入实际值：
|
||
|
||
```bash
|
||
# 数据库密码（从宝塔获取）
|
||
DB_PASSWORD=你的数据库密码
|
||
|
||
# JWT 密钥（必须修改）
|
||
JWT_SECRET=你的-production-jwt-secret-至少-32-字符
|
||
|
||
# Redis 密码（如果宝塔设置了）
|
||
REDIS_PASSWORD=
|
||
```
|
||
|
||
### 4. 修改部署脚本配置
|
||
|
||
编辑 `deploy-backend.sh`，找到环境变量部分，填入你的配置：
|
||
|
||
```bash
|
||
# 在启动脚本中添加环境变量
|
||
export DB_PASSWORD=你的数据库密码
|
||
export JWT_SECRET=你的 JWT 密钥
|
||
```
|
||
|
||
或者在服务器上创建 `/www/wwwroot/reading-platform/.env` 文件。
|
||
|
||
---
|
||
|
||
## 一键部署
|
||
|
||
```bash
|
||
# 方式 1：使用主部署脚本
|
||
./deploy.sh root@你的服务器 IP
|
||
|
||
# 方式 2：分别部署
|
||
export REMOTE_HOST=你的服务器 IP
|
||
./deploy-backend.sh # 部署后端
|
||
./deploy-frontend.sh # 部署前端
|
||
```
|
||
|
||
---
|
||
|
||
## 部署后配置
|
||
|
||
### 1. 配置 Nginx 反向代理
|
||
|
||
宝塔面板 → 网站 → 你的网站 → 设置 → 配置文件：
|
||
|
||
粘贴 `nginx-baota.conf` 中的配置。
|
||
|
||
### 2. 验证部署
|
||
|
||
```bash
|
||
# SSH 登录服务器
|
||
ssh root@你的服务器 IP
|
||
|
||
# 检查后端健康状态
|
||
curl http://localhost:8480/actuator/health
|
||
|
||
# 查看后端日志
|
||
tail -f /www/wwwroot/reading-platform/logs/app.log
|
||
```
|
||
|
||
### 3. 访问应用
|
||
|
||
- 前端：http://你的服务器 IP
|
||
- API 文档：http://你的服务器 IP:8480/swagger-ui.html
|
||
|
||
---
|
||
|
||
## 常用命令
|
||
|
||
### 后端管理
|
||
|
||
```bash
|
||
# 登录服务器
|
||
ssh root@你的服务器 IP
|
||
|
||
# 进入目录
|
||
cd /www/wwwroot/reading-platform
|
||
|
||
# 启动
|
||
./start.sh
|
||
|
||
# 停止
|
||
./stop.sh
|
||
|
||
# 查看日志
|
||
tail -f logs/app.log
|
||
|
||
# 查看进程
|
||
ps aux | grep app.jar
|
||
```
|
||
|
||
### 前端更新
|
||
|
||
```bash
|
||
# 本地重新构建并部署
|
||
./deploy-frontend.sh root@你的服务器 IP
|
||
```
|
||
|
||
---
|
||
|
||
## 问题排查
|
||
|
||
### 后端启动失败
|
||
|
||
```bash
|
||
# 查看详细日志
|
||
tail -100 /www/wwwroot/reading-platform/logs/app.log
|
||
|
||
# 检查 Java 版本
|
||
java -version
|
||
|
||
# 检查端口占用
|
||
netstat -tlnp | grep 8480
|
||
```
|
||
|
||
### 前端页面空白
|
||
|
||
1. 打开浏览器 Console（F12）
|
||
2. 查看 Network 标签，检查 API 请求
|
||
3. 确认 Nginx 反向代理配置正确
|
||
|
||
### 数据库连接失败
|
||
|
||
1. 确认数据库已创建
|
||
2. 确认数据库密码正确
|
||
3. 确认 MySQL 服务运行中
|
||
|
||
---
|
||
|
||
## 需要帮助？
|
||
|
||
- 详细部署文档：`DEPLOY_BAOTA.md`
|
||
- Nginx 配置：`nginx-baota.conf`
|
||
- 环境变量模板：`.env.prod.template`
|