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

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

Firebase Hosting предоставляет сертификат SSL для каждого из ваших доменов и передает ваш контент через глобальную CDN.

В оставшейся части документа описаны шаги по подключению личного домена.

Настройте свой домен для Hosting

Убедитесь, что вы завершили работу мастера «Начало работы» на странице Firebase Hosting вашего проекта, чтобы у вас был сайт Firebase Hosting в вашем проекте Firebase.

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

  1. На странице Hosting вашего проекта войдите в мастер подключения личного домена:

    • Если у вас только один Hosting сайт, нажмите «Добавить личный домен» .
    • Если у вас несколько Hosting сайтов , нажмите « Просмотреть» для нужного сайта, затем нажмите «Добавить собственный домен» .

  2. Введите собственное доменное имя, которое вы хотите подключить к своему Hosting сайту.

  3. (Необязательно) Установите флажок, чтобы перенаправлять все запросы в личном домене на второй указанный домен (например, example.com и www.example.com перенаправляются на один и тот же контент).

  4. Нажмите «Продолжить» , чтобы настроить записи DNS и завершить настройку личного домена.

Шаг 2. Настройка личного домена

Если появится запрос в мастере настройки подключения домена , подтвердите свой домен вершины.

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

  1. На сайте вашего провайдера домена найдите страницу управления DNS.

  2. Добавьте и сохраните новую запись со следующими входными данными:

    • Введите : добавьте запись TXT.

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

      Ваш провайдер домена может указать этот термин как «Тип записи».

    • Хост : Введите ключ домена apex .

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

      Ваш провайдер домена может указать этот термин как «Имя хоста», «Имя» или «Домен».

    • Значение : скопируйте уникальное значение проверки в поле.

      Firebase Hosting проверяет это значение, чтобы подтвердить ваше право собственности на домен.

      Ваш провайдер домена может указать этот термин как «Данные».

  3. Подождите до 24 часов для распространения обновленных записей TXT, затем нажмите «Подтвердить» .

    Обратите внимание, что вы можете нажать «Отмена» , чтобы безопасно закрыть окно «Подключить домен» и открыть его позже. Это не влияет на время распространения, но вам будет предложено повторно ввести имя домена при повторном открытии окна.

    По прошествии достаточного времени распространения, нажав «Проверить» в окне «Подключить домен» консоли Firebase , вы сможете начать процесс предоставления сертификата SSL.

    В большинстве случаев распространение ваших записей и проверка вашего домена произойдет в течение нескольких часов, в зависимости от вашего провайдера домена. Подробные инструкции по добавлению записей TXT и времени распространения см. в документации вашего провайдера домена.

    Если при нажатии «Проверить» появляется сообщение об ошибке, ваши записи не были распространены или ваши значения могут быть неверными.

В мастере добавления пользовательского домена консоли Firebase выберите «Быстрая настройка» или «Расширенная настройка» .

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

Мастер расширенной настройки поможет вам установить сертификат SSL и заявление о праве собственности, чтобы позволить Hosting обслуживать трафик в домене до получения трафика.

Быстрая настройка

  1. Мастер добавления пользовательского домена в консоли Firebase покажет необходимые записи, которые необходимо обновить, чтобы направить вашу страницу на Firebase Hosting . Добавляйте, удаляйте и сохраняйте записи из вашего домена у вашего DNS-провайдера, используя следующие входные данные:
    • Введите : добавьте предоставленную запись DNS.
    • Хост : введите ключ собственного домена для записей.

      • Указанный вами хост — это домен, на котором вы хотите размещать контент; этот домен может быть вершинным доменом или поддоменом.

      Ваш провайдер домена может указать этот термин как «Имя хоста», «Имя» или «Домен».

    • Значение : назначьте предоставленные IP-адреса значению записей.

      • Ваш провайдер домена может указать этот термин как «Данные», «Указывает на», «Содержимое», «Адрес» или «IP-адрес».

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

