Wie man eine Node.js-Anwendung auf einem VPS bereitstellt

Wie man eine Node.js-Anwendung auf einem VPS bereitstellt

Sie haben eine API für eine mobile Anwendung, einen Online-Buchungsdienst oder einen kleinen Online-Shop erstellt, der perfekt auf Ihrem Computer funktioniert. Allerdings sieht ihn sonst niemand, und jedes Mal, wenn Sie den Laptop ausschalten, hört die Software auf zu arbeiten. Damit andere Menschen es nutzen können, benötigt es einen Server, der rund um die Uhr läuft, eine feste IP-Adresse, eine Domain und HTTPS. Um Ihnen Zeit zu sparen, haben wir eine Schritt-für-Schritt-Anleitung vorbereitet, wie Sie eine Node.js-Anwendung auf einem VPS bereitstellen: von einem leeren Server bis zu einer funktionierenden Anwendung unter Ihrer Adresse.

Schritt-für-Schritt-Anleitung zur Erstellung einer Node.js-Anwendung auf VPS

Was Sie vor der Bereitstellung vorbereiten sollten

Zunächst müssen Sie den virtuellen Server mieten. Bei der VPS-Miete wird standardmäßig Ubuntu 24.04 installiert, für das alle Befehle in diesem Artikel geschrieben sind. Für eine kleine Anwendung reichen 2 GB RAM, wenn eine Datenbank daneben läuft – 4 GB, für schwere Websites auf Next.js – 8 GB.

Fügen Sie sofort im Domain-Management-Panel einen A-Eintrag mit der IP-Adresse des Servers hinzu, die Sie nach der Aktivierung per E-Mail erhalten. Die Aktualisierung der DNS dauert eine Weile, daher wird der Eintrag wirksam, während Sie den Server einrichten. Laden Sie den Anwendungscode zusammen mit der Datei package-lock.json auf GitHub hoch, in der die genauen Versionen der Bibliotheken aufgezeichnet sind.

Zusammen mit der IP-Adresse wird Ihnen das Passwort für den Benutzer root per E-Mail zugesendet. Verbinden Sie sich über SSH mit dem Befehl, der auf Windows 10/11, macOS und Linux gleich ist:

ssh root@IP-Adresse-des-Servers

Dann müssen Sie einen neuen Benutzer erstellen und ihm das Recht geben, sudo zu verwenden (ein Präfix, das Administratorrechte für einen Befehl aktiviert):

adduser deploy

usermod -aG sudo deploy

Danach verbinden Sie sich als ssh deploy@IP-Adresse-des-Servers und arbeiten Sie weiter unter diesem Benutzer.

Lesen Sie auch: Was ist SSH und die grundlegenden Arbeitsweisen damit

Wie man Node.js auf dem Server installiert

Auf dem VPS ist nichts von Ihrem Laptop vorhanden, daher muss Node.js neu installiert werden, und zwar in der gleichen Version, in der Sie die Anwendung entwickelt haben. Andernfalls könnte ein Teil des Codes oder der Bibliotheken nicht funktionieren. 

Überprüfen Sie zunächst die Version auf Ihrem Computer mit dem Befehl node -v. Für die Arbeit im Internet empfiehlt die offizielle Dokumentation nur LTS-Versionen. Laut Release-Zeitplan sind dies derzeit Node.js 22, 24 und 26 (LTS-Status ab dem 28. Oktober 2026). Wenn Sie 18 oder 20 haben, aktualisieren Sie zuerst Node.js auf Ihrem Computer und überprüfen Sie, ob Ihr Projekt funktioniert.

Wichtig! Verwenden Sie nicht den Befehl sudo apt install nodejs. In Ubuntu 24.04 installiert es Node.js 18, dessen Unterstützung bereits eingestellt wurde. Die benötigte Version sollten Sie besser aus dem Repository NodeSource beziehen. 

Um Version 24 zu installieren, verwenden Sie den Befehl:

curl -fsSL https://deb.nodesource.com/setup_24.x -o nodesource_setup.sh

sudo -E bash nodesource_setup.sh

