NVM与PM2安装配置指南
PM2是Node.js应用的守护进程管理器,可实现应用常驻后台、故障自动重启等功能。其依赖Node.js环境,因此需先通过NVM(Node Version Manager)管理Node.js版本,再完成PM2安装与使用。
一、NVM安装与配置
NVM用于灵活切换Node.js版本,适配不同项目的环境需求。
1.1 网络代理配置(可选)
若网络无法访问GitHub,需先配置Git代理,替换示例中的代理地址和端口。
# 设置全局Git代理
git config --global http.proxy http://192.168.87.1:7890
git config --global https.proxy http://192.168.87.1:7890
# 如需取消代理,执行以下命令
# git config --unset http.proxy
# git config --unset https.proxy
1.2 安装NVM
执行以下命令下载并安装NVM(以v0.39.7版本为例,可替换为最新版本)。
# 修正原命令中的“url”为“curl”,确保命令可执行
curl -x http://192.168.87.1:7890 -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
- 安装完成后,终端会输出环境变量配置命令,需手动复制执行,确保NVM生效。
- 示例效果:
二、Node.js与npm安装
通过NVM安装指定版本的Node.js(示例为v18,可替换为需求版本,如v20),npm会随Node.js自动安装。
# 安装Node.js v18并切换为当前使用版本
nvm install 18 && nvm use 18
- 执行完成后,可通过
node -v和npm -v验证安装是否成功。 - 示例效果:
三、PM2安装
使用npm全局安装PM2,确保在任意目录均可执行PM2命令。
# 安装最新版本的PM2
npm install pm2@latest -g
- 安装完成后,通过
pm2 --version验证版本。 - 示例效果:
四、PM2核心操作指南
4.1 PM2常用命令速查表
| 命令分类 | 命令示例 | 说明 |
|---|---|---|
| 基础启动 | pm2 start <脚本> | 启动应用(默认后台运行,如pm2 start app.js) |
| pm2 start <脚本> --name "应用名" | 启动时指定应用名(方便管理,如pm2 start app.js --name "api") |
|
| pm2 start <脚本> -- --port 3000 | 启动时传递参数(如指定端口,需用--分隔) |
|
| pm2 start <脚本> -i max | 集群模式启动(max自动适配CPU核数,提升性能) |
|
| pm2 start <配置文件> | 通过配置文件启动多应用(如pm2 start ecosystem.config.js) |
|
| 进程管理 | pm2 list / pm2 status | 查看进程列表(status显示CPU/内存占用详情) |
| pm2 stop <名称/ID> / pm2 stop all | 停止指定进程或所有进程(如pm2 stop api或pm2 stop 0) |
|
| pm2 restart <名称/ID> / pm2 restart all | 重启指定进程或所有进程 | |
| pm2 reload <名称/ID> | 平滑重启(零停机,仅适用于集群模式) | |
| pm2 delete <名称/ID> / pm2 delete all | 从PM2列表中删除指定进程或所有进程 | |
| 日志管理 | pm2 logs / pm2 logs <名称/ID> | 查看所有或指定进程的实时日志 |
| pm2 logs --lines 100 | 查看最近100行日志 | |
| pm2 flush | 清空所有日志 | |
| 监控与信息 | `pm2 monit | 交互式面板,实时监控CPU、内存占用 |
| pm2 describe <名称/ID> | 查看指定进程的详细信息(环境变量、启动参数等) | |
| pm2 report | 生成应用性能分析报告 | |
| 开机自启 | pm2 startup | 生成开机自启脚本(自动适配系统,如systemd) |
| pm2 save | 保存当前进程列表,配合startup实现开机自启 |
|
| pm2 unstartup | 取消开机自启配置 | |
| 其他 | pm2 --help / pm2 --version | 查看帮助文档或PM2版本 |
| pm2 reset <名称/ID> | 重置进程的重启统计次数 |
4.2 实操场景示例
场景1:启动项目进程
通过指定“启动命令”和“应用名”,创建PM2守护进程(示例为启动名为“tp8”的项目)。
pm2 start "<项目启动命令>" --name "<项目名称>"
# 示例:pm2 start "php think run" --name "tp8"
- 示例效果:
场景2:查看进程列表
查看所有已启动的PM2进程状态,包括进程ID、名称、CPU/内存占用等。
pm2 list
- 示例效果:
场景3:删除无用进程
删除不再需要的进程(需指定应用名或进程ID)。
pm2 delete "<项目名称>"
# 示例:pm2 delete "tp8"
- 示例效果:
场景4:集群模式启动(高并发优化)
通过-i max参数,让PM2根据CPU核数自动创建进程,提升应用并发能力。
pm2 start "<项目启动命令>" -i max --name "<项目名称>"
# 示例:pm2 start "app.js" -i max --name "api-server"
场景5:查看进程日志
实时查看指定进程的运行日志,用于排查错误或监控应用状态。
pm2 log "<项目名称>"
# 示例:pm2 log "tp8"
- 示例效果:
场景6:配置开机自启
确保服务器重启后,PM2进程自动恢复,无需手动启动。
- 生成自启脚本:
pm2 startup- 示例效果:
- 示例效果:
- 保存当前进程列表:
pm2 save- 示例效果:
- 示例效果:
场景7:实时监控进程
通过交互式面板,实时查看进程的CPU、内存占用及日志输出。
pm2 monit
- 操作说明:按
Ctrl+C可退出监控面板。 - 示例效果:
场景8:生成性能报告
生成PM2及应用的详细性能报告,包含系统信息、进程状态、日志片段等,用于问题排查。
pm2 report
- 报告示例(关键信息节选):
--- PM2 report ---------------------------------------------------------------- Date : Mon Oct 27 2025 07:59:16 GMT+0000 (Coordinated Universal Time) =============================================================================== --- Daemon ------------------------------------------------- pm2d version : 6.0.13 node version : 18.20.8 user : root uptime : 24min =============================================================================== --- PM2 list ----------------------------------------------- ┌────┬────────┬─────────────┬─────────┬─────────┬──────────┬────────┬──────┬───────────┬──────────┬──────────┬──────────┬──────────┐ │ id │ name │ namespace │ version │ mode │ pid │ uptime │ ↺ │ status │ cpu │ mem │ user │ watching │ ├────┼────────┼─────────────┼─────────┼─────────┼──────────┼────────┼──────┼───────────┼──────────┼──────────┼──────────┼──────────┤ │ 0 │ tp8 │ default │ N/A │ fork │ 17358 │ 4m │ 0 │ online │ 0% │ 34.0mb │ root │ disabled │ └────┴────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┴──────────┴──────────┴──────────┘
该文档聚焦 NVM 与 PM2 的实用配置,旨在帮助用户高效管理 Node.js 环境与应用进程。内容上,先解决 NVM 安装的网络问题与环境变量配置,再通过 NVM 快速部署 Node.js/npm;后续核心讲解 PM2 的功能应用,包括基础进程操作、性能监控、日志管理,以及保障应用稳定性的开机自启设置。文档搭配命令示例、效果截图与性能报告样例,既提供系统化的操作步骤,又通过速查表简化命令查询,能满足开发或运维场景中 “快速搭建环境 + 稳定守护应用” 的需求,降低 Node.js 应用管理的复杂度。
浙公网安备 33010602011771号