Подключите личный домен

Вам не нужно отказываться от уникальных, ориентированных на ваш бренд доменных имен для приложений, развернутых на Firebase App Hosting . Вы можете использовать собственный домен (например, example.com или app.example.com ) вместо домена, сгенерированного Firebase, для вашего сайта, размещенного на Firebase. Firebase App Hosting предоставляет SSL-сертификат для каждого из ваших доменов.

В оставшейся части этого документа описаны шаги по подключению пользовательского домена одним из следующих способов:

• Перенос домена
• Подключите новый домен

Для обеспечения бесперебойной работы необходимо обновлять DNS-записи в определенной последовательности. Следуйте инструкциям по миграции домена , чтобы предотвратить простои в работе вашего приложения.

Если простой в работе не является проблемой, например, при подключении нового домена к вашему веб-приложению, следуйте инструкциям по подключению нового домена .

Перед началом работы: Типы DNS-записей

Мастер настройки домена App Hosting может предложить вам добавить или удалить от 1 до 5 записей DNS в зависимости от текущей конфигурации вашего домена. Тип записи определяет её функцию. Вот типы записей, которые может запросить App Hosting :

Тип	Описание	Эксклюзив
А	Эти записи содержат значения IPv4 (например, 8.8.8.8), которые указывают браузерам, какой адрес использовать при попытке связаться с вашим доменом.	Да
ААААА	Эти записи содержат значения IPv6 (например, 2001:4860:4860::8888), это другой тип адресных записей, выполняющий примерно ту же функцию, что и записи типа A. В настоящее время App Hosting не использует записи AAAA, но попросит вас удалить все существующие записи из нашего домена, если таковые имеются.	Да
CNAME	Эти записи содержат отдельное доменное имя, которое следует использовать вместо вашего текущего домена для разрешения DNS-запросов. Записи CNAME разрешены только для поддоменов (например, www.example.com). App Hosting использует записи CNAME по двум причинам: Упрощенное подключение: по возможности, App Hosting предлагает вам создать запись CNAME для предварительно настроенного домена, начинающегося с _custom-domain... . Проверка SSL-сертификатов: App Hosting использует Cloud Certificate Manager для предоставления SSL-сертификатов для вашего пользовательского домена. Запись CNAME для поддомена _acme-challenge... позволяет Certificate Manager создавать и продлевать сертификаты для вас. После подключения эту запись нельзя удалять , иначе действие вашего сертификата прекратится.	Да
ТЕКСТ	Эти записи позволяют прикреплять к вашему домену произвольные метаданные. App Hosting позволяет использовать определенный формат TXT-записи, например, fah-claim=[UUID] , чтобы указать, какой пользовательский домен он должен обслуживать на вашем домене.	Нет
КАА	Эти записи служат в качестве списка разрешенных центров сертификации, уполномоченных выдавать SSL-сертификаты для вашего домена. App Hosting запрашивает записи CAA только в том случае, если ему запрещено выдавать сертификаты для вашего домена иным образом.	Нет

Перед началом работы: ваше собственное доменное имя

При добавлении или редактировании DNS-записей разные поставщики доменных имен ожидают от вас ввода разных значений в поле «Хост» (или «Имя хоста» ) на своих сайтах управления DNS. Мастер настройки пользовательского домена App Hosting требует ввода одного и того же значения в поле «Имя» .

Ниже мы собрали распространенные варианты ввода данных от популярных провайдеров. Подробные инструкции см. в документации вашего провайдера доменов .

Тип домена	Пользовательское доменное имя
Домен Apex	К числу распространенных входных данных относятся: @ Доменное имя верхнего уровня (например, example .com ) Оставьте поле "Хост" пустым.
Поддомен	К числу распространенных входных данных относятся: Полное имя поддомена (например, app. example .com ) Только часть поддомена (например, только app , без . example .com ).

Распространенные поставщики доменных имен

Ниже приведены некоторые распространенные поставщики доменных имен и типы входных данных, которые могут потребоваться для каждого из них. Эта информация по возможности постоянно обновляется, но для получения подробных инструкций обратитесь к документации вашего поставщика доменных имен .

