Node.js und npm für Website-Builds verwenden

Node.js und npm werden bei vielen Websites nur benötigt, um CSS-, JavaScript- oder Theme-Dateien zu erzeugen. Das bedeutet nicht automatisch, dass auf dem Webspace dauerhaft ein öffentlicher Node.js-Server laufen muss.

Voraussetzungen

Node.js muss im Tarif oder auf dem selbst verwalteten Server verfügbar sein. Prüfen Sie die vom Projekt verlangte Hauptversion und verwenden Sie ausschließlich vertrauenswürdige Paketquellen.

node --version
npm --version

Reproduzierbarer Build

Wenn eine geprüfte package-lock.json vorhanden ist, eignet sich für einen sauberen Build:

npm ci
npm run build

npm ci erwartet eine zur package.json passende Lock-Datei und verändert diese nicht. Der genaue Build-Befehl steht in den Skripten der Anwendung.

Sicherer Ablauf

1. Prüfen Sie Repository und Lock-Datei.
2. Führen Sie Builds bevorzugt in Entwicklung oder CI aus.
3. Veröffentlichen Sie nur die benötigten Build-Artefakte.
4. Prüfen Sie npm audit, bewerten Sie Funde aber anhand der tatsächlich produktiv verwendeten Pakete.
5. Speichern Sie keine Registry-Tokens oder API-Schlüssel im Repository.
6. Starten Sie keinen Entwicklungsserver öffentlich im Produktivbetrieb.

Typische Fehler

Falsche Node.js-Version

Verwenden Sie die im Projekt dokumentierte Version. Eine neue Hauptversion kann Build-Werkzeuge brechen.

Build funktioniert lokal, aber nicht auf dem Server

Vergleichen Sie Node-Version, Betriebssystem, Lock-Datei, Umgebungsvariablen und verfügbaren Speicher.

node_modules wird hochgeladen

Plattformabhängige Module können unpassend sein. Besser ist ein reproduzierbarer Build in einer passenden Umgebung.

Verwandte Artikel

• Abhängigkeiten, Updates und Supply-Chain-Risiken
• Website-Deployment mit Wartungsmodus und Rollback
• Umgebungsvariablen, .env und Zugangsdaten schützen