```
refactor(server): 更新服务器配置和部署脚本- 更改默认端口为3350，以适应生产环境。 - 增加了API信息端点，提供更详细的API状态信息。 - 提高了速率限制，以适应生产环境的更高请求量。 - 添加了错误处理中间件和404处理，增强了错误处理能力。 - 添加了优雅关机处理，确保服务器在接收到SIGINT或SIGTERM信号时能够优雅关闭。- 创建了生产环境配置文件示例 `.env.production.example`，并提供了详细的部署指南 `DEPLOYMENT_GUIDE.md`。 - 添加了启动脚本 `start-server.sh` 和同步脚本 `sync-to-server.sh`，简化了部署流程。 - 配置了Nginx配置文件 `xlxumu-api.conf`，支持HTTPS和反向代理。 ```
This commit is contained in:
218
scripts/DEPLOYMENT_GUIDE.md
Normal file
218
scripts/DEPLOYMENT_GUIDE.md
Normal file
@@ -0,0 +1,218 @@
|
||||
# 锡林郭勒盟智慧养殖平台 - 生产环境部署指南
|
||||
|
||||
## 服务器信息
|
||||
- **服务器地址**: www.jiebanke.com
|
||||
- **服务器系统**: CentOS
|
||||
- **部署目录**: /data/nodejs/xlxumu/
|
||||
- **API域名**: xlapi.jiebanke.com
|
||||
- **服务端口**: 3350
|
||||
|
||||
## 环境要求
|
||||
- Node.js 16+
|
||||
- npm 8+
|
||||
- PM2
|
||||
- Nginx
|
||||
- MySQL 8.0+
|
||||
|
||||
## 部署步骤
|
||||
|
||||
### 1. 服务器环境准备
|
||||
```bash
|
||||
# 登录服务器
|
||||
ssh root@www.jiebanke.com
|
||||
|
||||
# 创建部署目录
|
||||
mkdir -p /data/nodejs/xlxumu/
|
||||
|
||||
# 安装Node.js（如果未安装）
|
||||
curl -fsSL https://rpm.nodesource.com/setup_16.x | bash -
|
||||
yum install -y nodejs
|
||||
|
||||
# 安装PM2
|
||||
npm install -g pm2
|
||||
|
||||
# 安装Nginx
|
||||
yum install -y nginx
|
||||
|
||||
# 安装MySQL客户端（可选）
|
||||
yum install -y mysql
|
||||
```
|
||||
|
||||
### 2. 上传代码到服务器
|
||||
```bash
|
||||
# 在本地开发机器执行同步脚本
|
||||
cd e:/vue/xlxumu
|
||||
./scripts/sync-to-server.sh
|
||||
```
|
||||
|
||||
### 3. 配置生产环境
|
||||
```bash
|
||||
# 在服务器上编辑环境变量
|
||||
vi /data/nodejs/xlxumu/backend/api/.env
|
||||
|
||||
# 内容示例：
|
||||
NODE_ENV=production
|
||||
PORT=3350
|
||||
DB_HOST=生产环境MySQL地址
|
||||
DB_PORT=3306
|
||||
DB_USER=生产环境MySQL用户
|
||||
DB_PASSWORD=生产环境MySQL密码
|
||||
DB_NAME=xlxumu_production
|
||||
JWT_SECRET=your-super-secret-jwt-key-here
|
||||
```
|
||||
|
||||
### 4. 配置Nginx
|
||||
```bash
|
||||
# 上传Nginx配置到服务器
|
||||
scp ./scripts/xlxumu-api.conf root@www.jiebanke.com:/etc/nginx/conf.d/
|
||||
|
||||
# 检查Nginx配置
|
||||
nginx -t
|
||||
|
||||
# 重启Nginx
|
||||
systemctl restart nginx
|
||||
|
||||
# 设置Nginx开机自启
|
||||
systemctl enable nginx
|
||||
```
|
||||
|
||||
### 5. 启动应用服务
|
||||
```bash
|
||||
# 在服务器上执行启动脚本
|
||||
cd /data/nodejs/xlxumu/
|
||||
./scripts/start-server.sh
|
||||
|
||||
# 或者手动启动
|
||||
cd /data/nodejs/xlxumu/backend/api
|
||||
npm install --production
|
||||
pm2 start server.js --name xlxumu-api --env production
|
||||
pm2 startup
|
||||
pm2 save
|
||||
```
|
||||
|
||||
### 6. 配置SSL证书
|
||||
```bash
|
||||
# 将SSL证书文件上传到服务器
|
||||
# 证书文件应放置在：
|
||||
# - /etc/ssl/certs/xlapi.jiebanke.com.crt
|
||||
# - /etc/ssl/private/xlapi.jiebanke.com.key
|
||||
|
||||
# 设置证书文件权限
|
||||
chmod 644 /etc/ssl/certs/xlapi.jiebanke.com.crt
|
||||
chmod 600 /etc/ssl/private/xlapi.jiebanke.com.key
|
||||
```
|
||||
|
||||
## 服务管理命令
|
||||
|
||||
### PM2管理
|
||||
```bash
|
||||
# 查看服务状态
|
||||
pm2 status
|
||||
|
||||
# 查看日志
|
||||
pm2 logs xlxumu-api
|
||||
|
||||
# 重启服务
|
||||
pm2 restart xlxumu-api
|
||||
|
||||
# 停止服务
|
||||
pm2 stop xlxumu-api
|
||||
|
||||
# 删除服务
|
||||
pm2 delete xlxumu-api
|
||||
```
|
||||
|
||||
### Nginx管理
|
||||
```bash
|
||||
# 重启Nginx
|
||||
systemctl restart nginx
|
||||
|
||||
# 查看Nginx状态
|
||||
systemctl status nginx
|
||||
|
||||
# 查看Nginx错误日志
|
||||
tail -f /var/log/nginx/error.log
|
||||
```
|
||||
|
||||
## 文件目录结构
|
||||
```
|
||||
/data/nodejs/xlxumu/
|
||||
├── backend/
|
||||
│ ├── api/ # API服务核心代码
|
||||
│ │ ├── server.js # 主服务文件
|
||||
│ │ ├── package.json # 依赖配置
|
||||
│ │ ├── .env # 环境变量
|
||||
│ │ └── modules/ # 各业务模块
|
||||
│ ├── database/ # 数据库设计文档
|
||||
│ ├── services/ # 服务层代码
|
||||
│ └── utils/ # 工具类
|
||||
└── scripts/ # 部署脚本
|
||||
├── sync-to-server.sh # 同步脚本
|
||||
├── start-server.sh # 启动脚本
|
||||
└── xlxumu-api.conf # Nginx配置
|
||||
```
|
||||
|
||||
## 监控和维护
|
||||
|
||||
### 服务健康检查
|
||||
```bash
|
||||
# API健康检查
|
||||
curl https://xlapi.jiebanke.com/health
|
||||
|
||||
# 服务状态检查
|
||||
pm2 monit
|
||||
```
|
||||
|
||||
### 日志查看
|
||||
```bash
|
||||
# 查看应用日志
|
||||
pm2 logs xlxumu-api
|
||||
|
||||
# 查看Nginx访问日志
|
||||
tail -f /var/log/nginx/xlxumu-api.access.log
|
||||
|
||||
# 查看Nginx错误日志
|
||||
tail -f /var/log/nginx/xlxumu-api.error.log
|
||||
```
|
||||
|
||||
## 故障排除
|
||||
|
||||
### 常见问题
|
||||
1. **端口占用**: 检查3350端口是否被占用 `netstat -tlnp | grep 3350`
|
||||
2. **权限问题**: 确保部署目录有正确权限 `chown -R nginx:nginx /data/nodejs/xlxumu`
|
||||
3. **证书问题**: 检查SSL证书路径和权限
|
||||
4. **数据库连接**: 验证MySQL连接信息是否正确
|
||||
|
||||
### 紧急恢复
|
||||
```bash
|
||||
# 如果服务崩溃，手动重启
|
||||
pm2 restart xlxumu-api
|
||||
|
||||
# 如果PM2有问题，直接启动Node.js
|
||||
cd /data/nodejs/xlxumu/backend/api && node server.js
|
||||
```
|
||||
|
||||
## 备份策略
|
||||
|
||||
### 代码备份
|
||||
```bash
|
||||
# 定期备份代码
|
||||
tar -czf /backup/xlxumu-api-$(date +%Y%m%d).tar.gz /data/nodejs/xlxumu/
|
||||
```
|
||||
|
||||
### 数据库备份
|
||||
```bash
|
||||
# 定期备份MySQL数据库
|
||||
mysqldump -u用户名 -p密码 xlxumu_production > /backup/xlxumu-db-$(date +%Y%m%d).sql
|
||||
```
|
||||
|
||||
## 安全建议
|
||||
|
||||
1. 定期更新系统和软件包
|
||||
2. 使用强密码和密钥
|
||||
3. 配置防火墙规则
|
||||
4. 定期检查日志
|
||||
5. 监控系统资源使用情况
|
||||
|
||||
---
|
||||
*最后更新: $(date +%Y-%m-%d)*
|
||||
Reference in New Issue
Block a user