Расширенная настройка

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

  • Запись о праве собственности: запись TXT сообщает Hosting , какой сайт обслуживать в домене.
  • Сертификат SSL: сертификат для конкретного домена, который обеспечивает зашифрованную связь между серверами Hosting и конечными пользователями.
  • IP-записи хостинга: одна или несколько записей A и AAAA, которые направляют все запросы к домену на серверы Hosting

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

  1. Подготовить домен
    • Обновить записи DNS . Добавьте одну или несколько записей в свой домен:
      • Право собственности: запись TXT в форме `hosting-site=[site_id]`.
      • CAA (необязательно): пара записей CAA, которые позволяют центрам сертификации Hosting создавать сертификат SSL для вашего домена. Отображается только в том случае, если Hosting обнаруживает существующие записи CAA, которые не позволяют ему предоставить сертификат.
    • Настройка SSL-сертификата . Мастер предоставляет запрос ACME , который центры сертификации Hosting будут использовать для создания SSL-сертификата для вашего домена. Вы можете выбрать между вызовом DNS или HTTP:
      • Задача DNS : посетите сайты управления DNS вашего провайдера домена. Добавьте запись TXT с ключом субдомена вызова ACME и указанным значением. Разрешите до 24 часов на распространение ваших записей TXT.
      • HTTP-задание : загрузите предоставленный текстовый файл на существующий сайт по указанному URL-адресу и проверьте его существование.

      • Hosting сам попытается проверить вызовы ACME, прежде чем запрашивать проверку у своего центра сертификации. Если центр сертификации не может подтвердить ваши проблемы по какой-либо причине, например, из-за периодических проблем с обслуживанием. Hosting должен будет создать для вас новый набор задач. После успешной проверки Hosting может потребоваться до нескольких часов, чтобы предоставить сертификат SSL и разрешить его распространение.

  2. Прямо на Hosting

    3. После того, как Hosting установит ваше право собственности на домен и предоставит сертификат SSL, вернитесь к своему провайдеру DNS и добавьте записи DNS A/AAAA, направляющие запросы на Hosting :

    • Тип : добавить запрошенные записи DNS A/AAAA.
    • Хост : введите собственный ключ домена для обеих записей.

      Указанный вами хост — это домен, на котором вы хотите размещать контент; этот домен может быть вершинным доменом или поддоменом. Ваш провайдер домена может указать этот термин как «Имя хоста», «Имя» или «Домен».

    • Значение : присвойте одно значение каждой записи DNS A/AAAA, чтобы указать ваш домен на указанные IP-адреса.

      Ваш провайдер домена может указать этот термин как «Данные», «Указывает на», «Содержимое», «Адрес» или «IP-адрес».

Подождите, пока будет предоставлен SSL-сертификат.

После того как мы подтвердим право собственности на домен, мы предоставим сертификат SSL для вашего домена и развернем его в нашей глобальной CDN в течение 24 часов после того, как вы направите свои записи DNS A на Firebase Hosting .

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

Для пользователей расширенной настройки ваш веб-сайт будет размещаться у предыдущего хостинг-провайдера до тех пор, пока статус настройки на странице Firebase Hosting вашего проекта не обновится до «Подключено» .

Ваш личный доменный ключ

При добавлении или редактировании записей DNS разные поставщики доменов ожидают, что вы будете вводить разные данные в поле «Хост» на своих сайтах управления DNS. Ниже мы собрали общие сведения от популярных поставщиков. Подробные инструкции см. в документации вашего провайдера домена.

Тип домена Пользовательский ключ домена
Домен Апекс

Общие входные данные включают в себя:

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

Общие входные данные включают в себя:

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

Общие провайдеры доменов

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

Тип Хозяин Ценить
Входы записи DNS TXT
ТЕКСТ example .com значение проверки, указанное в консоли Firebase
DNS A записывает входные данные
А example .com 199.36.158.100
А www 199.36.158.100
Тип Хозяин Ценить
Входы записи DNS TXT
ТЕКСТ example .com значение проверки, указанное в консоли Firebase
DNS A записывает входные данные
А example .com 199.36.158.100
А www 199.36.158.100
Тип Хозяин Ценить
Входы записи DNS TXT
ТЕКСТ @ значение проверки, указанное в консоли Firebase
DNS A записывает входные данные
А @ 199.36.158.100
А www 199.36.158.100
Тип Хозяин Ценить
Входы записи DNS TXT
ТЕКСТ @ значение проверки, указанное в консоли Firebase
DNS A записывает входные данные
А @ 199.36.158.100
А www 199.36.158.100

Описания статуса настройки для личных доменов

Статус Описание
Требуется настройка

