Домены раздачи и CNAME

Каждый CDN-ресурс раздаёт контент на техническом домене <slug>.cdn.xipher.ru — сразу после создания, без настроек. Чтобы контент отдавался с вашего имени (например, cdn.example.com), добавьте поддомен в ресурс и направьте на технический домен CNAME-запись. Статья — как это сделать правильно.

Технический домен

Неизменяем, генерируется панелью при создании ресурса, виден в карточке в блоке «Источник и домены раздачи» с кнопкой копирования. Он всегда работает: даже до подключения своих доменов контент уже отдаётся по HTTPS на техническом домене — удобно для проверки до трогания DNS.

Добавление своего домена раздачи

Карточка ресурса → блок «Свои домены раздачи» → «+ Добавить домен».
Введите ваш поддомен, например cdn.example.com, подтвердите.
Панель покажет запись для создания у вашего DNS-провайдера:

cdn.example.com.  CNAME  ваш-slug.cdn.xipher.ru.

Создайте запись у провайдера и нажмите «Проверить» (дальше проверка идёт автоматически).

Лимит: до 2 своих доменов на ресурс (плюс технический домен — всего 3 имени раздачи). Нужно больше — распределите по нескольким ресурсам.

Статусы проверки CNAME

Статус	Значение	Что делать
«Ожидаем CNAME»	Запись ещё не создана	Создайте запись у провайдера
«CNAME не найден»	Записи нет или DNS не разошёлся	Проверьте запись, подождите TTL
«CNAME подтверждён»	Всё работает	Ничего

Важно: CNAME должен указывать на технический домен ресурса, а не на IP или чужой домен — иначе проверка не пройдёт, а трафик не попадёт в вашу сеть.

Проверка результата

dig +short cdn.example.com возвращает технический домен. https://cdn.example.com/файл.png отдаёт контент с сертификатом на ваше имя. В карточке домен — со статусом «CNAME подтверждён».

Если что-то пошло не так

Симптом	Причина	Что делать
«CNAME не найден» часами	TTL у провайдера большой / запись с опечаткой	Проверьте посимвольно; `dig` покажет, что реально резолвится
Сертификат не выпускается на поддомен	CNAME не подтверждён	Сначала подтверждение CNAME, сертификат за ним
Поддомен открывает не контент ресурса	CNAME указывает мимо тех.домена	Перенаправьте CNAME на `<slug>.cdn.xipher.ru`

Частые вопросы

Можно ли подключить корневой домен example.com?

Стандарт DNS запрещает CNAME в корне зоны. Раздачу на корне организуют через DNS-провайдера с функцией CNAME-flattening (или ANAME) — если ваш провайдер это умеет, направьте корень на технический домен. Надёжнее — выделять под раздачу поддомен cdn./static./files.

Свой SSL на поддомен нужен?

Нет: сертификат на домены раздачи выпускается автоматически после подтверждения CNAME.

Зачем отдельный CDN-ресурс, если можно подключить поддомен как сайт?

Ресурс — быстрый путь для чистой раздачи с источником и минимумом настроек. Сайт — полный набор (правила, WAF-карточка, страницы ошибок). Файловое хранилище удобно ресурсом, веб-приложение — сайтом.