# Individuelle Fehlerseiten

Source: https://support.kapsulehost.com/de-de/site-error-pages

Eine Custom Error Page ersetzt den schlichten Server-Standard durch Ihr eigenes, gebrandetes HTML, während der tatsächliche Fehlerstatus erhalten bleibt, sodass Suchmaschinen weiterhin einen echten 404 sehen. Diese Anleitung behandelt das Hinzufügen einer Seite für jeden unterstützten Code, was aus Sicherheitsgründen entfernt wird, und wie das Verifizierungs-Badge funktioniert.

## Wo sich Error Pages in KPanel befinden

1. Melden Sie sich bei [KPanel](https://kpanel.kapsulehost.com) an.
2. Klicken Sie in der linken Seitenleiste auf **Websites** und dann auf die jeweilige Website.
3. Öffnen Sie im linken Menü der Website **Einstellungen** und dann **Fehlerseiten**.

Die direkte Adresse lautet `/websites/<site-id>/error-pages`.

![Custom Error Pages für eine Website in KPanel](https://support.kapsulehost.com/help/screenshots/site-error-pages.89c17e2d.webp)

## Warum sich das lohnt

Eine Standard-Fehlerseite des Servers ist eine Sackgasse. Sie hat kein Branding, keine Navigation und keine Erklärung, sodass ein Besucher, der darauf landet, die Seite meist sofort wieder verlässt.

Eine Custom Error Page macht daraus einen Weg zurück auf die Website: Ihr Logo, Ihre Typografie, ein Satz in Ihrem eigenen Ton und ein Link zur Startseite oder zu einer Suchfunktion. Bei einer großen Website sind falsch getippte und veraltete URLs eine stetige Quelle von Traffic, und eine 404-Seite ist die günstigste Rückgewinnung, die Sie je umsetzen werden.

## Die unterstützten Codes

Sie können für acht Codes jeweils eine eigene Seite festlegen, eine Seite pro Code:

| Code | Bedeutung | Typische Ursache |
|---|---|---|
| 400 | Ungültige Anfrage | Eine fehlerhaft aufgebaute Anfrage |
| 401 | Unauthorized | Authentifizierung erforderlich oder fehlgeschlagen |
| 403 | Forbidden | Eine Zugriffsregel hat die Anfrage blockiert |
| 404 | Nicht gefunden | Unter dieser URL existiert nichts |
| 500 | Interner Serverfehler | Ihre Anwendung ist fehlgeschlagen |
| 502 | Ungültiges Gateway | Die Anwendung hat nicht korrekt geantwortet |
| 503 | Service nicht verfügbar | Die Anwendung ist nicht erreichbar oder überlastet |
| 504 | Gateway-Timeout | Die Anwendung hat zu lange gebraucht |

Beginnen Sie mit 404. Dieser Code ist mit Abstand der häufigste und der einzige, den ein Besucher durch normales Browsen erreicht, statt durch einen Fehler.

Die 5xx-Familie lohnt sich als Nächstes, denn das sind die Seiten, die Besucher an Ihrem schlechtesten Tag zu sehen bekommen. Eine ruhige, gebrandete Seite, die mitteilt, dass etwas schiefgelaufen ist, und eine E-Mail-Adresse angibt, ist weit besser als ein leerer Serverfehler.

## Eine Seite hinzufügen

1. Klicken Sie auf **Error Page hinzufügen**.
2. Wählen Sie einen Fehlercode aus dem Dropdown-Menü. Bereits verwendete Codes werden nicht angezeigt.
3. Ersetzen Sie das Beispiel-HTML im Feld **HTML-Body** durch Ihr eigenes.
4. Klicken Sie auf **Error Page hinzufügen**.

Der Editor startet mit einem funktionierenden 404-Dokument, das Sie anpassen können, was ein vernünftiger Ausgangspunkt ist, wenn Sie schnell etwas Ordentliches möchten.

## Das HTML schreiben

Stellen Sie ein vollständiges HTML-Dokument bereit, beginnend mit einem Doctype. Es wird so ausgeliefert, wie es ist, und muss daher für sich allein funktionieren.

Aus Sicherheitsgründen wird manches HTML entfernt, bevor die Seite überhaupt gespeichert wird:

- `<script>`-Tags
- inline Event-Handler wie `onclick`
- iframes
- externe Stylesheets

Falls etwas entfernt wurde, erhalten Sie nach dem Speichern eine entsprechende Warnung.

> **Warning:** Da externe Stylesheets entfernt werden, kann eine Error Page nicht die Haupt-CSS-Datei Ihrer Website laden. Gestalten Sie sie mit Inline-CSS oder einem `<style>`-Block im Dokumentenkopf. Das ist beabsichtigt: Eine Error Page muss auch dann dargestellt werden, wenn der Rest der Website defekt ist, und eine Seite, die auf das Laden von Assets von einem ausgefallenen Server angewiesen ist, wird genau im falschen Moment als unformatierter Text angezeigt.

Praktische Hinweise:

- **Halten Sie sie klein und in sich geschlossen.** Binden Sie alles inline ein. Vermeiden Sie externe Bilder. Die Seitenliste zeigt die Größe jeder Seite in KB an.
- **Beschreiben Sie in einfachen Worten, was passiert ist.** "Wir konnten diese Seite nicht finden" ist besser als "404 Not Found".
- **Bieten Sie einen Weg nach vorn.** Einen Link zur Startseite, einen Link zu Ihren Hauptbereichen oder eine Suchfunktion.
- **Fügen Sie auf den 5xx-Seiten einen Kontaktweg hinzu**, da der Besucher die Website nicht nutzen kann, um Sie zu erreichen.
- **Nutzen Sie sie nicht als Weiterleitung.** Wenn sich eine URL geändert hat, leiten Sie korrekt weiter. Siehe [Website-Weiterleitungen](https://support.kapsulehost.com/de-de/site-redirects).

## Der Statuscode bleibt erhalten

Ihre Custom Error Page wird mit dem tatsächlichen Fehlerstatus ausgeliefert, nicht mit 200. Ein 404 bleibt bis zum Client hin ein 404.

Das ist wichtiger, als es klingt. Eine gebrandete Seite, die als 200 zurückgegeben wird, ist ein "Soft 404": Suchmaschinen indexieren sie als echte Seite, Ihre Analytics zählen sie als erfolgreichen Seitenaufruf, und kein Tool markiert jemals defekte Links. Da KapsuleHost den tatsächlichen Status beibehält, funktioniert das alles weiterhin korrekt.

## Das Status-Badge lesen

Die Spalte **Status** zeigt, was tatsächlich verifiziert werden konnte, und ist dabei bewusst ehrlich über die Grenzen der Prüfung.

| Badge | Bedeutung |
|---|---|
| Verifiziert: Custom Error Page wird ausgeliefert (echter 404) | Wir haben von außen einen 404 erzwungen und Ihre Seite mit dem korrekten Status erhalten |
| Konfiguriert (nicht extern getestet) | Die Seite ist angewendet. Dieser Code kann von außen nicht auf Abruf ausgelöst werden |
| Noch nicht verifiziert | Die Prüfung wurde noch nicht ausgeführt |
| Angewendet, Live-Test nicht eindeutig | Die Prüfung erhielt etwas anderes als einen sauberen 404, oft weil eine Weiterleitung dazwischenkam |
| 404 erhalten, aber die Custom Error Page wurde nicht ausgeliefert | Die Regel ist vorhanden, aber Ihre Seite kam nicht zurück. Versuchen Sie, erneut zu speichern |

Nur 404 kann von außen erzwungen werden. Die Anfrage einer nicht existierenden URL erzeugt zuverlässig einen 404, aber es gibt keine Möglichkeit, einen gesunden Server auf Abruf einen echten 500 erzeugen zu lassen, ohne ihn dabei zu beschädigen. Deshalb melden die anderen Codes **Konfiguriert**, statt eine Verifizierung zu behaupten, die nie stattgefunden hat. Sie werden trotzdem ausgeliefert, wenn der Fehler tatsächlich auftritt.

Möglicherweise sehen Sie auch eine Warnung, dass eine andere Konfiguration auf dem Server dieselbe Domain beansprucht. Solange das nicht gelöst ist, wird die Error Page möglicherweise nicht angewendet. Kontaktieren Sie in diesem Fall den Support.

## Fehlerbehebung bei einer tatsächlich fehlerhaften Website

Wenn Sie hier sind, weil Ihre Website tatsächlich Fehler wirft, und nicht, weil Sie schönere Seiten möchten, bietet die Seite eine Abkürzung: die Schaltfläche **Mit Kora beheben** im Banner oben.

Sie bittet Kora, den Assistenten innerhalb von KPanel, die Fehlerprotokolle und jüngsten Ausfälle dieser Website zu lesen und Ihnen die wahrscheinliche Ursache sowie die Lösung mitzuteilen. Das ist ein deutlich schnellerer erster Schritt, als Rohprotokolle zu lesen.

Für das zugrunde liegende Performance-Bild siehe [Website-Performance und APM](https://support.kapsulehost.com/de-de/site-performance), und für die Fehlerrate im Zeitverlauf siehe [Website-Traffic-Analyse](https://support.kapsulehost.com/de-de/site-analytics).

## Bearbeiten und Entfernen

Jede Zeile verfügt über eine Bearbeiten-Schaltfläche, die denselben Editor mit festgelegtem Code und geladenem HTML öffnet, sowie eine Entfernen-Schaltfläche.

Das Entfernen erfordert eine Bestätigung und erklärt das Ergebnis: Anfragen, die diesen Code auslösen, fallen auf die Standard-Fehlerseite des Servers zurück.

## Fehlerbehebung

**Meine Seite wird nicht angezeigt.** Vergewissern Sie sich, dass Sie den richtigen Code auslösen. Ein Pfad, der weiterleitet, erreicht nie einen 404. Testen Sie mit einer URL, die tatsächlich nicht existiert, in einem privaten Fenster, damit kein Cache beteiligt ist.

**Die Seite wird angezeigt, sieht aber unformatiert aus.** Ihr Stylesheet wurde als externes Asset entfernt. Binden Sie das CSS inline ein.

**Mein Tracking-Skript fehlt.** Skripte werden absichtlich entfernt. Es gibt hier keine Möglichkeit, JavaScript von einer Custom Error Page auszuführen.

**Alle Codes haben bereits eine Seite.** Alle acht sind bereits in Verwendung. Bearbeiten Sie eine bestehende Seite, statt eine weitere hinzuzufügen.

**Das Badge zeigt an, dass die Custom Error Page nicht ausgeliefert wurde.** Speichern Sie die Seite erneut. Falls das Problem bestehen bleibt und keine Warnung zu einem Domain-Konflikt erschienen ist, eröffnen Sie ein Ticket.

## Verwandte Seiten

- [Website-Weiterleitungen](https://support.kapsulehost.com/de-de/site-redirects), um zu verhindern, dass der 404-Fehler überhaupt erst auftritt.
- [Website-Traffic-Analyse](https://support.kapsulehost.com/de-de/site-analytics), um zu sehen, wie viele 4xx- und 5xx-Antworten Sie tatsächlich ausliefern.
- [Passwortschutz für eine Website](https://support.kapsulehost.com/de-de/site-password-protect), der 401-Antworten absichtlich erzeugt.