CentOS 8.5 VPS服务器部署Node.js项目实战指南
文章分类:售后支持 /
创建时间:2025-08-11
在CentOS 8.5 VPS服务器上部署Node.js项目,既能发挥Node.js高效异步处理的优势,又能利用CentOS稳定的Linux内核特性。本文结合实际运维经验,详细拆解从环境准备到项目上线的全流程最佳实践。
一、基础环境准备
部署前需完成两项核心准备:首先确保已获取CentOS 8.5 VPS服务器的root权限(无权限可能导致后续操作受限);其次更新系统软件包至最新版本,这一步能修复已知安全漏洞并避免依赖冲突。执行以下命令完成更新:
sudo dnf update -y
命令执行时会自动下载并安装所有可用更新,整个过程约5-10分钟(具体时长取决于服务器网络和硬件配置)。
二、Node.js与npm安装
CentOS 8.5默认仓库的Node.js版本可能较旧,推荐通过NodeSource官方源安装。以LTS(长期支持)版本14.x为例,安装步骤如下:
1. 添加NodeSource软件源:
curl -sL https://rpm.nodesource.com/setup_14.x | sudo bash -
2. 安装Node.js和npm:
sudo dnf install -y nodejs
安装完成后,通过`node -v`和`npm -v`验证版本(正常输出如v14.21.3和6.14.18即表示成功)。需注意:若项目依赖特定Node.js版本,可将命令中的`14.x`替换为对应版本号(如16.x、18.x)。
三、项目部署与进程管理
假设项目文件已通过scp或SFTP上传至`/var/www/my-node-project`目录,接下来执行:
cd /var/www/my-node-project
npm install
`npm install`会根据`package.json`自动安装所有依赖(网络不佳时可添加`--registry=https://registry.npm.taobao.org`使用国内镜像加速)。
为确保项目在服务器重启后自动运行,推荐使用PM2进程管理器。操作步骤:
1. 全局安装PM2:
sudo npm install -g pm2
2. 启动项目(假设入口文件为app.js):
pm2 start app.js
3. 配置开机自启:
执行`pm2 startup`后,系统会输出一段初始化脚本(如`systemctl enable pm2-root`),复制并执行该脚本即可完成配置。PM2支持进程监控、日志聚合等功能,可通过`pm2 list`查看运行状态,`pm2 logs`实时查看输出。
四、反向代理配置(Nginx篇)
为让外部通过域名或IP访问项目,需配置Nginx反向代理。步骤如下:
1. 安装Nginx:
sudo dnf install -y nginx
2. 创建项目配置文件:
sudo nano /etc/nginx/conf.d/my-node-project.conf
3. 写入以下配置(根据实际情况修改域名和端口):
server {
listen 80;
server_name example.com; # 替换为实际域名或IP
location / {
proxy_pass http://localhost:3000; # Node.js项目监听端口
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
4. 验证配置并重启Nginx:
sudo nginx -t # 检查配置是否正确
sudo systemctl restart nginx
配置完成后,访问`http://example.com`即可看到Node.js项目运行页面。
完成上述步骤后,CentOS 8.5 VPS服务器上的Node.js项目即可稳定运行。从系统基础环境到进程管理、反向代理的全链路配置,每个环节都直接影响项目的运行质量。实际运维中建议定期检查PM2进程状态,结合Nginx访问日志优化性能,确保业务持续稳定。