На этой странице
CDN-зона
CDN-зона: запросы из кэша и от источника, трафик, адрес зоны.
  1. Создайте зону

    Меню «CDN» → «Новая зона». Источник — сервис Hangar (выберите проект и сервис) или адрес сайта https://….

  2. Получите адрес

    Зона сразу получает адрес вида cdn-statika-1a2b.apps.hangar.rest с HTTPS — его можно ставить на сайт.

  3. Подключите свой домен

    Вкладка «Домены»: TXT-запись _hangar-challenge и CNAME на адрес зоны. Сертификат Let’s Encrypt выпустится сам.

  4. Очищайте после релиза

    Вкладка «Очистка»: всё сразу или отдельные пути. Применяется за секунды.

Что кэшируется#

  • Статика — 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}