Подключить CDN к S3

Последнее изменение: 17 июля 2025

к сведению

Это инструкция для подключения CDN к бакету S3 с раздачей контента через персональный домен.

1. Создайте публичный бакет в S3.
2. Создайте CDN-ресурс.
3. Создайте персональный домен для CDN-ресурса.
4. Добавьте персональный домен к CDN-ресурсу.
5. Проверьте CDN-ресурс.

1. Создать публичный бакет

1. В панели управления в верхнем меню нажмите Продукты и выберите S3.

2. Нажмите Создать бакет.

3. Введите имя бакета. Для совместимости с S3 API имя бакета должно быть уникально в рамках S3 и соответствовать правилам именования бакетов Amazon S3, подробнее в инструкции Bucket naming rules документации Amazon.

4. Выберите тип бакета — публичный.

5. Выберите класс хранения:

   • стандартное хранение — для хранения и раздачи часто запрашиваемых данных;
   • холодное хранение — для хранения редко запрашиваемых данных.

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

6. Если вам нужен бакет с Virtual-Hosted адресацией для работы с S3 API, в блоке Тип адресации выберите vHosted. Включить Virtual-Hosted адресацию можно только один раз.

7. Нажмите Создать бакет.

8. Загрузите в бакет статический контент, который нужно раздавать через CDN.

2. Создать CDN-ресурс

1. В панели управления в верхнем меню нажмите Продукты и выберите CDN.
2. Нажмите Создать CDN-ресурс.
3. Введите имя ресурса. Имя не влияет на настройки ресурса и используется только для работы в панели управления.
4. В блоке Источник контента выберите S3 Selectel.
5. Выберите проект, в котором создали публичный бакет с контентом для CDN.
6. Выберите бакет.
7. Нажмите Создать CDN-ресурс.

3. Создать персональный домен для CDN-ресурса

1. Откройте панель управления вашего DNS-хостинга.

2. Создайте домен третьего уровня, например cdn.example.com. Этот домен будет использоваться в качестве персонального домена CDN для раздачи контента.

3. Создайте CNAME-запись:

   • тип записи — CNAME;
   • имя записи — поддомен вида cdn.example.com;
   • значение — домен по умолчанию в формате *.selcdn.net. Посмотреть домен можно в панели управления: в верхнем меню нажмите Продукты → CDN → страница ресурса → вкладка Общий. Указывайте домен без протокола.

4. Добавить персональный домен к CDN-ресурсу

1. В панели управления в верхнем меню нажмите Продукты и выберите CDN.
2. Откройте страницу CDN-ресурса → вкладка Общий.
3. В блоке Персональные домены нажмите Добавить домен.
4. Укажите домен третьего уровня, который вы создали в качестве персонального.
5. Нажмите Подключить.

5. Проверить CDN-ресурс

1. Убедитесь, что после всех настроек прошло не меньше 30 минут — это время необходимо, чтобы CDN-ресурс полноценно заработал.

2. Откройте объект напрямую через хранилище, для этого в панели управления в верхнем меню нажмите Продукты → S3 → страница бакета. В строке любого объекта нажмите на  и перейдите по ссылке в блоке Основной домен.

   Если объект не открывается, возможны проблемы с доступом — например, тип бакета был изменен на приватный или объект был удален.

3. Откройте объект через домен CDN по умолчанию по ссылке вида *.selcdn.net/images/image.png. Если объект не открывается, повторите попытку через некоторое время. Если ошибка сохраняется, очистите кэш и проверьте, что при создании CDN-ресурса выполнили указанные настройки.

4. Откройте объект через персональный домен CDN по ссылке вида cdn.example.com/images/image.png. Если объект не открывается, проверьте корректность CNAME-записи, которую добавили при создании персонального домена.