Zum Hauptinhalt springen

Node.js auf einem Windows Server einrichten – Moderne JavaScript-Anwendungen starten

Die passenden Produkte für diese Anleitung

Lege direkt los — bestelle das passende Produkt und folge dieser Anleitung Schritt für Schritt.

Einführung

Node.js ist eine plattformübergreifende, Open-Source JavaScript-Laufzeitumgebung, die JavaScript-Code außerhalb des Browsers ausführt, zum Beispiel auf Servern oder in Kommandozeilen-Tools. Basierend auf der V8-Engine unterstützt es asynchrones, ereignisgesteuertes I/O, was es extrem effizient macht für den Bau skalierbarer Netzwerk- und Echtzeit-Anwendungen.

Das „JavaScript überall“-Paradigma ermöglicht es Entwicklern, eine einzige Sprache sowohl im Backend als auch im Frontend zu nutzen.

Vorbereitung

Bevor du Node.js einrichtest, solltest du dein System vorbereiten. Dazu gehört, dein Betriebssystem auf die neueste Version zu aktualisieren und alle nötigen Abhängigkeiten zu installieren. Diese Vorbereitung sorgt für eine stabile Umgebung und hilft, Probleme während oder nach der Installation zu vermeiden.

System aktualisieren

Damit dein System mit den aktuellsten Software- und Sicherheitsupdates läuft, solltest du zuerst immer ein System-Update durchführen. Dafür führst du folgenden Befehl aus:

sudo apt update && sudo apt upgrade -y

So stellst du sicher, dass dein System vor dem nächsten Schritt alle aktuellen Sicherheitspatches und Softwareversionen hat.

Abhängigkeiten installieren

Nachdem das Update abgeschlossen ist, kannst du mit der Installation der Abhängigkeiten weitermachen. Node.js wird auf deinem System über verschiedene Docker-Container bereitgestellt und ausgeführt. Dafür muss Docker zuerst installiert sein. Führe dazu folgenden Befehl aus:

curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

Eine ausführliche Schritt-für-Schritt-Anleitung zur Installation und Nutzung von Docker findest du in unserer Docker Anleitung.

Installation

Jetzt, wo alle Voraussetzungen erfüllt und Vorbereitungen abgeschlossen sind, kannst du mit der Installation der Node.js-Anwendung starten.

Um Node.js in einer isolierten Umgebung zu nutzen, musst du zuerst das offizielle Alpine-basierte Image herunterladen. Mit folgendem Befehl holst du dir das neueste Node.js 22 Image auf dein System, damit es für Container-Deployments bereitsteht:

docker pull node:22-alpine

Anschließend kannst du einen Container basierend auf diesem Image starten und eine Shell-Session darin öffnen. So startest du den Container mit einer interaktiven Shell. Die Option --rm sorgt dafür, dass der Container automatisch gelöscht wird, sobald du ihn verlässt – so bleibt dein Host sauber.

docker run -it --rm --entrypoint sh node:22-alpine

Im Container kannst du die installierte Node.js-Version mit node -v prüfen, die v22.19.0 anzeigen sollte. Die npm-Version checkst du mit npm -v, hier wird 10.9.3 erwartet. Damit ist bestätigt, dass das Image die korrekten Versionen von Node.js und npm enthält und sofort einsatzbereit ist.

Konfiguration

Nachdem du den Node.js-Container gestartet hast, empfiehlt es sich, wichtige Node.js-Einstellungen direkt in der Umgebung zu konfigurieren. Ein gängiger Weg ist das Definieren von Umgebungsvariablen, zum Beispiel:

export NODE_ENV=production

Das aktiviert den Produktionsmodus, der Performance-Optimierungen einschaltet und das Logging anpasst. Für Entwicklungszwecke kannst du stattdessen NODE_ENV=development setzen, um ausführlichere Fehlermeldungen und Debugging-Features zu erhalten.

Ein gut strukturiertes Projektverzeichnis ist wichtig, beginnend mit einer Konfigurationsdatei, die du mit folgendem Befehl erstellst:

npm init -y

Das erzeugt eine package.json Datei, die Abhängigkeiten, Skripte und Metadaten für dein Projekt definiert. Sie ist die zentrale Konfigurationsdatei jeder Node.js-Anwendung.

Abhängigkeiten installierst du mit npm install <package>, während Entwicklungsabhängigkeiten mit npm install <package> --save-dev hinzugefügt werden. Der scripts-Abschnitt in der package.json erlaubt dir, eigene Befehle wie npm start oder npm run build zu definieren, um die Ausführung und das Projektmanagement zu vereinfachen.

Für fortgeschrittene Setups kannst du Node.js mit .npmrc oder .nvmrc Dateien anpassen, um private Registries, Cache-Optionen oder eine bestimmte Node.js-Version zu konfigurieren. So läuft deine Anwendung konsistent in verschiedenen Umgebungen.

Fazit und weitere Ressourcen

Glückwunsch! Du hast Node.js jetzt erfolgreich auf deinem VPS/Dedicated Server installiert und konfiguriert. Wir empfehlen dir außerdem, einen Blick auf folgende Ressourcen zu werfen, die dir bei der Server-Konfiguration weiterhelfen können:

Du hast spezielle Fragen, die hier nicht beantwortet wurden? Für weitere Fragen oder Support steht dir unser Team täglich zur Verfügung – zögere nicht, uns zu kontaktieren! 🙂