Node.js如何部署到云服务器

Node.js 云服务器部署实操指南

一 准备与规划

• 服务器与系统：选择主流 Linux（如 Ubuntu 22.04 LTS、CentOS 8），中小型应用建议 2核4G内存、50G系统盘、1Mbps带宽起步，便于后续横向扩容与成本控制。
• 安全组与防火墙：放行必要端口 22（SSH）、80/443（HTTP/HTTPS）、以及应用端口 3000；建议仅允许可信 IP 网段访问，禁用 root 远程登录，改用普通用户 + sudo，并使用 SSH 密钥认证。
• 版本兼容提醒：部分老系统存在 Node 版本限制，例如 Alibaba Cloud Linux 2 / CentOS 7.x 仅支持 Node.js 17.x 及以下，如需更高版本请选择 Alibaba Cloud Linux 3 或其他较新发行版。

二 服务器环境搭建

• 安装 Node.js（推荐 nvm 管理多版本）
  • 安装 nvm：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash && source ~/.bashrc
  • 安装 LTS：nvm install --lts
  • 验证：node -v、npm -v
  • 可选多版本：nvm install 18.20.8；nvm use 18.20.8；nvm alias default 18.20.8
• 全局工具：npm install -g pm2 yarn
• 二进制安装方式（备选）：下载官方 Linux x64 二进制包，解压后将 node 与 npm 软链至 /usr/local/bin，便于全局调用。

三 部署与进程管理

• 代码获取与依赖安装
  • Git 部署：git clone && cd && yarn install --production
  • 上传部署：使用 SCP/SFTP 将代码上传至服务器后执行 npm install
• 环境变量
  • 使用 dotenv：创建 .env 管理密钥与配置；生产环境优先通过系统环境变量注入
• 启动与守护
  • PM2 启动：pm2 start app.js --name “my-app”
  • 常用：pm2 list、pm2 logs、pm2 reload all（零停机重启）
  • 开机自启：pm2 startup；按提示执行生成的命令，确保重启后自动拉起应用

四 反向代理与域名 HTTPS

• Nginx 反向代理（将域名或公网 IP 的 80/443 转发到本地 3000）
  • 示例配置：

    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
• 防火墙放行
  • Ubuntu：sudo ufw allow 22,80,443/tcp && sudo ufw enable
  • CentOS：sudo firewall-cmd --permanent --add-service=http && sudo firewall-cmd --permanent --add-service=https && sudo firewall-cmd --reload
• HTTPS：使用 Let’s Encrypt/Certbot 为域名申请免费证书并自动续期，Nginx 配置 443 端口与证书路径即可。

五 常见问题与排查

• 端口与连通性
  • 云侧：安全组需放行 22/80/443/3000；系统防火墙（ufw/firewalld）同步放行
  • 应用侧：确保服务监听 0.0.0.0（而非 127.0.0.1），否则外网无法访问
• 版本不兼容
  • 老系统（如 Alibaba Cloud Linux 2 / CentOS 7.x）无法安装 Node.js 18+，请升级系统或选择受支持的 Node 17.x 及以下版本
• 进程稳定性
  • 使用 PM2 托管进程，结合日志与监控，必要时配置集群模式提升多核利用率
• 快速自检清单
  • 服务器：curl http://127.0.0.1:3000 能访问
  • 外网：浏览器访问域名或公网 IP 的 80/443 正常
  • 证书：HTTPS 证书有效且自动续期配置正确