Conecta un dominio personalizado

Con Firebase Hosting, no tienes que renunciar a tus nombres de dominio únicos y centrados en la marca. Puedes usar un dominio personalizado (como example.com o app.example.com) en lugar de uno generado por Firebase para un sitio alojado en Firebase.

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

El resto de este documento es una explicación de los pasos para conectar tu dominio personalizado.

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 un dominio personalizado

  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 Agrega un dominio personalizado.
    • Si tienes más de un sitio de Hosting, haz clic en Ver en el sitio deseado y, luego, en Agrega un dominio personalizado.
  2. Ingresa el nombre del dominio personalizado que quieres conectar al sitio de Hosting.

  3. (Opcional) Marca la casilla para redireccionar todas las solicitudes en el dominio personalizado a un segundo dominio especificado (de manera que example.com y www.example.com redirijan al mismo contenido).

  4. Haz clic en Continuar para configurar tus registros DNS y terminar de configurar tu dominio personalizado.

Paso 2: Configura el dominio personalizado

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ú seas el propietario del dominio especificado.

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

  2. Agrega y guarda un registro nuevo con las siguientes entradas:

    • Tipo: Agrega un registro TXT.

      Firebase Hosting requiere que mantengas este registro TXT presente de forma continua en tu configuración de DNS para probar tu propiedad del dominio y autorizar a Firebase 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 la 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”.

  3. Espera hasta 24 horas para que se propaguen tus registros TXT actualizados. Luego, haz clic en Verificar.

    Ten en cuenta que 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 del dominio cuando abras la ventana de nuevo.

    Después de un tiempo de propagación amplio, 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, en función de tu proveedor de dominio. Consulta la documentación del proveedor de dominio a fin de obtener instrucciones detalladas para agregar registros TXT y tiempos de propagación.

    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.

En el asistente Agregar dominio personalizado de Firebaseconsole, selecciona Configuración rápida o Configuración avanzada.

La Configuración rápida se puede usar para dominios nuevos que actualmente no reciben tráfico o dominios que intentas transferir desde otro sitio de Hosting. Puedes usar la Configuración avanzada si ya tienes un dominio que recibe solicitudes en otro proveedor de hosting y necesitas una migración con tiempo de inactividad cero.

El asistente de Configuración avanzada te ayudará a establecer un certificado SSL y una reclamación de propiedad para permitir que Hosting entregue tráfico en el dominio antes de recibirlo.

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 una parte normal del proceso y se resolverá cuando esté disponible el certificado de tu dominio.

En el caso de 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 detalladas.

Tipo de dominio Clave de dominio personalizado
Dominio principal

Las entradas comunes incluyen las siguientes:

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

Las entradas comunes incluyen las siguientes:

  • El nombre completo del subdominio (por ejemplo, app.example.com)
  • Solo la parte del subdominio (por ejemplo, solo app, sin incluir .example.com)
  • Solo www para el subdominio de www.example.com

Proveedores comunes de dominio

Estos son algunos proveedores comunes de dominio y los tipos de entrada que cada uno podría requerir. Esta información se mantiene actualizada tanto como sea posible, pero consulta la documentación de tu proveedor de dominio para obtener instrucciones detalladas.

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

Estado Descripción
Requiere configuración

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: Si han transcurrido más de 24 horas, verifica si dirigiste los registros a Firebase Hosting.

  • 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 estén dirigidos solo 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 al 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 las autoridades certificadas “letsencrypt.org” y “pki.goog” puedan crear certificados SSL para el dominio.
  • El código de desafío no es válido.
    Si usas el flujo de Configuración avanzada y la migración falla, el token (y su código de desafío) no son válidos.
    Sugerencia para la solución de problemas: Selecciona la opción Ver del dominio y proporciona un token nuevo al dominio existente.
  • 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.
Certificado de creación

Se está produciendo un certificado SSL para tu dominio.

Conectado

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