[特殊字符] PM2 入门实战：从 0 到线上托管 React SPA
1. 什么是 PM2？（30 s 速读）
PM2 是 Node.js 的生产级进程管理器，内置负载均衡、日志切割、开机自启、监控面板。
一句话：让你的 Node / 静态站点“永远在线”。
2. 本文目标
- 了解 PM2 核心能力
- 用一条命令把 React 单页应用跑在 3000 端口
- 配置 ecosystem 文件，实现“可重复、可回滚”的部署
- 开机自启 + 日志轮转，达到线上最低可维护标准
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. 小结 & 下一步
- 你已拥有可重复部署的 ecosystem 文件
- 日志切割 + 开机自启，达到线上最低可维护标准
- 下一步：
- 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之力