Возможно, вам придется изменить конфигурацию записей DNS.

  • В большинстве случаев ваши записи DNS A не передаются от вашего провайдера доменных имен на серверы Firebase Hosting .
    Совет по устранению неполадок. Если прошло более 24 часов, убедитесь, что вы направили свои записи на Firebase Hosting .

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

    • Проверка SSL-сертификата не удалась, и токен (записи DNS TXT или загруженный файл, предоставленный на ваш сайт) теперь недействителен.
      Совет по устранению неполадок: нажмите «Просмотреть» для домена, затем укажите новый токен для существующего домена.
В ожидании

Вы правильно настроили свой личный домен, но Firebase Hosting не предоставил SSL-сертификат.

Иногда следующие проблемы могут привести к остановке создания сертификата SSL для личного домена:

  • Ваши записи CAA слишком ограничительны.
    Совет по устранению неполадок: убедитесь, что центрам сертификации letencrypt.org и pki.goog разрешено создавать сертификаты SSL для вашего домена.
  • Ваш код вызова недействителен.
    Если вы используете поток расширенной настройки и миграция не удалась, ваш токен (и его код запроса) теперь недействителен.
    Совет по устранению неполадок: нажмите «Просмотреть» для домена, затем укажите новый токен для существующего домена.
  • Вы запросили сертификаты для слишком большого количества поддоменов.
    Совет по устранению неполадок. Как правило, Firebase Hosting рекомендует использовать не более 20 поддоменов в одном личном домене вершины из-за ограничений на создание сертификатов SSL.
Сертификат чеканки

Для вашего домена создается SSL-сертификат.

Подключено

Ваш личный домен имеет правильные записи DNS и сертификат SSL.
Вы можете обслуживать контент вашего сайта.

,

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

Firebase Hosting предоставляет сертификат SSL для каждого из ваших доменов и передает ваш контент через глобальную CDN.

В оставшейся части документа описаны шаги по подключению личного домена.

Настройте свой домен для Hosting

Убедитесь, что вы завершили работу мастера «Начало работы» на странице Firebase Hosting вашего проекта, чтобы у вас был сайт Firebase Hosting в вашем проекте Firebase.

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

  1. На странице Hosting вашего проекта войдите в мастер подключения личного домена:

    • Если у вас только один Hosting сайт, нажмите « Добавить личный домен» .
    • Если у вас несколько Hosting сайтов , нажмите « Просмотреть» для нужного сайта, затем нажмите «Добавить личный домен» .

  2. Введите собственное доменное имя, которое вы хотите подключить к своему Hosting сайту.

  3. (Необязательно) Установите флажок, чтобы перенаправлять все запросы в личном домене на второй указанный домен (например, example.com и www.example.com перенаправляются на один и тот же контент).

  4. Нажмите «Продолжить» , чтобы настроить записи DNS и завершить настройку личного домена.

Шаг 2. Настройка личного домена

Если появится запрос в мастере настройки подключения домена , подтвердите свой домен вершины.

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

  1. На сайте вашего провайдера домена найдите страницу управления DNS.

  2. Добавьте и сохраните новую запись со следующими входными данными:

    • Введите : добавьте запись TXT.

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

      Ваш провайдер домена может указать этот термин как «Тип записи».

    • Хост : Введите ключ домена apex .

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

      Ваш провайдер домена может указать этот термин как «Имя хоста», «Имя» или «Домен».

    • Значение : скопируйте уникальное значение проверки в поле.

      Firebase Hosting проверяет это значение, чтобы подтвердить ваше право собственности на домен.

      Ваш провайдер домена может указать этот термин как «Данные».

  3. Подождите до 24 часов для распространения обновленных записей TXT, затем нажмите «Подтвердить» .

    Обратите внимание, что вы можете нажать «Отмена» , чтобы безопасно закрыть окно «Подключить домен» и открыть его позже. Это не влияет на время распространения, но вам будет предложено повторно ввести имя домена при повторном открытии окна.

    По прошествии достаточного времени распространения, нажав «Проверить» в окне «Подключить домен» консоли Firebase , вы сможете начать процесс предоставления сертификата SSL.

    В большинстве случаев распространение ваших записей и проверка вашего домена произойдет в течение нескольких часов, в зависимости от вашего провайдера домена. Подробные инструкции по добавлению записей TXT и времени распространения см. в документации вашего провайдера домена.

    Если при нажатии «Проверить» появляется сообщение об ошибке, ваши записи не были распространены или ваши значения могут быть неверными.

