当前位置：首页 > news >正文

保姆级教程：让你的 Node.js 应用永远在线的神器——PM2

news 2026/7/2 0:27:29

保姆级教程：让你的 Node.js 应用永远在线的神器——PM2

你是否遇到过这样的崩溃瞬间：半夜服务器上运行的应用突然挂了，用户疯狂投诉，而你睡眼惺忪地登录重启？又或者每次更新代码都要手动node app.js，一关终端就 Game Over？今天介绍的这位“瑞士军刀”，能让你从此告别这些烦恼。

引言：想象你有一位 24 小时不睡觉的管家

假设你的 Node.js 应用是一个勤快的服务员，但它偶尔会累倒（崩溃），或者一到点就准时下班（终端关闭）。你需要的不是一个口头鼓励，而是一位铁面无私的管家，这位管家会：

服务员一倒下，立刻扶起来（自动重启）
餐厅客人太多，立刻多安排几个服务员站岗（多进程负载均衡）
记录每个服务员的一言一行，方便追责（日志管理）
在新服务员上岗时，保证老服务员先别走，客人不会察觉（零停机重载）

在 Node.js 的世界里，这位管家就叫PM2 (Process Manager 2)。这是一款生产级的进程管理工具，能把你的应用从“手工作坊”升级为“自动化工厂”。本篇文章就用最接地气的方式，带你从零掌握 PM2，让你的 Node.js 应用稳如老狗。

一、PM2 到底是什么？

用一句大白话说：PM2 是一个帮你把 Node.js 应用变成“后台服务”的工具。它让你的应用：

在后台持续运行，不依赖终端窗口
崩溃、异常退出后自动复活
可以利用多核 CPU 并行处理请求
集中管理日志，不用再console.log到屏幕上找半天
一条命令实现更新代码而不中断服务

它由 Keymetrics 团队开发，完全免费（核心功能），支持 Linux、macOS、Windows，甚至还能管理 Python、Ruby 等其他脚本。只要你会npm install，就能立刻拥有。

二、10 分钟快速上手

2.1 安装

确保你已经安装了 Node.js（建议版本 14 以上），然后打开终端，敲下这行命令：

npminstallpm2-g

这一步会把pm2命令安装到系统全局，之后在任何目录都能直接使用。

2.2 启动你的第一个应用

假设你有一个入口文件app.js（哪怕它只是console.log('hello')），用 PM2 启动它：

pm2 start app.js

神奇的事情发生了：

你的应用立刻在后台跑了起来，即使你关闭终端，它也不会停。
PM2 会返回一个像这样的进程列表：

┌─────┬────────┬─────────────┬─────────┬─────────┬──────────┬────────┬──────┬───────────┬──────────┬──────────┐ │ id │ name │ namespace │ version │ mode │ pid │ uptime │ ↺ │ status │ cpu │ mem │ ├─────┼────────┼─────────────┼─────────┼─────────┼──────────┼────────┼──────┼───────────┼──────────┼──────────┤ │ 0 │ app │ default │ 1.0.0 │ fork │ 12345 │ 0s │ 0 │ online │ 0% │ 25.0mb │ └─────┴────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┴──────────┘

重点看这几个字段：

id：PM2 给每个应用分配的编号，后续操作可以直接用 id 或者名称
status：online表示正常运行
↺：重启次数，如果异常退出这里会增长
uptime：运行时长

2.3 常用管理命令

pm2 list# 查看所有应用状态pm2 stop app# 停止应用（app 是名称或 id）pm2 restart app# 重启应用pm2 delete app# 从 PM2 管理列表移除（不再自动重启）pm2 logs# 实时查看所有应用的日志pm2 monit# 打开一个终端下的监控面板（CPU、内存、实时日志）

小技巧：如果应用名称太长，用pm2 list找到 id 后直接pm2 stop 0也一样。

三、两种工作模式：一个服务员 vs 一队服务员

这是很多小白容易困惑的点，但也是 PM2 的核心亮点。

PM2 启动应用时有两种执行模式：

模式	行为	适用场景
fork	单纯开一个子进程运行你的代码	小型应用、有状态服务（比如 WebSocket 强绑定）、定时任务
cluster	同时开多个子进程，共享同一个端口，PM2 自动做负载均衡	高并发、需要榨干多核 CPU 性能的无状态 API 服务

打个比方：

fork 模式就是雇佣一个全能服务员，客户少时够用，但来 100 个客人他就忙不过来了。
cluster 模式就是开一家连锁店，每个窗口（CPU 核心）配一个服务员，客人按顺序分配到不同窗口，所有人的等待时间都变短。

在 cluster 模式下，PM2 利用 Node.js 自带的cluster模块，创建一个主进程（master）和多个工作进程（worker）。所有 worker 都监听同一个端口，主进程负责把网络连接轮询分配给各个 worker，这就是所谓的Round-robin 负载均衡。

如何开启 cluster 模式？

pm2 start app.js-imax

-i max表示“有多少个 CPU 核心就开多少个进程”。你也可以指定具体数字，比如-i 4。

⚠️ 重要警告：cluster 模式要求你的应用是无状态的。什么意思？如果你的应用把用户 session 或临时数据存在进程内存里，那么同一个用户下次请求可能被分配到另一个 worker，数据就丢了。解决办法是使用 Redis、数据库等外部存储来存放共享状态。如果你的应用必须依赖内存状态（比如某些游戏服务器），请老老实实用 fork 模式。

