Dieser Leitfaden hilft Ihnen, die Ursache eines Problems schnell zu diagnostizieren, wenn Ihre Node.js-Website, die auf der Infomaniak-Infrastruktur gehostet wird, nicht wie erwartet funktioniert.

Überprüfen Sie den Status der Anwendung

Über das Dashboard Ihrer Node.js-Website können Sie den aktuellen Status der Anwendung überprüfen:

• Aktiv: Ihre Anwendung funktioniert normal.
• Wird neu gestartet: Die Anwendung wird neu gestartet. Warten Sie einen Moment.
• Gestoppt oder Fehler: Es gibt ein Problem.

Im Falle eines Fehlers oder eines Stops:

• Klicken Sie auf "Starten" oder "Neu starten" der Anwendung.
• Überprüfen Sie sofort die Ausführungsconsole auf mögliche technische Fehler.

Ausführungsconsole lesen

Die Konsole zeigt die Fehlermeldungen an, die beim Starten Ihrer Anwendung generiert werden. Hier sind die häufigen Fehler:

• Falscher Startbefehl: Stellen Sie sicher, dass Sie die richtige Syntax verwenden (z.B. npm start, node app.js, etc.).
• Fehler im Quellcode: Es könnte sich um eine unbehandelte Ausnahme, ein fehlendes Modul oder einen falsch definierten Port handeln.

Überprüfen Sie die Anwendungseinstellungen

Im Abschnitt Erweiterte Einstellungen der Website stellen Sie sicher, dass alle Einstellungen korrekt sind:

• Ausführungsverzeichnis: Verzeichnis, in dem die Befehle build und start ausgeführt werden.
• Build-Befehl (optional): z.B. npm run build, falls Ihre App einen benötigt.
• Start-Befehl: z.B. node index.js, npm start, etc.
• Listening Port: Der Port, auf dem die Anwendung auf Anfragen wartet (z.B. 8080, 3000, etc.).
  • Der in Ihrer Anwendung konfigurierte Port muss mit dem im Manager definierten übereinstimmen.
• Node.js-Version: Stellen Sie sicher, dass sie mit Ihrem Code kompatibel ist.

Infomaniak stellt die Paketmanager NPM und Yarn zur Verfügung. Sie können denjenigen auswählen, der zu Ihrem Projekt passt, im Konfigurationsassistenten.

Immer noch blockiert?

Die Website bleibt unzugänglich?

• Ihre Anwendung ist möglicherweise im Wartungsmodus.
• Der Listening-Port der Anwendung kann falsch oder blockiert sein.
• Die Anwendung gibt keine korrekte HTTP-Antwort zurück (z.B. kein res.send() oder res.end() in Ihrem Server).

Haben Sie eine erweiterte Installationsmethode verwendet?

Wenn Sie Ihren Code über Git, ZIP, SSH oder SFTP importiert haben, stellen Sie sicher, dass:

• Der Code korrekt entpackt oder in den richtigen Ordner geklont wurde.
• Die wesentlichen Dateien (package.json, server.js, index.js, etc.) vorhanden sind.
• Die Abhängigkeiten korrekt installiert sind (node_modules vorhanden nach npm install oder yarn install).

Wenn das Problem nach all diesen Überprüfungen weiterhin besteht:

• Versuchen Sie, eine neue Website mit der einfachen Methode zu erstellen, um mit einem funktionierenden Beispiel zu testen.
• Vergleichen Sie Ihre Konfiguration mit der des bereitgestellten Beispiels.
• Nehmen Sie Kenntnis von der offiziellen Node.js-Dokumentation für spezifische Fehler.
• Bei Bedarf, kontaktieren Sie den Infomaniak-Support mit einer Kopie der in der Konsole angezeigten Protokolle.