В мастере добавления пользовательского домена консоли Firebase выберите «Быстрая настройка» или «Расширенная настройка» .

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

Мастер расширенной настройки поможет вам установить сертификат SSL и заявление о праве собственности, чтобы позволить Hosting обслуживать трафик в домене до получения трафика.

Быстрая настройка

  1. Мастер добавления пользовательского домена в консоли Firebase покажет необходимые записи, которые необходимо обновить, чтобы направить вашу страницу на Firebase Hosting . Добавляйте, удаляйте и сохраняйте записи из вашего домена у вашего DNS-провайдера, используя следующие входные данные:
    • Введите : добавьте предоставленную запись DNS.
    • Хост : введите ключ собственного домена для записей.

      • Указанный вами хост — это домен, на котором вы хотите размещать контент; этот домен может быть вершинным доменом или субдоменом.

      Ваш провайдер домена может указать этот термин как «Имя хоста», «Имя» или «Домен».

    • Значение : назначьте предоставленные IP-адреса значению записей.

      • Ваш провайдер домена может указать этот термин как «Данные», «Указывает на», «Содержимое», «Адрес» или «IP-адрес».

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

Расширенная настройка

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

  • Запись о праве собственности: запись TXT сообщает Hosting , какой сайт обслуживать в домене.
  • Сертификат SSL: сертификат для конкретного домена, который обеспечивает зашифрованную связь между серверами Hosting и конечными пользователями.
  • IP-записи хостинга: одна или несколько записей A и AAAA, которые направляют все запросы к домену на серверы Hosting

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

  1. Подготовить домен
    • Обновить записи DNS . Добавьте одну или несколько записей в свой домен:
      • Право собственности: запись TXT в форме `hosting-site=[site_id]`.
      • CAA (необязательно): пара записей CAA, которые позволяют центрам сертификации Hosting создавать сертификат SSL для вашего домена. Отображается только в том случае, если Hosting обнаруживает существующие записи CAA, которые не позволяют ему предоставить сертификат.
    • Настройка SSL-сертификата . Мастер предоставляет запрос ACME , который центры сертификации Hosting будут использовать для создания SSL-сертификата для вашего домена. Вы можете выбрать между вызовом DNS или HTTP:
      • Задача DNS : посетите сайты управления DNS вашего провайдера домена. Добавьте запись TXT с ключом субдомена вызова ACME и указанным значением. Разрешите до 24 часов на распространение ваших записей TXT.
      • HTTP-задание : загрузите предоставленный текстовый файл на существующий сайт по указанному URL-адресу и проверьте его существование.

      • Hosting сам попытается проверить вызовы ACME, прежде чем запрашивать проверку у своего центра сертификации. Если центр сертификации не может подтвердить ваши проблемы по какой-либо причине, например, из-за периодических проблем с обслуживанием. Hosting должен будет создать для вас новый набор задач. После успешной проверки Hosting может потребоваться до нескольких часов, чтобы предоставить сертификат SSL и разрешить его распространение.

  2. Прямо на Hosting

    3. После того, как Hosting установит ваше право собственности на домен и предоставит сертификат SSL, вернитесь к своему провайдеру DNS и добавьте записи DNS A/AAAA, направляющие запросы на Hosting :

    • Тип : добавить запрошенные записи DNS A/AAAA.
    • Хост : введите собственный ключ домена для обеих записей.

      Указанный вами хост — это домен, на котором вы хотите размещать контент; этот домен может быть вершинным доменом или субдоменом. Ваш провайдер домена может указать этот термин как «Имя хоста», «Имя» или «Домен».

    • Значение : присвойте одно значение каждой записи DNS A/AAAA, чтобы указать ваш домен на указанные IP-адреса.

      Ваш провайдер домена может указать этот термин как «Данные», «Указывает на», «Содержимое», «Адрес» или «IP-адрес».

Подождите, пока будет предоставлен SSL-сертификат.

После того как мы подтвердим право собственности на домен, мы предоставим сертификат SSL для вашего домена и развернем его в нашей глобальной CDN в течение 24 часов после того, как вы направите свои записи DNS A на Firebase Hosting .

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

Для пользователей расширенной настройки ваш веб-сайт будет размещаться у предыдущего хостинг-провайдера до тех пор, пока статус настройки на странице Firebase Hosting вашего проекта не обновится до «Подключено» .

Ваш личный доменный ключ

