```

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和反向代理。 ```
2025-09-11 17:11:12 +08:00
parent 216cf80eab
commit bd379d505c
6 changed files with 597 additions and 7 deletions
--- a/scripts/DEPLOYMENT_GUIDE.md
+++ b/scripts/DEPLOYMENT_GUIDE.md
@@ -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)*
--- a/scripts/start-server.sh
+++ b/scripts/start-server.sh
@@ -0,0 +1,75 @@
+#!/bin/bash
+
+# 锡林郭勒盟智慧养殖平台 - 生产环境启动脚本
+# 服务器目录: /data/nodejs/xlxumu/
+
+TARGET_DIR="/data/nodejs/xlxumu"
+APP_DIR="$TARGET_DIR/backend/api"
+
+# 颜色定义
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+echo -e "${GREEN}🚀 启动锡林郭勒盟智慧养殖平台API服务${NC}"
+
+# 检查Node.js是否安装
+if ! command -v node &> /dev/null; then
+    echo -e "${RED}❌ Node.js未安装，请先安装Node.js${NC}"
+    exit 1
+fi
+
+# 检查npm是否安装
+if ! command -v npm &> /dev/null; then
+    echo -e "${RED}❌ npm未安装，请先安装npm${NC}"
+    exit 1
+fi
+
+# 检查PM2是否安装
+if ! command -v pm2 &> /dev/null; then
+    echo -e "${YELLOW}📦 安装PM2...${NC}"
+    npm install -g pm2
+fi
+
+# 进入应用目录
+cd $APP_DIR
+
+# 检查目录是否存在
+if [ ! -d "$APP_DIR" ]; then
+    echo -e "${RED}❌ 应用目录不存在: $APP_DIR${NC}"
+    exit 1
+fi
+
+# 检查package.json是否存在
+if [ ! -f "package.json" ]; then
+    echo -e "${RED}❌ package.json不存在${NC}"
+    exit 1
+fi
+
+# 安装依赖
+echo -e "${YELLOW}📦 安装项目依赖...${NC}"
+npm install --production
+
+# 停止现有服务（如果存在）
+echo -e "${YELLOW}🛑 停止现有服务...${NC}"
+pm2 delete xlxumu-api 2>/dev/null || true
+
+# 启动服务
+echo -e "${YELLOW}🚀 启动API服务...${NC}"
+pm2 start server.js --name xlxumu-api --env production
+
+# 配置PM2开机自启
+echo -e "${YELLOW}⚙️  配置PM2开机自启...${NC}"
+pm2 startup
+pm2 save
+
+# 显示服务状态
+echo -e "${GREEN}✅ 服务启动完成！${NC}"
+echo -e "${GREEN}📊 当前服务状态:${NC}"
+pm2 status xlxumu-api
+
+echo -e "${GREEN}🌐 API服务运行在: http://localhost:3350${NC}"
+echo -e "${GREEN}📋 查看详细日志: pm2 logs xlxumu-api${NC}"
+echo -e "${GREEN}🔄 重启服务: pm2 restart xlxumu-api${NC}"
+echo -e "${GREEN}⏹️  停止服务: pm2 stop xlxumu-api${NC}"
--- a/scripts/sync-to-server.sh
+++ b/scripts/sync-to-server.sh
@@ -0,0 +1,102 @@
+#!/bin/bash
+
+# 锡林郭勒盟智慧养殖平台 - 生产环境同步脚本
+# 服务器地址: www.jiebanke.com
+# 目标目录: /data/nodejs/xlxumu/
+
+SERVER="root@www.jiebanke.com"
+TARGET_DIR="/data/nodejs/xlxumu"
+
+# 颜色定义
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+echo -e "${GREEN}🚀 开始同步文件到生产服务器...${NC}"
+
+# 1. 创建服务器目录结构
+echo -e "${YELLOW}📁 创建服务器目录结构...${NC}"
+ssh $SERVER "mkdir -p $TARGET_DIR/backend/api"
+ssh $SERVER "mkdir -p $TARGET_DIR/backend/database"
+ssh $SERVER "mkdir -p $TARGET_DIR/backend/services"
+ssh $SERVER "mkdir -p $TARGET_DIR/backend/utils"
+
+# 2. 同步后端API核心文件
+echo -e "${YELLOW}📦 同步后端API文件...${NC}"
+rsync -avz --delete \
+  --include="server.js" \
+  --include="package.json" \
+  --include="package-lock.json" \
+  --include="ai/" \
+  --include="data-platform/" \
+  --include="farming/" \
+  --include="finance/" \
+  --include="government/" \
+  --include="mall/" \
+  --include="trade/" \
+  --include="user-center/" \
+  --exclude="*" \
+  ./backend/api/ $SERVER:$TARGET_DIR/backend/api/
+
+# 3. 同步数据库设计文档
+echo -e "${YELLOW}🗄️  同步数据库文档...${NC}"
+rsync -avz --delete \
+  --include="DESIGN.md" \
+  --include="README.md" \
+  --exclude="*" \
+  ./backend/database/ $SERVER:$TARGET_DIR/backend/database/
+
+# 4. 同步服务层代码
+echo -e "${YELLOW}🔧 同步服务层代码...${NC}"
+rsync -avz --delete \
+  --include="ai-service/" \
+  --include="data-platform-service/" \
+  --include="farming-service/" \
+  --include="finance-service/" \
+  --include="government-service/" \
+  --include="mall-service/" \
+  --include="trade-service/" \
+  --include="user-center-service/" \
+  --include="README.md" \
+  --exclude="*" \
+  ./backend/services/ $SERVER:$TARGET_DIR/backend/services/
+
+# 5. 同步工具类
+echo -e "${YELLOW}🛠️  同步工具类...${NC}"
+rsync -avz --delete \
+  --include="README.md" \
+  --exclude="*" \
+  ./backend/utils/ $SERVER:$TARGET_DIR/backend/utils/
+
+# 6. 创建生产环境配置文件
+echo -e "${YELLOW}⚙️  创建生产环境配置...${NC}"
+cat > .env.production << EOF
+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
+EOF
+
+# 上传生产环境配置
+scp .env.production $SERVER:$TARGET_DIR/backend/api/.env
+
+# 7. 安装依赖并重启服务
+echo -e "${YELLOW}📦 在服务器上安装依赖...${NC}"
+ssh $SERVER "cd $TARGET_DIR/backend/api && npm install --production"
+
+echo -e "${YELLOW}🔄 重启PM2服务...${NC}"
+ssh $SERVER "cd $TARGET_DIR/backend/api && pm2 delete xlxumu-api 2>/dev/null || true"
+ssh $SERVER "cd $TARGET_DIR/backend/api && pm2 start server.js --name xlxumu-api --env production"
+
+# 8. 保存PM2配置
+echo -e "${YELLOW}💾 保存PM2配置...${NC}"
+ssh $SERVER "pm2 save"
+
+echo -e "${GREEN}✅ 同步完成！${NC}"
+echo -e "${GREEN}🌐 API服务地址: https://xlapi.jiebanke.com${NC}"
+echo -e "${GREEN}📊 PM2状态: ssh $SERVER 'pm2 status'${NC}"
--- a/scripts/xlxumu-api.conf
+++ b/scripts/xlxumu-api.conf
@@ -0,0 +1,91 @@
+# 锡林郭勒盟智慧养殖平台API服务 - Nginx配置
+# 域名: xlapi.jiebanke.com
+# 后端服务: localhost:3350
+
+server {
+    listen 443 ssl http2;
+    listen [::]:443 ssl http2;
+    server_name xlapi.jiebanke.com;
+
+    # SSL证书配置 - 需要替换为实际证书路径
+    ssl_certificate /etc/ssl/certs/xlapi.jiebanke.com.crt;
+    ssl_certificate_key /etc/ssl/private/xlapi.jiebanke.com.key;
+    
+    # SSL优化配置
+    ssl_protocols TLSv1.2 TLSv1.3;
+    ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-SHA384;
+    ssl_prefer_server_ciphers off;
+    ssl_session_cache shared:SSL:10m;
+    ssl_session_timeout 10m;
+    ssl_session_tickets off;
+    
+    # 安全头部
+    add_header X-Frame-Options DENY;
+    add_header X-Content-Type-Options nosniff;
+    add_header X-XSS-Protection "1; mode=block";
+    add_header Strict-Transport-Security "max-age=63072000; includeSubDomains; preload";
+
+    # 静态资源缓存
+    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
+        expires 1y;
+        add_header Cache-Control "public, immutable";
+        access_log off;
+    }
+
+    # API代理配置
+    location / {
+        proxy_pass http://localhost:3350;
+        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;
+        proxy_cache_bypass $http_upgrade;
+        
+        # 超时设置
+        proxy_connect_timeout 60s;
+        proxy_send_timeout 60s;
+        proxy_read_timeout 60s;
+        
+        # 缓冲区设置
+        proxy_buffering on;
+        proxy_buffer_size 4k;
+        proxy_buffers 8 4k;
+        proxy_busy_buffers_size 8k;
+    }
+
+    # 健康检查端点
+    location /health {
+        proxy_pass http://localhost:3350/health;
+        access_log off;
+        allow 127.0.0.1;
+        allow ::1;
+        deny all;
+    }
+
+    # 禁止访问隐藏文件
+    location ~ /\. {
+        deny all;
+        access_log off;
+        log_not_found off;
+    }
+
+    # 访问日志
+    access_log /var/log/nginx/xlxumu-api.access.log main;
+    error_log /var/log/nginx/xlxumu-api.error.log warn;
+}
+
+# HTTP重定向到HTTPS
+server {
+    listen 80;
+    listen [::]:80;
+    server_name xlapi.jiebanke.com;
+    
+    # 重定向所有HTTP请求到HTTPS
+    return 301 https://$server_name$request_uri;
+    
+    access_log off;
+    error_log /dev/null;
+}