Desplegar una aplicación Node.js en un VPS

¿Por qué desplegar Node.js en un VPS en lugar de en una plataforma gestionada?

Lo que gana con un VPS para Node.js

• Proceso Node.js persistente, ideal para WebSocket, SSE y tareas largas sin cold start
• Reinicio automático tras un fallo y al reiniciar el servidor gracias a PM2
• Modo cluster para aprovechar todos los núcleos de CPU del VPS sin cambiar su código
• Proxy inverso Nginx delante de Node para HTTPS, compresión y archivos estáticos
• Workers de colas (BullMQ, Agenda) y tareas programadas que se ejecutan junto a la API, en la misma máquina
• Varias aplicaciones en un solo VPS, cada una en su puerto interno (3000, 3001…) y su subdominio detrás de Nginx
• Renderizado en servidor de frameworks como Nuxt o Next.js, servidos por la misma base de Node.js y PM2
• Coste fijo y previsible, sin facturación por petición ni sorpresas al escalar
• Control total de la versión de Node.js y de las dependencias del sistema

Requisitos previos

Partir de la plantilla Node.js Stack

Desplegar una aplicación Node.js en producción

1. 01

   Preparar el VPS e instalar Node.js

   En un VPS Ubuntu 24.04, actualice el sistema e instale una versión LTS de Node mediante nvm (nvm install --lts) o el repositorio de NodeSource. Compruebe con node -v y npm -v. Cree un usuario no root dedicado a la aplicación en lugar de ejecutarlo todo como root: ese usuario será el propietario del código, del archivo .env y de los procesos de PM2. Con la plantilla Node.js Stack, Node.js, npm y PM2 ya están instalados: solo queda crear el usuario.

2. 02

   Obtener el código y hacer el build

   Clone su repositorio en el VPS, instale las dependencias de producción (npm ci --omit=dev) y lance el build si hace falta (npm run build).

   Guarde las variables sensibles en un archivo .env no versionado, legible solo por el usuario de la aplicación (chmod 600 .env). No necesita ninguna librería para leerlo: desde Node.js 20.6, la opción --env-file carga ese archivo en process.env al arrancar.

3. 03

   Preparar la base de datos PostgreSQL

   Si la aplicación necesita una base de datos, cree un rol y una base dedicados en lugar de trabajar con el superusuario:

   sudo -u postgres createuser --pwprompt monapp
   sudo -u postgres createdb --owner=monapp monapp

   Después indique DATABASE_URL=postgres://monapp:<contraseña>@127.0.0.1:5432/monapp en el .env. Como PostgreSQL solo escucha en local, no hay que abrir ningún puerto de base de datos en el cortafuegos.

4. 04

   Lanzar la aplicación con PM2

   Instale PM2 de forma global (npm install -g pm2, ya hecho en la plantilla) y arranque la aplicación desde la carpeta del proyecto, pidiendo a Node que cargue el .env:

   pm2 start app.js --name monapp -i max --node-args="--env-file=.env"

   El flag -i max activa el modo cluster en todos los núcleos. PM2 reinicia automáticamente el proceso si falla.

5. 05

   Activar el arranque automático al iniciar

   Genere el script de systemd con pm2 startup, ejecutado por el usuario de la aplicación, lance con sudo el comando que se muestra y después fije el estado actual con pm2 save. En el próximo reinicio del VPS, su aplicación se relanzará automáticamente, sin intervención.

6. 06

   Configurar Nginx como proxy inverso

   Instale Nginx si aún no está presente y cree /etc/nginx/sites-available/monapp, un virtual host que redirige al puerto local de Node. Las cabeceras Upgrade y Connection sirven para los WebSocket, y X-Forwarded-Proto indica a la aplicación que el cliente está en HTTPS:

   server {
       listen 80;
       server_name yourdomain.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_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
           proxy_set_header X-Forwarded-Proto $scheme;
       }
   }

   Active el sitio, retire la página por defecto, pruebe la configuración y recargue:

   ln -s /etc/nginx/sites-available/monapp /etc/nginx/sites-enabled/
   rm /etc/nginx/sites-enabled/default
   nginx -t && systemctl reload nginx

7. 07

   Proteger con HTTPS mediante Let's Encrypt

   Instale Certbot y su plugin para Nginx y solicite el certificado:

   apt install certbot python3-certbot-nginx
   certbot --nginx -d yourdomain.com

   Certbot obtiene el certificado, configura la redirección HTTP→HTTPS y programa la renovación automática. Su aplicación Node ya se sirve en HTTPS.

Centralizar la configuración en ecosystem.config.js

module.exports = {
  apps: [
    {
      name: 'api',
      cwd: '/home/monapp/app',
      script: 'app.js',
      instances: 'max',
      exec_mode: 'cluster',
      node_args: '--env-file=.env',
      max_memory_restart: '500M',
      env: { NODE_ENV: 'production', PORT: 3000 }
    },
    {
      name: 'worker',
      cwd: '/home/monapp/app',
      script: 'worker.js',
      node_args: '--env-file=.env'
    }
  ]
}

Registros: leerlos y después rotarlos

pm2 install pm2-logrotate
pm2 set pm2-logrotate:max_size 50M
pm2 set pm2-logrotate:retain 7