Wie man eine Node.js-Anwendung auf einem cPanel-Hosting verwendet

Procédure

Was ist Node.js?

Node.js ist eine plattformübergreifende Open-Source-Laufzeitumgebung, mit der Sie eine Website oder eine Anwendung erstellen und auf einem Server hosten können, wobei die Sprache JavaScript verwendet wird. Bei unseren cPanel- und CloudCP-Paketen stellen wir Ihnen den Node.js-Anwendungsmanager zur Verfügung, mit dem Sie eine Node.js-Anwendung auf Ihrem cPanel-Webhosting-Paket einrichten können. Sie haben Node.js von Version 6.x bis einschließlich Version 20.x zur Verfügung.

Was ist der Phusion Passenger?

Um unseren Kunden eine stabile und robuste Umgebung für Node.js zur Verfügung zu stellen, integrieren wir Ihre Node.js-Anwendungen mithilfe des Phusion Passenger in den Apache-Webservice.

Wir richten keinen Reverse Proxy ein, und Node.js-Anwendungen können nicht standalone mit einem eigenen Webserver ausgeführt werden. Wenn Sie es gewohnt sind, Ihren Node.js-Server mit einem Befehl wie npm run start oder pm2 start myapp auszuführen, werden Sie dies auf unseren cPanel-Hosting-Paketen nicht tun können. Wenn Sie ein Framework verwenden, erkundigen Sie sich, ob es mit Phusion Passenger kompatibel ist.

Wie installiere ich eine Node.js-Anwendung?

Melden Sie sich bei Ihrer cPanel-Verwaltungsschnittstelle an und klicken Sie auf das Symbol"Setup Node.js App".

Auf der darauf folgenden Seite klicken Sie auf die Schaltfläche"Create Application" , um eine neue Anwendung hinzuzufügen.

Füllen Sie dann die Felder entsprechend den Anforderungen Ihrer Anwendung aus:

• Node.js version: Die Version von Node.js, die Ihre Anwendung benötigt.
• Application mode: Hiermit legen Sie fest, wie Ihre Anwendung ausgeführt werden soll, entweder im Entwickler- oder im Produktionsmodus. Dies manipuliert die Umgebungsvariable NODE_ENV und ermöglicht so im Entwicklermodus die Anzeige von Fehlern (was zu Debugging-Zwecken nützlich ist, bei einer Anwendung in der Produktion aber auch problematisch sein kann).
• Application root: Der Speicherort Ihrer Node.js-Anwendung, bezogen auf Ihr FTP-Root. Wir empfehlen Ihnen, Ihre Node.js-Anwendung nicht im Ordner public_html abzulegen.
• Application URL: Die Stamm-URL Ihrer Node.js-Anwendung.
• Application startup file: Der Name der .js-Datei, die Passenger an Node.js übermittelt, um Ihre Anwendung zu starten.

Klicken Sie dann auf die Schaltfläche"Create", nachdem Ihre Anwendung eingerichtet wurde.

Wenn Ihre Startup-Datei noch nicht existiert, wird das Tool sofort diese Datei mit einem Beispielinhalt erstellen. Dieses Beispiel zeigt " It works! " bei allen HTTP-Anfragen an, die mit diesem Beispiel verbunden sind.

Hier ist der Inhalt des Beispielskripts :

var http = require("http"); var server = http.createServer(function(req, res) { res.writeHead(200, {'Content-Type': 'text/plain'}); var message = 'It works!\n', version = 'NodeJS ' + process.versions.node + '\n', response = [message, version].join('\n'); res.end(response); }); server.listen();

Sie können auch die Datei package.json von der Schnittstelle aus bearbeiten, um Abhängigkeiten hinzuzufügen und diese Abhängigkeiten mit der Schaltfläche " Run NPM Install " zu installieren:

Beachten Sie, dass Sie Ihre Anwendung neu starten müssen, wenn die Abhängigkeiten geändert wurden.

Sie können im Abschnitt Umgebungsvariablen auch Umgebungsvariablen festlegen, wenn Ihre Anwendung auf diese angewiesen ist, um bestimmte Einstellungen zu erhalten.

Über das Terminal auf Ihre Anwendung zugreifen

