Conectar un dominio personalizado

No tienes que renunciar a tus nombres de dominio exclusivos y centrados en tu marca con Firebase Hosting. Puedes usar un dominio personalizado (como example.com o app.example.com ) en lugar de un dominio generado por Firebase para tu sitio alojado en Firebase.

Firebase Hosting proporciona un certificado SSL para cada uno de sus dominios y ofrece su contenido a través de una CDN global.

El resto de este documento lo guía a través de estos pasos para conectar su dominio personalizado.

Configura tu dominio para Hosting

Asegúrate de haber completado el asistente "Comenzar" desde la página de Firebase Hosting de tu proyecto para tener un sitio de Firebase Hosting en tu proyecto de Firebase.

Paso 1 : agregar un dominio personalizado

  1. Desde la página de Hosting de tu proyecto, ingresa al asistente para conectar un dominio personalizado:

    • Si solo tiene un sitio de alojamiento, haga clic en Agregar dominio personalizado .
    • Si tiene más de un sitio de alojamiento , haga clic en Ver para el sitio deseado y luego haga clic en Agregar dominio personalizado .
  2. Ingrese el nombre de dominio personalizado que desea conectar a su sitio de hosting.

  3. (Opcional) Marque la casilla para redirigir todas las solicitudes en el dominio personalizado a un segundo dominio especificado (de modo que example.com y www.example.com redireccionen al mismo contenido).

  4. Haga clic en Continuar para configurar sus registros DNS y terminar de configurar su dominio personalizado.

Paso 2 : configurar un dominio personalizado

Si se solicita en el asistente de configuración de Connect Domain , verifique su dominio apex.

Estos pasos garantizan que su dominio no esté vinculado a un proyecto de Firebase y que usted sea el propietario del dominio especificado.

  1. En el sitio de su proveedor de dominio, busque la página de administración de DNS.

  2. Agregue y guarde un nuevo registro con las siguientes entradas:

    • Escriba : agregue un registro TXT.

      Firebase Hosting requiere que mantenga este registro TXT continuamente presente en su configuración de DNS para demostrar su propiedad del dominio y autorizar a Firebase a asignar y renovar certificados SSL para su sitio.

      Su proveedor de dominio puede incluir este término como "Tipo de registro".

    • Anfitrión : Introduzca su clave de dominio Apex .

      Probar su propiedad de un dominio principal, o dominio raíz, demuestra su propiedad de todos sus subdominios.

      Su proveedor de dominio puede incluir este término como "Nombre de host", "Nombre" o "Dominio".

    • Valor : copie el valor de verificación único en el campo.

      Firebase Hosting verifica este valor para demostrar la propiedad de su dominio.

      Su proveedor de dominio puede incluir este término como "Datos".

  3. Espere hasta 24 horas para la propagación de sus registros TXT actualizados, luego haga clic en Verificar .

    Tenga en cuenta que puede hacer clic en Cancelar para cerrar de forma segura la ventana Conectar dominio y volver a abrirla más adelante. Esto no afecta el tiempo de propagación, pero se le pedirá que vuelva a ingresar su nombre de dominio cuando vuelva a abrir la ventana.

    Después de un tiempo de propagación amplio, hacer clic en Verificar en la ventana Conectar dominio de Firebase console le permite comenzar el proceso de aprovisionamiento del certificado SSL.

    En la mayoría de los casos, la propagación de sus registros y la verificación de su dominio se realizarán en unas pocas horas, dependiendo de su proveedor de dominio. Consulte la documentación de su proveedor de dominio para obtener instrucciones detalladas sobre cómo agregar registros TXT y tiempos de propagación.

    Si al hacer clic en Verificar aparece un mensaje de error, sus registros no se han propagado o sus valores pueden ser incorrectos.

En el asistente Agregar dominio personalizado de Firebase console, seleccione Configuración rápida o Configuración avanzada .

La configuración rápida se puede utilizar para dominios nuevos que actualmente no reciben tráfico o dominios que está intentando transferir desde otro sitio de alojamiento. La configuración avanzada se puede utilizar si ya tiene un dominio que recibe solicitudes en otro proveedor de hosting y necesita una migración sin tiempo de inactividad.

El asistente de configuración avanzada lo ayudará a establecer un certificado SSL y un reclamo de propiedad para permitir que Hosting proporcione tráfico en el dominio antes de recibirlo.