sudo apt install -y nodejs

node -v

Der letzte Befehl sollte die gleiche Version anzeigen wie auf Ihrem Computer. Zusammen mit Node.js wird npm installiert, und Sicherheitsupdates kommen über sudo apt upgrade.

Wie man eine Node.js-Anwendung auf VPS startet

Zuerst kopieren Sie den Code auf den Server und installieren die Bibliotheken:

git clone https://github.com/Ihr-Konto/myapp.git

cd myapp

npm ci --omit=dev

Der Befehl npm ci installiert die Bibliotheken gemäß der Liste aus package-lock.json, und --omit=dev überspringt Entwicklungstools. Wenn die Anwendung beispielsweise mit TypeScript oder Next.js gebaut werden muss, führen Sie stattdessen npm ci und npm run build aus.

Passwörter und API-Schlüssel werden in der Datei .env gespeichert, die nicht in Git gelangt, also erstellen Sie sie auf dem Server mit dem Befehl nano .env und tragen Sie die gleichen Zeilen ein wie lokal. Speichern Sie die Datei mit der Kombination Ctrl+O und Enter, verlassen Sie sie mit Ctrl+X und schließen Sie den Zugriff für Dritte mit dem Befehl chmod 600 .env.

Überprüfen Sie dann, unter welcher Adresse Ihr Projekt läuft. Die Anwendung sollte Anfragen nur von innerhalb des Servers annehmen, während Nginx, den wir später konfigurieren werden, Besucher durchlässt. Dazu muss im Code die Adresse 127.0.0.1 angegeben sein. Für das Express-Framework sieht das so aus:

app.listen(3000, '127.0.0.1');

Wenn Sie die Anwendung mit dem normalen Befehl node server.js starten, stoppt sie zusammen mit der SSH-Verbindung oder nach dem ersten Fehler. Daher verwenden Sie den Prozessmanager PM2, der die Anwendung nach einem Absturz und einem Neustart des Servers neu startet:

sudo npm install -g pm2

pm2 start server.js --name myapp --node-args="--env-file=.env"

pm2 startup

pm2 save

Geben Sie anstelle von server.js die Hauptdatei der Anwendung an. Der Parameter --node-args übergibt das Flag --env-file, damit die Anwendung Geheimnisse (Datenbankpasswörter, Schlüssel von Zahlungssystemen) aus .env erhält. Der Befehl pm2 startup gibt einen weiteren Befehl aus, den Sie kopieren und ausführen müssen, um den Autostart zu aktivieren. Und schließlich überprüfen Sie das Ergebnis über pm2 status: neben myapp sollte online stehen.

Schritt-für-Schritt-Start einer Node.js-Anwendung auf VPS

Wie man die Anwendung für Besucher über Nginx öffnet

Damit jeder Interessierte Ihre Anwendung sehen und nutzen kann, verwenden Sie Nginx – einen Server, der Besucher an den Ports 80 und 443 empfängt und Anfragen an die Anwendung weiterleitet. Installieren Sie es und erstellen Sie eine Konfigurationsdatei:

sudo apt install -y nginx

sudo nano /etc/nginx/sites-available/myapp

Fügen Sie den folgenden Text ein, wobei Sie example.com durch Ihre Domain ersetzen:

server {

    listen 80;

    server_name example.com www.example.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;

    }

}

Die Zeile proxy_pass leitet Anfragen an die Anwendung auf Port 3000 weiter, und Upgrade sowie Connection sind für WebSocket erforderlich, auf dem Chats und Echtzeitbenachrichtigungen basieren. Aktivieren Sie die Konfiguration und überprüfen Sie sie mit dem Befehl:

sudo ln -s /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/

sudo nginx -t

sudo systemctl reload nginx

Wenn nginx -t keine Fehler meldet, öffnen Sie http://Ihre-Domain.com im Browser, wo Ihre Anwendung erscheinen sollte. Für jedes weitere Projekt auf diesem Server erstellen Sie eine separate solche Datei mit Ihrer Domain und Ihrem Port.

Wie man kostenloses HTTPS einrichtet

