Wie man eine Node.js-Anwendung in cPanel einrichtet

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 SiecPanel**.
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.

Aktualisiert am: 28/04/2026