So konfigurieren Sie den Apache für die Verwendung eigener Fehlerseiten

Das Erstellen eigener Apache-Fehlerseiten ermöglicht es Ihnen unter anderem, ihr Design und Branding auf Ihrer gesamten Webseite sichtbar zu machen. Wir zeigen Ihnen, wie das gelingt.

Warum sollte man eine eigene Fehlerseite haben?

Keiner möchte, dass bei seinem Webserver HTTP-Fehler auftreten. Doch je nach Serverauslastung, Internetverbindung oder Benutzereingabe kann dies ab und zu passieren. Der Apache-Webserver bietet einen Standardsatz von generischen Fehlerseiten für Error 404, HTTP-Error 500 und andere häufige Fehler.

Das Erstellen benutzerdefinierter Fehlerseiten ermöglicht es Ihnen jedoch:

  • Ihr Branding auf diesen Seiten fortzusetzen
  • Ihr Design in das Look and Feel Ihrer Website zu integrieren
  • Verloren gegangene Besuchende an ihren Bestimmungsort weiterzuleiten
  • Fehlerseiten in anderen Sprachen als Englisch bereitzustellen
Cloud Server
Leistungsstarke Konfigurationen
  • On-Demand skalierbar, Load Balancer und Traffic inklusive
  • Hochverfügbare Server-Plattform
  • ISO-zertifizierte Rechenzentren am Standort Deutschland
  • Inkl. 100,- € Startguthaben im 1. Monat

Anforderungen

  • Cloud Server unter Linux (CentOS Stream 9 oder Ubuntu 24.04)
  • Apache ist installiert und wird ausgeführt
Tipp

Apache und Ubuntu gehören zu den beliebtesten Open-Source-Plattformen, um einen Webserver zu hosten. Wir zeigen Ihnen, wie Sie Apache unter Ubuntu installieren können.

Eigene Apache-Fehlerseite erstellen

Zuerst müssen Sie die benutzerdefinierte Fehlerseite erstellen. Zu Testzwecken werden wir eine Beispiel-Fehlerseite erstellen, um 404-Fehler zu abzufangen.

Verwenden Sie SSH, um sich mit Ihrem Server zu verbinden, und gehen Sie zum Hauptverzeichnis Ihrer Website (oft /var/www/html/). Erstellen Sie mit folgendem Befehl eine neue Seite namens my-404.html:

sudo nano my-404.html
bash

Fügen Sie das Folgende in diese Datei ein:

<html>
<head>
<title>My Custom 404 Error Page</title>
</head>
<body>
<p>Whoops, page not found! Sorry about that.</p>
</body>
</html>

Speichern Sie die Datei und verlassen Sie Nano mit den Tastenkombinationen [Strg] + [O] und [Strg] + [X]. Sie können die Datei nun ansehen, indem Sie auf “http://example.com/my-404.html” gehen, um sicherzustellen, dass sie korrekt angezeigt wird.

Eigene Apache-Fehlerseite konfigurieren

Nun müssen Sie Ihren Apache-Webserver so konfigurieren, dass er die eben erstellte Fehlerseite auch verwendet. Zu diesem Zweck fügen Sie eine ErrorDocument-Anweisung hinzu. Die Syntax für diese Direktive lautet:

ErrorDocument 404 [path to file]

Wollen Sie diese Fehlerseite global verwenden, sollte die Direktive in der Hauptkonfigurationsdatei von Apache stehen. Soll die Seite stattdessen nur für einen virtuellen Host verwendet werden (z. B. wenn Sie die Ihre Website in mehreren Sprachen anbieten), muss sie in einem VirtualHost-Befehlsblock stehen. In diesem Abschnitt beschäftigen wir uns hauptsächlich mit der globalen Konfiguration.

Die Apache-Hauptkonfigurationsdatei befindet sich konventionell an folgenden Speicherorten:

  • CentOS Stream 9 /etc/httpd/conf/httpd.conf
  • Ubuntu 24.04 /etc/apache2/apache2.conf
Hinweis

Der Speicherort und der Dateiname der Apache-Konfigurationsdatei einer Website kann je nachdem, wie Sie oder Ihr Serveradministrator das Hosting eingerichtet haben, variieren.

Bearbeiten Sie diese Datei mit einem Editor Ihrer Wahl, z.B. mit dem Befehl:

  • CentOS Stream 9 sudo nano /etc/httpd/conf/httpd.conf
  • Ubuntu 24.04 sudo nano /etc/apache2/apache2.conf

Fügen Sie das ErrorDocument an einer passenden Stelle ein. Zum Beispiel:

ErrorDocument 404 /my-404.html

Wollen Sie das nur für einen virtuellen Host machen, müssen Sie in der entsprechenden Konfigurationsdatei scrollen, bis Sie den VirtualHost-Befehlsblock finden. Stellen Sie sicher, dass die Direktive außerhalb von Directory-Befehlsblöcken platziert wird. Zum Beispiel:

<VirtualHost *:80>
ServerName example.com
ErrorDocument 404 /my-404.html
    <Directory "/var/www/example.com/html">
    AllowOverride All
    </Directory>
</VirtualHost>

Speichern und beenden Sie die Datei, und starten Sie dann Apache neu, damit die Änderungen wirksam werden:

  • CentOS Stream 9 sudo systemctl restart httpd
  • Ubuntu 24.04 sudo systemctl restart apache2

Testen Sie schließlich Ihr Fehlerdokument, indem Sie zu einer ungültigen URL für Ihre Website gehen. Sie werden stattdessen zu Ihrer neuen benutzerdefinierten 404-Seite weitergeleitet.

Andere HTTP-Fehlercodes

Der häufigste benutzerdefinierte Fehler ist der Fehler 404. Sie können jedoch auch eigene Fehlermeldungen für andere HTTP-Fehlermeldungen erstellen. Bei Apache können eigene Fehlerseiten für alle 4xx- und 5xx-Fehlercodes konfiguriert werden. Eine Übersicht der wichtigsten HTTP-Status-Codes finden Sie in unserem weiterführenden Artikel. Eine vollständige Liste der Fehlercodes finden Sie auf Wikipedia.