16. Puesta en Producción en VPS: Modo Cluster, PM2 y Proxy Inverso con Nginx
Aprende a ejecutar tu aplicación Express en un servidor VPS con Linux utilizando PM2 en modo clúster para aprovechar todos los núcleos de CPU, compresión gzip, certificados SSL y proxy inverso Nginx.
Puesta en Producción Empresarial en VPS de OVH
Ejecutar node server.js directamente en un servidor de producción es inadmisible: si la aplicación sufre una excepción no capturada, el proceso muere y el sitio queda fuera de línea. En un entorno profesional sobre un VPS (Servidor Privado Virtual), combinamos el gestor de procesos PM2 con un proxy inverso Nginx y certificados SSL para lograr alta disponibilidad, balanceo de carga entre núcleos de CPU y reinicios sin caída (Zero Downtime).
1. PM2 en Modo Clúster (cluster_mode)
Node.js es monohilo por defecto, lo que significa que un proceso solo utiliza un núcleo de CPU. Si tu VPS cuenta con 4 núcleos vCPU, el 75% de la capacidad de cómputo queda ociosa. Configurando PM2 con instances: 'max', PM2 instancia un proceso de Express por cada núcleo de CPU disponible y balancea las conexiones entrantes mediante el módulo cluster nativo de Node.js.
2. El Rol del Proxy Inverso con Nginx
| Responsabilidad | ¿Quién la asume? | Ventaja |
|---|---|---|
| Terminación SSL/TLS (HTTPS) | Nginx | Libera a Node.js de la pesada carga criptográfica de cifrar y descifrar el tráfico TLS. |
| Servicio de Archivos Estáticos | Nginx | Nginx sirve imágenes, CSS y bundles en milisegundos mediante la llamada al sistema sendfile de Linux sin tocar el Event Loop de Express. |
| Lógica de la API y Persistencia | Express.js (PM2) | Express se enfoca exclusivamente en la computación de datos de negocio y consultas a PostgreSQL. |
⚡ Configuración de ecosystem.config.cjs para PM2 y Bloque Nginx
Archivos de configuración listos para despliegue en servidor VPS.
// ==========================================
// ARCHIVO: ecosystem.config.cjs (PM2 Cluster)
// ==========================================
module.exports = {
apps: [
{
name: 'kilopolis-api',
script: './src/server.js',
instances: 'max', // Un worker por cada núcleo de CPU del VPS
exec_mode: 'cluster',
autorestart: true, // Reiniciar automáticamente si el proceso falla
watch: false, // Desactivar watch en producción
max_memory_restart: '500M', // Reiniciar si una instancia supera 500MB de RAM (fuga de memoria)
env_production: {
NODE_ENV: 'production',
PORT: 3000,
},
},
],
};
/* =========================================================================
BLOQUE DE CONFIGURACIÓN DE NGINX (/etc/nginx/sites-available/kilopolis-api)
=========================================================================
server {
listen 80;
server_name api.kilopolis.com;
return 301 https://$host$request_uri; # Forzar redirección HTTPS
}
server {
listen 443 ssl http2;
server_name api.kilopolis.com;
# Certificados SSL gestionados con Certbot / Let's Encrypt
ssl_certificate /etc/letsencrypt/live/api.kilopolis.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/api.kilopolis.com/privkey.pem;
# Cabeceras de proxy esenciales para Express.js (trust proxy)
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
# Soporte para WebSockets
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
# Preservar la IP y host real del cliente
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;
# Timeouts de proxy
proxy_connect_timeout 60s;
proxy_send_timeout 60s;
proxy_read_timeout 60s;
}
}
*/
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Qué beneficio ofrece configurar PM2 con instances: "max" y exec_mode: "cluster" en un servidor VPS multicore?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar Express.js: Framework Backend & APIs Empresariales 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.