Schnellstart
Pull-Zone anlegen, auf Ihr Origin zeigen lassen, Traffic auf den vergebenen Hostnamen schicken. Kein Agent, kein Sidecar, am Origin ist nichts zu installieren.
# 1
$ arclight zones create --name assets --origin https://origin.example.com
✓ zone assets created
hostname: assets.sonata.lunarsymphony.store
# 2
CNAME cdn.example.com -> assets.sonata.lunarsymphony.store
# 3
$ curl -sI https://cdn.example.com/logo.svg | grep -i x-cache
x-cache: HIT, AMS
TLS wird automatisch ausgestellt und erneuert, sobald der CNAME auflöst. HTTP/2 und HTTP/3 sind standardmäßig aktiv.
Cache-Regeln
Standardmäßig respektieren wir das Cache-Control Ihres Origins. Pro Pfad überschreiben, wenn das Origin nicht änderbar ist.
{
"rules": [
{ "match": "/static/*", "edge_ttl": "365d", "browser_ttl": "7d" },
{ "match": "/api/*", "edge_ttl": "0s", "bypass_cookie": "session" },
{ "match": "*.jpg", "edge_ttl": "30d", "optimize": "auto" }
]
}
Regeln greifen von oben nach unten, die erste Übereinstimmung gewinnt. Eine Regel mit edge_ttl: 0s terminiert weiterhin TLS und nutzt die Origin-Verbindung weiter — dynamische Pfade bekommen das Netz ohne Caching.
Purge
Purges erreichen jeden Standort in unter 150 ms. Nach URL, nach Präfix oder nach Surrogate-Key.
$ curl -X POST https://api.sonata.lunarsymphony.store/v1/zones/assets/purge \
-H "Authorization: Bearer $TOKEN" \
-d '{"keys": ["product-4192"]}'
202 {"purged": 141, "took_ms": 118}
Markieren Sie Antworten am Origin mit Surrogate-Key: product-4192 catalogue — ein Aufruf invalidiert die ganze Produktseite, überall.
CLI
Das CLI ist eine einzelne statische Binary und spricht dieselbe API wie Ihr Dashboard.
$ arclight zones list
NAME ORIGIN HIT RATIO EGRESS 30d
assets origin.example.com 96.4% 2.1 TB
video s3.eu-central.example.com 91.8% 18.7 TB
$ arclight tail --zone assets --status 5xx
Edge-Funktionen
Funktionen laufen auf derselben Maschine, die den Cache ausliefert. Ein Rewrite oder eine Auth-Prüfung kostet Mikrosekunden statt eines Roundtrips.
export default async function (request, ctx) {
const country = ctx.geo.country;
if (country === "JP")
return ctx.rewrite("/jp" + new URL(request.url).pathname);
return ctx.next();
}
Deploys sind netzweit atomar. Ein Rollback ist die vorige Version, sofort hochgezogen.
Logs & Metriken
Jede Anfrage erzeugt am Edge eine strukturierte Logzeile. Streamen Sie sie in Ihre eigene Senke oder fragen Sie 30 Tage im Dashboard ab.
{"ts":"2026-05-14T08:21:07Z","pop":"FRA","status":200,"cache":"HIT",
"ttfb_ms":6,"bytes":48210,"host":"cdn.example.com","path":"/logo.svg"}
Etwas fehlt? Schreiben Sie an den Support — es antwortet ein Mensch aus dem Delivery-Team.