Das Erstellen eigener Apache-Feh­ler­sei­ten er­mög­licht 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 Feh­ler­sei­te haben?

Keiner möchte, dass bei seinem Webserver HTTP-Fehler auftreten. Doch je nach Ser­ver­aus­las­tung, In­ter­net­ver­bin­dung oder Be­nut­zer­ein­ga­be kann dies ab und zu passieren. Der Apache-Webserver bietet einen Stan­dard­satz von ge­ne­ri­schen Feh­ler­sei­ten für Error 404, HTTP-Error 500 und andere häufige Fehler.

Das Erstellen be­nut­zer­de­fi­nier­ter Feh­ler­sei­ten er­mög­licht es Ihnen jedoch:

  • Ihr Branding auf diesen Seiten fort­zu­set­zen
  • Ihr Design in das Look and Feel Ihrer Website zu in­te­grie­ren
  • Verloren gegangene Be­su­chen­de an ihren Be­stim­mungs­ort wei­ter­zu­lei­ten
  • Feh­ler­sei­ten in anderen Sprachen als Englisch be­reit­zu­stel­len
Cloud Server
Leis­tungs­star­ke Kon­fi­gu­ra­tio­nen
  • On-Demand ska­lier­bar & Root-Zugriff inklusive
  • Hoch­ver­füg­ba­re Server-Plattform
  • ISO-zer­ti­fi­zier­te Re­chen­zen­tren am Standort Deutsch­land

An­for­de­run­gen

  • Cloud Server unter Linux (CentOS Stream 9 oder Ubuntu 24.04)
  • Apache ist in­stal­liert und wird aus­ge­führt
Tipp

Apache und Ubuntu gehören zu den be­lieb­tes­ten Open-Source-Platt­for­men, um einen Webserver zu hosten. Wir zeigen Ihnen, wie Sie Apache unter Ubuntu in­stal­lie­ren können.

Eigene Apache-Feh­ler­sei­te erstellen

Zuerst müssen Sie die be­nut­zer­de­fi­nier­te Feh­ler­sei­te erstellen. Zu Test­zwe­cken werden wir eine Beispiel-Feh­ler­sei­te erstellen, um 404-Fehler zu ab­zu­fan­gen.

Verwenden Sie SSH, um sich mit Ihrem Server zu verbinden, und gehen Sie zum Haupt­ver­zeich­nis 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 Tas­ten­kom­bi­na­tio­nen [Strg] + [O] und [Strg] + [X]. Sie können die Datei nun ansehen, indem Sie auf “http://example.com/my-404.html” gehen, um si­cher­zu­stel­len, dass sie korrekt angezeigt wird.

Eigene Apache-Feh­ler­sei­te kon­fi­gu­rie­ren

Nun müssen Sie Ihren Apache-Webserver so kon­fi­gu­rie­ren, dass er die eben erstellte Feh­ler­sei­te auch verwendet. Zu diesem Zweck fügen Sie eine Er­ror­Do­cu­ment-Anweisung hinzu. Die Syntax für diese Direktive lautet:

ErrorDocument 404 [path to file]

Wollen Sie diese Feh­ler­sei­te global verwenden, sollte die Direktive in der Haupt­kon­fi­gu­ra­ti­ons­da­tei von Apache stehen. Soll die Seite statt­des­sen nur für einen vir­tu­el­len Host verwendet werden (z. B. wenn Sie die Ihre Website in mehreren Sprachen anbieten), muss sie in einem VirtualHost-Be­fehls­block stehen. In diesem Abschnitt be­schäf­ti­gen wir uns haupt­säch­lich mit der globalen Kon­fi­gu­ra­ti­on.

Die Apache-Haupt­kon­fi­gu­ra­ti­ons­da­tei befindet sich kon­ven­tio­nell an folgenden Spei­cher­or­ten:

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

Der Spei­cher­ort und der Dateiname der Apache-Kon­fi­gu­ra­ti­ons­da­tei einer Website kann je nachdem, wie Sie oder Ihr Ser­ver­ad­mi­nis­tra­tor das Hosting ein­ge­rich­tet haben, variieren.

Be­ar­bei­ten 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 Er­ror­Do­cu­ment an einer passenden Stelle ein. Zum Beispiel:

ErrorDocument 404 /my-404.html

Wollen Sie das nur für einen vir­tu­el­len Host machen, müssen Sie in der ent­spre­chen­den Kon­fi­gu­ra­ti­ons­da­tei scrollen, bis Sie den VirtualHost-Be­fehls­block finden. Stellen Sie sicher, dass die Direktive außerhalb von Directory-Be­fehls­blö­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 Än­de­run­gen wirksam werden:

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

Testen Sie schließ­lich Ihr Feh­ler­do­ku­ment, indem Sie zu einer un­gül­ti­gen URL für Ihre Website gehen. Sie werden statt­des­sen zu Ihrer neuen be­nut­zer­de­fi­nier­ten 404-Seite wei­ter­ge­lei­tet.

Andere HTTP-Feh­ler­codes

Der häufigste be­nut­zer­de­fi­nier­te Fehler ist der Fehler 404. Sie können jedoch auch eigene Feh­ler­mel­dun­gen für andere HTTP-Feh­ler­mel­dun­gen erstellen. Bei Apache können eigene Feh­ler­sei­ten für alle 4xx- und 5xx-Feh­ler­codes kon­fi­gu­riert werden. Eine Übersicht der wich­tigs­ten HTTP-Status-Codes finden Sie in unserem wei­ter­füh­ren­den Artikel. Eine voll­stän­di­ge Liste der Feh­ler­codes finden Sie auf Wikipedia.

Zum Hauptmenü