При добавлении или редактировании записей DNS разные поставщики доменов ожидают, что вы будете вводить разные данные в поле «Хост» на своих сайтах управления DNS. Ниже мы собрали общие сведения от популярных поставщиков. Подробные инструкции см. в документации вашего провайдера домена.

Тип домена Пользовательский ключ домена
Домен Апекс

Общие входные данные включают в себя:

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

Общие входные данные включают в себя:

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

Общие провайдеры доменов

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

Тип Хозяин Ценить
Входы записи DNS TXT
ТЕКСТ example .com значение проверки, указанное в консоли Firebase
DNS A записывает входные данные
А example .com 199.36.158.100
А www 199.36.158.100
Тип Хозяин Ценить
Входы записи DNS TXT
ТЕКСТ example .com значение проверки, указанное в консоли Firebase
DNS A записывает входные данные
А example .com 199.36.158.100
А www 199.36.158.100
Тип Хозяин Ценить
Входы записи DNS TXT
ТЕКСТ @ значение проверки, указанное в консоли Firebase
DNS A записывает входные данные
А @ 199.36.158.100
А www 199.36.158.100
Тип Хозяин Ценить
Входы записи DNS TXT
ТЕКСТ @ значение проверки, указанное в консоли Firebase
DNS A записывает входные данные
А @ 199.36.158.100
А www 199.36.158.100

Описания статуса настройки для личных доменов

Статус Описание
Требуется настройка

Возможно, вам придется изменить конфигурацию записей DNS.

  • В большинстве случаев ваши записи DNS A не передаются от вашего провайдера доменных имен на серверы Firebase Hosting .
    Совет по устранению неполадок. Если прошло более 24 часов, убедитесь, что вы направили свои записи на Firebase Hosting .

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

    • Проверка SSL-сертификата не удалась, и токен (записи DNS TXT или загруженный файл, предоставленный на ваш сайт) теперь недействителен.
      Совет по устранению неполадок: нажмите «Просмотреть» для домена, затем укажите новый токен для существующего домена.
В ожидании

Вы правильно настроили свой личный домен, но Firebase Hosting не предоставил SSL-сертификат.

Иногда следующие проблемы могут привести к остановке создания сертификата SSL для личного домена:

  • Ваши записи CAA слишком ограничительны.
    Совет по устранению неполадок: убедитесь, что центрам сертификации letencrypt.org и pki.goog разрешено создавать сертификаты SSL для вашего домена.
  • Ваш код вызова недействителен.
    Если вы используете поток расширенной настройки и миграция не удалась, ваш токен (и его код запроса) теперь недействителен.
    Совет по устранению неполадок: нажмите «Просмотреть» для домена, затем укажите новый токен для существующего домена.
  • Вы запросили сертификаты для слишком большого количества поддоменов.
    Совет по устранению неполадок. Как правило, Firebase Hosting рекомендует использовать не более 20 поддоменов в одном личном домене вершины из-за ограничений на создание сертификатов SSL.
Сертификат чеканки

Для вашего домена создается SSL-сертификат.

Подключено

Ваш личный домен имеет правильные записи DNS и сертификат SSL.
Вы можете обслуживать контент вашего сайта.

,

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

Firebase Hosting предоставляет сертификат SSL для каждого из ваших доменов и передает ваш контент через глобальную CDN.

В оставшейся части документа описаны шаги по подключению личного домена.

Настройте свой домен для Hosting

Убедитесь, что вы завершили работу мастера «Начало работы» на странице Firebase Hosting вашего проекта, чтобы у вас был сайт Firebase Hosting в вашем проекте Firebase.

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

  1. На странице Hosting вашего проекта войдите в мастер подключения личного домена:

    • Если у вас только один Hosting сайт, нажмите «Добавить личный домен» .
    • Если у вас несколько Hosting сайтов , нажмите « Просмотреть» для нужного сайта, затем нажмите «Добавить собственный домен» .

  2. Введите собственное доменное имя, которое вы хотите подключить к своему Hosting сайту.

  3. (Необязательно) Установите флажок, чтобы перенаправлять все запросы в личном домене на второй указанный домен (например, example.com и www.example.com перенаправляются на один и тот же контент).

  4. Нажмите «Продолжить» , чтобы настроить записи DNS и завершить настройку личного домена.

Шаг 2. Настройка личного домена

