Быстрый старт
Создайте pull-зону, укажите свой origin и направьте трафик на выданное имя хоста. Ни агента, ни сайдкара — на origin ставить нечего.
# 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 выпускается и продлевается автоматически, как только резолвится CNAME. HTTP/2 и HTTP/3 включены по умолчанию.
Правила кэша
По умолчанию мы учитываем заголовок Cache-Control вашего источника. Переопределяйте по путям, если источник править нельзя.
{
"rules": [
{ "match": "/static/*", "edge_ttl": "365d", "browser_ttl": "7d" },
{ "match": "/api/*", "edge_ttl": "0s", "bypass_cookie": "session" },
{ "match": "*.jpg", "edge_ttl": "30d", "optimize": "auto" }
]
}
Правила проверяются сверху вниз, побеждает первое совпадение. Правило с edge_ttl: 0s всё равно терминирует TLS и переиспользует соединение к origin — динамика получает сеть без кэширования.
Сброс кэша
Сброс расходится по всем точкам меньше чем за 150 мс. Сбрасывайте по URL, по префиксу или по surrogate-ключу.
$ 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}
Помечайте ответы на origin заголовком Surrogate-Key: product-4192 catalogue — и одна команда погасит всю карточку товара во всей сети.
CLI
CLI — один статический бинарник. Он ходит в тот же API, что и панель.
$ 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-функции
Функции выполняются на той же машине, что отдаёт кэш, поэтому переписывание пути или проверка авторизации стоят микросекунды, а не сетевого похода.
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();
}
Деплой атомарен по всей сети. Откат — это предыдущая версия, поднятая мгновенно.
Логи и метрики
Каждый запрос даёт структурированную строку лога на границе. Стримьте их в свой приёмник или смотрите последние 30 дней в панели.
{"ts":"2026-05-14T08:21:07Z","pop":"FRA","status":200,"cache":"HIT",
"ttfb_ms":6,"bytes":48210,"host":"cdn.example.com","path":"/logo.svg"}
Не нашли нужного? Напишите в поддержку — отвечает живой инженер команды доставки.