Skip to content

后端部署指南 ​

服务器环境 ​

服务器信息 ​

yaml
服务器提供商: 阿里云ECS
操作系统: CentOS 7
服务器IP: 8.147.129.77
用户名: root
后端路径: /var/www/src/
API地址: http://8.147.129.77:3003/api/

环境要求 ​

  • Node.js 18.x或更高版本
  • MySQL 8.0
  • Git (用于代码同步)
  • nohup或PM2 (进程管理)

本地开发 ​

1. 克隆项目 ​

bash
git clone <repository-url>
cd backend

2. 安装依赖 ​

bash
npm install

3. 配置环境变量 ​

创建.env文件:

env
# 数据库配置
DB_HOST=localhost
DB_USER=root
DB_PASSWORD=your_password
DB_NAME=rizhi_db
DB_PORT=3306

# JWT密钥
JWT_SECRET=your_jwt_secret_key

# 服务器端口
PORT=3003

# Firebase配置
FIREBASE_PROJECT_ID=your_project_id
FIREBASE_CLIENT_EMAIL=your_client_email
FIREBASE_PRIVATE_KEY=your_private_key

# 钉钉配置
DINGTALK_APP_KEY=your_app_key
DINGTALK_APP_SECRET=your_app_secret

# 百度地图配置
BAIDU_MAP_AK=your_baidu_map_ak

# 文件上传路径
UPLOAD_PATH=./uploads

4. 初始化数据库 ​

bash
# 测试数据库连接
npm run test-db

# 执行数据库脚本(如果有)
node scripts/init_database.js

5. 启动开发服务器 ​

bash
# 开发模式 (使用nodemon自动重启)
npm run dev

# 或生产模式
npm start

服务器将在 http://localhost:3003 启动。

6. 测试API ​

bash
# 测试健康检查
curl http://localhost:3003/api/health

# 应返回: {"status":"ok"}

生产环境部署 ​

方式一: 使用同步脚本 ​

项目提供了自动同步脚本:

Windows环境 ​

使用 sync_backend.ps1:

powershell
# 同步所有文件
.\sync_backend.ps1

# 同步单个文件
.\sync_backend.ps1 -file "src/api/logs.js"

Linux/Mac环境 ​

使用 sync_backend.sh:

bash
# 给脚本添加执行权限
chmod +x sync_backend.sh

# 同步所有文件
./sync_backend.sh

# 同步单个文件
./sync_backend.sh push "src/api/logs.js"

方式二: 手动部署 ​

1. 上传代码到服务器 ​

bash
# 使用scp上传
scp -r backend/ root@8.147.129.77:/var/www/

# 或使用rsync同步
rsync -avz --exclude 'node_modules' backend/ root@8.147.129.77:/var/www/src/

2. SSH连接服务器 ​

bash
ssh root@8.147.129.77

3. 安装依赖 ​

bash
cd /var/www/src
npm install --production

4. 配置环境变量 ​

bash
# 编辑.env文件
vi .env

# 填写生产环境配置

5. 启动服务 ​

使用nohup后台运行:

bash
# 启动服务
nohup /usr/bin/node server.js > server.log 2>&1 &

# 查看进程
ps aux | grep node

# 查看日志
tail -f server.log

6. 验证服务 ​

bash
# 检查端口占用
netstat -tlnp | grep 3003

# 测试API
curl http://localhost:3003/api/health

使用PM2管理进程 (推荐) ​

PM2是更专业的Node.js进程管理工具。

1. 安装PM2 ​

bash
npm install -g pm2

2. 启动应用 ​

bash
# 启动应用
pm2 start server.js --name rizhi-backend

# 设置开机自启
pm2 startup
pm2 save

3. 管理进程 ​

bash
# 查看状态
pm2 status

# 查看日志
pm2 logs rizhi-backend

# 重启应用
pm2 restart rizhi-backend

# 停止应用
pm2 stop rizhi-backend

# 删除应用
pm2 delete rizhi-backend

4. PM2配置文件 ​

创建 ecosystem.config.js:

javascript
module.exports = {
  apps: [{
    name: 'rizhi-backend',
    script: './server.js',
    instances: 1,
    autorestart: true,
    watch: false,
    max_memory_restart: '1G',
    env: {
      NODE_ENV: 'production',
      PORT: 3003
    },
    error_file: './logs/err.log',
    out_file: './logs/out.log',
    log_date_format: 'YYYY-MM-DD HH:mm:ss'
  }]
}

使用配置文件启动:

bash
pm2 start ecosystem.config.js

Nginx反向代理 (可选) ​

使用Nginx作为反向代理可以:

  • 提供HTTPS支持
  • 负载均衡
  • 静态文件服务
  • Gzip压缩

1. 安装Nginx ​

bash
yum install nginx -y

2. 配置Nginx ​

编辑 /etc/nginx/conf.d/rizhi.conf:

nginx
server {
    listen 80;
    server_name bjbmkj.cn www.bjbmkj.cn;

    # API反向代理
    location /api/ {
        proxy_pass http://localhost:3003/api/;
        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_cache_bypass $http_upgrade;
    }

    # WebSocket支持
    location /socket.io/ {
        proxy_pass http://localhost:3003/socket.io/;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        proxy_set_header Host $host;
    }

    # 文档站点
    location / {
        root /opt/apps/docs-site;
        index index.html;
        try_files $uri $uri/ /index.html;
    }

    # 静态文件
    location /uploads/ {
        alias /var/www/src/uploads/;
        expires 30d;
        access_log off;
    }
}