Если появится запрос в мастере настройки подключения домена , подтвердите свой домен вершины.

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

  1. На сайте вашего провайдера домена найдите страницу управления DNS.

  2. Добавьте и сохраните новую запись со следующими входными данными:

    • Введите : добавьте запись TXT.

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

      Ваш провайдер домена может указать этот термин как «Тип записи».

    • Хост : Введите ключ домена apex .

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

      Ваш провайдер домена может указать этот термин как «Имя хоста», «Имя» или «Домен».

    • Значение : скопируйте уникальное значение проверки в поле.

      Firebase Hosting проверяет это значение, чтобы подтвердить ваше право собственности на домен.

      Ваш провайдер домена может указать этот термин как «Данные».

  3. Подождите до 24 часов для распространения обновленных записей TXT, затем нажмите «Подтвердить» .

    Обратите внимание, что вы можете нажать «Отмена» , чтобы безопасно закрыть окно «Подключить домен» и открыть его позже. Это не влияет на время распространения, но вам будет предложено повторно ввести имя домена при повторном открытии окна.

    По прошествии достаточного времени распространения, нажав «Проверить» в окне «Подключить домен» консоли Firebase , вы сможете начать процесс предоставления сертификата SSL.

    В большинстве случаев распространение ваших записей и проверка вашего домена произойдет в течение нескольких часов, в зависимости от вашего провайдера домена. Подробные инструкции по добавлению записей TXT и времени распространения см. в документации вашего провайдера домена.

    Если при нажатии «Проверить» появляется сообщение об ошибке, ваши записи не были распространены или ваши значения могут быть неверными.

В мастере добавления пользовательского домена консоли Firebase выберите «Быстрая настройка» или «Расширенная настройка» .

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

Мастер расширенной настройки поможет вам установить сертификат SSL и заявление о праве собственности, чтобы позволить Hosting обслуживать трафик в домене до получения трафика.

Быстрая настройка

  1. Мастер добавления пользовательского домена в консоли Firebase покажет необходимые записи, которые необходимо обновить, чтобы направить вашу страницу на Firebase Hosting . Добавляйте, удаляйте и сохраняйте записи из вашего домена у вашего DNS-провайдера, используя следующие входные данные:
    • Введите : добавьте предоставленную запись DNS.
    • Хост : введите ключ собственного домена для записей.

      • Указанный вами хост — это домен, на котором вы хотите размещать контент; этот домен может быть вершинным доменом или поддоменом.

      Ваш провайдер домена может указать этот термин как «Имя хоста», «Имя» или «Домен».

    • Значение : назначьте предоставленные IP-адреса значению записей.

      • Ваш провайдер домена может указать этот термин как «Данные», «Указывает на», «Содержимое», «Адрес» или «IP-адрес».

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

Расширенная настройка

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

  • Запись о праве собственности: запись TXT сообщает Hosting , какой сайт обслуживать в домене.
  • Сертификат SSL: сертификат для конкретного домена, который обеспечивает зашифрованную связь между серверами Hosting и конечными пользователями.
  • IP-записи хостинга: одна или несколько записей A и AAAA, которые направляют все запросы к домену на серверы Hosting

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

  1. Подготовить домен
    • Обновить записи DNS . Добавьте одну или несколько записей в свой домен:
      • Право собственности: запись TXT в форме `hosting-site=[site_id]`.
      • CAA (необязательно): пара записей CAA, которые позволяют центрам сертификации Hosting создавать сертификат SSL для вашего домена. Отображается только в том случае, если Hosting обнаруживает существующие записи CAA, которые не позволяют ему предоставить сертификат.
    • Настройка SSL-сертификата . Мастер предоставляет запрос ACME , который центры сертификации Hosting будут использовать для создания SSL-сертификата для вашего домена. Вы можете выбрать между вызовом DNS или HTTP:
      • DNS Challenge : посетите сайты управления DNS вашего поставщика доменов. Добавьте запись TXT с ключом субдомена ACME Challenge и предоставленным значением. Разрешить до 24 часов для распространения ваших записей TXT.
      • HTTP Challenge : Загрузите предоставленный текстовый файл на существующий сайт на указанный URL -адрес и проверьте его существование.

      • Hosting попытается проверить себя ACME, прежде чем запросить проверку из его ок. Если CA не может подтвердить ваши проблемы по какой -либо причине, например, прерывистые вопросы обслуживания. Hosting должен будет создать новый набор проблем для вас. После успешной проверки это может занять несколько часов для Hosting , чтобы предоставить сертификат SSL и позволить ему распространяться.

  2. Прямо на Hosting

    3. После того, как Hosting установит ваше доменное право собственности и предоставление сертификата SSL, вернитесь к своему поставщику DNS и добавьте DNS A/AAAA Records, направляющие запросы на Hosting :

    • Тип : добавить запрошенные DNS A/AAAA Records.
    • Хост : введите свой пользовательский доменное ключ для обеих записей.

      Хост, который вы указываете, является доменом, в котором вы хотите обслуживать контент; Этот домен может быть доменом вершины или поддомена. Ваш поставщик доменов может назвать этот термин «имя хоста», «имя» или «домен».

    • Значение : назначьте одно значение каждой записи DNS A/AAAA, чтобы указать ваш домен на указанные IP -адреса.

      Ваш поставщик доменов может назвать этот термин «данные», «указывает на« контент »,« адрес »или« IP -адрес ».