Espere el aprovisionamiento del certificado SSL

Después de verificar la propiedad del dominio, proporcionamos un certificado SSL para su dominio y lo implementamos en nuestra CDN global dentro de las 24 horas posteriores a que apunte sus registros DNS A a Firebase Hosting.

Su dominio aparecerá como uno de los nombres alternativos del sujeto (SAN) en el certificado SSL de FirebaseApp. Puede ver este certificado utilizando las herramientas de seguridad del navegador. Mientras se aprovisiona el dominio, es posible que vea un certificado no válido que no incluye su nombre de dominio. Esta es una parte normal del proceso y se resolverá una vez que el certificado de su dominio esté disponible.

Para los usuarios de Configuración avanzada , su sitio web será alojado por su proveedor de alojamiento anterior hasta que el estado de configuración en la página Firebase Hosting de su proyecto se actualice a Conectado .

Su clave de dominio personalizada

Al agregar o editar registros DNS, diferentes proveedores de dominio esperan que ingrese diferentes entradas para el campo Host dentro de sus sitios de administración de DNS. A continuación, recopilamos aportes comunes de proveedores populares. Consulte la documentación de su proveedor de dominio para obtener instrucciones detalladas.

tipo de dominio Clave de dominio personalizada
Dominio ápice

Las entradas comunes incluyen:

  • @
  • El nombre de dominio principal (por ejemplo, example .com )
  • Dejar el campo Anfitrión en blanco
Subdominio

Las entradas comunes incluyen:

  • El nombre completo del subdominio (por ejemplo, app. example .com )
  • Solo la parte del subdominio (por ejemplo, solo app y omitiendo . example .com )
  • Sólo www para el subdominio de www. example .com

Proveedores de dominio comunes

A continuación se muestran algunos proveedores de dominios comunes y los tipos de entrada que cada uno puede requerir. Esta información se mantiene actualizada tanto como sea posible, pero consulte la documentación de su proveedor de dominio para obtener instrucciones detalladas.

Configurar descripciones de estado para dominios personalizados

Estado Descripción
Necesita configuración

Es posible que deba cambiar una configuración con sus registros DNS.

  • En la mayoría de los casos, sus registros DNS A no se han propagado desde su proveedor de nombre de dominio a los servidores de Firebase Hosting.
    Consejo para solucionar problemas: si han pasado más de 24 horas, verifique que haya apuntado sus registros a Firebase Hosting.

  • En casos más raros, especialmente si utiliza el flujo de Configuración avanzada, los desafíos de SSL pueden fallar porque:

    • Sus registros DNS tienen registros A o registros CNAME que apuntan a otros proveedores de alojamiento.
      Consejo para solucionar problemas: verifique que sus registros A apunten solo a Firebase Hosting y elimine todos los registros CNAME.
    • La migración falló y el token (registros DNS TXT o archivo cargado proporcionado a su sitio) ahora no es válido.
      Consejo para solucionar problemas: haga clic en Ver para el dominio y luego proporcione el nuevo token a su dominio existente.
Pendiente

Configuraste correctamente tu dominio personalizado, pero Firebase Hosting no ha proporcionado un certificado SSL.

En ocasiones, los siguientes problemas pueden detener la emisión de un certificado SSL para un dominio personalizado:

  • Sus registros CAA son demasiado restrictivos.
    Consejo para la solución de problemas: asegúrese de que las autoridades certificadoras `letsencrypt.org` y `pki.goog` tengan permiso para crear certificados SSL para su dominio.
  • Su código de desafío no es válido.
    Si está utilizando el flujo de Configuración avanzada y la migración falló, su token (y su código de desafío) ahora no son válidos.
    Consejo para solucionar problemas: haga clic en Ver para el dominio y luego proporcione el nuevo token a su dominio existente.
  • Solicitó certificados para demasiados subdominios.
    Consejo para solucionar problemas: por lo general, Firebase Hosting recomienda no más de 20 subdominios en un dominio personalizado principal, debido a los límites de acuñación de certificados SSL.
Certificado de acuñación

Se está generando un certificado SSL para su dominio.

Conectado

Su dominio personalizado tiene los registros DNS adecuados y tiene un certificado SSL.
Puede servir el contenido de su sitio.