四、生产环境必杀技：配置文件`ecosystem.config.js`

虽然用命令行启动很方便，但真正上生产，强烈建议你使用配置文件。它能帮你：

一次管理多个应用
固定各种参数，避免遗漏
轻松区分开发环境和生产环境的变量

在项目根目录创建一个ecosystem.config.js（名字可以自定义）：

module.exports={apps:[{name:"my-api",// 给应用起个名字script:"./server.js",// 入口文件instances:"max",// 使用所有 CPU 核心exec_mode:"cluster",// 集群模式watch:false,// 生产环境不要开文件监听max_memory_restart:"500M",// 内存占用超过 500MB 自动重启env:{NODE_ENV:"development",PORT:3000},env_production:{NODE_ENV:"production",PORT:80},error_file:"./logs/err.log",// 错误日志专门存放out_file:"./logs/out.log",// 普通日志存放merge_logs:true,// 集群模式下所有 worker 日志合并log_date_format:"YYYY-MM-DD HH:mm:ss Z"}]};

然后启动时指定环境：

pm2 start ecosystem.config.js--envproduction

配置文件里几个救命参数详解：

max_memory_restart：内存泄漏是 Node.js 应用的常见病，这个参数就是你的“自动退烧药”。内存飙到设定值，PM2 无脑重启该进程，保证服务不会因为内存爆掉而彻底瘫痪。
autorestart: true：默认开启，崩溃自动复活。如果你希望只在特定情况下自动重启，可以写false。
max_restarts：如果应用在短时间内反复崩溃，PM2 会认为它“没救了”，从而停止重启，避免无限循环消耗资源。默认 15 次。
min_uptime：进程至少要运行多久才被认为是“正常启动”。配合max_restarts使用，比如min_uptime: "10s", max_restarts: 5表示如果 10 秒内连续崩溃 5 次，就不再重启。

五、日志管理：再也不怕黑夜里的 bug

5.1 日志都去哪了？

默认情况下，PM2 会把每个应用的输出（console.log和错误信息）保存到~/.pm2/logs/文件夹，文件名为应用名-out.log和应用名-error.log。

常用命令：

pm2 logs# 实时滚动所有应用的日志（类似 tail -f）pm2 logs my-api# 只看 my-api 的日志pm2 logs--lines200# 显示最近 200 行pm2 flush# 一键清空所有日志（磁盘告急时特好用）

5.2 日志切分：防止硬盘被撑爆

如果不做任何限制，日志文件会越来越大，最终占满磁盘。PM2 官方提供了模块pm2-logrotate来解决这个问题。

安装：

pm2installpm2-logrotate

安装后按需配置（都是字面意思）：

pm2setpm2-logrotate:max_size 10M# 单个日志文件超过 10MB 自动切分pm2setpm2-logrotate:retain30# 保留最近 30 个文件，老的删掉pm2setpm2-logrotate:compresstrue# 被切分的老日志压缩保存

这样你就拥有了一个全自动的日志管家，根本不用操心。

六、零停机重载：用户无感知的代码更新

传统更新代码的流程是：git pull→ 关闭应用 → 重启，这中间至少有几秒到十几秒的服务中断，高峰期那就是一场灾难。

PM2 的绝招：在 cluster 模式下，pm2 reload可以做到零停机重载（也叫滚动重启）。

原理解析（配合上面的服务员比喻）：

PM2 先悄悄启动一个全新的服务员（新版本进程）。
等新服务员准备就绪，PM2 把客人（新请求）指给新服务员，同时告诉老服务员“你可以先不接新客人了，把手头的客人服务完”。
老服务员处理完手头工作后，优雅地退出。
重复以上步骤，逐个替换所有服务员，整个过程客人完全没有感觉到任何停顿。

实操就是一句命令：

pm2 reload my-api

或者如果你用配置文件启动，直接：

pm2 reload ecosystem.config.js

注意：在 fork 模式下，reload退化为restart，会有短暂中断。而且 reload 对无状态应用效果最好，如果你有 WebSocket 长连接，reload 时连接会断开，除非你做了额外的连接迁移处理。

七、开机自启：服务器重启后自动复活

服务器总是要定期维护重启的，你肯定不希望每次重启后都要手动敲pm2 start。

设置开机自启动只需三步：

# 1. 让 PM2 根据你的操作系统生成对应的启动脚本（它会自动检测是 systemd、launchd 还是其他）pm2 startup# 2. 把当前所有运行的应用保存为一个“复活列表”pm2 save# 3. (可选) 将来某一天想恢复这个列表pm2 resurrect

完成之后，哪怕是机房断电又来电，你的应用也会自动回到工作岗位。

八、Docker 环境下的正确打开方式

现在微服务、容器化大行其道，很多人会把 PM2 塞进 Docker。但要注意，容器本身就是一个进程管理器（比如 Kubernetes 管理 Pod），双重管理容易出问题。如果非要用，请遵守这个准则：

用pm2-runtime代替pm2作为容器入口命令。它会保证 PM2 在前台运行，并且能正确将SIGTERM等信号传递给你的应用，让容器能优雅退出。

示例 Dockerfile 片段：

FROM node:20-alpine WORKDIR /app COPY package*.json ./ RUN npm ci --production COPY . . RUN npm install pm2 -g EXPOSE 3000 CMD ["pm2-runtime", "start", "ecosystem.config.js"]

这样既享受了 PM2 的进程守护和负载均衡，又不违背容器的设计哲学。