3. 启动Nginx ​

bash
# 测试配置
nginx -t

# 启动服务
systemctl start nginx
systemctl enable nginx

# 重新加载配置
systemctl reload nginx

4. 配置HTTPS (推荐) ​

使用Let's Encrypt免费SSL证书:

bash
# 安装certbot
yum install certbot python3-certbot-nginx -y

# 获取证书
certbot --nginx -d bjbmkj.cn -d www.bjbmkj.cn

# 自动续期
certbot renew --dry-run

服务器管理 ​

查看服务状态 ​

bash
# 检查端口占用
netstat -tlnp | grep 3003

# 查看进程
ps aux | grep node

# 查看日志
tail -f /var/www/src/server.log

重启服务 ​

bash
# 找到进程ID
ps aux | grep "node server.js"

# 停止进程
kill <PID>

# 重新启动
cd /var/www/src
nohup /usr/bin/node server.js > server.log 2>&1 &

数据库管理 ​

bash
# 连接数据库
mysql -h <host> -u <user> -p

# 备份数据库
mysqldump -h <host> -u <user> -p rizhi_db > backup.sql

# 恢复数据库
mysql -h <host> -u <user> -p rizhi_db < backup.sql

日志管理 ​

bash
# 查看实时日志
tail -f server.log

# 搜索错误
grep "ERROR" server.log

# 清理旧日志
# 创建日志轮转配置 /etc/logrotate.d/rizhi
/var/www/src/*.log {
    daily
    rotate 7
    compress
    missingok
    notifempty
}

监控和维护 ​

性能监控 ​

bash
# CPU和内存使用
top

# 磁盘使用
df -h

# 网络连接
netstat -ant | grep 3003

自动化脚本 ​

创建管理脚本 /var/www/manage.sh:

bash
#!/bin/bash

case "$1" in
    start)
        cd /var/www/src
        nohup /usr/bin/node server.js > server.log 2>&1 &
        echo "服务已启动"
        ;;
    stop)
        pkill -f "node server.js"
        echo "服务已停止"
        ;;
    restart)
        $0 stop
        sleep 2
        $0 start
        ;;
    status)
        if pgrep -f "node server.js" > /dev/null; then
            echo "服务正在运行"
        else
            echo "服务未运行"
        fi
        ;;
    *)
        echo "用法: $0 {start|stop|restart|status}"
        exit 1
esac

使用:

bash
chmod +x /var/www/manage.sh
./manage.sh start
./manage.sh status
./manage.sh restart

故障排查 ​

服务无法启动 ​

  1. 检查端口是否被占用
bash
netstat -tlnp | grep 3003
  1. 检查日志文件
bash
tail -100 server.log
  1. 检查环境变量
bash
cat .env
  1. 检查数据库连接
bash
node -e "require('./src/config/database').query('SELECT 1')"

API请求失败 ​

  1. 检查服务是否运行
  2. 检查防火墙设置
  3. 检查Nginx配置
  4. 查看错误日志

性能问题 ​

  1. 增加服务器资源
  2. 优化数据库查询
  3. 添加Redis缓存
  4. 使用CDN加速

更新部署流程 ​

1. 备份当前版本 ​

bash
# 备份代码
cp -r /var/www/src /var/www/src_backup_$(date +%Y%m%d)

# 备份数据库
mysqldump -h <host> -u <user> -p rizhi_db > backup_$(date +%Y%m%d).sql

2. 上传新代码 ​

bash
# 使用同步脚本
./sync_backend.sh

# 或手动上传
scp -r backend/ root@8.147.129.77:/var/www/src/

3. 更新依赖 ​

bash
ssh root@8.147.129.77
cd /var/www/src
npm install --production

4. 数据库迁移 ​

bash
# 如果有数据库变更
node scripts/migrate_database.js

5. 重启服务 ​

bash
# 使用管理脚本
./manage.sh restart

# 或使用PM2
pm2 restart rizhi-backend

6. 验证部署 ​

bash
# 测试API
curl http://8.147.129.77:3003/api/health

# 检查日志
tail -f server.log

回滚操作 ​

如果部署出现问题:

bash
# 停止服务
./manage.sh stop

# 恢复代码
rm -rf /var/www/src
mv /var/www/src_backup_20240101 /var/www/src

# 恢复数据库(如果需要)
mysql -h <host> -u <user> -p rizhi_db < backup_20240101.sql

# 重启服务
./manage.sh start

安全建议 ​

  1. 定期更新

    • 及时更新Node.js版本
    • 更新npm依赖包
    • 修复安全漏洞
  2. 访问控制

    • 使用防火墙限制访问
    • 定期更换密码
    • 使用SSH密钥认证
  3. 数据备份

    • 每日自动备份数据库
    • 定期备份代码
    • 测试备份恢复流程
  4. 监控告警

    • 设置服务监控
    • 配置告警通知
    • 定期检查日志

参考资料 ​

炳明一企通正式版 · 企业服务与协同管理