Документация

1. Подключение домена через CNAME

Добавьте домен в личном кабинете и получите технический адрес вида example-com.cdn.msk.vkname.com. Затем создайте у вашего DNS-провайдера запись для поддомена, который будет отдавать контент через сеть:

static.example.com.   300   IN   CNAME   example-com.cdn.msk.vkname.com.

Изменения DNS распространяются от 5 минут до нескольких часов. Для корневого домена используйте записи ALIAS или ANAME, если их поддерживает ваш провайдер.

2. Проверка работы

Отправьте запрос и убедитесь, что ответ пришёл с одного из узлов сети. Заголовок X-CDN-Node содержит идентификатор узла, а X-Cache — признак попадания в кэш:

$ curl -sI https://static.example.com/css/main.css
HTTP/2 200
content-type: text/css
cache-control: public, max-age=86400
x-cdn-node: RU-MOW-03
x-cache: HIT
age: 1184

3. Заголовки кэширования

Время хранения определяется заголовками вашего сервера. Рекомендуемые значения:

Ответы с заголовком Set-Cookie по умолчанию не кэшируются.

4. Очистка кэша через API

Запросы к API авторизуются токеном, который создаётся в разделе «Доступ» личного кабинета. Очистить можно конкретные адреса, префикс или все объекты с заданным тегом:

curl -X POST https://msk.vkname.com/api/v1/purge \
  -H "Authorization: Bearer $CDNEDGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"zone":"example-com","urls":["https://static.example.com/css/main.css"]}'

Ответ при успешной постановке задачи:

{"status":"accepted","task_id":"pg_8f2c41d7","eta_seconds":5}

Чтобы очистить по тегу, передайте "tags":["catalog"] вместо списка адресов. Лимит — 600 запросов в минуту на токен.

5. Коды ответов API

Нужна помощь?

Напишите на support@msk.vkname.com — инженеры помогут с настройкой и проверкой DNS.