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 Zone 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>IP-Adresse: ::SX_REMOTE_IP::</p>
<p>Wenn dieses Problem weiterhin besteht, bitte unser Support-Team kontaktieren.</p>
</body>
</html>Anforderungen
| Anforderung | Details |
|---|---|
| Format | Nur HTML (.html) |
| Größe | Maximal 100 KB pro Datei |
| Syntax | Muss gültiges HTML5 sein |
| Assets | Externe Ressourcen müssen absolute HTTPS-URLs verwenden |
| Skripte | JavaScript wird unterstützt, kann aber eingeschränkt sein |
| Kodierung | UTF-8 |
Andere Dateitypen (Bilder, PDFs, Skripte) werden nicht akzeptiert. Die HTML-Seite eigenständig und schlank halten und externe Assets über absolute HTTPS-URLs referenzieren.
Benutzerdefinierte Seite hochladen
- Zur Zone in smoxy navigieren
- Proxy ö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 Access Rule oder die WAF blockiert
Template-Variablen: Alle 4 Variablen verfügbar
Voraussetzung: Die Sicherheitsfunktion muss auf der Zone aktiviert sein, damit Sicherheitsblockierungen auftreten. Siehe Sicherheit & WAF für Details.
Wartungsseite
Die Wartungsseite wird angezeigt, wenn der Wartungsmodus für die Zone 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
- Seiten eigenständig und schlank halten: Ressourcen, die auf eigenen Servern gehostet werden, laden möglicherweise nicht, wenn der Origin nicht erreichbar ist. Referenzierte externe Assets müssen absolute HTTPS-URLs verwenden.
- Dateigrößenlimit: Seiten unter 100 KB halten. Dieses Limit stellt eine schnelle Auslieferung auch unter hoher Last sicher.
- JavaScript kann eingeschränkt sein: JavaScript wird unterstützt, kann aber eingeschränkt sein, und externe Skripte werden bei nicht erreichbarem Origin oder CDN nicht geladen. Nicht auf JavaScript für kritische Inhalte verlassen.
- 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 Zone hat eine benutzerdefinierte Seite pro Typ. Unterschiedliche Seiten für verschiedene Hostnamen auf derselben Zone sind nicht konfigurierbar.