La Configuración de VPS Que Realmente Funciona: Node.js, PM2, Nginx y Deploys Sin Tiempo de Inactividad | Akousa

javascript

// ecosystem.config.js
module.exports = {
  apps: [
    {
      name: "myapp",
      script: "node_modules/.bin/next",
      args: "start -p 3002",
      cwd: "/var/www/example.com",
      instances: 2,
      exec_mode: "cluster",
      max_memory_restart: "500M",
      env: {
        NODE_ENV: "production",
        PORT: 3002,
      },
      // Apagado elegante
      kill_timeout: 5000,
      listen_timeout: 10000,
      wait_ready: false,
      // Logging
      log_date_format: "YYYY-MM-DD HH:mm:ss Z",
      error_file: "/var/log/pm2/myapp-error.log",
      out_file: "/var/log/pm2/myapp-out.log",
      merge_logs: true,
      // Auto-reinicio ante fallos
      autorestart: true,
      max_restarts: 10,
      min_uptime: "10s",
      // No observar en produccion
      watch: false,
    },
  ],
};

nginx

# /etc/nginx/sites-available/example.com
 
upstream node_app {
    server 127.0.0.1:3002;
    keepalive 64;
}
 
server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;
 
    # Redirigir todo HTTP a HTTPS
    return 301 https://$host$request_uri;
}
 
server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name example.com www.example.com;
 
    # SSL (gestionado por Certbot — estas lineas se agregan automaticamente)
    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
 
    # Headers de seguridad
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-XSS-Protection "1; mode=block" always;
    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
    add_header Strict-Transport-Security "max-age=63072000; includeSubDomains; preload" always;
 
    # Compresion gzip
    gzip on;
    gzip_vary on;
    gzip_proxied any;
    gzip_comp_level 6;
    gzip_min_length 256;
    gzip_types
        text/plain
        text/css
        text/javascript
        application/javascript
        application/json
        application/xml
        image/svg+xml
        application/wasm;
 
    # Configuracion del proxy
    location / {
        proxy_pass http://node_app;
        proxy_http_version 1.1;
 
        # Headers
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
 
        # Soporte WebSocket (por si alguna vez lo necesitas)
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
 
        # Timeouts — generosos pero no infinitos
        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;
 
        # Buffering — deja que Nginx maneje los clientes lentos
        proxy_buffering on;
        proxy_buffer_size 16k;
        proxy_buffers 4 32k;
        proxy_busy_buffers_size 64k;
    }
 
    # Assets estaticos de Next.js — deja que Nginx los sirva directamente
    location /_next/static/ {
        alias /var/www/example.com/.next/static/;
        expires 365d;
        access_log off;
        add_header Cache-Control "public, immutable";
    }
 
    # Archivos estaticos publicos
    location /static/ {
        alias /var/www/example.com/public/static/;
        expires 30d;
        access_log off;
    }
 
    # Bloquear acceso a archivos punto
    location ~ /\. {
        deny all;
        access_log off;
        log_not_found off;
    }
}

bash

#!/bin/bash
# deploy.sh — despliegue con casi-cero tiempo de inactividad
 
set -euo pipefail
 
APP_DIR="/var/www/example.com"
APP_NAME="myapp"
LOG_FILE="/var/log/deploy.log"
HEALTH_URL="http://localhost:3002"
MAX_RETRIES=10
RETRY_INTERVAL=3
 
log() {
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" | tee -a "$LOG_FILE"
}
 
log "=== Deploy iniciado ==="
 
cd "$APP_DIR"
 
# Obtener el codigo mas reciente
log "Obteniendo ultimos cambios..."
git pull origin main 2>&1 | tee -a "$LOG_FILE"
 
# Instalar dependencias
log "Instalando dependencias..."
npm install --legacy-peer-deps 2>&1 | tee -a "$LOG_FILE"
 
# Compilar
log "Compilando aplicacion..."
rm -rf .next
npm run build 2>&1 | tee -a "$LOG_FILE"
 
if [ $? -ne 0 ]; then
    log "ERROR: La compilacion fallo. Abortando deploy."
    exit 1
fi
 
# Recargar PM2 (sin tiempo de inactividad en modo cluster)
log "Recargando PM2..."
pm2 reload "$APP_NAME" 2>&1 | tee -a "$LOG_FILE"
pm2 save 2>&1 | tee -a "$LOG_FILE"
 
# Health check con reintentos
log "Ejecutando health check..."
for i in $(seq 1 $MAX_RETRIES); do
    HTTP_CODE=$(curl -s -o /dev/null -w '%{http_code}' "$HEALTH_URL" 2>/dev/null || echo "000")
    if [ "$HTTP_CODE" = "200" ]; then
        log "Health check exitoso (HTTP $HTTP_CODE)"
        log "=== Deploy completado exitosamente ==="
        exit 0
    fi
    log "Intento de health check $i/$MAX_RETRIES (HTTP $HTTP_CODE). Reintentando en ${RETRY_INTERVAL}s..."
    sleep $RETRY_INTERVAL
done
 
log "ERROR: Health check fallo despues de $MAX_RETRIES intentos"
log "Revirtiendo al estado anterior de PM2..."
pm2 restart "$APP_NAME" 2>&1 | tee -a "$LOG_FILE"
exit 1

La Configuración de VPS Que Realmente Funciona: Node.js, PM2, Nginx y Deploys Sin Tiempo de Inactividad

Empieza Con Seguridad, No Con Código

Crea un Usuario No-Root

Configura la Autenticación por Clave SSH

Firewall Con UFW

Fail2Ban

Actualizaciones de Seguridad Automaticas

Node.js: Usa NVM, No apt

PM2: El Gestor de Procesos Qué Se Gana Su Lugar

Instala y Configura

El Archivo de Configuración Ecosystem

Script de Inicio

Rotacion de Logs

Nginx: El Reverse Proxy Que Hace Más De Lo Que Crees

Instala

La Configuración

SSL en Cinco Minutos

Verifica la Renovacion Automática

El Script de Deploy

Cuando Las Cosas Se Rompen a las 2 AM

"El sitio esta caido"

"La memoria sigue creciendo"

"El certificado SSL expiro"

"El disco esta lleno"

El Comando Qué Ejecuto Cada Mañana

Lo Qué La Mayoria de las Guias No Te Dicen

La Lista de Verificación Completa

Es Esto "Enterprise-Grade"?

Artículos relacionados

Monorepos in 2026: Nx, Turborepo, and the Lessons Nobody Shares

YAML Validator Guide: Catch Config Errors Before Deploy