Ждать предоставления сертификата SSL

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

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

Для пользователей Advanced Setup ваш веб -сайт будет размещен вашим предыдущим хостингом до тех пор, пока статус настройки в обновлениях страниц Firebase Hosting вашего проекта для подключения .

Ваш пользовательский ключ домена

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

Тип домена Пользовательский домен ключ
Домен вершины

Общие входные данные включают:

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

Общие входные данные включают:

  • Полное имя поддомена (например, app. example .com )
  • Только субдоменная часть (например, только app и уходя . example .com )
  • Только www для поддомена www. example .com

Общие доменные поставщики

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

Тип Хозяин Ценить
DNS TXT записывает входы
ТЕКСТ example .com Проверка, предоставленная в консоли Firebase
DNS входы записей
А example .com 199.36.158.100
А www 199.36.158.100
Тип Хозяин Ценить
DNS TXT записывает входы
ТЕКСТ example .com Проверка, предоставленная в консоли Firebase
DNS входы записей
А example .com 199.36.158.100
А www 199.36.158.100
Тип Хозяин Ценить
DNS TXT записывает входы
ТЕКСТ @ Проверка, предоставленная в консоли Firebase
DNS входы записей
А @ 199.36.158.100
А www 199.36.158.100
Тип Хозяин Ценить
DNS TXT записывает входы
ТЕКСТ @ Проверка, предоставленная в консоли Firebase
DNS входы записей
А @ 199.36.158.100
А www 199.36.158.100

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

Статус Описание
Нуждается в настройке

Возможно, вам потребуется изменить конфигурацию с помощью записей DNS.

  • В большинстве случаев ваши DNS A Записи не распространялись от вашего поставщика доменных имен на серверы Firebase Hosting .
    Совет по устранению неполадок: если это было более 24 часов, проверьте, что вы указали свои записи на Firebase Hosting .

  • В более редких случаях, особенно если вы используете расширенный поток настройки, проблемы SSL могут потерпеть неудачу, потому что:

    • Проблемы сертификации SSL не удались, и токен (DNS TXT Records или загруженный файл, предоставленный на ваш сайт), теперь недействителен.
      Совет по устранению неполадок: нажмите «Просмотр домена», а затем предоставьте новый токен для вашего существующего домена.
В ожидании

Вы правильно настроили свой пользовательский домен, но Firebase Hosting не предоставил сертификат SSL.

Иногда следующие проблемы могут остановить майнер сертификата SSL для пользовательского домена:

  • Ваши записи CAA слишком ограничительны.
    Совет по устранению неполадок: убедитесь, что властям сертификации `letsencrypt.org` и` pki.goog` разрешается создавать SSL Certs для вашего домена.
  • Ваш код вызова неверен.
    Если вы используете расширенную поток настройки и миграцию, ваш токен (и его код вызова) теперь недействителен.
    Совет по устранению неполадок: нажмите «Просмотр домена», а затем предоставьте новый токен для вашего существующего домена.
  • Вы просили СЕРТ для слишком большого количества субдоменов.
    Совет по устранению неполадок: обычно, Firebase Hosting рекомендует не более 20 субдоменов на одном Apex Custom Domain из -за ограничений добычи сертификатов SSL.
Сертификат добычи

Для вашего домена производится сертификат SSL.

Подключено

Ваш пользовательский домен имеет соответствующие записи DNS и имеет сертификат SSL.
Вы можете обслуживать контент вашего сайта.