Node.js ist eine mächtige JavaScript-basierte Laufzeitumgebung, die es Entwicklern ermöglicht, serverseitige Anwendungen mit JavaScript zu erstellen. Plesk hingegen ist ein beliebtes Webhosting-Kontrollpanel, das die Verwaltung von Webservern vereinfacht. Die Kombination aus beiden kann unglaublich leistungsstark sein, aber der Einrichtungsprozess kann manchmal etwas knifflig sein. Dieser Artikel führt Sie Schritt für Schritt durch die Einrichtung von Node.js auf Ihrem Plesk Server, damit Ihre Anwendungen reibungslos laufen. Und das Wichtigste: Wir konzentrieren uns darauf, was wirklich funktioniert!
Voraussetzungen
Bevor wir beginnen, stellen Sie sicher, dass Sie Folgendes haben:
- Einen Plesk Server mit Administratorzugriff.
- Eine Domain oder Subdomain, die Sie für Ihre Node.js-Anwendung verwenden möchten.
- Grundlegende Kenntnisse der Befehlszeile (SSH).
Schritt 1: Node.js-Unterstützung in Plesk aktivieren
Die meisten neueren Plesk-Installationen verfügen über integrierte Node.js-Unterstützung. So aktivieren Sie diese:
- Melden Sie sich in Ihrem Plesk-Panel an.
- Navigieren Sie zu „Tools & Einstellungen” (oder „Serververwaltung” je nach Ihrer Plesk Version).
- Suchen Sie nach „Updates & Upgrades” und klicken Sie darauf.
- Klicken Sie auf „Komponenten hinzufügen/entfernen”.
- Suchen Sie im Abschnitt „Webhosting-Funktionen” nach „Node.js-Unterstützung”.
- Aktivieren Sie das Kontrollkästchen neben „Node.js-Unterstützung” und klicken Sie auf „Weiter”.
- Warten Sie, bis die Installation abgeschlossen ist.
Dieser Vorgang installiert die notwendigen Node.js-Komponenten auf Ihrem Server.
Schritt 2: Node.js für Ihre Domain aktivieren
Nachdem die globale Unterstützung aktiviert wurde, müssen Sie Node.js für die Domain aktivieren, auf der Ihre Anwendung laufen soll:
- Gehen Sie zu „Websites & Domains”.
- Wählen Sie die Domain aus, für die Sie Node.js aktivieren möchten.
- Suchen Sie nach „Node.js” (oder „Node.js-Einstellungen”, je nach Plesk-Version) und klicken Sie darauf. Falls Sie „Node.js” nicht sehen, stellen Sie sicher, dass es in Schritt 1 erfolgreich installiert wurde.
- Klicken Sie auf den Schalter „Node.js aktivieren”.
Hier können Sie auch die Node.js-Version auswählen, die Sie verwenden möchten. Stellen Sie sicher, dass Sie eine Version wählen, die mit Ihrer Anwendung kompatibel ist.
Schritt 3: Ihre Node.js-Anwendung hochladen
Nun müssen Sie Ihre Node.js-Anwendung auf den Server hochladen. Es gibt verschiedene Möglichkeiten, dies zu tun:
- Plesk Dateimanager: Dies ist die einfachste Option für kleinere Anwendungen. Sie können Ihre Dateien einfach per Drag & Drop in den Anwendungsordner hochladen (standardmäßig ist dies oft der „httpdocs”-Ordner).
- FTP: Verwenden Sie einen FTP-Client wie FileZilla, um Ihre Dateien hochzuladen. Stellen Sie sicher, dass Sie die korrekten FTP-Zugangsdaten verwenden, die Sie in Plesk finden.
- Git: Dies ist die empfohlene Methode für größere und komplexere Anwendungen. Sie können Ihr Git-Repository direkt mit Plesk verbinden und Ihre Anwendung automatisch bereitstellen.
Unabhängig von der gewählten Methode, stellen Sie sicher, dass sich Ihre Hauptanwendungsdatei (z.B. app.js oder server.js) im Stammverzeichnis Ihres Anwendungsordners befindet.
Schritt 4: Anwendungsstammverzeichnis und Startdatei konfigurieren
Zurück im Plesk Panel unter „Node.js„, müssen Sie das Anwendungsstammverzeichnis und die Startdatei konfigurieren:
- Dokumentenstamm: Dies ist das Verzeichnis, das für öffentliche Dateien wie HTML, CSS und JavaScript verwendet wird. In den meisten Fällen sollte dies auf „httpdocs” eingestellt sein.
- Anwendungsstamm: Dies ist das Verzeichnis, in dem sich Ihre Node.js-Anwendung befindet. In der Regel ist dies dasselbe wie der „httpdocs”-Ordner, es sei denn, Sie haben Ihre Anwendung in einem Unterordner platziert.
- Anwendungs-URL: Dies ist die URL, unter der Ihre Anwendung erreichbar sein wird. Standardmäßig ist dies die Hauptdomain.
- Startdatei: Dies ist der Name Ihrer Hauptanwendungsdatei (z.B. app.js oder server.js). Stellen Sie sicher, dass Sie den korrekten Dateinamen angeben.
Stellen Sie sicher, dass Sie alle diese Einstellungen korrekt konfigurieren, da sonst Ihre Anwendung möglicherweise nicht ordnungsgemäß ausgeführt wird.
Schritt 5: Abhängigkeiten installieren (npm install)
Fast jede Node.js-Anwendung verwendet externe Abhängigkeiten, die mit npm (Node Package Manager) installiert werden müssen. So installieren Sie diese:
- Klicken Sie im Plesk Panel unter „Node.js” auf die Schaltfläche „npm install”.
- Wenn Sie eine bestimmte Version eines Pakets installieren müssen, können Sie dies über die Befehlszeile (SSH) tun. Verbinden Sie sich per SSH mit Ihrem Server. Navigieren Sie zum Anwendungsordner (z.B.
cd /var/www/vhosts/ihredomain.de/httpdocs). Führen Sie dann den Befehlnpm install [paketname]@[version]aus.
Das kann eine Weile dauern, je nachdem, wie viele Abhängigkeiten Ihre Anwendung hat. Achten Sie auf Fehlermeldungen. Wenn Sie Fehler sehen, überprüfen Sie Ihre package.json-Datei und stellen Sie sicher, dass alle Abhängigkeiten korrekt angegeben sind.
Schritt 6: Node.js-Anwendung neustarten
Nachdem die Abhängigkeiten installiert wurden, müssen Sie Ihre Node.js-Anwendung neu starten. Klicken Sie im Plesk Panel unter „Node.js” auf die Schaltfläche „Anwendung neustarten”.
Schritt 7: Testen Sie Ihre Anwendung
Öffnen Sie nun Ihren Webbrowser und navigieren Sie zu Ihrer Domain. Wenn alles gut geht, sollte Ihre Node.js-Anwendung ordnungsgemäß ausgeführt werden.
Fehlerbehebung
Wenn Ihre Anwendung nicht ordnungsgemäß ausgeführt wird, gibt es ein paar Dinge, die Sie überprüfen können:
- Protokolle: Überprüfen Sie die Node.js-Protokolle im Plesk Panel. Diese können Ihnen wertvolle Informationen darüber geben, was schief gelaufen ist.
- Fehlermeldungen: Achten Sie auf Fehlermeldungen im Browser oder in der Konsole.
- Abhängigkeiten: Stellen Sie sicher, dass alle Abhängigkeiten korrekt installiert sind.
- Startdatei: Überprüfen Sie, ob die Startdatei korrekt angegeben ist.
- Node.js-Version: Stellen Sie sicher, dass Sie eine kompatible Node.js-Version verwenden.
Zusätzliche Tipps
- PM2: Für Produktionsumgebungen empfiehlt es sich, einen Prozessmanager wie PM2 zu verwenden. PM2 stellt sicher, dass Ihre Anwendung automatisch neu gestartet wird, falls sie abstürzt. PM2 kann über die Befehlszeile installiert und verwendet werden.
- Umgebungsvariablen: Verwenden Sie Umgebungsvariablen, um Konfigurationsdaten wie Datenbankverbindungszeichenfolgen zu speichern. Diese können im Plesk Panel unter „Umgebungsvariablen” konfiguriert werden.
- Git-Bereitstellung: Nutzen Sie die Git-Integration von Plesk für eine automatisierte Bereitstellung.
Fazit
Die Einrichtung von Node.js auf Plesk kann zunächst etwas einschüchternd wirken, aber mit dieser Schritt-für-Schritt-Anleitung sollte es Ihnen gelingen, Ihre Anwendungen reibungslos zum Laufen zu bringen. Denken Sie daran, die Protokolle zu überprüfen und die Fehlermeldungen sorgfältig zu lesen, wenn Probleme auftreten. Und vergessen Sie nicht, die zusätzlichen Tipps zu nutzen, um Ihre Node.js-Anwendungen in Produktionsumgebungen optimal zu verwalten.