---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.2
alternate:
  - https://sourcecraft.dev/portal/docs/en/vibecraft/operations/attach-domain.md
  - https://sourcecraft.dev/portal/docs/ru/vibecraft/operations/attach-domain.md
  - href: ru/vibecraft/operations/attach-domain.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
title: Привязать домен к проекту Vibecraft
description: Привяжите собственный домен к опубликованному проекту Vibecraft.
---
> **Documentation Index:** Fetch the complete configuration index at https://sourcecraft.dev/portal/docs/ru/llms.txt


# Привязать собственный домен к проекту Vibecraft

_Домен_ — это уникальное символьное имя сайта в интернете, например `example.com`. Собственный домен позволяет открывать опубликованный проект Vibecraft по короткому и запоминающемуся адресу вместо технической ссылки, которая формируется по умолчанию.

Регистрацией доменов занимаются специальные организации — _доменные регистраторы_. В большинстве случаев регистрация домена платная, а ее стоимость зависит от выбранной доменной зоны, например `.ru`, `.com`, `.org`, и регистратора. Регистрацию домена нужно ежегодно продлевать — как правило, за отдельную плату. Не забывайте продлевать регистрацию, иначе вы можете лишиться домена, и он станет доступен для регистрации другими пользователями.

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

{% note warning %}

