Dominio personalizado: de github.io a tu propio dominio
Objetivo en una frase: completar la configuración del dominio personalizado de GitHub Pages — cambiar la dirección <用户名>.github.io publicada en la lección anterior por tu propio dominio, para que la barra de direcciones ya no incluya github.io.
Antes de empezar
Confirma tres cosas:
- Has completado «GitHub Pages en línea: alojamiento de sitios estáticos gratuito» y el sitio se abre a través de la dirección predeterminada.
- Ya tienes un dominio propio. Si aún no lo has comprado, el proceso de compra no entra en el alcance de este artículo; esta lección solo trata la vinculación.
- Puedes iniciar sesión en la consola DNS del dominio (donde se añaden los registros de resolución).
Recordatorio: GitHub Pages es un alojamiento estático público; cambiar de dominio solo cambia el «número de la puerta», el contenido del sitio sigue siendo visible en la red pública, así que no pongas información privada ahí.
Sígueme paso a paso
Paso 1: primero verifica el dominio en GitHub para evitar que sea apropiado
Entra en la configuración de Pages de GitHub, añade tu dominio como «dominio verificado», sigue las indicaciones de la página para añadir en la consola DNS el registro de verificación requerido y luego vuelve a GitHub para completar la verificación.
Resultado esperado: el dominio aparece como verificado. Hacer este paso primero vincula el dominio a tu cuenta por adelantado, evitando que otra persona lo conecte antes a su propio sitio de Pages.
Paso 2: añade registros de resolución en la consola DNS
Añade dos registros al dominio:
wwwSubdominio: registro CNAME, apuntando a<用户名>.github.io.- Dominio raíz (el dominio principal sin www): registro A, ALIAS o ANAME, apuntando a los servidores de GitHub Pages @@I18N_KEEP_000007@@.
La recomendación oficial es usar el subdominio www como dominio principal; es la configuración más sencilla.
Resultado esperado: al consultar www.你的域名 con una herramienta de consulta DNS, verás que apunta a <用户名>.github.io.
Paso 3: vincula el dominio personalizado en la configuración del repositorio
Abre el repositorio del sitio, entra en Settings → Pages, escribe en Custom domain el dominio que has elegido (se recomienda www.你的域名) y guarda. Luego revisa el archivo CNAME en el directorio de publicación del repositorio; su contenido debe ser tu dominio; si no existe, créalo manualmente.
Resultado esperado: cuando la resolución surta efecto, al visitar www.你的域名 se abrirá el sitio; si tanto la resolución del dominio raíz como la de www están configuradas, GitHub redirigirá automáticamente entre ambas y podrás llegar desde cualquiera de las dos.
Verificación
- Visita
www.你的域名en el navegador; el contenido coincide con<用户名>.github.io. - Abre el repositorio y confirma que el archivo CNAME existe y que su contenido es tu dominio.
- Visita más tarde el dominio raíz y confirma que la redirección automática funciona.
Errores comunes
- Vincular sin verificar primero: usar el dominio sin verificarlo puede permitir que otra cuenta de GitHub lo reclame y desvíe el tráfico. Primero verifica, luego vincula.
- Modificar solo el archivo CNAME no surte efecto: los cambios en el archivo CNAME del repositorio no añaden ni eliminan automáticamente el dominio personalizado del sitio; la configuración del dominio debe hacerse mediante la configuración del repositorio (Settings → Pages) o la API. Al cambiar o retirar el dominio, hazlo en la página de configuración, no modifiques solo el archivo CNAME.
- Tipo de registro del dominio raíz incompatible: algunos proveedores DNS no admiten ALIAS/ANAME, por lo que el dominio raíz solo puede usar un registro A. Si prefieres evitar complicaciones, usa el subdominio www recomendado oficialmente; un solo registro CNAME es suficiente.
- En Cloudflare, elimina el CNAME antes de eliminar el proyecto: si también has desplegado este dominio en Cloudflare Pages, elimina primero el registro de resolución CNAME correspondiente antes de borrar el proyecto; de lo contrario, el registro quedará residual y apuntará a un proyecto ya eliminado.
- Sacar conclusiones al probar inmediatamente después de cambiar: la propagación de DNS lleva tiempo; que no se abra durante unos minutos no significa que la configuración esté mal, no te apresures a revertir.
Próxima lección
El dominio es solo la fachada; con esto la ruta desde cero prácticamente termina. La próxima lección, «Glosario rápido: manual de jerga del vibe coding», reúne en una tabla de consulta rápida los términos aparecidos a lo largo del recorrido, para consultarlos cuando no entiendas algo. Lecturas relacionadas: «GitHub Pages en línea: alojamiento de sitios estáticos gratuito», «Comparación de plataformas de despliegue: cuotas gratuitas, limitaciones y cómo elegir».