Runstack
    nodejs-python/Artigo

    Node.js em produção com PM2

    PM2 é o gerenciador de processos mais usado para Node.js em produção — garante que a aplicação reinicia automaticamente após crashes, usa todos os CPUs disponíveis via cluster mode e centraliza logs de múltiplos processos. É a alternativa mais simples ao Docker para quem quer Node.js diretamente no host da VPS.

    Instalar e iniciar a aplicação com PM2

    PM2 é instalado globalmente via npm. Após instalar, inicie a aplicação e configure o startup automático:

    bash
    # Instalar PM2 globalmente
npm install -g pm2

# Iniciar aplicação (modo fork — 1 processo)
pm2 start dist/index.js --name "minha-api"

# Iniciar com variáveis de ambiente
pm2 start dist/index.js --name "minha-api" --env production

# Ver processos rodando
pm2 list
pm2 status

# Configurar para iniciar no boot da VPS
pm2 startup
# Executar o comando que o PM2 sugerir (ex: sudo env PATH=... pm2 startup systemd -u deploy)
pm2 save
    Dica
    pm2 startup gera um comando específico para o seu sistema (systemd, upstart, etc.). Execute o comando sugerido exatamente como aparece — ele configura o PM2 para iniciar automaticamente no boot.

    ecosystem.config.js: configuração declarativa

    O arquivo de ecosistema centraliza a configuração de todos os processos e deve ser commitado no repositório:

    javascript
    // ecosystem.config.js
module.exports = {
  apps: [
    {
      name: 'minha-api',
      script: 'dist/index.js',
      instances: 'max',           // um processo por CPU
      exec_mode: 'cluster',       // modo cluster (workers)
      watch: false,               // nunca watch em produção
      max_memory_restart: '500M', // reiniciar se usar > 500 MB
      env_production: {
        NODE_ENV: 'production',
        PORT: 3000,
      },
      // Logs centralizados
      out_file: '/var/log/pm2/minha-api-out.log',
      error_file: '/var/log/pm2/minha-api-err.log',
      merge_logs: true,
      log_date_format: 'YYYY-MM-DD HH:mm:ss',
      // Restart inteligente
      restart_delay: 3000,        // aguardar 3s antes de reiniciar
      max_restarts: 10,           // max 10 restarts em 15min
      min_uptime: '5s',           // mínimo 5s rodando para ser "estável"
    },
  ],
}

    Cluster mode: usar todos os CPUs

    No modo cluster, PM2 cria um processo por CPU e distribui requisições com balanceamento de carga nativo do Node.js:

    bash
    # Iniciar com ecosistema (modo cluster)
pm2 start ecosystem.config.js --env production

# Ver distribuição de carga entre workers
pm2 list
# Cada processo mostra CPU%, RAM e restarts

# Reiniciar workers um a um (zero downtime)
pm2 reload minha-api

# Escalar para número específico de instâncias
pm2 scale minha-api 4      # 4 processos
pm2 scale minha-api +2     # adicionar 2 processos
pm2 scale minha-api -1     # remover 1 processo

# Ver em que worker cada requisição está sendo processada
pm2 monit
    Dica
    pm2 reload (diferente de pm2 restart) reinicia workers um a um sem derrubar o processo: zero downtime deploy. Use pm2 reload em produção; pm2 restart apenas quando necessário reiniciar tudo de uma vez.

    Gerenciar logs

    PM2 centraliza logs de todos os workers. Configure rotação para evitar disco cheio:

    bash
    # Ver logs em tempo real
pm2 logs minha-api
pm2 logs minha-api --lines 100

# Ver apenas erros
pm2 logs minha-api --err

# Limpar logs manualmente
pm2 flush minha-api

# Instalar rotação de logs automática
pm2 install pm2-logrotate

# Configurar rotação
pm2 set pm2-logrotate:max_size 10M    # arquivo máximo 10 MB
pm2 set pm2-logrotate:retain 7        # manter 7 arquivos rotacionados
pm2 set pm2-logrotate:compress true   # comprimir arquivos antigos

    Deploy com PM2 (sem Docker)

    Script de deploy para aplicações Node.js gerenciadas pelo PM2 diretamente no host:

    bash
    #!/bin/bash
# deploy.sh

VPS_USER=deploy
VPS_HOST=IP_DA_VPS
APP_DIR=/opt/minha-api

# Sincronizar arquivos
rsync -avz --exclude='node_modules' --exclude='.env' --exclude='.git' \
  ./ $VPS_USER@$VPS_HOST:$APP_DIR/

# Na VPS: instalar deps, build e reload
ssh $VPS_USER@$VPS_HOST "
  cd $APP_DIR
  npm ci --only=production
  npm run build
  pm2 reload ecosystem.config.js --env production
  pm2 save
"
    Dica
    pm2 reload após rsync e build faz o deploy com zero downtime — os workers são reiniciados um a um enquanto os outros continuam servindo tráfego.

    $ runstack deploy --plan starter

    Não quer configurar manualmente?

    Não quer configurar manualmente? Implante o VPS em menos de 3 minutos com a Runstack. Infraestrutura da OPEN DATACENTER, com servidores no Brasil.

    Começar agoraVer planos e preços

    Perguntas frequentes

    Conteúdos relacionados

    VPS para Node.js no Brasil →Como instalar o Docker →Deploy de app Node.js na VPS com DockerVariáveis de ambiente em Node.jsLogs em Node.js para produção