Node.js-App auf einem VPS deployen - systemd + Nginx, ohne…

Schritt für Schritt: Node.js 22 von NodeSource, eigener App-User, automatischer Neustart per systemd, Nginx-Reverse-Proxy und HTTPS. Echte Befehle, Deploy in 15 Minuten.

Kein Docker, kein PaaS, keine Magie. Node.js plus systemd und Nginx ist ein Stack, der Neustarts, Abstürze und Traffic übersteht - und Sie können alles lesen.

1. Node.js installieren

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

2. App-Benutzer anlegen

Führen Sie eine Web-App niemals als root aus. Ein eigener Benutzer begrenzt den Schaden, falls die App je kompromittiert wird.

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

3. App hochladen

Von Ihrem Laptop aus, mit rsync über SSH - kein Git-Server nötig:

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

Auf dem Server Abhängigkeiten installieren und einmal im Vordergrund testen:

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

Die App muss auf `127.0.0.1:3000` lauschen - nicht auf der öffentlichen Schnittstelle. Nginx wird nach außen zeigen.

4. systemd hält sie am Leben

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

Absturz? Startet in drei Sekunden neu. Neustart? Startet automatisch. Neue Version deployen? `rsync`, dann `systemctl restart myapp`.

5. Nginx davor

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

Richten Sie dann die A-Record Ihres Domains auf den Server und ergänzen Sie HTTPS - der vollständige Durchlauf steht im Nginx- und-HTTPS-Leitfaden.

6. Logs prüfen

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

Die Konsolenausgabe Ihrer App landet automatisch in journald - keine Logdateien zu konfigurieren.

Kurzantworten

Brauche ich PM2?

Eigentlich nicht. systemd erledigt alles, was PM2 für einen einzelnen Server kann - Neustart bei Absturz, Start beim Boot, Logs - ohne zusätzliche Abhängigkeit. PM2 lohnt sich vor allem, wenn Sie mehrere Node-Prozesse mit Clustering betreiben.

Wie viel RAM braucht eine Node-App?

Eine typische Express-App liegt im Leerlauf bei rund 80–150 MB. Ein 2-GB-Server betreibt sie angenehm neben Nginx und PostgreSQL; Build-Schritte wie webpack sind der speicherhungrige Teil - bauen Sie in CI oder auf Ihrem Laptop.

Wie deploye ich eine neue Version ohne Ausfallzeit?

Neuen Code per rsync übertragen, dann neu starten - die Lücke liegt unter einer Sekunde, weil systemd den Prozess sofort neu startet. Für Null-Ausfallzeit würden Sie zwei Ports betreiben und den Nginx-Upstream umschalten, aber die meisten Projekte brauchen das nie.

Dieser Stack passt bequem auf Core VPS 4 für €12/Monat.

Verwandte Themen

Tarife ansehenAnleitungenFAQ