Die Verwendung des Terminals in der Kommandozeile ist ein integraler Bestandteil des Node.js-Ökosystems. Um vom Terminal aus auf die Umgebung Ihrer Anwendung zuzugreifen, stellen Sie eine Verbindung zum Terminal her (über das Webterminal cPanel oder einen SSH-Client) und kopieren Sie den angegebenen Befehl, um in die Umgebung Ihrer Anwendung zu gelangen :

Dadurch wird automatisch die richtige virtuelle Umgebung für Ihre Anwendung aktiviert, die die richtige Version von Node.js und NPM sowie die in der Umgebung installierten Abhängigkeiten enthält (anstatt im Ordner " node_modules " in Ihrem Anwendungsordner installiert zu sein).

Eine Node.js-Anwendung debuggen

Um eine Node.js-Anwendung zu debuggen, können Sie das Apache-Fehlerprotokoll kons ultieren. Die Apache-Fehlerprotokolldatei enthält :

• Die STDOUT- und STDERR-Ausgabe der Node.js-Anwendung.
• Die mit Passenger verbundenen Fehler.
• Die mit Apache verbundenen Fehler.

Wenn Sie den Wert PassengerLogFile in der .htaccess-Datei Ihrer Website manuell eingestellt haben, werden die STDOUT- und STDERR-Ausgabe sowie die mit Passenger verbundenen Fehler in diese Datei statt in die Apache-Logdatei gesendet.

Sie können auch den Wert PassengerFriendlyErrorPages in Ihrer .htaccess-Datei auf on setzen, um Fehler im Zusammenhang mit dem Start Ihrer Node.js-Anwendung direkt im Webbrowser anzuzeigen.

Häufige Fehler in Node.js

Error: /lib64/libstdc+++.so.6: Version 'CXXABI_X.X.X' not found.

Mögliche Gründe: Ihre Node.js-Anwendung (oder eine ihrer Abhängigkeiten) erfordert eine bestimmte Funktion in der C++-Bibliothek, die derzeit auf dem betreffenden Server nicht vorhanden ist. Dies kann auf unseren cPanel-Formeln mit dem Betriebssystem CloudLinux 7 (ein auf CentOS / RHEL 7 basierendes Betriebssystem) vorkommen, während eine Ihrer Abhängigkeiten RHEL 8 / CentOS 8 oder höher erfordert.

Lösung: Sie können eine Anfrage an den Support stellen, um eine Migration auf einen Server mit dem Betriebssystem CloudLinux 8 zu beantragen.

Prozess wird bei der Ausführung von npm install angehalten.

Mögliche Gründe: Ihr Prozess kann vom Server gestoppt werden, wenn er über die für Ihr Hostingpaket zulässige Ausführungszeit und/oder Ressourcenmenge (CPU, RAM ...) hinaus ausgeführt wird. Sie können den Verlauf von Prozessabbrüchen über unser Tool " Protokolle " einsehen, das über Ihre cPanel-Schnittstelle verfügbar ist.

Lösung: Sie können den von npm verwendeten RAM-Speicher mit der Umgebungsvariablen NODE_OPTIONS wie folgt begrenzen:

NODE_OPTIONS='--max-old-space-size=2048' npm install.

Dieses Beispiel zeigt beispielsweise eine Beschränkung auf 2048 Mio (2 Gio).

Angegebenes Verzeichnis, das bereits von /home/$USER/public_html/monapp bei der Erstellung aus Setup Node.js App verwendet wurde.

Mögliche Gründe:

• Eine Node.js-, Python- oder Ruby-Anwendung, die im angegebenen Ordner veröffentlicht wurde, existiert bereits.
• DieRoot-Anwendung und die angegebeneURL-Anwendung zeigen auf denselben Ordner.

Lösungen:

• Stellen Sie sicher, dass keine Node.js-, Python- oder Ruby-Anwendung auf dem angegebenen Ordner veröffentlicht ist. Sie können die .htaccess-Datei des betreffenden Ordners über den Dateimanager oder Ihren üblichen FTP-Client überprüfen, um dies schnell zu identifizieren.
• Stellen Sie sicher, dass die Dateien Ihrer Anwendung (die .js-Dateien, package.json ...), die von application root angegeben werden, sich nicht in dem von application URL angegebenen Veröffentlichungsordner befinden. Im Gegensatz zu PHP-Anwendungen müssen und sollten sich die Dateien einer Node.js-Anwendung nicht in public_html befinden.