Solucionar problemas de dominios personalizados y Páginas de GitHub

Puedes buscar errores comunes para resolver los problemas que existan con los dominios personalizados o HTTPS para tu sitio de Páginas de GitHub.

Páginas de GitHub se encuentra disponible en los repositorios públicos con GitHub Free y con GitHub Free para las organizaciones, y en los repositorios públicos y privados con GitHub Pro, GitHub Team, Nube de GitHub Enterprise, y GitHub Enterprise Server. Para obtener más información, consulta la sección "Productos de GitHub".

Errores CNAME

Los dominios personalizados se almacenan en un archivo CNAME en la raíz de tu fuente de publicación. Puedes agregar o actualizar este archivo a través de la configuración del repositorio o manualmente. Para obtener más información, consulta "Administrar un dominio personalizado para tu sitio de Páginas de GitHub".

Para que tu sitio se represente en el dominio correcto, asegúrate de que el archivo CNAME aún exista en el repositorio. Por ejemplo, muchos generadores de sitios estáticos realizan empujes forzados a tu repositorio, que pueden sobrescribir el archivo CNAME que se agregó a tu repositorio cuando configuraste tu dominio personalizado. Si compilas tu sitio localmente y subes los archivos generados a GitHub, asegúrate de extraer primero la confirmación que agregó el archivo CNAME a tu repositorio local. De este modo, el archivo se incluirá en la compilación.

Luego, asegúrate de que el archivo CNAME tenga el formato correcto.

  • El nombre de archivo CNAME debe estar todo en mayúsculas.
  • El archivo CNAME puede contener solo un dominio. Para apuntar múltiples dominios a tu sitio, debes configurar un redireccionamiento a través de tu proveedor DNS.
  • El archivo CNAME debe contener únicamente el nombre del dominio. Por ejemplo, www.example.com, blog.example.com, o example.com.
  • El nombre de dominio debe ser único a lo largo de todos los sitios de Páginas de GitHub. Por ejemplo, si el archivo CNAME de otro repositorio contiene example.com, no puedes usar example.com en el archivo CNAME para tu repositorio.

Error de configuración DNS

Si tienes problemas para apuntar el dominio predeterminado para tu sitio a tu dominio personalizado, contáctate con tu proveedor DNS.

También puedes utilizar uno de los siguientes métodos para probar si los registros de DNS de tus dominios personalizados están configurados correctamente:

Nombres de dominios personalizados que no son compatibles

Si tu dominio personalizado no es compatible, puede que debas cambiar tu dominio a un dominio compatible. También te puedes contactar con tu proveedor DNS para ver si ofrece servicios de reenvío para los nombres de dominio.

Asegúrate de que en tu sitio no ocurra lo siguiente:

  • Uso de más de un dominio apex. Por ejemplo, example.com y anotherexample.com.

  • Uso de más de un subdominio www. Por ejemplo, www.example.com y www.anotherexample.com.

  • Uso de un dominio apex y de un subdominio personalizado. Por ejemplo, example.com y docs.example.com.

    La única exepción es el subdominio www. Si se configura correctamente, el subdominio www se redirigirá automáticamente al dominio apex. Para obtener más información, consulta "Administrar un dominio personalizado para tu sitio de Páginas de GitHub".

Advertencia: Es altamente recomendable no utilizar registros DNS comodines, como *.example.com. Un registro DNS comodín le permitirá a cualquiera que aloje un sitio Páginas de GitHub en uno de tus subdominios.

Para obtener una lista de dominios personalizados que son compatibles, consulta "Acerca de los dominios personalizados y de las Páginas de GitHub".

Errores HTTPS

A los sitios Páginas de GitHub que utilizan dominios personalizados que no están configurados de manera correcta con CNAME, ALIAS, ANAME o registros DNS A se puede acceder por HTTPS. Para obtener más información, consulta "Asegurar tu sitio de Páginas de GitHub con HTTPS".

Puede tardar hasta una hora que tu sitio se vuelva disponible a través de HTTPS una vez que configures tu dominio personalizado. Después de actualizar los ajustes DNS existentes, puede que debas eliminar y volver a agregar tu dominio personalizado a tu repositorio del sitio para activar el proceso de habilitación HTTPS. Para obtener más información, consulta "Administrar un dominio personalizado para tu sitio de Páginas de GitHub".

Si estás usando registros de Autorización de la Autoridad de Certificación (CAA), debe existir al menos un registro CAA con el valor letsencrypt.org para que tu sitio sea accesible a través de HTTPS. Para obtener más información, consulta "Autorización de la Autoridad de Certificado (CAA)" en la documentación de Let's Encrypt.

Formato de URL en Linux

Si la URL de tu sitio contiene un nombre de usuario o nombre de organización que comienza o termina con un guion, o que contiene guiones consecutivos, las personas que naveguen con Linux recibirán un error del servidor cuando traten de visitar tu sitio. Para corregir esto, cambia tu nombre de usuario de GitHub y elimina cualquier caracter que no sea alfanumérico. Para obtener más información, consulta Cambiar tu GitHub nombre de usuario"

Caché del navegador

Si has cambiado o eliminado recientemente tu dominio personalizado y no puedes acceder a la URL nueva en tu navegador, puede que debas limpiar el caché de tu navegador para llegar a la URL nueva. Para obtener más información acerca de limpiar tu caché, consulta la documentación de tu navegador.

¿Te ayudó este documento?

Política de privacidad

¡Ayúdanos a hacer geniales estos documentos!

Todos los documentos de GitHub son de código abierto. ¿Notas algo que esté mal o que no sea claro? Emite una solicitud de cambios.

Haz una contribución

O, aprende cómo contribuir.