Связаться с намиПопробовать бесплатно

CDN-ресурс

Статья создана
Обновлена 13 января 2026 г.

Ресурс — это основная логическая сущность сервиса Yandex Cloud CDN, позволяющая настраивать и управлять распространением контента с источников через CDN. Распространение контента осуществляется через точки присутствия.

Чтобы начать распространять контент через CDN, нужно создать ресурс по инструкции, указав в нем:

После создания ресурса в нем также можно настроить:

Доступ к ресурсу можно ограничить с помощью защищенных токенов и политики доступа по IP-адресам.

Можно настроить перенаправление запросов от CDN-ресурса к источнику, изменив URI запроса с помощью правила Rewrite.

Важно

При создании каждого CDN-ресурса и каждой группы источников за ними закрепляется конкретный провайдер. Изменить закрепленного провайдера нельзя.

Для CDN-ресурса с провайдером EdgeCDN можно задать дополнительные настройки. Полная функциональность описана в документации API CDN-провайдера. Чтобы включить дополнительные опции, запросите доступ к ним в технической поддержке.

Настройки ресурса начинают действовать через некоторое время после создания или изменения ресурса. На это может потребоваться до 15 минут.

Доменные имена для раздачи контента

Доменные имена для раздачи контента используются в запросах клиентов к CDN-серверам. Например, чтобы файл styles/common.css был доступен по адресу cdn.example.com/styles/common.css, нужно указать доменное имя cdn.example.com.

В Cloud CDN поддерживаются любые доменные имена, в том числе IDN с символами национальных алфавитов не из ASCII, например кириллическими. Такие имена можно указывать в исходном виде (пример.рф) или преобразовывать в Punycode с добавлением префиксов xn-- (xn--e1afmkfd.xn--p1ai). В информации о ресурсе в консоли управления IDN будут отображаться в исходном виде, без преобразования в Punycode.

При создании ресурса нужно указать хотя бы одно доменное имя. Первое имя является основным, его нельзя изменить после создания ресурса.

Для корректной работы ресурса у вас должны быть:

  • Права на все указанные доменные имена.

  • Доступ к настройкам DNS для имен.

    Для каждого имени в настройках вашего DNS-хостинга нужно создать CNAME-запись, связывающую это имя с доменным именем CDN-балансировщика вида e1b83ae3********.topology.gslb.yccdn.ru или cl-msa87*****.edgecdn.ru в зависимости от используемого провайдера CDN. Оно отображается при создании ресурса и на странице уже созданного ресурса в консоли управления. Например, так может выглядеть запись для доменного имени cdn.example.com:

    cdn.example.com. CNAME e1b83ae3********.topology.gslb.yccdn.ru

Примечание

Нельзя на одном домене второго уровня иметь и CDN-ресурс, и почтовый сервер. Рекомендуем создать два домена:

  • Для контента, распространяемого через CDN. Обратите внимание, что Cloud CDN следует использовать только с ресурсными записями CNAME, поскольку при использовании записи ANAME конечный пользователь получит ответ, не зависящий от его геолокации. Подробнее о CNAME-записях и их ограничениях см. в RFC-1035.
  • Для легковесного контента и почтового сервера. В этом случае вы можете использовать ресурсные записи ANAME и MX.

Время, требуемое на применение настроек

CDN-ресурс начинает корректно работать через некоторое время после создания или изменения:

  • Новый ресурс начнет корректно работать после того, как запись CNAME, которую вы создали в своем DNS-хостинге (см. раздел о доменных именах для раздачи контента), распространится по серверам DNS. На это может потребоваться несколько часов.

  • Чтобы новые настройки существующего ресурса применились к CDN-серверам, может потребоваться до 15 минут. После этого рекомендуется очистить кеш ресурса.

Статусы ресурса

Ресурс Cloud CDN может быть в одном из статусов:

Для переключения используется опция Доступ конечных пользователей к контенту в основных настройках ресурса.

Если к ресурсу в течение 90 дней нет пользовательских запросов, он переходит в статус Not active.

Статистика использования ресурса

Cloud CDN предоставляет метрики использования ресурса за последние 30 дней:

  • Загружено из источников — объем трафика, загруженного CDN-серверами из источников.
  • Отправлено клиентам — объем трафика, отправленного с CDN-серверов клиентам.
  • Весь трафик — сумма метрик Загружено из источников и Отправлено клиентам.
  • Запросы от клиентов — количество запросов клиентов к CDN.
  • Ответы из кеша — количество запросов клиентов, в ответ на которые CDN-серверы отправили кешированные копии файлов, не запрашивая их у источников (если кеширование на CDN-серверах включено).
  • Ответы с запросами к источникам — количество запросов клиентов, в ответ на которые CDN-серверы не смогли отправить кешированные копии файлов (например, кеширование отключено, файл еще не кешировался сервером или время жизни кеша истекло) и обратились за ними к источникам.
  • Снижение нагрузки на источники — доля трафика, отправленного с CDN-серверов клиентам, за которым не потребовалось обращаться к источникам. Рассчитывается по формуле (1 − (Загружено из источников / Отправлено клиентам)) × 100%.
  • Загружено экранирующим сервером — объем трафика, загруженного экранирующим сервером из источников (если экранирование включено).
  • Ответы с кодами 2xx, 3xx, 4xx, 5xx — количество ответов, отправленных CDN-серверами клиентам, с соответствующими HTTP-кодами состояния.

Посмотреть статистику можно на странице ресурса в консоли управления.

Метрики Monitoring

Cloud CDN автоматически отправляет метрики работы ресурсов в сервис Yandex Monitoring.

Вы можете посмотреть статистику работы на странице ресурса или в интерфейсе Monitoring.

Метрики Cloud CDN обновляются в среднем раз в 3 минуты.

Примечание

Из-за технических особенностей метрики от CDN-провайдера EdgeЦентр экспортируются из Yandex Monitoring в формате Prometheus с задержкой, значения времени в метриках сдвинуто на 10–15 минут вперед относительно их реального значения. Например, значение метрики, выгруженной в формате Prometheus, для 01:00 будет соответствовать реальному значению в промежутке от 00:45 до 00:50.

При просмотре метрик в интерфейсе Monitoring временные значения метрик соответствуют реальным.

Список метрик, передаваемых в Monitoring, представлен в справочнике.

Примеры использования

См. также

Предыдущая
Точки присутствия
Следующая
Источники и их группы