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

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

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

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

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

Подготовка: типы записей DNS

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

Тип Описание Эксклюзивные
A Эти записи содержат значения IPv4 (например, 8.8.8.8), которые сообщают браузерам, какой адрес использовать при попытке связаться с вашим доменом. Да
AAAA Эти записи содержат значения 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... позволяет Менеджеру сертификатов создавать и обновлять сертификаты. После регистрации эту запись нельзя удалять, иначе сертификат перестанет действовать.
 Да
TXT Эти записи позволяют прикреплять к домену произвольные метаданные. App Hosting позволяет использовать специальный формат записи TXT, fah-claim=[UUID], чтобы указать, какой собственный домен должен обслуживаться в вашем домене. Нет
CAA Эти записи работают как белый список, в котором указаны центры сертификации, уполномоченные выпускать SSL-сертификаты для вашего домена. App Hosting запрашивает записи CAA, только если не может выпустить сертификаты для вашего домена. Нет

Подготовка: собственное доменное имя

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

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

Тип домена Собственное доменное имя
Домен Apex

Вот примеры таких данных:

  • @
  • Имя домена верхнего уровня (например, example.com).
  • Оставьте поле Host (Хост) пустым.
Субдомен

Вот примеры таких данных:

  • Полное название субдомена, например app.example.com.
  • Только субдомен (например, app, без .example.com).

Популярные регистраторы доменов

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

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

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

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

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

Шаг 2. Подготовьте домен

  1. В мастере Настройка домена выберите вкладку Перенос домена.
  2. Следуйте инструкциям на первом шаге Подготовка домена, который включает набор изменений, необходимых для того, чтобы App Hosting обслуживал предпочитаемый вами сервер и устанавливал безопасные TLS-соединения для вашего домена. Добавьте, удалите и сохраните записи домена у поставщика услуг DNS, используя следующие входные данные для обязательных записей:
    • Name (Имя). Введите имя собственного домена для записей. Хост – это домен, на котором вы хотите размещать контент. Это может быть домен верхнего уровня или субдомен. Регистратор домена может использовать для этого поля название "Имя хоста", "Имя" или "Домен".
    • Тип записи. Добавьте предоставленную запись DNS.
    • Значение. Назначьте записям указанное значение. Регистратор домена может использовать для этого термина другие названия, например "Данные", "Указывает на", "Контент", "Адрес" или "IP-адрес". Содержимое поля значения зависит от типа записи. Например, записи TXT представляют собой строки.
  3. Нажмите Проверить записи. App Hosting попытается обнаружить изменения, которые вы внесли у регистратора домена. Изменения вступят в силу в течение 24 часов. Проверить статус можно в разделе Settings (Настройки) > Domains (Домены) на панели управления.

Шаг 3. Перенаправление на App Hosting

  1. После того как App Hosting проверит изменения записей, внесенные на предыдущем шаге, мастер перейдет к последнему шагу – Перенаправление в App Hosting. На этом шаге вы увидите, какие изменения нужно внести в записи, чтобы направить трафик домена на серверы App Hosting. Как и ранее, добавьте, удалите и сохраните записи из домена у поставщика услуг DNS, указав следующие данные для обязательных записей:
    • Name (Имя). Введите имя собственного домена для записей. Хост – это домен, на котором вы хотите размещать контент. Это может быть домен верхнего уровня или субдомен. Регистратор домена может использовать для этого поля название "Имя хоста", "Имя" или "Домен".
    • Тип записи. Добавьте предоставленную запись DNS.
    • Значение. Назначьте записям указанное значение. Регистратор домена может использовать для этого термина другие названия, например "Данные", "Указывает на", "Контент", "Адрес" или "IP-адрес". Содержимое поля значения зависит от типа записи. Например, записи TXT представляют собой строки.
  2. Нажмите Проверить записи. App Hosting попытается обнаружить изменения, которые вы внесли у регистратора домена. Изменения вступят в силу в течение 24 часов. Проверить статус можно в разделе Settings (Настройки) > Domains (Домены) на панели управления.

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

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

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

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

Шаг 2. Проверьте записи DNS

  1. Мастер Настройка домена в консоли Firebase покажет, какие записи нужно обновить, чтобы направить страницу на Firebase App Hosting. Добавьте, удалите и сохраните записи домена у поставщика услуг DNS, используя следующие данные:
    • Name (Имя). Введите имя собственного домена для записей. Хост – это домен, на котором вы хотите размещать контент. Это может быть домен верхнего уровня или субдомен. Регистратор домена может использовать для этого поля название "Имя хоста", "Имя" или "Домен".
    • Тип записи. Добавьте предоставленную запись DNS.
    • Значение. Назначьте записям указанное значение. Регистратор домена может использовать для этого термина другие названия, например "Данные", "Указывает на", "Контент", "Адрес" или "IP-адрес". Содержимое поля значения зависит от типа записи. Например, записи TXT представляют собой строки.
  2. Нажмите Проверить записи. App Hosting попытается обнаружить изменения, которые вы внесли у регистратора домена. Изменения вступят в силу в течение 24 часов. Проверить статус можно в разделе Settings (Настройки) > Domains (Домены) на панели управления.

Дождитесь инициализации SSL-сертификата

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

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

Примечание. 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-сертификат.
Вы можете показывать контент своего сайта.