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.

¿Quién puede utilizar esta característica?

GitHub Pages is available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see "GitHub’s plans."

GitHub Pages now uses GitHub Actions to execute the Jekyll build. When using a branch as the source of your build, GitHub Actions must be enabled in your repository if you want to use the built-in Jekyll workflow. Alternatively, if GitHub Actions is unavailable or disabled, adding a .nojekyll file to the root of your source branch will bypass the Jekyll build process and deploy the content directly. For more information on enabling GitHub Actions, see "Managing GitHub Actions settings for a repository."

En este artículo

Errores de CNAME

Si publica 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, vea «Configurar un dominio personalizado para tu sitio de Páginas de GitHub».

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, vea «Configurar un dominio personalizado para tu sitio de Páginas de GitHub».

Advertencia: Se recomienda encarecidamente que no uses registros DNS con caracteres comodín, como *.example.com. Estos registros te ponen en riesgo inmediato de adquisición de dominio, incluso si compruebas el dominio. Por ejemplo, si compruebas example.com, esto impide que alguien use a.example.com, pero todavía podrían hacerse cargo de b.a.example.com (que está cubierto por el registro DNS con caracteres comodín). Para obtener más información, vea «Verificar tu dominio personalizado para GitHub Pages».

Para una lista de los dominios personalizados admitidos, consulta "Acerca de los dominios personalizados y las Páginas de GitHub".

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 obtener más información, vea «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, vea «Configurar un dominio personalizado para tu sitio de Páginas de GitHub».

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, vea «Cambiar tu 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.

Nombre de dominio ya en uso

Si está intentando usar un dominio personalizado y dice que el dominio ya está en uso, puedes hacer que el dominio esté disponible para tu propio uso comprobándolo primero. Para obtener más información, consulta “Verificar tu dominio personalizado para GitHub Pages”.