Клаудфлаер

Хозяин	Вход
example.com.	@
www.example.com.	www

Google Cloud DNS

Хозяин	Вход
example.com.	.example.com.
www.example.com.	www .

NameCheap

Хозяин	Вход
example.com.	@
www.example.com.	www

Squarespace

Хозяин	Вход
example.com.	@
www.example.com.	www

Перенос домена

Если вы хотите перенести свой домен от другого провайдера на App Hosting без простоев, вы можете использовать процесс миграции домена в консоли Firebase. Этот процесс в два этапа подготовит App Hosting к предоставлению контента на вашем домене, прежде чем перенаправлять трафик на серверы App Hosting .

Шаг 1: Добавьте собственный домен

1. Откройте страницу App Hosting вашего проекта.
2. Выберите бэкэнд App Hosting , используя опцию «Просмотреть панель управления» .
3. Выберите вкладку «Настройки» , затем нажмите «Добавить пользовательский домен» .
4. Введите доменное имя, которое вы хотите подключить к своему сайту, App Hosting .
5. (Необязательно) Установите флажок, чтобы перенаправлять все запросы с пользовательского домена на второй указанный домен (так, чтобы example.com и www.example.com перенаправляли на один и тот же контент).
6. Нажмите «Продолжить настройку» , чтобы сконфигурировать DNS-записи и завершить настройку собственного домена.

Шаг 2: Подготовка домена

1. В мастере настройки домена выберите вкладку «Миграция домена» .
2. Следуйте инструкциям на первом шаге «Подготовка домена» , который включает в себя набор изменений, необходимых для того, чтобы App Hosting мог обслуживать предпочитаемый вами бэкэнд и устанавливать безопасные TLS-соединения для вашего домена. Добавьте, удалите и сохраните записи для вашего домена в DNS-провайдере, указав следующие необходимые данные:
   • Имя : Введите ваше собственное доменное имя для записей. Указанный вами хост — это домен, на котором вы хотите размещать контент; это может быть главный домен или поддомен. Ваш поставщик доменных услуг может указывать этот термин как «Имя хоста», «Имя» или «Домен».
   • Тип записи : Добавить предоставленную DNS-запись.
   • Значение : Присвойте предоставленное значение вашим записям. Ваш поставщик доменных услуг может указывать этот термин как «Данные», «Указывает на», «Содержание», «Адрес» или «IP-адрес». Содержимое поля значения различается в зависимости от типа записи; например, записи TXT представляют собой строки.
3. Выберите «Проверить записи» . App Hosting попытается обнаружить изменения, внесенные вами в настройки вашего доменного провайдера. Для распространения изменений может потребоваться до 24 часов. Вы можете проверить статус в разделе «Настройки > Домены» в панели управления.

Шаг 3: Прямая ссылка на App Hosting

1. После того, как App Hosting проверит обновления записей, выполненные на предыдущем шаге, мастер переходит к заключительному шагу «Прямая настройку на App Hosting . На этом шаге отображаются обновления записей, которые необходимо внести для перенаправления трафика вашего домена на серверы App Hosting . Как и прежде, добавьте, удалите и сохраните записи для вашего домена в DNS-провайдере, указав следующие необходимые данные:
   • Имя : Введите ваше собственное доменное имя для записей. Указанный вами хост — это домен, на котором вы хотите размещать контент; это может быть главный домен или поддомен. Ваш поставщик доменных услуг может указывать этот термин как «Имя хоста», «Имя» или «Домен».
   • Тип записи : Добавить предоставленную DNS-запись.
   • Значение : Присвойте предоставленное значение вашим записям. Ваш поставщик доменных услуг может указывать этот термин как «Данные», «Указывает на», «Содержание», «Адрес» или «IP-адрес». Содержимое поля значения различается в зависимости от типа записи; например, записи TXT представляют собой строки.
2. Выберите «Проверить записи» . App Hosting попытается обнаружить изменения, внесенные вами в настройки вашего доменного провайдера. Для распространения изменений может потребоваться до 24 часов. Вы можете проверить статус в разделе «Настройки > Домены» в панели управления.

