Ir a la consola

Conecta un dominio personalizado

Con Firebase Hosting, no tienes que renunciar a tus nombres de dominio únicos y centrados en la marca. Puedes conectar dominios personalizados (como yourdomain.com o app.yourdomain.com), en lugar de un dominio generado por Firebase, a un sitio de Firebase Hosting.

Firebase Hosting aprovisiona un certificado SSL para cada uno de tus dominios y entrega el contenido a través de una CDN global.

Debido a los límites de creación de certificados SSL, en general no se recomienda que un dominio personalizado principal contenga más de 20 subdominios para Firebase Hosting.

Configura tu dominio para Hosting

Asegúrate de completar el asistente “Primeros pasos” en la página de Firebase Hosting de tu proyecto para tener un sitio de Firebase Hosting en tu proyecto de Firebase.

Paso 1: Agrega el dominio

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

    • Si solo tienes un sitio de Hosting, haz clic en Conectar dominio.
    • Si tienes más de un sitio de Hosting, haz clic en Ver en el sitio deseado y, luego, haz clic en Conectar dominio.
  2. Ingresa el nombre del dominio personalizado que quieres conectar al sitio de Hosting.

  3. Marca la casilla para redireccionar todas las solicitudes en el dominio personalizado a un segundo dominio especificado, de modo que yourdomain.com y www.yourdomain.com redireccionen al mismo contenido (opcional).

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

Paso 2: Verifica la propiedad del dominio

Si se solicita en el asistente de configuración Conectar dominio, verifica tu dominio principal.

Estos pasos garantizan que tu dominio aún no esté vinculado con un proyecto de Firebase y que tú eres el propietario del dominio especificado.

  1. En el sitio de tu proveedor de dominio, busca la página de administración de DNS. Agrega y guarda un registro nuevo con las siguientes entradas:

    • Tipo: Agrega un registro TXT.

      Requerimos que mantengas este registro TXT presente de forma continua en tu configuración de DNS para probar tu propiedad del dominio y autorizarnos a asignar y renovar los certificados SSL de tu sitio.

      Tu proveedor de dominio puede incluir este término como “Tipo de registro”.

    • Host: Ingresa tu clave de dominio principal.

      Probar tu propiedad de un dominio principal, o dominio raíz, prueba tu propiedad de todos sus subdominios.

      Tu proveedor de dominio puede incluir este término como “Nombre de host”, “Nombre” o “Dominio”.

    • Valor: Copia el valor de verificación único en el campo. Firebase Hosting verifica este valor para demostrar la propiedad de tu dominio.

      Tu proveedor de dominio puede incluir este término como “Datos”.

  2. Espera hasta 24 horas para que tus registros TXT actualizados se propaguen.

    Si aparece un mensaje de error cuando haces clic en Verificar, significa que tus registros no se han propagado o que tus valores pueden ser incorrectos.

    Puedes 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 te pedirá que vuelvas a ingresar el nombre de tu dominio cuando ingreses a la ventana.

    Después de una propagación amplia, si haces clic en Verificar en la ventana Conectar dominio de Firebase console, puedes comenzar el proceso de aprovisionamiento de certificados SSL.

    En la mayoría de los casos, la propagación de tus registros y la verificación de tu dominio ocurrirán en unas pocas horas, dependiendo de tu proveedor de dominio. Consulta la documentación de tu proveedor de dominio a fin de obtener instrucciones detalladas para agregar registros TXT y tiempos de propagación.

Paso 3: Activa el dominio

En la ventana Conectar dominio de Firebase console, selecciona Configuración rápida para un sitio nuevo o Configuración avanzada si ya tienes un sitio ejecutándose en otro proveedor de hosting y necesitas una migración con tiempo de inactividad cero.

Espera el aprovisionamiento del certificado SSL

Después de verificar la propiedad del dominio, aprovisionamos un certificado SSL para tu dominio y lo implementamos en nuestra CDN global en un plazo de 24 horas después de que dirijas tus registros A del DNS a Firebase Hosting.

Tu dominio se mostrará en la sección de nombres alternativos de la entidad (SAN) del certificado SSL de FirebaseApp. Puedes usar las herramientas de seguridad del navegador para ver el certificado. Mientras se aprovisiona el dominio, es posible que veas un certificado no válido en el que falta el nombre de dominio. Esta es parte normal del proceso y se resolverá cuando esté disponible el certificado de tu dominio.

