Deploy de app Node.js num VPS - systemd + Nginx, sem Docker

Passo a passo: Node.js 22 via NodeSource, usuário dedicado para a app, reinício automático com systemd, reverse proxy Nginx e HTTPS. Comandos reais, deploy em 15 minutos.

Sem Docker, sem PaaS, sem magia. Node.js com systemd e Nginx é uma stack que sobrevive a reinícios, falhas e tráfego - e que pode ler por inteiro.

1. Instale o 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. Crie um utilizador para a aplicação

Nunca execute uma aplicação web como root. Um utilizador separado limita os danos se a aplicação alguma vez for comprometida.

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

3. Envie a aplicação

Do seu portátil, com rsync sobre SSH - sem necessidade de servidor Git:

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

No servidor, instale as dependências e teste uma vez em primeiro plano:

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

A aplicação deve escutar em `127.0.0.1:3000` - não na interface pública. O Nginx dará a cara à internet.

4. O systemd mantém-na 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

Falhou? Reinicia em três segundos. Reinício do servidor? Arranca automaticamente. Nova versão para publicar? `rsync` e depois `systemctl restart myapp`.

5. Nginx à frente

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

Depois aponte o registo A do seu domínio para o servidor e adicione HTTPS - o passo a passo completo está no guia de Nginx e HTTPS.

6. Verifique os registos

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

A saída da consola da sua aplicação vai automaticamente para o journald - sem ficheiros de registo para configurar.

Respostas rápidas

Preciso do PM2?

Na verdade, não. O systemd faz tudo o que o PM2 faz num único servidor - reinício automático, arranque com o sistema, registos - sem uma dependência extra. O PM2 faz sentido sobretudo se executar vários processos Node em cluster.

De quanta RAM precisa uma aplicação Node?

Uma aplicação Express típica usa cerca de 80–150 MB em repouso. Um servidor de 2 GB executa-a à vontade ao lado do Nginx e do PostgreSQL; as etapas de build como o webpack consomem muita memória, por isso faça o build no CI ou no seu portátil.

Como publico uma nova versão sem tempo de inatividade?

Faça rsync do código novo e reinicie - a interrupção é inferior a um segundo, porque o systemd reinicia o processo de imediato. Para zero interrupção, usaria duas portas e trocaria o upstream do Nginx, mas a maioria dos projetos nunca precisa disso.

Esta stack cabe à vontade num Core VPS 4 de 12 €/mês.

Relacionados

Ver planosGuiasFAQ