Dokumentation

Zum ersten Cache-Treffer

Hostnamen aufs Netz zeigen lassen, eine Cache-Regel setzen — und Sie liefern vom Edge. Alles hier verhält sich an jedem Standort gleich.

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.