PM2 使用教程（Node.js 进程守护工具）

PM2 是 Node.js 最常用的进程管理器，可以让你的应用在后台持久运行，支持自动重启、负载均衡、日志管理等功能。

目录#

安装 PM2
启动应用
常用管理命令
日志管理
开机自启
集群模式
环境变量
常见问题
快速参考卡片
完整部署示例

1. 安装 PM2#

1
# 全局安装
2
npm install -g pm2
3

4
# 验证安装
5
pm2 --version

2. 启动应用#

2.1 基础启动#

1
# 启动单个文件
2
pm2 start index.mjs
3

4
# 指定应用名称（推荐）
5
pm2 start index.mjs --name "my-app"
6

7
# 启动时指定参数
8
pm2 start index.mjs --name "my-app" -- --port 3000

2.2 使用配置文件启动（推荐）#

在项目根目录创建 ecosystem.config.js：

1
module.exports = {
2
  apps: [
3
    {
4
      name: 'my-app',              // 应用名称
5
      script: './index.mjs',       // 启动文件
6
      cwd: '/opt/my-project',      // 工作目录（可选）
7
      instances: 1,                // 实例数量（1 或 'max' 使用全部CPU）
8
      exec_mode: 'fork',           // 执行模式：fork 或 cluster
9

10
      // 环境变量
11
      env: {
12
        NODE_ENV: 'development',
13
        PORT: 3000
14
      },
15
      env_production: {
16
        NODE_ENV: 'production',
17
        PORT: 3000
18
      },
19

20
      // 自动重启
21
      autorestart: true,
22

23
      // 内存限制（超过自动重启）
24
      max_memory_restart: '500M',
25

26
      // 日志配置
27
      log_file: './logs/combined.log',
28
      out_file: './logs/out.log',
29
      error_file: './logs/error.log',
30
      log_date_format: 'YYYY-MM-DD HH:mm:ss Z',
31

32
      // 监听文件变化自动重启（开发环境用）
33
      watch: false,
34
      ignore_watch: ['node_modules', 'logs'],
35

36
      // 延迟启动
37
      restart_delay: 3000,
38

39
      // 最大重启次数（防止无限重启）
40
      max_restarts: 10,
41

42
      // 最小运行时间
43
      min_uptime: '10s'
44
    }
45
  ]
46
};

启动命令：

1
pm2 start ecosystem.config.js
2

3
# 指定环境
4
pm2 start ecosystem.config.js --env production

3. 常用管理命令#

1
# 查看所有应用状态
2
pm2 status
3

4
pm2 ls
5

6
pm2 list
7

8
# 查看某个应用详情
9
pm2 show my-app
10

11
pm2 describe my-app
12

13
# 查看应用监控面板（实时）
14
pm2 monit
15

16
# 重启应用
17
pm2 restart my-app
18

19
pm2 restart all          # 重启所有
20

21
# 停止应用（不删除）
22
pm2 stop my-app
23

24
pm2 stop all
25

26
# 删除应用
27
pm2 delete my-app
28

29
pm2 delete all
30

31
# 重载应用（0 停机时间，仅 cluster 模式）
32
pm2 reload my-app
33

34
# 查看应用日志
35
pm2 logs my-app
36

37
pm2 logs my-app --lines 50    # 查看最新50行
38

39
pm2 logs --lines 100           # 查看所有应用最新100行
40

41
pm2 logs my-app --timestamp    # 带时间戳
42

43
# 清空日志（全局操作，不支持按应用）
44
pm2 flush
45

46
# 保存当前进程列表（用于开机自启）
47
pm2 save

WARNING

pm2 flush my-app 这种按应用清空日志的写法无效，flush 是全局操作，会清空所有应用的日志。

4. 日志管理#

1
# 实时查看日志
2
pm2 logs
3

4
# 查看指定应用日志
5
pm2 logs my-app
6

7
# 查看历史日志（带行数限制）
8
pm2 logs my-app --lines 200
9

10
# 只查看错误日志
11
pm2 logs my-app --err
12

13
# 只查看标准输出
14
pm2 logs my-app --out

日志文件默认位置：

路径	说明
`~/.pm2/logs/`	全局日志目录
`./logs/`	如果在配置中指定了相对路径

5. 开机自启#

1
# 生成开机启动脚本（根据系统类型自动生成）
2
pm2 startup
3

4
# 执行输出的命令（需要 root 权限）
5
# 例如：sudo env PATH=$PATH:/usr/bin pm2 startup systemd -u username --hp /home/username
6

7
# 保存当前运行的进程列表
8
pm2 save
9

10
# 取消开机自启
11
pm2 unstartup systemd

IMPORTANT

pm2 startup 只是生成命令，必须复制并执行它输出的那行命令才能真正生效。

6. 集群模式（多核利用）#

1
# 启动多个实例，利用全部 CPU 核心
2
pm2 start index.mjs -i max
3

4
# 或指定实例数
5
pm2 start index.mjs -i 4

在 ecosystem.config.js 中配置：

1
instances: 'max',
2
exec_mode: 'cluster'

7. 环境变量#

启动时传入环境变量：

1
pm2 start index.mjs --name "my-app" --env production

在 ecosystem.config.js 中定义：

1
env: {
2
  NODE_ENV: 'development',
3
  PORT: 3000,
4
  DATABASE_URL: 'mysql://localhost:3306/mydb'
5
}

TIP

环境变量建议在 ecosystem.config.js 中集中管理，不要在命令行里写一堆 --env。

8. 常见问题#

Q1: pm2 启动后访问不了？#

检查应用是否监听 0.0.0.0（不能仅监听 127.0.0.1）
检查防火墙是否放行端口
查看日志：pm2 logs my-app

Q2: 修改代码后如何生效？#

1
pm2 restart my-app

开发环境可开启 watch 模式：

1
pm2 start index.mjs --watch

Q3: 如何更新 PM2？#

1
npm install -g pm2@latest
2

3
pm2 update

Q4: 服务器重启后应用没了？#

1
pm2 save        # 保存进程列表
2

3
pm2 startup    # 设置开机自启（记得执行输出的命令）

9. 快速参考卡片#

命令	作用
`pm2 start app.js`	启动应用
`pm2 start app.js --name "xxx"`	指定名称启动
`pm2 status` / `ls` / `list`	查看状态
`pm2 restart xxx`	重启
`pm2 stop xxx`	停止
`pm2 delete xxx`	删除
`pm2 logs xxx`	查看日志
`pm2 monit`	监控面板
`pm2 save`	保存进程列表
`pm2 startup`	设置开机自启
`pm2 flush`	清空日志

10. 完整部署示例#

1
# 1. 进入项目目录
2
cd /opt/my-project
3

4
# 2. 安装依赖
5
npm install
6

7
# 3. 用 pm2 启动
8
pm2 start index.mjs --name "my-app"
9

10
# 4. 保存进程列表
11
pm2 save
12

13
# 5. 设置开机自启（复制并执行输出的命令）
14
pm2 startup
15

16
# 6. 查看状态确认
17
pm2 status

文档版本： 2026-07-30

本地阅读版下载

点击下载 TXT 版本

音乐

音乐

目录#