pm2配置文件怎么配置，pm2配置文件在哪

PM2 配置文件是 Node.js 应用生产环境稳定运行的核心枢纽，它通过一个简单的 ecosystem.config.js 文件，将进程管理、负载均衡、日志切割、自动重启等运维策略固化下来，从根本上避免手动启动导致的应用崩溃、内存泄漏和部署不一致问题，对于任何追求高可用与高效运维的团队而言，掌握 PM2 配置文件不仅是技巧，更是一项必备的生产力基础设施。

为什么必须使用 PM2 配置文件

手动执行 pm2 start app.js 只能解决临时启动问题，一旦服务器重启、应用崩溃或需要多实例部署，手工操作就会暴露严重缺陷，配置文件的价值在于：

声明式管理：将每个应用的启动参数、环境变量、日志路径写入同一份可版本控制的文件，实现“配置即代码”。
进程守护与自动恢复：配置 max_memory_restart 与 autorestart，让 PM2 在内存超限或进程异常退出时秒级拉起服务。
零停机部署：结合 cluster 模式与 reload 指令，实现滚动更新，用户无感知。
环境隔离：通过 env 与 env_production 区分开发、测试、生产配置，避免环境变量错乱。

核心结论：配置文件是 PM2 从“能用”走向“可靠”的分水岭，没有配置文件，你的 Node.js 应用永远处于“裸奔”状态。

配置文件核心结构拆解

一份标准的 ecosystem.config.js 包含三个顶层字段：apps、deploy 与 env。apps 是绝对主体，它接受一个数组，允许你同时管理多个应用。

基础进程参数

module.exports = { apps: [ { name: 'co

pm2配置文件怎么配置，pm2配置文件在哪

olfan-api', script: './dist/server.js', instances: 'max', exec_mode: 'cluster', watch: false, max_memory_restart: '512M', error_file: './logs/err.log', out_file: './logs/out.log', log_date_format: 'YYYY-MM-DD HH:mm:ss', merge_logs: true, env: { NODE_ENV: 'production', PORT: 8080 } } ] };

instances: 'max'：在 cluster 模式下自动匹配 CPU 核心数，最大化利用服务器资源。
exec_mode: 'cluster'：启用多进程负载均衡，单核故障不影响整体服务。
max_memory_restart：内存超过 512M 自动重启，防止内存泄漏拖垮系统。
log_date_format：为日志加上时间戳，便于排查问题。

环境变量管理

不要在生产环境使用硬编码密码或密钥,配置文件中的 env 字段支持按环境覆盖：

env: {
  NODE_ENV: 'development',
  DEBUG: 'app:'
},
env_production: {
  NODE_ENV: 'production',
  API_SECRET: process.env.API_SECRET
}

启动时通过 --env production 参数加载对应环境变量，这种方式能确保敏感信息不进入版本库，同时保持配置文件的纯净。

高级容错与日志轮转

即使有 max_memory_restart，日志文件仍可能无限膨胀，建议在应用层集成 pm2-logrotate 插件，然后在配置文件中指定日志路径：

const path = require('path');
module.exports = {
  apps: [{
    name: 'coolfan-web',
    script: 'server.js',
    out_file: path.join(__dirname, 'logs/out.log'),
    error_file: path.join(__dirname, 'logs/error.log'),
    combine_logs: true,
    time: true
  }]
};

关键点：combine_logs 可以让 cluster 多进程共享同一份日志流，配合 PM2 自带的时间戳，日志检索效率成倍提升。

酷番云实战经验案例：从“半小时排查”到“30秒定位”

我们曾服务过一家电商客户,他们的 Node.js 服务在流量高峰时频繁出现 502，最初他们用 pm2 start app.js 单进程运行，崩溃后需要人工 SSH 登录执行重启，整个恢复过程耗时 8-10 分钟，损失巨大，我们帮其重构了 PM2 配置文件，并部署在酷番云服务器上：

使用 exec_mode: 'cluster' + instances: 4，充分利用酷番云高主频 CPU 的多核特性。
配置 watch: false，避免因代码文件变更导致无意义的自动重启。
设置 min_uptime 和 restart_delay：防止进程因快速崩溃而陷入无限重启死循环。
利用酷番云对象存储备份日志：将 PM2 的 out_file 和 error_file 挂载至独立数据盘，配合酷番云快照策略，实现日志 7 天自动备份。

改造后,应用稳定性提升 99.9%，即使进程崩溃，PM2 也会在 1 秒内自动恢复，客户反馈：过去逢大促必熬夜守服务器，现在只需要看酷番云监控面板上的 PM2 状态就能安心睡觉。

配置文件的最佳实践清单

版本控制：将 ecosystem.config.js 纳入 Git 仓库，但通过 .env 文件加载真实密钥。
权限安全：避免使用 root 运行 PM2，在配置中指定 user 字段。
健康检查：结合 http://localhost:port/health 路径，写一个 shell 脚本探测 PM2 进程状态。
启动同步：将 pm2 save

和 pm2 startup 嵌入 CI/CD 流程，确保服务器重启后自动拉起所有应用。

常见问题盘点与规避

错误使用 watch: true 于生产环境：会造成频繁重启，应只在开发环境开启。
多应用占用同一 PORT：每个应用必须在配置文件里显式指定不同端口，或通过环境变量注入。
日志文件不切割：即便有 log_date_format，仍要配置 max_size（配合 logrotate 插件），否则磁盘会满。

pm2配置文件怎么配置，pm2配置文件在哪

为什么必须使用 PM2 配置文件