CentOS Node.js项目部署步骤

CentOS 7 上部署 Node.js 项目的标准流程

一准备与系统检查

以具有 sudo 权限的用户登录服务器，建议先更新系统并安装常用工具：
- 更新与基础工具：sudo yum update -y && sudo yum install -y curl wget git
放行访问端口（示例为 3000）：
- firewalld：sudo firewall-cmd --permanent --zone=public --add-port=3000/tcp && sudo firewall-cmd --reload
- 如使用云服务器，还需在控制台安全组放行对应端口。

二安装 Node.js 与 npm

方式一二进制包安装（稳定可控，适合生产）
1. 下载与解压（以 Node.js 18.20.8 为例，可按需替换版本）：
  - wget https://nodejs.org/dist/v18.20.8/node-v18.20.8-linux-x64.tar.xz
  - tar -xf node-v18.20.8-linux-x64.tar.xz
2. 建立软链，便于全局使用：
  - sudo ln -s /root/node-v18.20.8-linux-x64/bin/node /usr/local/bin/node
  - sudo ln -s /root/node-v18.20.8-linux-x64/bin/npm /usr/local/bin/npm
3. 验证版本：
  - node -v 应返回 v18.20.8
  - npm -v 返回对应 npm 版本
方式二 NodeSource 仓库安装（便于通过 YUM 管理）
- 安装 Node.js 18.x：curl -sL https://rpm.nodesource.com/setup_18.x | sudo bash - && sudo yum install -y nodejs
- 验证：node -v、npm -v
方式三 NVM 多版本管理（适合多项目与切换）
- 安装 NVM：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
- 加载：source ~/.nvm/nvm.sh
- 安装与切换：nvm install 18 && nvm use 18（可设置默认：nvm alias default 18）

三部署与运行应用

准备代码
- 方式 A 直接上传：scp -r your-app user@your_ip:/opt/your-app
- 方式 B Git 拉取：git clone https://your-repo.git /opt/your-app && cd /opt/your-app
安装依赖与构建
- 安装：npm ci --only=production（或 npm install 开发环境）
- 构建（如有）：npm run build
配置环境变量
- 推荐在应用目录使用 .env，或统一放到 /etc/profile.d/：
  - 示例：echo 'export NODE_ENV=production' | sudo tee /etc/profile.d/node.env
  - 使生效：source /etc/profile.d/node.env
启动与守护
- 使用 PM2（进程管理、开机自启、日志管理）：
  - 全局安装：sudo npm install -g pm2
  - 启动：pm2 start dist/index.js --name "myapp" --env production
  - 常用：pm2 status、pm2 logs myapp、pm2 monit
  - 开机自启：pm2 startup systemd -u $USER --hp $HOME && pm2 save
- 直接运行（不推荐生产）：node app.js

四反向代理与域名访问（Nginx）

安装与启动：
- sudo yum install -y nginx
- sudo systemctl start nginx && sudo systemctl enable nginx

配置反向代理（示例将 80 转发到 3000）：

新建配置：sudo vim /etc/nginx/conf.d/myapp.conf

内容：

server {
  listen 80;
  server_name your-domain.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 reload nginx

如启用 HTTPS，建议使用 Certbot 申请免费证书并配置 443 端口。

五常见问题与排查

端口未放行或监听错误
- 检查监听：ss -tpln | grep 3000
- 云服务器需同时放行安全组与系统防火墙
权限与环境变量
- 全局 npm 包建议用 sudo npm install -g；应用环境变量放入 .env 或 /etc/profile.d/
多版本冲突
- 使用 NVM 隔离项目 Node 版本，避免系统级冲突
构建或运行报错
- 确认 Node/npm 版本匹配项目要求；清理并重新安装依赖：rm -rf node_modules package-lock.json && npm install
日志与监控
- 使用 PM2 查看实时日志与资源：pm2 logs、pm2 monit

最新问答

相关标签