Функциональность доступна только для плана потребления [Vibecraft Pro](https://sourcecraft.dev/portal/docs/ru/vibecraft/pricing.md).

При привязке домена в Yandex Cloud создаются дополнительные ресурсы, которые тарифицируются отдельно:
* [API-шлюз Yandex API Gateway](https://yandex.cloud/ru/docs/api-gateway/pricing)
* (Опционально) [DNS-зона и ресурсные записи Yandex Cloud DNS](https://yandex.cloud/ru/docs/dns/pricing)

{% endnote %}

Чтобы привязать собственный домен к проекту Vibecraft:
1. [Опубликуйте](https://sourcecraft.dev/portal/docs/ru/vibecraft/operations/deploy.md) проект Vibecraft в Yandex Cloud.
1. Оформите желаемый домен в сервисе регистрации доменных имен.
1. Откройте [главную страницу](https://vibe.sourcecraft.dev) Vibecraft.
1. В разделе ![image](../../_assets/console-icons/circles-4-square.svg) **Проекты** выберите нужный проект.
1. В правом верхнем углу нажмите ![image](../../_assets/console-icons/gear.svg) **Настройки**.
1. В открывшемся окне на вкладке ![image](../../_assets/console-icons/globe.svg) **Домены** нажмите ![image](../../_assets/console-icons/plus.svg) **Добавить домен**.
1. В поле ввода укажите домен, который хотите привязать, например `example.com` или `www.example.com`. Подробности об ограничениях для корневого (apex) домена — в следующем пункте.
1. Выберите тип привязки домена — он определяет, как будут настраиваться ресурсные записи для домена:

    * **Yandex Cloud DNS** — рекомендуемый вариант, при котором дальнейшая привязка домена происходит автоматически. Поддерживаются корневые домены, например `example.com`, и поддомены, например `www.example.com`.

      Чтобы использовать этот вариант, делегируйте управление доменом в [Yandex Cloud DNS](https://yandex.cloud/ru/docs/dns/concepts/). Для этого в личном кабинете вашего доменного регистратора укажите адреса NS-серверов `ns1.yandexcloud.net.` и `ns2.yandexcloud.net.` _Указывайте адреса вместе с завершающей точкой — она является частью полного доменного имени (FQDN)._

      [Пример настройки NS-серверов на Рег.ру](https://help.reg.ru/support/dns-servery-i-nastroyka-zony/rabota-s-dns-serverami/kak-propisat-dns-dlya-domena-v-lichnom-kabinete-reg-ru)

      {% note warning %}

      Домен не должен быть добавлен в существующую [DNS-зону](https://yandex.cloud/ru/docs/dns/concepts/dns-zone) ни в одном каталоге Yandex Cloud. Иначе при привязке возникнет ошибка `domain is occupied`.

      {% endnote %}

    * **Внешний DNS** — подходит, если доменом управляет сторонний провайдер. В таком случае часть шагов по привязке домена будет выполнена вручную. Привязать можно только поддомен, например `www.example.com`. Корневой (apex) домен для этого варианта не поддерживается.

1. Нажмите **Привязать** и выполните дальнейшие действия в зависимости от выбранного типа привязки:

    {% list tabs group=dns_type %}

    - Yandex Cloud DNS {#yc-dns}

      Дождитесь завершения привязки домена. В Vibecraft будут автоматически выполнены следующие действия:
      1. Выпуск сертификата Let's Encrypt®.
      1. Создание DNS-зоны в Yandex Cloud DNS.
      1. Добавление TXT-записи для проверки прав на домен.
      1. Создание [API-шлюза](https://yandex.cloud/ru/docs/api-gateway/concepts/index) Yandex API Gateway.
      1. Добавление ANAME- или CNAME-записи, которая указывает на URL контейнера Serverless Containers с вашим проектом.

    - Внешний DNS {#custom-dns}

      1. На этапе **Проверка DNS** будут выведены варианты ресурсных записей для проверки прав на домен. Скопируйте тип, имя и значение одной из записей из интерфейса Vibecraft и добавьте их у вашего DNS-провайдера:

          #|
          || **Тип** | **Имя** | **Значение** ||
          || TXT | `_acme-challenge.<ваш_поддомен>.` | `<токен_подтверждения>` ||
          || CNAME | `_acme-challenge.<ваш_поддомен>.` | `<идентификатор>.cm.yandexcloud.net.` ||
          |#

          Значения `<токен_подтверждения>` и `<идентификатор>` генерируются автоматически. Их полные значения показаны в интерфейсе Vibecraft на этапе **Проверка DNS**.

          Обновление DNS-записей может занять до 72 часов. Дождитесь, пока запись будет проверена, и начнется следующий этап.

          [Пример настройки ресурсных записей на Рег.ру](https://help.reg.ru/support/dns-servery-i-nastroyka-zony/nastroyka-resursnykh-zapisey-dns/nastroyka-resursnykh-zapisey-dns-dlya-domena)

      1. После выпуска сертификата удалите у DNS-провайдера TXT- или CNAME-запись, которую вы добавили для проверки прав на домен.
      1. На этапе **Привязка CNAME** будет выведена CNAME-запись, которая указывает на URL контейнера Serverless Containers с вашим проектом. Скопируйте значение из интерфейса Vibecraft и добавьте запись у своего DNS-провайдера:

          #|
          || **Тип** | **Имя** | **Значение** ||
          || CNAME | `<ваш_поддомен>.` | `<идентификатор>.apigw.yandexcloud.net.` ||
          |#

    {% endlist %}

Прогресс привязки отображается на этапах: **Инициализация** → **Выпуск сертификата** → **Проверка DNS** → **Привязка CNAME** → **Готово**.

После выпуска сертификата на почту, привязанную к учетной записи SourceCraft, придет письмо от Yandex Cloud о выпуске сертификата Let's Encrypt® для вашего сайта.

После завершения всех этапов проект будет доступен на вашем домене.

### Полезные ссылки {#see-also}

* [Как начать работать с Vibecraft](https://sourcecraft.dev/portal/docs/ru/vibecraft/index.md)
* [Опубликовать проект Vibecraft в Yandex Cloud](https://sourcecraft.dev/portal/docs/ru/vibecraft/operations/deploy.md)
* [Обзор сервиса Vibecraft](https://sourcecraft.dev/portal/docs/ru/vibecraft/concepts/index.md)
* [Вопросы и ответы про Vibecraft](https://sourcecraft.dev/portal/docs/ru/vibecraft/qa.md)
* [Квоты и лимиты в Vibecraft](https://sourcecraft.dev/portal/docs/ru/vibecraft/concepts/limits.md)
* [Правила тарификации для Vibecraft](https://sourcecraft.dev/portal/docs/ru/vibecraft/pricing.md)
* [Yandex Cloud DNS](https://yandex.cloud/ru/docs/dns/concepts/)
* [Certificate Manager](https://yandex.cloud/ru/docs/certificate-manager/concepts/)