Para los usuarios de Configuración avanzada, el proveedor de hosting anterior alojará el sitio web hasta que el estado de configuración en la página de Firebase Hosting de tu proyecto se actualice a Conectado.

Tu clave de dominio personalizado

Cuando agregas o editas registros DNS, los diferentes proveedores de dominio esperan que ingreses diferentes entradas para el campo Host dentro de sus sitios de administración de DNS. A continuación, incluimos una compilación de entradas comunes de proveedores populares. Consulta la documentación de tu proveedor de dominio para obtener instrucciones más detalladas.

Tipo de dominio Clave de dominio personalizado
Dominio principal

Las entradas comunes incluyen las siguientes:

  • @

  • El nombre de dominio principal (yourdomain.com)

  • Dejar el campo Host en blanco

Subdominio

Las entradas comunes incluyen las siguientes:

  • El nombre del subdominio (app.yourdomain.com)
  • Únicamente la parte del subdominio (app, sin incluir .yourdomain.com)
    • Un caso práctico común es ingresar www como tu clave para el subdominio www.yourdomain.com.

Descripciones de los estados de la configuración de dominios personalizados

Estado Descripción
Falta configurar

Es posible que debas cambiar la configuración de los registros DNS.

  • En la mayoría de los casos, los registros A del DNS no se han propagado desde el proveedor de nombre de dominio hasta los servidores de Firebase Hosting.
    Sugerencia para la solución de problemas: Verifica si dirigiste los registros a Firebase Hosting si han transcurrido más de 24 horas.

  • En casos menos frecuentes, en especial si se usa el flujo de configuración avanzada, los desafíos de SSL pueden estar fallando debido a lo siguiente:

    • Tus registros DNS tienen registros A o CNAME dirigidos a otros proveedores de hosting.
      Sugerencia para la solución de problemas: Comprueba que tus registros A solo estén dirigidos a Firebase Hosting. También quita todos los registros CNAME.
    • La migración falló y ahora el token (los registros TXT de DNS o el archivo que se subió y proporcionó a tu sitio) no es válido.
      Sugerencia para la solución de problemas: Selecciona la opción Ver de tu dominio y proporciona un token nuevo a tu dominio existente.
Pendiente

La configuración del dominio personalizado se realizó sin problemas, pero Firebase Hosting no ha aprovisionado un certificado SSL.

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

  • Tus registros CAA son muy restrictivos.
    Sugerencia para la solución de problemas: Asegúrate de que la autoridad certificada Let's Encrypt pueda crear certificados SSL para tu dominio.
  • El código del desafío no es válido.
    Si estás usando el flujo de configuración avanzada y la migración falló, tus tokens (y sus códigos de desafío) ya no son válidos.
    Sugerencia para la solución de problemas: Selecciona la opción Ver de tu dominio y, luego, proporciónale un token nuevo.
  • Solicitaste certificados para demasiados subdominios.
    Sugerencia para la solución de problemas: Debido a los límites de creación de certificados SSL, en general, no se recomienda que un dominio personalizado principal contenga más de 20 subdominios para Firebase Hosting.
Conectado

Tu dominio personalizado tiene los registros DNS adecuados y un certificado SSL.
Puedes entregar el contenido de tu sitio.

Debe verificarse de nuevo

Firebase solo requerirá que vuelvas a verificar manualmente la propiedad del dominio después de la etapa de configuración inicial cuando ocurran estas dos situaciones:

  • El registro TXT del Paso 2 se alteró o quitó de la configuración de DNS de tu dominio.
    • Ten en cuenta que se permiten varios registros TXT con un token de verificación de sitio de Google en un solo dominio.
    • Requerimos que el registro TXT esté presente de forma continua en tu configuración de DNS, ya que esto demuestra que eres el propietario del dominio y nos autoriza a asignar y renovar certificados SSL para tu sitio.
  • La persona que demostró la propiedad del dominio se quitó del proyecto.
Sugerencia para la solución de problemas: Visita la página de Hosting de tu proyecto a fin de completar el proceso de reverificación dentro del período especificado (generalmente 30 días) para evitar que el dominio se quite automáticamente de la consola de Hosting.