Das Zertifikat für HTTPS wird kostenlos von Let’s Encrypt ausgestellt. Bei herkömmlichem Hosting wird es vom Anbieter ausgestellt und verlängert, während auf VPS diese Arbeit Certbot übernimmt. Die Entwickler empfehlen, es über snap zu installieren:

sudo snap install --classic certbot

sudo ln -s /snap/bin/certbot /usr/local/bin/certbot

sudo certbot --nginx -d example.com -d www.example.com

sudo certbot renew --dry-run

Certbot wird nach einer E-Mail für Benachrichtigungen fragen und Nginx automatisch auf https:// konfigurieren. Der letzte Befehl überprüft die automatische Verlängerung: Wenn keine Fehler auftreten, wird das Zertifikat automatisch erneuert.

Wichtig! Let’s Encrypt überprüft die Domain über Port 80. Wenn Certbot einen Fehler ausgibt, überprüfen Sie, ob der A-Eintrag bereits auf die IP des Servers zeigt und ob Port 80 in der Firewall im persönlichen Bereich des VPS geöffnet ist.

Einrichtung von kostenlosem HTTPS für eine Node.js-Anwendung auf VPS

Wie man unnötige Ports schließt

HTTPS schützt die Daten auf dem Weg zum Server, während die Firewall den Server selbst schützt. Sie schließt alle Ports außer den benötigten: 22 für SSH, 80 und 443 für die Website. 

Um den Zugriff über SSH nicht zu verlieren, aktivieren Sie die in Ubuntu integrierte Firewall UFW in folgender Reihenfolge:

sudo ufw allow OpenSSH

sudo ufw allow 'Nginx Full'

sudo ufw enable

Die externe Firewall im persönlichen Bereich des VPS-UP filtert den Verkehr bereits vor dem Server und steht nicht im Konflikt mit UFW. Öffnen Sie darin dieselben drei Ports, um zwei Schutzebenen zu erhalten.

Lesen Sie auch: DDoS-Angriff: Methoden zum Schutz von Servern und Websites

Wie man eine Node.js-Anwendung nach dem Start aktualisiert

An der Anwendung arbeiten Sie weiterhin auf Ihrem Computer, während der Server selbst nichts aktualisiert. Die neue Version gelangt nur zu den Nutzern, wenn Sie sie bereitstellen:

  1. Ändern Sie den Code und überprüfen Sie ihn auf localhost.

  2. Übertragen Sie die Änderungen auf GitHub mit dem Befehl git push.

  3. Verbinden Sie sich über SSH mit dem Server und wechseln Sie in das Projektverzeichnis.

  4. Laden Sie die neue Version des Codes mit dem Befehl git pull herunter.

  5. Aktualisieren Sie die Bibliotheken mit dem Befehl npm ci --omit=dev.

  6. Starten Sie die Anwendung mit dem Befehl pm2 reload myapp neu.

Wenn die neue Version nicht startet, zeigt der Befehl pm2 logs myapp einen Fehler an. Um die funktionierende Version wiederherzustellen, verwenden Sie git revert HEAD auf Ihrem Computer: Übertragen Sie das Ergebnis auf GitHub und wiederholen Sie die Schritte 3-6. Vor Änderungen am Server selbst, wie z.B. der Aktualisierung von Node.js oder Ubuntu, erstellen Sie einen Snapshot im persönlichen Bereich, um den VPS bei Bedarf in den gespeicherten Zustand zurückzusetzen.

Zum Schluss starten Sie den Server mit dem Befehl sudo reboot neu und öffnen nach einer Minute die Website von Ihrem Telefon. Wenn die Anwendung selbst hochgefahren ist und über HTTPS geöffnet wird, ist sie bereit für echte Nutzer. Und wenn die Last die Möglichkeiten des VPS übersteigt, können Sie auf einen dedizierten Server umsteigen und die gleichen Schritte wiederholen.

Autor

Богдана Гайворонська

Журналіст (з 2003 року), IT-копірайтер (з 2013 року), контент-маркетолог Cityhost.ua. Спеціалізується на статтях про технології, створення та просування сайтів.