Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Conectar un dominio personalizado

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

No tiene que renunciar a sus nombres de dominio únicos y centrados en la marca con Firebase Hosting. Puede usar un dominio personalizado (como example.com o app.example.com ) en lugar de un dominio generado por Firebase para su sitio alojado por Firebase.

Firebase Hosting proporciona un certificado SSL para cada uno de sus dominios y sirve 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úrese de haber completado el asistente "Comenzar" de la página de Firebase Hosting de su proyecto para tener un sitio de Firebase Hosting en su proyecto de Firebase.

Paso 1 : Agregar dominio

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

    • Si solo tiene un sitio de hospedaje, haga clic en Agregar dominio personalizado .
    • Si tiene más de un sitio de hospedaje , haga clic en Ver para el sitio deseado, luego haga clic en Agregar dominio personalizado .

  2. Ingrese el nombre de dominio personalizado que le gustaría conectar a su sitio de hospedaje.

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

  4. Haga clic en Continuar para iniciar el proceso de validación.

Paso 2 : Verificar la propiedad del dominio

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

Estos pasos garantizan que su dominio no esté ya vinculado con un proyecto de Firebase y que 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 que es el propietario del dominio y para 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 : Ingrese su clave de dominio principal .

      Demostrar su propiedad de un dominio principal, o dominio raíz, prueba 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 que eres el propietario del dominio.

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

  3. Permita 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 tarde. 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 amplio tiempo de propagación, 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, según el proveedor de su 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.

Paso 3 : Transmitir en vivo

En la ventana Conectar dominio de Firebase console, seleccione Configuración rápida para un sitio nuevo o Configuración avanzada si ya tiene un sitio ejecutándose en otro proveedor de alojamiento y necesita una migración sin tiempo de inactividad.

Espere el aprovisionamiento del certificado SSL

Una vez que verificamos 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 dirija 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 usando 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 de alojamiento de Firebase de su proyecto se actualice a Conectado .

Su clave de dominio personalizada

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

tipo de dominio Clave de dominio personalizada
dominio de vértice

Las entradas comunes incluyen:

  • @
  • El nombre de dominio principal (por ejemplo, example .com )
  • Dejar el campo Host 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 la app y dejando de lado . example .com )
  • Sólo www para el subdominio de www. example .com

Proveedores de dominios comunes

Estos son algunos proveedores de dominio comunes y los tipos de entrada que cada uno puede requerir. Esta información se mantiene lo más actualizada posible, pero consulte la documentación de su proveedor de dominio para obtener instrucciones detalladas.

Descripciones de estado de configuración 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.
    Sugerencia para la solución de 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 está utilizando 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.
      Sugerencia para la solución de 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.
      Sugerencia para la solución de problemas: haga clic en Ver para el dominio, luego proporcione el nuevo token a su dominio existente.
Pendiente

Configuró correctamente su dominio personalizado, pero Firebase Hosting no proporcionó un certificado SSL.

Ocasionalmente, los siguientes problemas pueden detener la creación de un certificado SSL para un dominio personalizado:

  • Sus registros CAA son demasiado restrictivos.
    Sugerencia para la solución de problemas: asegúrese de que las autoridades de certificación `letsencrypt.org` y `pki.goog` puedan 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.
    Sugerencia para la solución de problemas: haga clic en Ver para el dominio, luego proporcione el nuevo token a su dominio existente.
  • Solicitó certificados para demasiados subdominios.
    Sugerencia para la solución de problemas: por lo general, Firebase Hosting recomienda no más de 20 subdominios en un dominio personalizado de Apex, debido a los límites de acuñación de certificados SSL.
Conectado

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

Necesita una nueva verificación

Firebase puede requerir que vuelvas a verificar manualmente la propiedad de tu dominio si ocurre alguna de las siguientes situaciones:

  • El registro TXT agregado cuando verificó inicialmente la propiedad de su dominio se modificó o eliminó de la configuración de DNS de su dominio.
    • Tenga en cuenta que se permiten múltiples registros TXT con un token de verificación del sitio de Google en un solo dominio.
    • Requerimos que el registro TXT esté continuamente presente en su configuración de DNS, ya que esto demuestra que es el propietario del dominio y nos autoriza a asignar y renovar certificados SSL para su sitio.
  • A la persona que verificó la propiedad del dominio ya no se le asigna un rol de IAM que contiene el permiso requerido para verificar la propiedad del dominio. Estos roles incluyen propietario, editor, administrador de Firebase y administrador de desarrollo de Firebase.
Sugerencia para la solución de problemas: visite la página de Hosting de su proyecto para completar el proceso de verificación dentro del período de tiempo especificado (generalmente 30 días) para evitar que su dominio personalizado se desconecte automáticamente de Firebase Hosting.