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, 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
oexample.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 usarexample.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:
- Una herramienta de la CLI, como
dig
. Para obtener más información, consulta "Configurar un dominio personalizado para tu sitio de Páginas de GitHub". - Una herramienta de búsqueda de DNS en línea.
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
yanotherexample.com
. -
Uso de más de un subdominio de
www
. Por ejemplo,www.example.com
ywww.anotherexample.com
. -
Uso de un dominio apex y de un subdominio personalizado. Por ejemplo,
example.com
ydocs.example.com
.La única excepción es el subdominio
www
. Si se configura correctamente, el subdominiowww
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».
Warning
Se recomienda encarecidamente no usar registros DNS 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 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”.