PM2 管理器

通过 SSH 连接管理远程 PM2 进程。该能力提供用于监控、控制和维护部署在远程服务器上的 Node.js 应用（使用 PM2 进程管理器）的命令。

前提条件

• 具备目标服务器的 SSH 访问权限
• 远程服务器已安装 PM2
• 推荐使用基于 SSH 密钥的身份验证方式
• 本地机器可访问目标服务器

使用方法

基础进程管理

列出所有进程：

ssh user@server "pm2 list"
ssh user@server "pm2 status"

启动 / 停止 / 重启服务：

# 启动指定应用
ssh user@server "pm2 start ecosystem.config.js"
ssh user@server "pm2 start app.js --name myapp"

# 重启指定进程
ssh user@server "pm2 restart myapp"
ssh user@server "pm2 restart 0"  # 按 ID

# 停止进程
ssh user@server "pm2 stop myapp"
ssh user@server "pm2 delete myapp"  # 彻底移除

# 重启全部进程
ssh user@server "pm2 restart all"

日志管理

查看实时日志：

# 所有进程
ssh user@server "pm2 logs"

# 指定进程
ssh user@server "pm2 logs myapp"
ssh user@server "pm2 logs 0"

# 最近 N 行日志
ssh user@server "pm2 logs myapp --lines 100"

# 仅错误日志
ssh user@server "pm2 logs myapp --err"

日志轮转与清理：

# 清空全部日志
ssh user@server "pm2 flush"

# 安装日志轮转插件
ssh user@server "pm2 install pm2-logrotate"

监控与性能

实时监控：

# 监控仪表盘
ssh user@server "pm2 monit"

# 显示详细信息
ssh user@server "pm2 show myapp"
ssh user@server "pm2 describe 0"

内存与 CPU 使用情况：

# 按内存使用量排序列出进程
ssh user@server "pm2 list --sort memory"

# 输出 JSON 格式（便于解析）
ssh user@server "pm2 jlist"
ssh user@server "pm2 prettylist"

高级操作

环境管理：

# 使用不同环境启动
ssh user@server "pm2 start ecosystem.config.js --env production"
ssh user@server "pm2 start app.js --env development"

# 更新环境变量
ssh user@server "pm2 restart myapp --update-env"

进程扩缩容：

# 扩容至 4 个实例
ssh user@server "pm2 scale myapp 4"

# 启动集群模式
ssh user@server "pm2 start app.js -i max"  # 使用全部 CPU
ssh user@server "pm2 start app.js -i 4"    # 启动 4 个实例

健康检查与自动重启：

# 设置触发重启的最大内存阈值
ssh user@server "pm2 start app.js --max-memory-restart 100M"

# 设置重启延迟时间（毫秒）
ssh user@server "pm2 start app.js --restart-delay 3000"

# 禁用自动重启
ssh user@server "pm2 start app.js --no-autorestart"

Ecosystem 配置

为复杂部署创建 ecosystem.config.js 文件：

module.exports = {
  apps: [
    {
      name: 'main-app',
      script: './app.js',
      instances: 2,
      env: {
        NODE_ENV: 'development',
        PORT: 3000
      },
      env_production: {
        NODE_ENV: 'production',
        PORT: 8080
      }
    },
    {
      name: 'worker',
      script: './worker.js',
      instances: 1,
      cron_restart: '0 0 * * *',  // 每日重启
      max_memory_restart: '200M'
    }
  ]
};

使用 ecosystem 配置部署：

# 上传并启动
scp ecosystem.config.js user@server:/path/to/app/
ssh user@server "cd /path/to/app && pm2 start ecosystem.config.js"

# 生产环境部署
ssh user@server "cd /path/to/app && pm2 start ecosystem.config.js --env production"

开机自启与持久化

保存当前进程列表：

ssh user@server "pm2 save"

配置开机启动脚本：

# 生成启动脚本
ssh user@server "pm2 startup"
# 按照提示执行生成的命令

# 保存当前状态并启用 systemd 开机自启
ssh user@server "pm2 save && pm2 startup systemd"

批量操作脚本示例

#!/bin/bash
# pm2-batch-restart.sh

SERVER="user@10.0.0.213"
APPS=("main-app" "linebot-server" "liff-server")

echo "正在重启 $SERVER 上的 PM2 服务..."

for app in "${APPS[@]}"; do
    echo "正在重启 $app..."
    ssh $SERVER "pm2 restart $app"
    if [ $? -eq 0 ]; then
        echo "✅ $app 重启成功"
    else
        echo "❌ $app 重启失败"
    fi
done

echo "检查运行状态..."
ssh $SERVER "pm2 list"

故障排查

常见问题及解决方案：

1. 进程无法启动：

ssh user@server "pm2 logs myapp --err"
ssh user@server "pm2 show myapp"

2. 内存占用过高：

ssh user@server "pm2 restart myapp"  # 快速修复
ssh user@server "pm2 reload myapp"   # 零停机重启

3. 端口冲突：

ssh user@server "pm2 show myapp | grep 'port'"
ssh user@server "netstat -tlnp | grep :3000"

4. 清除 PM2 缓存：

ssh user@server "pm2 kill && pm2 start ecosystem.config.js"

生产环境示例（Pro-Power 系统）

# 生产服务器管理
SERVER="administrator@10.0.0.213"

# 检查全部服务状态
ssh $SERVER "pm2 list"

# 重启指定服务
ssh $SERVER "pm2 restart main-app"
ssh $SERVER "pm2 restart linebot-server"
ssh $SERVER "pm2 restart ProPower-tunnel"

# 查看日志
ssh $SERVER "pm2 logs main-app --lines 50"

# 监控性能
ssh $SERVER "pm2 monit"

该能力简化了远程 PM2 管理流程，便于高效维护运行在生产服务器上的 Node.js 应用。