¿Cómo conecto mi dominio a GitHub Pages?

¿Qué necesito antes de conectar un dominio a GitHub Pages?

DotAlmanac es una guía de extensiones de dominio y un registrador: compara todas las extensiones y luego registra la que elijas sin KYC y paga con criptomonedas. Para seguir esta guía, necesitas tres cosas.

• Un dominio con los servidores de nombres de DotAlmanac. En la pestaña Servidores de nombres del dominio debe aparecer "Nuestros servidores de nombres". Si el dominio usa otros servidores de nombres, añade los mismos registros en ese proveedor de DNS.
• Un repositorio con GitHub Pages activado. Puede publicar desde una rama o desde un flujo de trabajo de GitHub Actions.
• Tu nombre de usuario u organización de GitHub. Va en el registro www. El nombre del repositorio nunca.

Muchos desarrolladores eligen .dev o .app para la web de un proyecto. Revisa antes la renovación: según la tabla de precios de DotAlmanac, .dev se renueva un 44 % por encima de su precio del primer año y .app un 67 % por encima, a 29 de octubre de 2026. Un .dev cuesta 8,99 US$/año y luego 12,99 US$/año. Ambas extensiones exigen HTTPS, que GitHub Pages proporciona. Compáralas en .app vs .dev.

¿Puedo pegar los registros como archivo de zona?

Sí. Abre DNS › Importar / exportar › Importar archivo de zona, elige "Añadir a los registros existentes" y pega las líneas de abajo. Sustituye octocat por tu propio nombre de usuario. La importación lee la sintaxis BIND estándar, muestra una vista previa y no envía nada hasta que guardas.

@    3600  IN  A      185.199.108.153
@    3600  IN  A      185.199.109.153
@    3600  IN  A      185.199.110.153
@    3600  IN  A      185.199.111.153
@    3600  IN  AAAA   2606:50c0:8000::153
@    3600  IN  AAAA   2606:50c0:8001::153
@    3600  IN  AAAA   2606:50c0:8002::153
@    3600  IN  AAAA   2606:50c0:8003::153
www  3600  IN  CNAME  octocat.github.io.

¿Uso el dominio sin www o con www en GitHub Pages?

Configura los dos e introduce en el repositorio el que prefieras. Cuando los registros del dominio raíz y de www son correctos, GitHub Pages redirige el otro hacia él.

GitHub admite un dominio raíz o un nombre www por sitio. No admite dos dominios raíz, dos nombres www, ni un dominio raíz combinado con otro subdominio personalizado. Para un proyecto en un subdominio, como docs.example.com, añade un CNAME de docs a USERNAME.github.io y omite los registros A.

¿Cuánto tarda mi dominio en funcionar en GitHub Pages?

Depende del TTL de los registros que los resolvedores vieron antes de tu cambio. El TTL es el número de segundos que un resolvedor guarda una respuesta en su caché.

• Un nombre sin ningún registro previo resuelve en cuanto guardas.
• Un registro sustituido conserva su valor antiguo en algunas cachés hasta que vence su TTL anterior. Los registros de la plantilla usan 3600 segundos, es decir, una hora.
• Planifica la migración con antelación: baja el TTL de los registros antiguos a 300 segundos un día antes del cambio.

La propia documentación de GitHub indica que los cambios de DNS pueden tardar hasta 24 horas en propagarse. El certificado HTTPS llega después de que la comprobación de DNS se complete correctamente.

¿Por qué GitHub dice que mi dominio no está configurado correctamente?

En la mayoría de los casos, un registro antiguo sigue respondiendo para el mismo nombre. Revisa estos puntos en orden:

• Registros sobrantes. Un registro A, AAAA o ALIAS antiguo en @, o un registro de parking, compite con los de GitHub. La plantilla los elimina; con las ediciones manuales se suele escapar alguno.
• Nombre del repositorio en el CNAME. El destino de www es solo USERNAME.github.io.
• Registro comodín. GitHub advierte que un registro como *.example.com crea un riesgo de secuestro del dominio. Elimínalo.
• Otros servidores de nombres. Si el dominio usa otro proveedor de DNS, los registros de la pestaña DNS de DotAlmanac no se sirven.
• Registros CAA. Si publicas registros CAA, GitHub exige al menos uno con el valor letsencrypt.org para HTTPS.

Comprueba el resultado con dig example.com +short o con cualquier herramienta de consulta DNS en línea.