PM2 速查表

Node.js 进程守护、日志监控、集群扩缩容与开机自启常用命令

基础

版本、守护进程状态、列表与监控

命令 说明
pm2 -v 查看 PM2 版本
pm2 ping 检查 PM2 守护进程状态
pm2 list 查看进程列表(简写:pm2 ls)
pm2 monit 打开实时监控面板(CPU/内存)

进程管理

启动、重启、重载、停止、删除、扩缩容

命令 说明
pm2 start app.js 启动脚本
pm2 start app.js --name api 启动并指定进程名
pm2 start npm --name web -- run start 以 npm script 方式启动
pm2 restart api 重启进程
pm2 reload api 零停机重载(cluster 模式更常用)
pm2 stop api 停止进程
pm2 delete api 删除进程(从 PM2 列表移除)
pm2 scale api 4 扩缩容到指定实例数

日志与排查

日志查看、诊断信息、环境变量

命令 说明
pm2 logs 查看全部进程日志
pm2 logs api 查看指定进程日志
pm2 logs api --lines 200 查看最近 N 行日志
pm2 flush 清空所有日志文件
pm2 show api 查看进程详情(路径、环境变量、重启次数)
pm2 describe api 同 show,输出更偏诊断信息
pm2 env 0 查看指定 id 进程的环境变量

开机自启与状态恢复

startup/save/resurrect 常用组合

命令 说明
pm2 startup 生成开机自启命令(按提示执行)
pm2 save 保存当前进程列表到 dump 文件
pm2 resurrect 从 dump 文件恢复进程
pm2 unstartup 移除开机自启配置
pm2 reset api 重置指定进程重启计数

Ecosystem 与部署

配置文件驱动的多应用管理与远程部署

命令 说明
pm2 init simple 生成基础 ecosystem 配置文件
pm2 start ecosystem.config.js 按配置文件启动应用
pm2 restart ecosystem.config.js --env production 按指定环境重启应用
pm2 deploy ecosystem.config.js production 执行部署(需预先配置 deploy)