PM2 使用指南

安装

npm

npm install pm2@latest -g

yarn

yarn global add pm2

基础命令

进程管理

启动应用.sh

# 基础启动
pm2 start app.js

# 指定应用名称
pm2 start app.js --name "myapp"

# 启用监视模式（文件变化时自动重启）
pm2 start app.js --watch

# 启动4个实例（集群模式）
pm2 start app.js -i 4

# 根据CPU核心数启动最大实例数
pm2 start app.js -i max

重启应用.sh

# 硬重启
pm2 restart app.js

# 零停机重载（推荐用于生产环境）
pm2 reload app.js

# 优雅重载所有应用
pm2 gracefulReload all

停止应用.sh

# 停止特定应用
pm2 stop app.js

# 停止所有应用
pm2 stop all

删除应用.sh

# 删除特定应用
pm2 delete app.js

# 删除所有应用
pm2 delete all

监控和查看

查看列表.sh

# 显示所有进程状态
pm2 list

# 等同于 list
pm2 status

查看信息.sh

# 显示应用详细信息
pm2 show <app-name>

# 等同于 show
pm2 describe <app-name>

监控.sh

# 监控所有进程资源使用情况
pm2 monit

日志.sh

# 显示所有应用日志
pm2 logs

# 显示特定应用日志
pm2 logs <app-name>

# 显示最后200行日志
pm2 logs --lines 200

配置文件使用

配置文件示例

pm2.conf.json

{
  "apps": {
    "name": "ws", // 应用名
    "script": "index.js", // 启动应用文件位置
    "cwd": "./", // 当前工作路径
    "watch": true, // 监听模式
    "ignore_watch": [
      // 忽略不想监听的文件改动
      "node_modules",
      "logs"
    ],
    "instances": 4, // 多进程，0表示根据CPU数量启动尽可能多的进程（集群模式）
    "error_file": "logs/err.log", // 普通输出日志文件及位置
    "out_file": "logs/out.log", // 错误输出日志文件及位置，使用pm2 install pm2-logrotate进行日志文件拆分
    "log_type": "json", // 日志类型
    "log_date_format": "YYYY-MM-DD HH:mm:ss" // 日志日期记录格式
  }
}

启动配置

default.sh

# 使用默认环境
pm2 start ecosystem.config.js

production.sh

# 使用生产环境配置
pm2 start ecosystem.config.js --env production

常用维护命令

更新.sh

# 保存当前应用列表
pm2 save

# 热更新 PM2
pm2 update

自启动.sh

# 生成开机自启脚本
pm2 startup

# 保存当前应用列表以便开机启动
pm2 save

日志清理.sh

# 清空所有日志
pm2 flush