一、部署前的基础准备

1.1 云服务器选型建议

选择云服务器时需综合考虑项目规模、并发量及预算。对于中小型Node.js应用，推荐配置为2核4G内存、50G系统盘及1Mbps带宽的云主机。主流云平台如阿里云、腾讯云、AWS等均提供按需计费模式，建议初期选择弹性计算实例以降低成本。

1.2 服务器系统选择

Linux系统（Ubuntu 22.04 LTS或CentOS 8）是Node.js部署的首选环境，其稳定性及包管理工具（apt/yum）能大幅提升部署效率。Windows Server仅适用于特定兼容场景，且需额外配置IIS或Nginx反向代理。

1.3 安全组配置要点

部署前必须配置安全组规则，开放必要端口（如22-SSH、80/443-HTTP/HTTPS、3000-应用端口）并限制来源IP。建议禁用root用户SSH登录，改用普通用户+sudo权限组合，同时配置密钥认证替代密码登录。

二、服务器环境搭建

2.1 Node.js环境安装

推荐使用nvm管理多版本Node.js：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
source ~/.bashrc
nvm install --lts
npm install -g pm2 yarn

此方式可隔离项目依赖，避免全局安装冲突。

2.2 反向代理配置

使用Nginx作为反向代理（以Ubuntu为例）：

server {
    listen 80;
    server_name yourdomain.com;
    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

配置后需执行sudo nginx -t测试语法，sudo systemctl restart nginx应用更改。

2.3 防火墙设置

Ubuntu系统启用ufw防火墙：

sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

CentOS系统则使用firewalld：

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload

三、项目部署流程

3.1 代码传输方式

推荐使用Git进行版本控制部署：

git clone your-repo.git
cd your-project
yarn install --production

对于大型项目，可配置.gitignore排除node_modules，在服务器端重新安装依赖。

3.2 环境变量管理

使用dotenv包管理环境变量，创建.env文件：

DB_HOST=localhost
DB_PORT=27017
JWT_SECRET=your-secret-key

在代码中通过require('dotenv').config()加载，生产环境建议通过系统环境变量注入。

3.3 PM2进程管理

PM2是Node.js进程管理的首选工具：

pm2 start app.js --name "my-app"
pm2 save
pm2 startup  # 生成开机自启命令
sudo env PATH=$PATH:/usr/bin /usr/lib/node_modules/pm2/bin/pm2 startup systemd -u your-user --hp /home/your-user

常用命令：

• pm2 list：查看进程状态
• pm2 logs：实时查看日志
• pm2 reload all：零停机重启

四、生产环境优化

4.1 性能调优策略

• 启用集群模式：pm2 start app.js -i max
• 配置内存限制：pm2 start app.js --max-memory-restart 512M
• 使用压缩中间件：compression()
• 启用HTTP/2：Nginx配置中添加listen 443 ssl http2;

4.2 日志管理方案

推荐使用winston日志库，配置分级日志：

const winston = require('winston');
const logger = winston.createLogger({
    level: 'info',
    format: winston.format.json(),
    transports: [
        new winston.transports.File({ filename: 'error.log', level: 'error' }),
        new winston.transports.File({ filename: 'combined.log' })
    ]
});

4.3 监控告警设置

集成PM2的Keymetrics服务或自建Prometheus+Grafana监控：

pm2 install pm2-logrotate
pm2 set pm2-logrotate:max_size 10M
pm2 set pm2-logrotate:retain 7

五、自动化部署方案

5.1 CI/CD流水线构建

GitHub Actions示例配置：

name: Deploy Node.js
on: [push]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
    - uses: actions/setup-node@v2
      with: { node-version: '18' }
    - run: yarn install
    - run: yarn build
    - uses: appleboy/ssh-action@master
      with:
        host: ${{ secrets.SSH_HOST }}
        username: ${{ secrets.SSH_USERNAME }}
        key: ${{ secrets.SSH_KEY }}
        script: |
          cd /path/to/project
          git pull
          yarn install --production
          pm2 reload all

5.2 蓝绿部署实现

通过Nginx配置实现无停机切换：

upstream backend {
    server 127.0.0.1:3000;  # 旧版本
    server 127.0.0.1:3001;  # 新版本
}
server {
    location / {
        split_clients $remote_addr $new_version {
            10% 127.0.0.1:3001;
            *   127.0.0.1:3000;
        }
        proxy_pass http://$new_version;
    }
}

六、常见问题解决方案

6.1 端口冲突处理

使用netstat -tulnp | grep :3000查找占用进程，通过kill -9 PID终止，或修改应用端口后重启。

6.2 依赖安装失败

清除缓存后重试：

yarn cache clean
rm -rf node_modules
yarn install --check-files

6.3 内存泄漏排查

使用pm2 monit监控内存，配合--inspect参数进行Chrome DevTools调试：

node --inspect app.js

七、安全加固措施

7.1 HTTPS配置

通过Let’s Encrypt获取免费证书：

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d yourdomain.com

配置自动续期：

sudo certbot renew --dry-run

7.2 定期更新策略

设置cron任务每周更新系统：

0 3 * * 1 sudo apt update && sudo apt upgrade -y

7.3 备份方案

使用rsync进行增量备份：

rsync -avz --delete /path/to/project user@backup-server:/backup/path

本文系统阐述了Node.js项目从开发环境到生产部署的全流程，涵盖了环境搭建、进程管理、性能优化、自动化部署等关键环节。通过实际代码示例和配置文件，开发者可快速构建稳定高效的云端服务。建议结合具体项目需求，逐步实施文中推荐的各项优化措施，持续提升系统可靠性和运维效率。