Erste Schritte
Diese Anleitung führt Sie durch die initiale Einrichtung, damit Ihre Website über smoxy ausgeliefert wird. Der Ablauf ist unabhängig vom verwendeten Modul derselbe — Bildoptimierung, Acceleration oder Sicherheit. Sobald der Traffic durch smoxy fließt, können Sie Ihre Module aktivieren.
Was Sie benötigen:
- Einen smoxy-Account
- Die IP-Adresse und den Port Ihres Origin-Servers
- Zugriff auf das DNS-Management Ihrer Domain
Schritt 1: Site anlegen
- Klicken Sie auf Erste Site anlegen (oder das +-Symbol, falls bereits Sites existieren)
- Geben Sie die URL der Website ein, die Sie optimieren möchten (z. B.
example.com) - Wählen Sie einen Site-Typ (Production oder Staging — nur zur internen Organisation)
- Vergeben Sie einen Namen für die Site (wird automatisch aus der URL ausgefüllt, kann aber geändert werden)
- Fügen Sie Hostnamen hinzu — das sind die Domains, die diese Site-Konfiguration nutzen sollen (z. B.
example.com,www.example.com). Weitere können später ergänzt werden.
INFO
Was ist eine Site? Eine Site ist ein wiederverwendbares Bündel von Einstellungen — Caching, Sicherheit, Optimierung —, das Sie einer oder mehreren Domains zuweisen. Siehe Was ist eine Site? für Details.
Schritt 2: SSL einrichten
Für jeden Hostnamen benötigt smoxy ein SSL-Zertifikat. Es gibt zwei Optionen:
Automatisch verwaltet (empfohlen)
smoxy erstellt und erneuert Zertifikate automatisch über Let's Encrypt. Zur Verifizierung der Domain-Inhaberschaft müssen Sie einen DNS-CNAME-Eintrag anlegen:
| Datensatztyp | Name | Wert |
|---|---|---|
| CNAME | _acme-challenge.example.com | Wird im Einrichtungs-Assistenten angezeigt (Copy-Button) |
Nachdem Sie den Eintrag bei Ihrem DNS-Provider angelegt haben, klicken Sie in smoxy auf Einträge verifizieren. Sobald die Verifizierung erfolgreich ist, wird das Zertifikat automatisch erstellt.
INFO
Hinweis: Dieser DNS-Eintrag dient ausschließlich zur Zertifikatserstellung — er leitet noch keinen Traffic durch smoxy.
Selbstverwaltet
Wenn Sie ein eigenes Zertifikat verwenden möchten, klicken Sie auf Eigenes SSL-Zertifikat hochladen und fügen Sie Ihr Zertifikat (PEM-Format) und den privaten Schlüssel ein. Format-Anforderungen siehe „Selbstverwaltete SSL-Zertifikate".
Schritt 3: Origin konfigurieren
Der Origin ist Ihr Backend-Server, an den smoxy Anfragen weiterleitet.
| Feld | Beschreibung |
|---|---|
| Schema | https (Standard) oder http |
| IP-Adresse | Die IPv4-Adresse Ihres Servers (z. B. 12.3.45.6) |
| Port | Standard 443 für HTTPS, 80 für HTTP |
| Hostname (optional) | Überschreibt den Host-Header an Ihren Server. Leer lassen, um die eingehende Domain zu nutzen. |
Sie können auch einen bereits unter Organisation > Origins & Loadbalancer konfigurierten Origin oder Loadbalancer auswählen.
Schritt 4: Go-Live-Checkliste abschließen
Nach dem Setup zeigt das Dashboard eine Go-Live-Checkliste mit vier Punkten:
- Target-Setup — Origin oder Loadbalancer konfiguriert
- Konnektivität — smoxy kann Ihren Origin erreichen (Klick auf Retry zum Testen)
- Hostnamen — Mindestens ein Hostname hinzugefügt
- SSL — Gültiges Zertifikat für Ihre Hostnamen
Alle vier müssen grün sein, bevor Sie live gehen können.
Schritt 5: DNS auf smoxy umstellen
Dieser Schritt leitet den Traffic Ihrer Besucher tatsächlich durch smoxy. Das Dashboard zeigt die genauen CNAME-Einträge an:
| Datensatztyp | Name | Wert |
|---|---|---|
| CNAME | example.com | Wird im Dashboard angezeigt (Copy-Button) |
| CNAME | www.example.com | Wird im Dashboard angezeigt (Copy-Button) |
Legen Sie diese Einträge bei Ihrem DNS-Provider an. Verwenden Sie eine niedrige TTL (z. B. 300 Sekunden / 5 Minuten), damit Sie bei Bedarf schnell zurückwechseln können.
INFO
Hinweis: DNS-Änderungen können bis zu 24–48 Stunden brauchen, um global propagiert zu werden, sind aber meist innerhalb von Minuten sichtbar.
Traffic verifizieren
Aktivieren Sie den Live-Modus im Dashboard, um eingehende Anfragen in Echtzeit zu sehen. Sobald Traffic im Requests-Chart erscheint, funktioniert Ihr Setup.
Schritt 6: Module aktivieren
Zu diesem Zeitpunkt fließt der Traffic durch smoxy, es ist aber noch keine Optimierung aktiv. Aktivieren Sie die von Ihnen gebuchten Module:
Bildoptimierung
Komprimiert und konvertiert Bilder automatisch in moderne Formate (WebP, AVIF) – abhängig vom Browser-Support. Aktivieren Sie sie in den Site-Einstellungen und konfigurieren Sie die Qualitäts-Schwellen.
Acceleration
Cached HTML-Seiten am Edge für nahezu sofortige Auslieferung. Aktivieren Sie sie in den Site-Einstellungen. Achten Sie darauf, dynamische Seiten (Warenkorb, Checkout, Account) per Bedingten Regeln auszuschließen.
Sicherheit
Aktiviert die Web Application Firewall (WAF) mit verwalteten Regeln, die vor gängigen Bedrohungen schützen. Für alle Sites unbedenklich aktivierbar — kein Setup nötig, um loszulegen.
Wie geht's weiter?
- Erweitertes Caching — TTL, Cache-Keys und Cache-Tags feinjustieren
- Dashboard — Traffic überwachen, Cache-Hits einsehen und Site verwalten
- Regeln — Regeln erstellen, um das Verhalten pro Pfad, Land oder Gerät anzupassen
- Wie SSL in smoxy funktioniert — Zertifikatsverwaltung im Detail verstehen