[特殊字符] PM2 入门实战：从 0 到线上托管 React SPA

1. 什么是 PM2？（30 s 速读）

PM2 是 Node.js 的生产级进程管理器，内置负载均衡、日志切割、开机自启、监控面板。
一句话：让你的 Node / 静态站点“永远在线”。

---

2. 本文目标

1. 了解 PM2 核心能力
2. 用一条命令把 React 单页应用跑在 3000 端口
3. 配置 ecosystem 文件，实现“可重复、可回滚”的部署
4. 开机自启 + 日志轮转，达到线上最低可维护标准

---

3. 环境准备

项目	版本
OS	OpenCloudOS / CentOS 8+
Node	22.11.0（已预装）
构建产物	react-app/build/ 目录已存在

---

4. 一条命令体验 PM2

cd /www/wwwroot/react-app
pm2 serve build 3000 --spa --name "react-app"

• --spa：所有 404 重定向到 index.html，支持 React-Router
• --name：进程别名，方便后续管理

成功后会看到：

[PM2] Serving /www/wwwroot/react-app/build on port 3000
┌────┬─────────────┬────────────┬──────┬──────┬────────┬───┬────────┬───┐
│ id │ name        │ namespace  │ mode │ pid  │ status │ ↑ │ cpu    │ mem │
├────┼─────────────┼────────────┼──────┼──────┼────────┼───┼────────┼───┤
│ 0  │ react-app   │ default    │ fork │ xxxx │ online │ 0 │ 0%     │ 32M │
└────┴─────────────┴────────────┴──────┴──────┴────────┴───┴────────┴───┘

浏览器访问 http://<服务器IP>:3000 即可看到 React 页面。

---

5. 核心概念图解（Mermaid）

5.1 PM2 架构一览

5.2 静态 SPA 流程

---

6. 把“命令”升级成“代码”——ecosystem 文件

在项目根新建 ecosystem.config.js：

module.exports = {
  apps: [{
    name: "react-app",
    script: "serve",
    args: "-s build -l 3000",
    instances: 1,
    exec_mode: "fork",
    env: { NODE_ENV: "production" },
    log_date_format: "YYYY-MM-DD HH:mm:ss Z",
    out_file: "./logs/combined.log",
    error_file: "./logs/combined.log",
    merge_logs: true
  }]
};

启动/重载：

pm2 start ecosystem.config.js
pm2 reload ecosystem.config.js        # 0 中断更新

---

7. 日志切割 & 磁盘保护

pm2 install pm2-logrotate
pm2 set pm2-logrotate:max_size 50M
pm2 set pm2-logrotate:retain 7

50 MB 自动切，保留 7 份，再也不怕磁盘爆。

---

8. 开机自启（systemd）

pm2 save                           # 保存当前列表
pm2 startup systemd                # 生成 systemd 服务
# 按提示执行
systemctl enable pm2-root

重启机器后 pm2 ls 仍在，进程自动拉回。

---

9. 日常值班 6 大宝命令

任务	命令
看列表	pm2 ls
实时日志	pm2 log react-app --lines 50
资源监控	pm2 monit
平滑重载	pm2 reload react-app
停止并删除	pm2 delete react-app
保存现场	pm2 save

---

10. 小结 & 下一步

1. 你已拥有可重复部署的 ecosystem 文件
2. 日志切割 + 开机自启，达到线上最低可维护标准
3. 下一步：
   • Nginx 反向代理 80/443
   • 接入 CI/CD（GitLab/GitHub Actions）一条 pm2 reload 完成上线
   • 使用 pm2-io-apm 接入 Web 监控 & 邮件/钉钉告警

---

11. 一键 cheatsheet（保存即可）

pm2 start app.js -i max      # 集群模式
pm2 reload api               # 平滑重启
pm2 monit                    # 资源面板
pm2 install pm2-logrotate    # 日志轮转
pm2 save && pm2 startup      # 开机自启

---

🎉 至此，PM2 入门完成！把这篇 Markdown 丢进仓库，团队其他成员也能 3 分钟跑起同样的环境。 Happy shipping!

---

以我之思，借AI之力