Benutzerdefinierte Seiten
smoxy ermöglicht es, die Standard-Fehler-, Sicherheits- und Wartungsseiten durch eigene HTML-Seiten zu ersetzen. So besteht volle Kontrolle darüber, was Besucher bei Ausfällen, Sicherheitsblockierungen oder geplanten Wartungsarbeiten sehen.
Seitentypen
smoxy unterstützt drei benutzerdefinierte Seitentypen, die jeweils durch unterschiedliche Szenarien ausgelöst werden:
| Seitentyp | Ausgelöst wenn | HTTP-Statuscodes |
|---|---|---|
| Fehlerseite | Der Origin-Server nicht erreichbar ist oder nicht rechtzeitig antwortet | 502 (Bad Gateway), 504 (Gateway Timeout) |
| Sicherheitsseite | Eine Anfrage durch WAF oder Sicherheitsregeln blockiert wird | 403 (Forbidden) |
| Wartungsseite | Der Wartungsmodus für die Site aktiviert wird | 503 (Service Unavailable) |
Jeder Seitentyp lässt sich unabhängig aktivieren — eine benutzerdefinierte Fehlerseite kann verwendet werden, ohne die Sicherheits- oder Wartungsseiten anzupassen.
Template-Variablen
Benutzerdefinierte Seiten unterstützen dynamische Template-Variablen, die smoxy beim Ausliefern der Seite durch echte Werte ersetzt. Damit lassen sich Besuchern kontextbezogene Informationen anzeigen.
| Variable | Beschreibung | Verfügbar in |
|---|---|---|
::SX_STATUS:: | Der HTTP-Statuscode (z. B. 502, 403) | Fehler, Sicherheit |
::SX_STATUS_TEXT:: | Lesbarer Statustext (z. B. Bad Gateway, Forbidden) | Fehler, Sicherheit |
::SX_HOST:: | Der Hostname, der die Anfrage empfangen hat | Fehler, Sicherheit |
::SX_REMOTE_IP:: | Die IP-Adresse des Besuchers | Fehler, Sicherheit |
INFO
Hinweis: Wartungsseiten unterstützen keine Template-Variablen. Die Wartungsseite wird als statischer Inhalt ausgeliefert.
Beispielverwendung
<!DOCTYPE html>
<html>
<head>
<title>Fehler ::SX_STATUS:: - ::SX_HOST::</title>
</head>
<body>
<h1>::SX_STATUS:: ::SX_STATUS_TEXT::</h1>
<p>Beim Laden von <strong>::SX_HOST::</strong> ist leider ein Fehler aufgetreten.</p>
<p>Deine IP: ::SX_REMOTE_IP::</p>
<p>Wenn dieses Problem weiterhin besteht, bitte unser Support-Team kontaktieren.</p>
</body>
</html>Anforderungen
| Anforderung | Details |
|---|---|
| Dateiformat | Nur HTML (.html oder .txt Erweiterung) |
| Maximale Dateigröße | 256 KB |
| MIME-Typ | text/html |
Andere Dateitypen (Bilder, PDFs, Skripte) werden nicht akzeptiert. Die HTML-Seite sollte eigenständig sein — CSS und Bilder bei Bedarf als Base64-Data-URIs inline einbinden.
Benutzerdefinierte Seite hochladen
- Zur Site in smoxy navigieren
- Grundkonfiguration öffnen
- Zum entsprechenden Abschnitt scrollen (Benutzerdefinierte Fehlerseite, Benutzerdefinierte Sicherheitsseite oder Wartungsmodus)
- Funktion aktivieren
- HTML-Datei hochladen
- Konfiguration speichern
Nach dem Upload erscheint eine Live-Vorschau der Seite im Konfigurationsbereich. Ein Klick auf die Vorschau öffnet sie in einem neuen Tab.
Details zu den Seitentypen
Fehlerseite
Die Fehlerseite wird angezeigt, wenn smoxy den Origin-Server nicht erreichen kann oder der Origin zu lange für eine Antwort braucht.
Wann sie erscheint:
- 502 Bad Gateway — Der Origin hat eine ungültige Antwort zurückgegeben oder ist offline
- 504 Gateway Timeout — Der Origin hat nicht rechtzeitig geantwortet
Template-Variablen: Alle 4 Variablen verfügbar (::SX_STATUS::, ::SX_STATUS_TEXT::, ::SX_HOST::, ::SX_REMOTE_IP::)
Tipp: Mit ::SX_STATUS:: lässt sich auf einer einzigen Seite zwischen 502- und 504-Fehlern unterscheiden, z. B. um unterschiedliche Problemlösungshinweise anzuzeigen.
Sicherheitsseite
Die Sicherheitsseite wird angezeigt, wenn eine Anfrage durch die Sicherheitsregeln oder WAF von smoxy blockiert wird.
Wann sie erscheint:
- 403 Forbidden — Die Anfrage wurde durch eine Zugriffsregel oder die WAF blockiert
Template-Variablen: Alle 4 Variablen verfügbar
Voraussetzung: Die Sicherheitsfunktion muss auf der Site aktiviert sein, damit Sicherheitsblockierungen auftreten. Siehe Sicherheit & WAF für Details.
Wartungsseite
Die Wartungsseite wird angezeigt, wenn der Wartungsmodus für die Site aktiviert wird. Dies ist nützlich für geplante Ausfallzeiten oder Deployments.
Wann sie erscheint:
- 503 Service Unavailable — Der Wartungsmodus ist aktiv
Template-Variablen: Keine — die Wartungsseite wird als statisches HTML ohne Variablenersetzung ausgeliefert.
Tipp: Da Wartungsseiten keine Template-Variablen unterstützen, sollten alle notwendigen Informationen direkt im HTML eingebunden werden.
Vorschau
Nach dem Upload einer benutzerdefinierten Seite bietet smoxy eine interaktive Vorschau mit einer Toolbar zum Testen, wie die Seite mit verschiedenen Werten aussieht:
- Statuscode — verschiedene Statuscodes wählen, um das Rendering der Template-Variablen zu sehen
- Hostname — einen Hostnamen eingeben, um die
::SX_HOST::-Ersetzung zu testen - Remote IP — eine IP eingeben, um die
::SX_REMOTE_IP::-Ersetzung zu testen
Die Vorschau wird in Echtzeit aktualisiert, sobald Toolbar-Werte geändert werden.
Wichtige Hinweise
- Eigenständiges HTML: Die benutzerdefinierte Seite sollte eine einzelne HTML-Datei sein. Externe Ressourcen (CSS-Dateien, Bilder, JavaScript), die auf eigenen Servern gehostet werden, laden möglicherweise nicht, wenn der Origin nicht erreichbar ist. Stattdessen Inline-Styles und Base64-kodierte Bilder verwenden.
- Dateigrößenlimit: Seiten unter 256 KB halten. Dieses Limit stellt eine schnelle Auslieferung auch unter hoher Last sicher.
- Keine JavaScript-Abhängigkeiten: Keine Abhängigkeit von externen JavaScript-Bibliotheken aufbauen. Bei nicht erreichbarem Origin oder CDN werden auch diese Ressourcen nicht geladen.
- Mit der Vorschau testen: Vor dem Livegang immer die Vorschaufunktion nutzen, um sicherzustellen, dass die Template-Variablen korrekt gerendert werden.
- Eine Seite pro Typ: Jede Site hat eine benutzerdefinierte Seite pro Typ. Unterschiedliche Seiten für verschiedene Hostnamen auf derselben Site sind nicht konfigurierbar.