PM2 是 node 进程管理工具,可以利用它来简化很多 node 应用管理的繁琐任务,如性能监控、自动重启、负载均衡等,而且使用非常简单。

PM2 特性

  • 内建负载均衡(使用 Node cluster 集群模块)

  • 后台运行

  • 0秒停机重载

  • 具有 Ubuntu 和 CentOS 的启动脚本

  • 停止不稳定的进程(避免无限循环)

  • 控制台检测

  • 提供 HTTP API

  • 远程控制和实时的接口 API(Node.js 模块允许和 PM2 进程管理器交互)

全局安装

$ npm i -g pm2

常用命令

pm2 的功能十分强大,除了重启进程以外,还能实时收集日志和监控。

分叉模式(Fork mode)

# 启动并命名一个进程
$ pm2 start app.js --name my-app

集群模式(Cluster mode)

# 指定同时起多少个进程(进程数由 CPU 核数决定),组成一个集群
$ pm2 start app.js -i max
$ pm2 start app.js -i 0 # 将根据可用的 CPU 使用 LB 启动最大进程
$ pm2 start app.js -i 4  # 启动4个应用程序实例,并将网络请求负载均衡到每个应用中。


$ pm2 start app.js -o out.log  # 标准输出日志文件的路径
$ pm2 start app.js -e err.log  # 错误输出日志文件的路径
$ pm2 start app.js -e err.log -o out.log

# 用 fork 模式启动而非 cluster
$ pm2 start app.js -x  

# 将应用程序调整到10个实例
$ pm2 scale [app-name] 10  

进程监控

# 列出所有正在运行的进程
$ pm2 list
$ pm2 ls
pm2-list.png
# 原始 JSON 中的打印进程列表 
$ pm2 jlist

# 美化 JSON 中的打印进程列表
$ pm2 prettylist  

# 显示有关特定进程的所有信息  
$ pm2 describe 0

# 显示指定进程的所有信息
$ pm2 show APP-NAME 

# 列出所有 node 进程的 CPU 和内存统计数据,如:监视日志、自定义指标和进程信息
$ pm2 monit
pm2-monit.png

日志管理

$ pm2 logs # 查看所有日志
$ pm2 logs APP-NAME  # 显示 APP-NAME 日志
$ pm2 logs --json    # JSON 输出
$ pm2 logs --format  # JSON 格式化输出

# 清空所有日志文件(刷新所有日志)
$ pm2 flush

# 重新加载所有日志
$ pm2 reloadLogs

进程状态管理(重启、停止、删除)

# 可启动 Node、Python、bash 脚本、JSON 文件等。
$ pm2 start app.js

# 如果 pm2 守护进程还不存在,就在前台运行它
$ pm2 start app.js --no-daemon

# 跳过 vizion 功能(版本控制)
$ pm2 start app.js --no-vizion

# 不自动重新启动 app
$ pm2 start app.js --no-autorestart

# 监听应用目录的变化,发生变化时,自动重启。
$ pm2 start app.js --watch

# 排除监听的目录/文件,可以是特定的文件名,也可以是正则。比如 --ignore-watch="test node_modules "some scripts""
$ pm2 start app.js --ignore-watch

# 应用的名称。查看应用信息的时候可以用到。
$ pm2 start app.js -n --name

# 停止特定进程 ID
$ pm2 stop 0
$ pm2 stop app.js

# 停止所有进程
$ pm2 stop all

# 重新启动特定进程 ID
$ pm2 restart 0

# 重新启动所有进程
$ pm2 restart all

# 将从 pm2 列表中删除特定进程
$ pm2 delete 0

# 将从 pm2 列表中删除所有进程
$ pm2 delete all

# 0s 停机重新加载进程(对于 NETWORKED 进程)
# 这项功能允许你重新载入代码而不用失去请求连接。
# Note:仅能用于 web 应用,运行于 Node 0.11.x 版本,运行于 cluster 模式(默认模式)
$ pm2 reload all

# 清除所有进程
$ pm2 kill

# 将在 .pm2 文件夹下生成默认文件名为 dump.pm2 文件,导出 pm2 list 中的所有项目启动方式的数据
$ pm2 dump

# 重新导出新数据,覆盖 dump.pm2 文件
$ pm2 resurect

# 保存进程列表,可在重新启动时恢复
$ pm2 save

开机自动启动

pm2 start 运行你要开机启动的程序,在输入以下两个命令。

$ pm2 save
$ pm2 startup

按上面步骤试了一下发生错误提示。网上找了一些文章,但还没试过,这里贴出来给有需要的看看 在windows上安装pm2并设置开机启动

其他

# 启动 web 界面 http://localhost:9615
$ pm2 web

# 重置元数据(重新启动时间。。。)
$ pm2 reset

# 内存 pm2 更新
$ pm2 updatePM2

# 确保 pm2 守护进程已启动
$ pm2 ping

# 向脚本发送系统信号
$ pm2 sendSignal SIGHUP my-app