Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Runbook: Website nicht erreichbar

Was zu tun ist, wenn eine Exponential-Website Fehler oder gar nichts liefert - die Fehlerseite erkennen, die Engine, die Datenbank, den Wartungsmodus, vendor und Berechtigungen prüfen, das richtige Log lesen, beheben…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/hosting/runbooks/site-down.md

On this page

This page is a translation. Read the English original

Runbook: Website nicht erreichbar

Für die Bereitschaft, wenn die Exponential-Website eines Kunden keine Seiten ausliefert. Arbeiten Sie von oben nach unten; hören Sie auf, wenn die Ursache gefunden ist. Die Fehlerseiten und ihre Ursachen stammen aus 12.9 Seiten und Fehler zur Laufzeit.

Warnung .htaccess bremst jede Anfrage. Sind .htaccess-Dateien erlaubt (AllowOverride alles außer None), geschweige denn genutzt, sucht Apache sie bei jeder Anfrage in jedem Verzeichnis des Pfads und liest und wertet sie aus, und die Ladezeiten der Seiten steigen drastisch (gemessen). Die einzige wirkliche Abhilfe ist, die Funktion für den virtuellen Host abzuschalten: AllowOverride None im virtuellen HTTPS-Host, und die Regeln in der Konfiguration des virtuellen Hosts selbst als mod_rewrite-Regeln. Das ist in Geschwindigkeitstests im Produktivbetrieb weit schneller und die Zeit für die Optimierung einer Produktivkonfiguration unbedingt wert. Stellen Sie sofort um: Übernehmen Sie die Regeln des Beispiels für einen virtuellen HTTPS-Host in Ihren virtuellen Host (mit dem statischen Cache auch staticcache_offload.conf), setzen Sie AllowOverride None, führen Sie apachectl configtest aus, laden Sie Apache neu und testen Sie die Website. Dieselben Regeln für andere Server: nginx, LiteSpeed, Caddy, IIS, Velocity (eingebaut); wohin Regeln für virtuelle Hosts in einem Control Panel gehören: Plesk, cPanel, DirectAdmin, ISPConfig. Unter LiteSpeed oder OpenLiteSpeed kann zusätzlich der Seiten-Cache des Servers anonyme Besucher und Crawler ohne PHP bedienen: Seiten-Caching mit LiteSpeed und OpenLiteSpeed.

Inhalt

  1. Symptome
  2. Die ersten fünf Minuten
  3. Welche Seite sieht der Besucher?
  4. Überhaupt nichts antwortet
  5. Nach dem Vorfall

Symptome

  • Die externe Prüfung löst einen Alarm aus.
  • Kunden melden eine Fehlerseite (Something went wrong, We'll be right back), eine leere Seite oder einen Verbindungsfehler des Browsers.

Die ersten fünf Minuten

  1. Öffnen Sie die Website selbst und notieren Sie genau, was sie zeigt, mit dem HTTP-Status:

    curl -sI https://www.example.com/ | head -5
  2. Öffnen Sie auch die Administration: Scheitert sie auf dieselbe Weise?

  3. Lesen Sie die neuesten Fehler:

    ./console exp:logs --tail=var/log/error.log --lines=50
  4. Prüfen Sie die Maschine: Speicherplatz (df -h), Arbeitsspeicher, Last. Eine volle Festplatte verursacht die meisten Symptome unten; siehe Festplatte voll.

Welche Seite sieht der Besucher?

Der Besucher siehtUrsacheTun Sie
We'll be right back (503, Retry-After: 30)die Datenbank war nicht erreichbarprüfen Sie, dass der Datenbankserver läuft; prüfen Sie die Zugangsdaten in settings/override/site.ini.append.php; die Log-Zeile enthält die Meldung des Treibers
Down for maintenance (503)der Wartungsmodus ist anphp bin/php/maintenance.php status --allow-root-user; wenn die Arbeit erledigt ist: php bin/php/maintenance.php off --allow-root-user; das Löschen von var/maintenance.json beendet ihn, was auch immer sonst falsch ist
The site is missing the software libraries it needs (503)vendor/ fehlt, wurde verschoben oder umbenanntlegen Sie vendor/ zurück oder führen Sie composer install --no-dev aus; dann php bin/php/ezcache.php --clear-all, und starten Sie Velocity neu, wenn er die Website ausliefert
Something went wrong on our side (500) mit ERR-...ein nicht abgefangener Fehler./console exp:logs --reference=ERR-...; die Zeile nennt Meldung, Datei und Zeile (Einen Fehler über seine Referenz finden)
Eine leere Seite, oder 500 ohne etwas in error.logPHP scheiterte, bevor Exponential protokollieren konnte: Syntaxfehler, fehlende Erweiterung, Speicher erschöpftlesen Sie das Fehlerlog des Webservers oder von PHP-FPM; php -l auf einer kürzlich geänderten Datei
404 für jede Seite unter Apache.htaccess wird nicht gelesen oder mod_rewrite ist auserlauben Sie Overrides, aktivieren Sie mod_rewrite (Apache mit PHP-FPM)

Tipp Fehler, die direkt nach einem Ausrollen oder einem Update begonnen haben: Die Ursache liegt fast immer in dieser Änderung. Unter Velocity braucht eine geänderte Klasse oder Einstellung exp:velocity restart oder exp:velocity deploy; siehe Änderungen ausrollen.

Überhaupt nichts antwortet

Die Verbindung wird abgelehnt oder läuft in eine Zeitüberschreitung.

Unter Velocity:

php bin/php/console exp:velocity status --allow-root-user

status meldet nur dann „running“, wenn der Server eine Anfrage beantwortet; sonst gibt es die gefundenen Probleme aus und endet mit 1. Wenn er nicht läuft, starten Sie ihn (exp:velocity start) und lesen Sie var/vc/qbix/run/console.log, wenn er nicht hochkommt; siehe Velocity startet nicht. Ein Server, der läuft, aber nicht antwortet: exp:velocity restart, und wenn ein Worker festhängt, exp:velocity kill und dann start.

Unter Apache oder nginx mit PHP-FPM:

  • Läuft der Webserver? Läuft der PHP-FPM-Pool der Website? (systemctl status <service>; auf Plesk ist der Dienst plesk-php<XY>-fpm.)
  • Sind alle PHP-FPM-Kinder beschäftigt? Die Statusseite oder das Log des Pools sagt es; siehe Langsame Website.

Davor: Ein Load Balancer, Reverse Proxy, CDN oder eine Firewall-Regel könnte der Teil sein, der scheitert. Testen Sie den Origin direkt.

Nach dem Vorfall

  • To do: Leeren Sie die Caches, die die Abhilfe braucht, und mit Velocity seinen Antwort-Cache nach jedem Neustart (php bin/php/console exp:velocity cache clear --apply --allow-root-user).
  • To do: Prüfen Sie: Startseite, Administration, eine Anmeldung, eine Veröffentlichung.
  • To do: Schreiben Sie die Notiz zum Vorfall: Beginn, Erkennung, Ursache, Abhilfe, Ende, was eine Wiederholung verhindert.
  • To do: Informieren Sie den Kunden.
  • To do: Wenn die Ursache ein Fehler in Exponential ist, melden Sie ihn (Wenn etwas schiefgeht).

Verwandte Seiten

Werden Sie Exponential-Partner

Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x