Appearance
后端部署指南
服务器环境
服务器信息
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 backend2. 安装依赖
bash
npm install3. 配置环境变量
创建.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=./uploads4. 初始化数据库
bash
# 测试数据库连接
npm run test-db
# 执行数据库脚本(如果有)
node scripts/init_database.js5. 启动开发服务器
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.773. 安装依赖
bash
cd /var/www/src
npm install --production4. 配置环境变量
bash
# 编辑.env文件
vi .env
# 填写生产环境配置5. 启动服务
使用nohup后台运行:
bash
# 启动服务
nohup /usr/bin/node server.js > server.log 2>&1 &
# 查看进程
ps aux | grep node
# 查看日志
tail -f server.log6. 验证服务
bash
# 检查端口占用
netstat -tlnp | grep 3003
# 测试API
curl http://localhost:3003/api/health使用PM2管理进程 (推荐)
PM2是更专业的Node.js进程管理工具。
1. 安装PM2
bash
npm install -g pm22. 启动应用
bash
# 启动应用
pm2 start server.js --name rizhi-backend
# 设置开机自启
pm2 startup
pm2 save3. 管理进程
bash
# 查看状态
pm2 status
# 查看日志
pm2 logs rizhi-backend
# 重启应用
pm2 restart rizhi-backend
# 停止应用
pm2 stop rizhi-backend
# 删除应用
pm2 delete rizhi-backend4. 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.jsNginx反向代理 (可选)
使用Nginx作为反向代理可以:
- 提供HTTPS支持
- 负载均衡
- 静态文件服务
- Gzip压缩
1. 安装Nginx
bash
yum install nginx -y2. 配置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 nginx4. 配置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故障排查
服务无法启动
- 检查端口是否被占用
bash
netstat -tlnp | grep 3003- 检查日志文件
bash
tail -100 server.log- 检查环境变量
bash
cat .env- 检查数据库连接
bash
node -e "require('./src/config/database').query('SELECT 1')"API请求失败
- 检查服务是否运行
- 检查防火墙设置
- 检查Nginx配置
- 查看错误日志
性能问题
- 增加服务器资源
- 优化数据库查询
- 添加Redis缓存
- 使用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).sql2. 上传新代码
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 --production4. 数据库迁移
bash
# 如果有数据库变更
node scripts/migrate_database.js5. 重启服务
bash
# 使用管理脚本
./manage.sh restart
# 或使用PM2
pm2 restart rizhi-backend6. 验证部署
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安全建议
定期更新
- 及时更新Node.js版本
- 更新npm依赖包
- 修复安全漏洞
访问控制
- 使用防火墙限制访问
- 定期更换密码
- 使用SSH密钥认证
数据备份
- 每日自动备份数据库
- 定期备份代码
- 测试备份恢复流程
监控告警
- 设置服务监控
- 配置告警通知
- 定期检查日志
