Node.js en un VPS - systemd + Nginx, sin Docker

Paso a paso: Node.js 22 desde NodeSource, usuario dedicado para la app, reinicio automático con systemd, reverse proxy Nginx y HTTPS. Comandos reales, despliegue en 15 minutos.

Sin Docker, sin PaaS, sin magia. Node.js más systemd y Nginx es un stack que sobrevive a reinicios, caídas y tráfico - y puede leerlo todo.

1. Instale Node.js

apt update && apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
apt install -y nodejs
node --version

2. Cree un usuario para la aplicación

Nunca ejecute una aplicación web como root. Un usuario separado limita el daño si la aplicación se ve comprometida.

adduser --system --group --home /opt/myapp app
mkdir -p /opt/myapp
chown app:app /opt/myapp

3. Suba la aplicación

Desde su portátil, con rsync sobre SSH - sin necesidad de un servidor Git:

rsync -avz --exclude node_modules ./app/ root@YOUR_SERVER_IP:/opt/myapp/

En el servidor, instale las dependencias y pruebe una vez en primer plano:

cd /opt/myapp
sudo -u app npm ci --omit=dev
sudo -u app PORT=3000 node server.js

La aplicación debe escuchar en `127.0.0.1:3000` - no en la interfaz pública. Nginx se enfrentará a internet.

4. systemd la mantiene viva

cat > /etc/systemd/system/myapp.service <<'EOF'
[Unit]
Description=My Node.js app
After=network-online.target
[Service]
User=app
WorkingDirectory=/opt/myapp
Environment=NODE_ENV=production
Environment=PORT=3000
ExecStart=/usr/bin/node server.js
Restart=always
RestartSec=3
[Install]
WantedBy=multi-user.target
EOF
systemctl daemon-reload
systemctl enable --now myapp
systemctl status myapp

¿Fallo? Se reinicia en tres segundos. ¿Reinicio? Arranca automáticamente. ¿Despliega una versión nueva? `rsync` y después `systemctl restart myapp`.

5. Nginx delante

apt install -y nginx
cat > /etc/nginx/sites-available/myapp <<'EOF'
server {
    listen 80;
    server_name example.com;
    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
EOF
ln -s /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/myapp
nginx -t && systemctl reload nginx

Luego apunte el registro A de su dominio al servidor y añada HTTPS - la guía completa está en la guía de Nginx y HTTPS.

6. Compruebe los registros

journalctl -u myapp -f --no-pager
tail -f /var/log/nginx/error.log

La salida de consola de su aplicación llega a journald automáticamente - sin archivos de registro que configurar.

Respuestas rápidas

¿Necesito PM2?

No realmente. systemd hace todo lo que PM2 hace para un solo servidor - reinicio automático, arranque en el inicio, registros - sin una dependencia extra. PM2 tiene sentido sobre todo si ejecuta varios procesos de Node con clúster.

¿Cuánta RAM necesita una aplicación de Node?

Una aplicación Express típica consume en reposo unos 80–150 MB. Un servidor de 2 GB la ejecuta cómodamente junto a Nginx y PostgreSQL; los pasos de compilación como webpack son la parte que más memoria consume, así que compile en CI o en su portátil.

¿Cómo despliego una versión nueva sin tiempo de inactividad?

Haga rsync del código nuevo y reinicie - la interrupción es inferior a un segundo, porque systemd reinicia el proceso al instante. Para un tiempo de inactividad cero ejecutaría dos puertos y cambiaría el upstream de Nginx, pero la mayoría de proyectos nunca lo necesitan.

Este stack cabe cómodamente en Core VPS 4 a €12/mes.

Relacionado

Ver planesGuíasFAQ