16. Despliegue en Producción: Gestión de Procesos con PM2, Reverse Proxy Nginx y VPS
Prepara tu aplicación Node.js para producción en servidores VPS: reinicios automáticos y modo cluster con PM2, configuración de proxy inverso con Nginx y variables NODE_ENV.
El Reto de Ejecutar Node.js en Servidores de Producción
En tu máquina de desarrollo basta con ejecutar node server.js. Sin embargo, en un servidor de producción VPS (como las instancias de Kilopolis en OVH), esta estrategia es inaceptable por dos razones críticas:
- Si cierras la sesión SSH en la terminal, el proceso se mata de inmediato.
- Si la aplicación sufre una excepción no controlada o el servidor se reinicia, el proceso muere y tus usuarios se encontrarán con el servicio caído.
PM2: El Gestor de Procesos de Nivel Empresarial
PM2 (Production Process Manager) es la herramienta estándar para mantener aplicaciones Node.js vivas para siempre (24/7), recargarlas sin tiempo de inactividad (Zero-Downtime Reloads) y facilitar el monitoreo de CPU y memoria.
# 1. Instalar PM2 de forma global en el VPS
npm install -g pm2
# 2. Iniciar la aplicación asignándole un nombre legible
pm2 start src/server.js --name "kilopolis-api"
# 3. Iniciar en Modo Cluster aprovechando todos los núcleos de la CPU
pm2 start src/server.js -i max --name "kilopolis-api-cluster"
# 4. Listar procesos y monitorear telemetría
pm2 status
pm2 monit
pm2 logs kilopolis-api --lines 50
Persistencia tras Reinicio del VPS
Para que tus servicios de Node.js arranquen automáticamente si el servidor VPS se reinicia por mantenimiento o corte de energía:
# Genera el script de inicio para el gestor systemd de Linux
pm2 startup
# Guarda la lista actual de procesos en ejecución
pm2 save
Arquitectura con Proxy Inverso Nginx
Nunca expongas el puerto de Node (ej. 3000) directamente a internet. La práctica recomendada en servidores VPS es colocar Nginx como Reverse Proxy en el puerto 80/443. Nginx se encarga de negociar el cifrado SSL (HTTPS con Let's Encrypt), comprimir respuestas con Gzip y reenviar las peticiones a la aplicación interna de Node:
server {
server_name api.kilopolis.com;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
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;
}
}
⚡ Archivo de Configuración para PM2: ecosystem.config.cjs
Configuración declarativa para orquestar despliegues, variables de entorno y modo cluster:
// ecosystem.config.cjs - Configuración Oficial de Despliegue con PM2
module.exports = {
apps: [
{
name: 'kilopolis-api',
script: './src/server.js',
// Modo Cluster: crea una instancia por cada núcleo de CPU del VPS
instances: 'max',
exec_mode: 'cluster',
// Reinicio automático si el proceso supera 300MB de RAM (previene fugas)
max_memory_restart: '300M',
// Entorno de Producción
env_production: {
NODE_ENV: 'production',
PORT: 3000,
},
// Configuración de Bitácoras Rotativas
error_file: './storage/logs/pm2-err.log',
out_file: './storage/logs/pm2-out.log',
merge_logs: true,
time: true,
},
],
};
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Cuál es la función principal del "Modo Cluster" de PM2 (pm2 start -i max) en un servidor VPS multi-núcleo?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar Node.js & npm Profesional y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.