
- Создайте зону
Меню «CDN» → «Новая зона». Источник — сервис Hangar (выберите проект и сервис) или адрес сайта
https://…. - Получите адрес
Зона сразу получает адрес вида
cdn-statika-1a2b.apps.hangar.restс HTTPS — его можно ставить на сайт. - Подключите свой домен
Вкладка «Домены»: TXT-запись
_hangar-challengeи CNAME на адрес зоны. Сертификат Let’s Encrypt выпустится сам. - Очищайте после релиза
Вкладка «Очистка»: всё сразу или отдельные пути. Применяется за секунды.
Что кэшируется#
- Статика — css, js, картинки, шрифты, видео, pdf — хранится 7 дней (переключатель «Кэшировать статику»).
- Остальное — как скажут заголовки источника
Cache-ControlиExpires;privateиno-storeне хранятся. Если источник молчит — срок из настроек зоны (по умолчанию 1 час, можно «не кэшировать»). - Мимо кэша — запросы с cookies или
Authorizationи ответы сSet-Cookie: личные страницы не попадут к чужим посетителям. - Свои правила —
/static/*(начало пути),*.css(расширение),/robots.txt(точный путь): срок хранения или «мимо кэша». Первое подходящее правило решает.
В ответе CDN есть заголовок X-Cache: HIT — из кэша, MISS — от источника (и сохранено), BYPASS — мимо кэша. Age — сколько секунд копия в кэше.
curl -sI https://cdn-shop-1a2b.apps.hangar.rest/app.js | grep -i -E 'x-cache|age'
# X-Cache: HIT
# Age: 42Источник#
Сервис Hangar CDN достаёт изнутри платформы: публичный адрес сервису не нужен, а снаружи до него по-прежнему не добраться. Если сервис уснул, первый запрос его разбудит (CDN ответит «повторите через несколько секунд»). Внешний сайт берётся по публичному адресу; внутренние адреса как источник запрещены.
Статистика и цена#
Вкладка «Обзор» — запросы за сутки, 7 и 30 дней, доля ответов из кэша, трафик клиентам и к источнику, объём кэша. Трафик CDN оплачивается за гигабайт и списывается с баланса вместе с остальным расходом — см. Оплата.
API#
GET /v1/workspaces/{id}/cdn-zones # зоны и счётчики за сутки
POST /v1/workspaces/{id}/cdn-zones {"name", "origin_kind": "service", "service_id", "port"} или {"origin_kind": "url", "url"}
GET /v1/cdn-zones/{id} # зона, домены, история очисток
PATCH /v1/cdn-zones/{id} {"default_ttl", "respect_origin", "ignore_query", "cache_static", "rules", "disabled"}
POST /v1/cdn-zones/{id}/purge {"all": true} или {"paths": ["/static/"]}
GET /v1/cdn-zones/{id}/stats?range=24h|7d|30d
POST /v1/cdn-zones/{id}/domains {"domain": "static.shop.ru"}
DELETE /v1/cdn-zones/{id}
