01
Wie läuft Node.js in cPanel?
Eine PHP-Website führt ihre Dateien bei jeder Anfrage von Neuem aus. Eine Node.js-Anwendung ist dagegen ein Prozess, der einmal gestartet wird und eingehende Anfragen mit dem Code im Arbeitsspeicher beantwortet. Deshalb genügt es nicht, die Dateien hochzuladen; Sie müssen festlegen, mit welcher Node.js-Version und aus welcher Datei der Prozess startet. Das legen Sie im Anwendungsmanager fest, und der Webserver leitet die Anfragen an Ihre Domain an Ihre Anwendung weiter.
Auf dem Server laufen der LiteSpeed-Webserver und die Sicherheitsschicht Imunify360, gespeichert wird auf NVMe; mit dem kostenlosen SSL ist Ihre Anwendung über https erreichbar. Jedes Konto läuft mit CloudLinux in seinem eigenen Ressourcenbereich: Nutzbarer RAM und Prozessorleistung sind die Werte in der Zeile Ihres Pakets in der Tabelle. Befehle führen Sie unter cPanel → „Terminal“ im Browser aus; diese Sitzung ist mit CageFS isoliert, Root-Zugriff gibt es nicht. Für eine direkte SSH-Verbindung von Ihrem eigenen Computer fragen Sie das Support-Team.
02
Express-Anwendung veröffentlichen: Schritt für Schritt
Die folgende Reihenfolge ist für eine Express-API aus einer einzigen Datei geschrieben; mit Fastify, Koa oder einem anderen Node.js-Framework gehen Sie genauso vor.
- Code vorbereiten: Lesen Sie den Port, auf dem die Anwendung lauscht, aus einer Umgebungsvariable, statt ihn fest in den Code zu schreiben (
app.listen(process.env.PORT || 3000)); jedes Paket, das Sie verwenden, muss in package.json eingetragen sein. - Dateien hochladen: Holen Sie das Projekt unter cPanel → „Terminal“ mit Git aus Ihrem Repository oder laden Sie es als Archiv in den Dateimanager von cPanel hoch und entpacken es. Laden Sie den Ordner
node_modules nicht hoch. - Anwendung anlegen: Wählen Sie im Bereich „Setup Node.js App“ die Node.js-Version, den Anwendungsordner, die Veröffentlichungsadresse und die Startdatei (etwa
app.js oder server.js). - Abhängigkeiten installieren: Klicken Sie auf die Schaltfläche „Run NPM Install“ oder wechseln Sie unter cPanel → „Terminal“ in den Anwendungsordner und führen Sie
npm install --production aus. - Einstellungen hinterlegen: Schreiben Sie
NODE_ENV=production, Datenbankdaten und API-Schlüssel nicht in den Code, sondern in Umgebungsvariablen. - Neu starten und testen: Starten Sie die Anwendung neu und öffnen Sie die Adresse im Browser; rufen Sie einen Endpunkt Ihrer API mit
curl auf und prüfen Sie die Antwort.
03
Startdatei, Umgebungsvariablen und Neustart
Die Startdatei ist die Datei, mit der der Prozess gestartet wird. Bei Projekten mit Build-Schritt wie TypeScript ist diese Datei nicht der Quellcode, sondern die kompilierte Ausgabe (z. B. dist/index.js); kompilieren Sie zuerst mit npm run build und geben Sie die Ausgabe als Startdatei an. Der Compiler (z. B. typescript) ist in den meisten Projekten eine Entwicklungsabhängigkeit; oft ist es einfacher, auf Ihrem eigenen Computer zu kompilieren und die Ausgabe hochzuladen.
Mit Umgebungsvariablen läuft derselbe Code auf Ihrem Computer und auf dem Server mit unterschiedlichen Einstellungen. Express cacht Templates und zeigt Besuchern keine Fehlerdetails an, wenn NODE_ENV den Wert production hat. Legen Sie Passwörter nicht im Git-Repository ab; verwenden Sie eine .env-Datei, die nicht ins Repository gelangt, oder Umgebungsvariablen.
Der Code wird beim Start des Prozesses in den Arbeitsspeicher geladen. Geänderter Code, ein neu installiertes Paket oder eine geänderte Einstellung werden erst nach einem Neustart der Anwendung wirksam; wenn Ihre Änderung nicht sichtbar ist, sollten Sie hier zuerst nachsehen.
04
npm install --production und Module, die kompiliert werden müssen
Das Flag --production installiert nur die Pakete, die zur Laufzeit der Anwendung benötigt werden; Test- und Entwicklungswerkzeuge landen nicht auf dem Server. In neueren npm-Versionen erledigt das Flag --omit=dev dieselbe Aufgabe.
Einige Pakete kompilieren bei der Installation C/C++-Code (node-gyp); bcrypt, sqlite3 und canvas sind Beispiele dafür. Die meisten dieser Pakete laden für verbreitete Systeme vorkompilierte Dateien herunter; wird keine passende Datei gefunden, kann die Installation im Kompilierschritt fehlschlagen. Probieren Sie in diesem Fall die reine JavaScript-Alternative des Pakets aus (etwa statt bcrypt das Paket bcryptjs) oder wenden Sie sich an das Support-Team.
Übertragen Sie keinen unter Windows entstandenen Ordner node_modules auf den Server: Kompilierte Dateien sind betriebssystemspezifisch, und die Hosting-Pakete basieren auf Linux. Installieren Sie die Abhängigkeiten immer auf dem Server.
05
Next.js-Hosting und statische Websites
Eine Next.js-Website mit serverseitigem Rendering (SSR) oder API-Routen braucht einen Node.js-Prozess: Dynamische Seiten werden bei eingehenden Anfragen in diesem Prozess erzeugt, der Prozess belegt dauerhaft Arbeitsspeicher und verbraucht bei jeder dynamischen Anfrage Rechenleistung. Die in der Datei next.config gesetzte Einstellung output: 'standalone' erzeugt einen Ordner, der nur die benötigten Pakete enthält und statt next start eine kleine ausführbare server.js mitbringt; die Ordner public und .next/static werden nicht automatisch in diese Ausgabe kopiert, sondern von Hand hinzugefügt. Wenn Sie nicht sicher sind, wie Sie diese Struktur mit dem Anwendungsmanager verbinden, fragen Sie das Support-Team.
next build benötigt deutlich mehr Arbeitsspeicher als die laufende Website und kann an das RAM-Limit des Kontos stoßen. Bequemer ist es, außerhalb des Servers zu bauen, vorzugsweise in einer Linux-Umgebung, etwa in einer CI-Pipeline (Continuous Integration), und die Ausgabe hochzuladen. Da der Bedarf einer SSR-Website von Seitenzahl und Traffic abhängt, können wir keine genaue Zahl nennen; wenn Sie viel Traffic erwarten, bieten HAN-DEV-3 oder HAN-DEV-4 mit mehr RAM komfortableren Spielraum.
Websites ohne Servercode (React mit Vite, Vue, Astro oder die Ausgabe output: 'export' von Next.js) bestehen nach dem Build nur noch aus Dateien. Sie laden den Inhalt des Ordners dist oder out in den Ordner public_html Ihrer Hauptdomain hoch; LiteSpeed liefert die Dateien direkt aus, ein Node.js-Prozess ist nicht nötig. Für eine solche Website reichen die Webhosting-Pakete aus.
06
Welche Projekte passen, und welche brauchen einen VDS?
Die Faustregel ist einfach: Beantwortet Ihre Anwendung eine Webanfrage und ist dann fertig, passt Hosting; muss sie unabhängig von Anfragen dauerhaft laufen, brauchen Sie einen VDS.
- Geeignet: mit Express und Fastify geschriebene REST- oder GraphQL-APIs, Backends für mobile Apps, Dienste, die Webhooks (Ereignisbenachrichtigungen) empfangen.
- Geeignet: kleine Webanwendungen und Verwaltungsoberflächen; Next.js-Websites mit SSR, sofern Sie den Ressourcenbedarf einplanen.
- Nicht geeignet: Discord-Bots, denn ein Bot hält eine dauerhaft offene Verbindung zu Discord. Nutzen Sie einen Discord-Bot-Server oder einen VDS.
- Nicht geeignet: Live-Chat-, Spiel- und Benachrichtigungsdienste, die auf dauerhaft offenen WebSocket-Verbindungen beruhen; lange Hintergrundaufgaben wie Queue-Worker, Videoverarbeitung und Web-Scraping.
- Nicht geeignet: Projekte, die mit Docker laufen; für Docker und Root-Zugriff ist ein VDS-Server erforderlich. Wenn Sie ein Node.js-basiertes Tool wie n8n auf einem Server mit vorinstallierter Software möchten, sehen Sie sich die Seite n8n-Server an.
07
Paketwahl: RAM, CPU-Limit und Datenbank
Das CPU-Limit in der Tabelle ist eine CloudLinux-Einheit: 200 % entsprechen der Rechenleistung von zwei Prozessorkernen, 800 % der von acht Kernen. Das RAM-Limit gilt gemeinsam für alle Prozesse im Konto; Ihre laufende Anwendung, die npm-Installation und gegebenenfalls Ihre PHP-Website nutzen denselben Pool. Für eine einzelne API ist HAN-DEV-1 ein ausreichender Einstieg; wenn Sie mehrere Anwendungen oder Domains veröffentlichen, achten Sie auf den RAM und die Spalte Addon-Domains.
Die Pakete enthalten MySQL und phpMyAdmin; aus Node.js verbinden Sie sich mit einem Treiber wie mysql2 oder einem ORM wie Sequelize. Im selben Konto stehen außerdem PHP (bis 8.5), Python (3.11–3.13), Composer 2 und Git zur Verfügung. Wenn Sie eine andere Datenbank-Engine benötigen, fragen Sie vor der Bestellung das Support-Team.
08
Backup, Zahlung und Umzug
Hosting-Konten werden jede Nacht automatisch gesichert, und die Backups der letzten 3 Tage werden aufbewahrt. Das ist ein Komfortangebot, bewahren Sie daher auch eine eigene Kopie auf: Ihr Code gehört in Ihr Git-Repository, Ihr Datenbank-Dump auf Ihren eigenen Computer.
Sie können per Karte (iyzico), Banküberweisung oder mit dem Kontoguthaben bezahlen; sobald die Zahlung bestätigt ist, wird Ihr Konto automatisch eingerichtet. Eine Rückerstattung erfolgt nicht; ein überfälliges Konto wird gesperrt und, wenn es nicht innerhalb von 2 Tagen bezahlt wird, gekündigt und samt seinen Daten gelöscht (Rückerstattungs- und Kündigungsrichtlinie). Für Ihr Hosting-Konto bei einem anderen Anbieter können Sie über das Formular für den kostenlosen Hosting-Umzug eine Anfrage stellen.