Skip to main content

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 GitHub Pages.

GitHub Pages 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, GitHub Enterprise Cloud, y GitHub Enterprise Server. Para más información, vea "Productos de GitHub".

Errores de CNAME

Si publicas desde un flujo de trabajo de GitHub Actions personalizado, se omite cualquier archivo CNAME y no es necesario.

Si publicas desde una rama, los dominios personalizados se almacenan en un archivo CNAME en la raíz de la 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, consulte "Administración de un dominio personalizado para el sitio de GitHub Pages".

Para que su sitio se represente en el dominio correcto, es importante asegurarse de que el archivo CNAME aún exista en el repositorio. Por ejemplo, muchos generadores de sitios estáticos realizan envíos de cambios forzosos al repositorio que pueden sobrescribir el archivo CNAME que se agregó al repositorio cuando configuró su dominio personalizado. Si compila el sitio de manera local y envía los archivos generados a GitHub Enterprise Cloud, asegúrate de incorporar primero la confirmación que agregó el archivo CNAME al repositorio local. De este modo, el archivo se incluirá en la compilación.

A continuación, asegúrese de que el archivo CNAME tenga el formato correcto.

  • El nombre de archivo CNAME debe estar en mayúsculas.
  • El archivo CNAME solo puede contener un dominio. Para apuntar múltiples dominios a tu sitio, debes configurar un redireccionamiento a través de tu proveedor DNS.
  • El archivo CNAME solo debe contener el nombre de 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 GitHub Pages. Por ejemplo, si el archivo CNAME de otro repositorio contiene example.com, no puede usar example.com en el archivo CNAME de su 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 de 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 excepción es el subdominio www. Si se configura correctamente, el subdominio www se redirigirá automáticamente al dominio de vértice. Para obtener más información, consulte "Administración de un dominio personalizado para el sitio de GitHub Pages".

Advertencia: Se recomienda encarecidamente no usar registros DNS con caracteres comodín, como *.example.com. Un registro DNS comodín permitirá a cualquiera hospedar un sitio de GitHub Pages en uno de los subdominios, incluso aquellos que están verificados. Para más información, vea "Comprobación de un dominio personalizado para GitHub Pages".

Para obtener una lista de dominios personalizados admitidos, consulte "Acerca de dominios personalizados y GitHub Pages".

Errores HTTPS

Los sitios de GitHub Pages que usan dominios personalizados configurados correctamente con registros DNS CNAME, ALIAS, ANAME o A son accesibles mediante HTTPS. Para más información, vea "Protección del sitio de GitHub Pages 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, consulte "Administración de un dominio personalizado para el sitio de GitHub Pages".

Si está usando registros de Autorización de entidad de certificación (CAA), debe existir al menos un registro de CAA con el valor letsencrypt.org para que el sitio sea accesible mediante HTTPS. Para obtener más información, consulte "Autorización de entidad de certificación (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 Enterprise Cloud y elimina cualquier caracter que no sea alfanumérico. Para obtener más información, consulte "Cambio del nombre de usuario de GitHub".

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.