Поддержка нескольких доменных имен с помощью консоли управления, CLI или API

Статья создана

Улучшена

Обновлена 14 ноября 2025 г.

Создайте бакеты
Настройте статический сайт для основного домена
Настройте переадресацию для дополнительного домена
Проверьте работу нескольких доменов

Чтобы создать инфраструктуру для поддержки нескольких доменных имен сайта с помощью консоли управления Yandex Cloud, CLI или API:

Создайте бакеты

Создайте бакеты и назовите их в соответствии с доменными именами, например example.com и example2.com.

Создайте бакет для основного доменного имени example.com:
Консоль управления

Yandex Cloud CLI

API
1. В консоли управления выберите каталог, в котором хотите создать бакет.
2. Перейдите в сервис Object Storage.
3. На панели сверху нажмите Создать бакет.
4. На странице создания бакета:
  1. Введите имя бакета в соответствии с основным доменным именем сайта, например example.com.
    
    Примечание
    
    Имена бакетов должны совпадать с доменными именами.
  2. Задайте максимальный размер бакета.
  3. Включите Для всех — доступ для любых пользователей.
  4. Выберите класс хранилища по умолчанию — Стандартное.
  5. Нажмите Создать бакет для завершения операции.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.
1. Посмотрите описание команды CLI для создания бакета:
  yc storage bucket create --help
2. Создайте бакет в каталоге по умолчанию:
  yc storage bucket create --name <имя_бакета> \ --public-read \ --public-list
  Где
  - --name — имя бакета в соответствии с основным доменным именем сайта, например example.com.
    
    Примечание
    
    Имена бакетов должны совпадать с доменными именами.
  - --public-read — включить публичный доступ на чтение объектов в бакете.
  - --public-list — включить публичный доступ на просмотр списка объектов в бакете.
  Результат:
  name: example.com folder_id: b1geoelk7fld******** anonymous_access_flags: read: true list: true default_storage_class: STANDARD versioning: VERSIONING_DISABLED created_at: "2025-08-08T09:12:45.743187Z" resource_id: e3etgi7l43gs********
Чтобы создать бакет, воспользуйтесь методом REST API create для ресурса Bucket, вызовом gRPC API BucketService/Create или методом S3 API create.
Создайте бакет для дополнительного доменного имени example2.com, повторив шаги выше.

Настройте статический сайт для основного домена

Настройте статический сайт для бакета и свяжите его с основным доменным именем example.com:

Настройте бакет example.com в качестве хостинга статического сайта.
Консоль управления

Yandex Cloud CLI

API
1. В консоли управления выберите каталог.
2. Перейдите в сервис Object Storage.
3. Выберите бакет, для которого хотите настроить хостинг.
4. На панели слева выберите Настройки.
5. Выберите вкладку Веб-сайт.
6. В разделе Хостинг:
  - В поле Главная страница укажите абсолютный путь к файлу в бакете для главной страницы сайта, например index.html.
    
    Важно
    
    Ключ объекта с главной страницей сайта не может содержать символ /.
  - (опционально) В поле Страница ошибки укажите абсолютный путь к файлу в бакете, который будет отображаться при ошибках 4xx, например pages/error404.html. По умолчанию Object Storage возвращает собственную страницу.
7. Нажмите кнопку Сохранить.
Проверить хостинг можно, перейдя по ссылке в поле Ссылка.
1. Посмотрите описание команды CLI для настройки хостинга статического сайта в бакете:
  yc storage bucket update --help
2. Создайте файл с настройками хостинга в формате JSON. Например:
  { "index": "index.html", "error": "error404.html" }
  Где:
  - index — абсолютный путь к файлу главной страницы сайта.
    
    Важно
    
    Ключ объекта с главной страницей сайта не может содержать символ /.
  - error — абсолютный путь к файлу, который будет отображаться пользователю при ошибках 4xx.
3. Выполните следующую команду:
  yc storage bucket update --name <имя_бакета> \ --website-settings-from-file <путь_к_файлу>
  Где:
  - --name — имя бакета.
  - --website-settings-from-file — путь к файлу с настройками хостинга.
  Результат:
  name: my-bucket folder_id: b1gjs8dck8bv******** default_storage_class: STANDARD versioning: VERSIONING_SUSPENDED max_size: "10737418240" acl: {} created_at: "2022-12-14T08:42:16.273717Z"
Чтобы убедиться, что настройки хостинга появились в описании бакета, выполните команду:
```
yc storage --name <имя_бакета> bucket get --full
```
Результат:
```
website_settings:
  index: index.html
  error: error404.html
  redirect_all_requests: {}
```
Чтобы настроить хостинг статического сайта, воспользуйтесь методом REST API update для ресурса Bucket, вызовом gRPC API BucketService/Update или методом S3 API upload.
Свяжите доменное имя example.com и соответствующий бакет.
1. Создайте на DNS-сервере публичную зону DNS и ресурсную запись, которая связывает ваше доменное имя и бакет:
  Yandex Cloud DNS
  
  Внешний DNS-сервер
  Важно
  
  Использование сервиса Cloud DNS тарифицируется, подробнее см. Правила тарификации для Cloud DNS.
  1. В консоли управления выберите каталог.
  2. Перейдите в сервис Object Storage.
  3. Выберите бакет, для которого хотите использовать собственный домен.
  4. На панели слева выберите Настройки и перейдите на вкладку Веб-сайт.
  5. В разделе Хостинг в блоке Домены в Cloud DNS нажмите кнопку Создать запись.
    
    Примечание
    
    В блоке Домены в Cloud DNS раздела Хостинг отображаются только те домены, которые были созданы непосредственно в этом интерфейсе. Если запись была создана в сервисе Cloud DNS, то в этом блоке она отображаться не будет.
  6. В открывшемся окне нажмите кнопку Создать зону и выберите доменную зону, которая соответствует имени бакета, например example.com. Нажмите кнопку Создать.
  7. Раскройте блок Дополнительные настройки.
  8. В поле TTL (в секундах) укажите время жизни ресурсной записи или выберите из предложенных.
  9. Нажмите кнопку Создать.
  10. Нажмите кнопку Сохранить.
  Чтобы получить доступ к именам из публичной зоны, делегируйте домен. Для этого в личном кабинете вашего доменного регистратора укажите адреса серверов ns1.yandexcloud.net и ns2.yandexcloud.net.
  
  Делегирование домена и обновление ресурсных записей могут занять некоторое время.
  
  Вы также можете создать зону DNS и ресурсную запись средствами Cloud DNS.
  Пример параметров зоны DNS и ресурсной записи
  Параметры зоны DNS:
  
  Зона — example.com..
  
  Тип — публичная.
  
  Параметры ресурсной записи:
  
  Имя Тип TTL Значение
  
  example.com. ANAME 600 example.com.website.yandexcloud.net
  
  Записи ANAME позволяют использовать для хостинга домены второго уровня и, в отличие от CNAME, не ограничивают использование других типов записей в одной с ними зоне.
  Пример параметров зоны DNS:
  - Зона — example.com..
  - Тип — публичная.
  Пример ресурсной записи CNAME:
  example.com CNAME example.com.website.yandexcloud.net
  Чтобы использовать ресурсную запись CNAME, ваше доменное имя должно быть в домене не ниже третьего уровня — это связано с особенностями обработки CNAME-записей на DNS-хостингах. Подробнее см. п. 2.4 RFC 1912.
  
  Обновление ресурсных записей может занять некоторое время.
  В результате статический сайт будет доступен по адресу example.com.
Настройте HTTPS: привяжите к бакету сертификат из Certificate Manager или загрузите свой.

Примечание

Вы можете использовать один сертификат для основного и дополнительного домена или несколько сертификатов для каждого домена.

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

Имя	Тип	TTL	Значение
example.com.	ANAME	600	example.com.website.yandexcloud.net

В результате статический сайт будет доступен по адресу example.com по протоколу HTTPS.

Настройте переадресацию для дополнительного домена

Для бакета с дополнительным доменным именем example2.com:

Настройте в бакете example2.com переадресацию всех запросов на основной домен example.com и протокол HTTPS.
Консоль управления

Yandex Cloud CLI

API
1. В консоли управления выберите каталог.
2. Перейдите в сервис Object Storage.
3. Выберите бакет, для которого хотите настроить переадресацию всех запросов.
4. На панели слева выберите Настройки.
5. Выберите вкладку Веб-сайт.
6. В разделе Переадресация укажите:
  - Доменное имя — доменное имя, на которое будут переадресованы все запросы, например example.com.
  - Протокол — HTTPS.
7. Нажмите кнопку Сохранить.
1. Посмотрите описание команды CLI для настройки переадресации всех запросов:
  yc storage bucket update --help
2. Создайте файл с настройками переадресации в формате JSON. Например:
  { "redirectAllRequests": { "protocol": "PROTOCOL_HTTPS", "hostname": "example.com" } }
  Где:
  - protocol — протокол передачи данных.
  - hostname — доменное имя хоста, на который будут перенаправляться все запросы к текущему бакету.
3. Выполните следующую команду:
  yc storage bucket update --name <имя_бакета> \ --website-settings-from-file <путь_к_файлу>
  Где:
  - --name — имя бакета.
  - --website-settings-from-file — путь к файлу с настройками переадресации.
  Результат:
  name: example2.com folder_id: b1gjs8dck8bv******** default_storage_class: STANDARD versioning: VERSIONING_SUSPENDED max_size: "10737418240" acl: {} created_at: "2022-12-14T08:42:16.273717Z"
Чтобы настроить переадресацию всех запросов к бакету, воспользуйтесь методом REST API update для ресурса Bucket, вызовом gRPC API BucketService/Update или методом S3 API upload.
Настройте HTTPS: привяжите к бакету сертификат из Certificate Manager или загрузите свой.

Переадресация запросов с HTTP на HTTPS включается автоматически после настройки доступа к бакету по HTTPS. Дополнительных настроек для такой переадресации не требуется.
Свяжите доменное имя example2.com и соответствующий бакет.

Проверьте работу нескольких доменов

Дождитесь выпуска TLS-сертификата и его перехода в статус Issued. После этого убедитесь, что переадресация работает: откройте сайт https://example2.com, и вы будете переадресованы на https://example.com.

См. также

Поддержка нескольких доменных имен с помощью Terraform

Поддержка нескольких доменных имен с помощью консоли управления, CLI или API

Создайте бакетыСоздайте бакеты

Настройте статический сайт для основного доменаНастройте статический сайт для основного домена

Настройте переадресацию для дополнительного доменаНастройте переадресацию для дополнительного домена

Проверьте работу нескольких доменовПроверьте работу нескольких доменов

См. такжеСм. также

Была ли статья полезна?

Создайте бакеты

Настройте статический сайт для основного домена

Настройте переадресацию для дополнительного домена

Проверьте работу нескольких доменов

См. также