Подключите новый домен

Если простой в работе не является проблемой, например, при подключении нового домена к вашему веб-приложению, следуйте инструкциям в этом разделе.

Шаг 1: Добавьте собственный домен

1. Откройте страницу App Hosting вашего проекта.
2. Выберите бэкэнд App Hosting , используя опцию «Просмотреть панель управления» .
3. Выберите вкладку «Настройки» , затем нажмите «Добавить пользовательский домен» .
4. Введите доменное имя, которое вы хотите подключить к своему сайту, App Hosting .
5. (Необязательно) Установите флажок, чтобы перенаправлять все запросы с пользовательского домена на второй указанный домен (так, чтобы example.com и www.example.com перенаправляли на один и тот же контент).
6. Нажмите «Продолжить настройку» , чтобы сконфигурировать DNS-записи и завершить настройку собственного домена.

Шаг 2: Проверка DNS-записей

1. Мастер настройки домена в консоли Firebase покажет необходимые записи, которые нужно обновить, чтобы ваша страница указывала на Firebase App Hosting. Добавьте, удалите и сохраните записи для вашего домена в DNS-провайдере, используя следующие данные:
   • Имя : Введите ваше собственное доменное имя для записей. Указанный вами хост — это домен, на котором вы хотите размещать контент; это может быть главный домен или поддомен. Ваш поставщик доменных услуг может указывать этот термин как «Имя хоста», «Имя» или «Домен».
   • Тип записи : Добавить предоставленную DNS-запись.
   • Значение : Присвойте предоставленное значение вашим записям. Ваш поставщик доменных услуг может указывать этот термин как «Данные», «Указывает на», «Содержание», «Адрес» или «IP-адрес». Содержимое поля значения различается в зависимости от типа записи; например, записи TXT представляют собой строки.
2. Выберите «Проверить записи» . App Hosting попытается обнаружить изменения, внесенные вами в настройки вашего доменного провайдера. Для распространения изменений может потребоваться до 24 часов. Вы можете проверить статус в разделе «Настройки > Домены» в панели управления.

Дождитесь завершения процесса предоставления SSL-сертификата.

После обновления DNS-записей настройка SSL-сертификата для вашего домена App Hosting может занять до нескольких часов. В некоторых случаях это может занять до 24 часов после переадресации DNS-записей на Firebase App Hosting .

Вы можете просмотреть этот сертификат с помощью инструментов безопасности браузера. Во время подготовки домена вы можете увидеть недействительный сертификат или столкнуться с проблемами при подключении к вашему домену. Это нормальная часть процесса, и проблема будет решена после того, как сертификат вашего домена станет доступен.

Примечание: Firebase App Hosting автоматически перенастраивает SSL-сертификаты по мере необходимости для пользовательских доменов.

Описания статуса для пользовательских доменов

Статус	Описание
Требуется настройка	Возможно, вам потребуется изменить конфигурацию ваших DNS-записей. В большинстве случаев ваши DNS A-записи не были переданы от вашего поставщика доменных имен на серверы Firebase App Hosting . Совет по устранению неполадок: если прошло более 24 часов, проверьте, правильно ли вы указали Firebase App Hosting в своих записях. В более редких случаях проверка SSL-соединения может завершаться неудачей из-за того, что ваши DNS-записи содержат записи A или CNAME, указывающие на других хостинг-провайдеров. Совет по устранению неполадок: убедитесь, что ваши записи A указывают только на Firebase App Hosting , и удалите все записи CNAME.
В ожидании	Вы правильно настроили свой пользовательский домен, но Firebase App Hosting не выдал SSL-сертификат. Иногда чрезмерно ограничительные записи CAA могут затормозить создание SSL-сертификата для пользовательского домена. Убедитесь, что центрам сертификации `letsencrypt.org` и `pki.goog` разрешено создавать SSL-сертификаты для вашего домена.
Сертификат чеканки	В настоящее время для вашего домена создается SSL-сертификат.
Подключено	Ваш пользовательский домен имеет правильные DNS-записи и SSL-сертификат. Вы можете отображать контент своего сайта.