cPanel enthält ein Setup Node.js App-Tool, mit dem Sie Node.js-Anwendungen auf Ihrem Hosting-Konto ausführen können, ohne einen VPS oder Root-Zugriff zu benötigen. Es verwaltet Node.js-Versionen, installiert npm-Pakete und steuert den Lebenszyklus des Anwendungsprozesses.

„Setup Node.js App" öffnen

1. Melden Sie sich unter https://tpc-hosting.com/login[[T13]] an und öffnen Sie cPanel.
2. Klicken Sie unter Software auf Setup Node.js App.
3. Klicken Sie auf Create Application.

Anwendung konfigurieren

1. Node.js-Version: Wählen Sie die Version aus, die Ihre Anwendung benötigt. Die verfügbaren Versionen sind im Dropdown-Menü aufgeführt.
2. Anwendungsmodus: Wählen Sie Production für Live-Anwendungen oder Development für Testzwecke.
3. Anwendungsverzeichnis: Das Verzeichnis, in dem sich die Dateien Ihrer Node.js-Anwendung befinden (z. B. myapp — relativ zu Ihrem Home-Verzeichnis). Erstellen Sie diesen Ordner zunächst über den Dateimanager, falls er noch nicht vorhanden ist.
4. Anwendungs-URL: Wählen Sie die Domain und den optionalen Pfad aus, über den Ihre Anwendung erreichbar sein soll (z. B. yourdomain.com oder yourdomain.com/app).
5. Startdatei der Anwendung: Der Haupt-Einstiegspunkt Ihrer Anwendung (z. B. app.js oder server.js).
6. Klicken Sie auf Create.

Anwendungsdateien hochladen

1. Laden Sie die Dateien Ihrer Node.js-Anwendung über den Dateimanager oder FTP in das Anwendungsverzeichnis hoch.
2. Stellen Sie sicher, dass sich Ihre package.json im Anwendungsverzeichnis befindet.

npm-Abhängigkeiten installieren

1. Suchen Sie in der Node.js-App-Liste Ihre Anwendung und klicken Sie im Terminal-Bereich auf Open application root, oder klicken Sie auf die Schaltfläche „npm install" in den Anwendungseinstellungen.
2. Alternativ können Sie sich per SSH in Ihr Konto einloggen (siehe: So verbinden Sie sich per SSH mit Ihrem Hosting-Konto) und Folgendes ausführen:

   cd ~/myapp
   npm install

Anwendung starten, stoppen und neu starten

• In der Node.js-App-Liste verfügt jede Anwendung über die Schaltflächen Start, Stop und Restart.
• Klicken Sie auf Restart, nachdem Sie Ihre Anwendungsdateien oder Umgebungsvariablen aktualisiert haben, um die Änderungen zu übernehmen.

Umgebungsvariablen

1. Scrollen Sie in den Anwendungseinstellungen zu Environment Variables.
2. Fügen Sie Schlüssel-Wert-Paare für die Konfiguration Ihrer Anwendung hinzu (Datenbank-URL, API-Schlüssel, Port usw.).
3. Klicken Sie auf Save und starten Sie die Anwendung neu.

Fehlerbehebung

• Anwendung lädt nicht: Überprüfen Sie, ob der Name der Startdatei genau mit dem von Ihnen eingegebenen übereinstimmt. Vergewissern Sie sich, dass keine npm-Abhängigkeitsfehler vorliegen, indem Sie die Protokolle über SSH prüfen (cat ~/myapp/logs/error.log oder ähnlich).
• Port-Konflikte: Geben Sie in Ihrem Anwendungscode keinen Port an — cPanel übernimmt das Routing automatisch über Passenger. Entfernen Sie alle app.listen(PORT)-Aufrufe, die einen Port fest kodieren, oder verwenden Sie die von Passenger bereitgestellte Umgebungsvariable PORT.