Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

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 is available in public repositories with GitHub gratis, and in public and private repositories with GitHub Pro, Equipo de GitHub, Nube de GitHub Enterprise, and Servidor de GitHub Enterprise. For more information, see "GitHub's products."

En este artículo

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.
  • La entrada CNAME debe ser el dominio solo. Por ejemplo, www.example.com,blog.example.com o example.com.
  • La entrada CNAME solo se puede usar una vez en 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 probar si los registros DNS de tu dominio personalizado están configurados correctamente. Para obtener más información, consulta "Administrar un dominio personalizado para tu sitio de Páginas de GitHub".

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.

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.

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos