Configurar un dominio personalizado para tu sitio de Páginas de GitHub

Puedes configurar o actualizar determinados registros DNS y las configuraciones de tu repositorio para que apunten el dominio predeterminado de tu sitio de Páginas de GitHub a un dominio personalizado.

Páginas de GitHub 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, Nube de GitHub Enterprise, y GitHub Enterprise Server. Para obtener más información, consulta la sección "Productos de GitHub".

Las personas con permisos de administración para un repositorio pueden configurar un dominio personalizado para un sitio de Páginas de GitHub.

Acerca de la configuración de dominios personalizados

Asegúrate de agregar tu dominio personalizado al sitio de Páginas de GitHub antes de configurar el dominio personalizado con tu proveedor DNS. Configurar tu dominio personalizado con tu proveedor DNS sin agregar tu dominio personalizado a GitHub podría dar como resultado que alguien aloje un sitio en uno de tus subdominios.

El comando dig, que se puede usar para verificar la correcta configuración de los registros DNS, no está incluido en Windows. Antes de poder verificar que tus registros DNS estén configurados correctamente, debes instalar BIND.

Nota: Los cambios DNS pueden tardar hasta 24 horas en propagarse.

Configurar un subdominio

Para configurar un subdominio personalizado o de www tal como www.example.com o blog.example.com, debes agregar tu dominio en la configuración de repositorio, el cual creará un archivo de CNAME en el repositorio de tu sitio. Después de esto, configura un registro de CNAME con tu proveedor de DNS.

  1. En GitHub, navega al repositorio de tu sitio.

  2. Debajo de tu nombre de repositorio, da clic en Configuración. Botón de configuración del repositorio

  3. En la barra lateral izquierda, da clic en Páginas. Pestaña de página en la barra lateral izquierda

  4. Debajo de "Dominio personalizado", teclea tu dominio personalizado y luego da clic en Guardar. Esto creará una confirmación que agregará un archivo CNAME en la raíz de tu fuente de publicación. Botón de guardar dominio personalizado

  5. Desplázate hasta tu proveedor DNS y crea un registro CNAME que apunte tu subdominio al dominio predeterminado de tu sitio. Por ejemplo, si quieres usar el subdominio www.example.com para tu sitio de usuario, crea un registro CNAME que apunte www.example.com a <user>.github.io. Si quieres utilizar el subdominio www.anotherexample.com para el sitio de tu organización, crea un registro de CNAME que apunte a www.anotherexample.com hacia <organization>.github.io. El registro CNAME siempre deberá apuntar hacia <user>.github.io o <organization>.github.io, excluyendo el nombre del repositorio. Para obtener más información acerca de cómo crear el registro correcto, consulta la documentación de tu proveedor de DNS. Para obtener más información acerca del dominio predeterminado para tu sitio, consulta la sección "Acerca de Páginas de GitHub".

    Advertencia: Es altamente recomendable no utilizar registros DNS comodines, como *.example.com. Un registro DNS comodín le permitirá a cualquiera que aloje un sitio Páginas de GitHub en uno de tus subdominios.

  6. Abre la TerminalTerminalGit Bash.

  7. Para confirmar que tu registro DNS esté configurado correctamente, usa el comando dig reemplazando WW.EXAMPLE.COM por tu subdominio.

    $ dig WWW.EXAMPLE.COM +nostats +nocomments +nocmd
        > ;WWW.EXAMPLE.COM.                     IN      A
        > WWW.EXAMPLE.COM.              3592    IN      CNAME   YOUR-USERNAME.github.io.
        > YOUR-USERNAME.github.io.      43192   IN      CNAME    GITHUB-PAGES-SERVER .
        >  GITHUB-PAGES-SERVER .         22      IN      A       192.0.2.1
  8. Si utilizas un generador de sitio estático para construir tu sitio localmente y subes los archivos generados a GitHub, extrae la confirmación que agregó el archivo CNAME a tu repositorio local. Para obtener más información, consulta la sección "Resolver problemas en dominios personalizados y en Páginas de GitHub".

  9. Opcionalmente, para requerir cifrado HTTPS para tu sitio, selecciona Requerir HTTPS. Puede tomar hasta 24 horas antes de que esta opción se encuentre disponible. Para obtener más información, consulta "Asegurar tu sitio de Páginas de GitHub con HTTPS". Opción de Requerir HTTPS para dominios personalizados

Configurar un dominio apex

Para coonfigurar un dominio apex, tal como example.com, debes configurar un archivo CNAME en tu repositorio de Páginas de GitHub y por lo menos un registro de ALIAS, ANAME, o A con tu proveedor de DNS.

Si estás utilizando un dominio apex como tu dominio personalizado, te recomendamos configurar un subdominio www. Si configuras los registros correctos para cada dominio, teclea a tu proveedor de DNS, Páginas de GitHub creará automáticamente redireccionamientos entre los dominios. Por ejemplo, sin configuras www.example.com como el dominio personalizado de tu sitio y tienes configurados los dominios de DNS de Páginas de GitHub para los dominios de apex y www, entonces, example.com te redirigirá a www.example.com. Nota que las redirecciones automáticas solo aplican al subdominio www. Las redirecciones automáticas no aplican a ningún otro subdominio, tal como blog. Para obtener más información, consulta la sección "Configurar un subdominio".

  1. En GitHub, navega al repositorio de tu sitio.

  2. Debajo de tu nombre de repositorio, da clic en Configuración. Botón de configuración del repositorio

  3. En la barra lateral izquierda, da clic en Páginas. Pestaña de página en la barra lateral izquierda

  4. Debajo de "Dominio personalizado", teclea tu dominio personalizado y luego da clic en Guardar. Esto creará una confirmación que agregará un archivo CNAME en la raíz de tu fuente de publicación. Botón de guardar dominio personalizado

  5. Desplázate hasta tu proveedor DNS y crea un registro ALIAS, ANAME o A. También puedes crear registros de AAAA para compatibilidad con IPv6. Para obtener más información acerca de cómo crear el registro correcto, consulta la documentación de tu proveedor de DNS.

    • Para crear un registro ALIAS o ANAME, apunta tu dominio apex al dominio predeterminado de tu sitio. Para obtener más información acerca del dominio predeterminado para tu sitio, consulta la sección "Acerca de Páginas de GitHub".
    • Para crear registros A, apunta tu dominio apex a las direccioens IP de Páginas de GitHub.
      185.199.108.153
      185.199.109.153
      185.199.110.153
      185.199.111.153
    • Para crear registros de AAAA, apunta tu dominio de apex a la dirección IP para Páginas de GitHub.
      2606:50c0:8000::153
      2606:50c0:8001::153
      2606:50c0:8002::153
      2606:50c0:8003::153

    Advertencia: Es altamente recomendable no utilizar registros DNS comodines, como *.example.com. Un registro DNS comodín le permitirá a cualquiera que aloje un sitio Páginas de GitHub en uno de tus subdominios.

  6. Abre la TerminalTerminalGit Bash.

  7. Para confirmar que tu registro DNS esté configurado correctamente, usa el comando dig reemplazando EXAMPLE.COM por tu dominio apex. Confirma que los resultados coincidan con las direcciones IP de las Páginas de GitHub que aparecen arriba.

    • Para los registros de A.
      $ dig EXAMPLE.COM +noall +answer -t A
      > EXAMPLE.COM     3600    IN A     185.199.108.153
      > EXAMPLE.COM     3600    IN A     185.199.109.153
      > EXAMPLE.COM     3600    IN A     185.199.110.153
      > EXAMPLE.COM     3600    IN A     185.199.111.153
    • Para los registros de AAAA.
      $ dig EXAMPLE.COM +noall +answer -t AAAA
      > EXAMPLE.COM     3600    IN AAAA     2606:50c0:8000::153
      > EXAMPLE.COM     3600    IN AAAA     2606:50c0:8001::153
      > EXAMPLE.COM     3600    IN AAAA     2606:50c0:8002::153
      > EXAMPLE.COM     3600    IN AAAA     2606:50c0:8003::153
  8. Si utilizas un generador de sitio estático para construir tu sitio localmente y subes los archivos generados a GitHub, extrae la confirmación que agregó el archivo CNAME a tu repositorio local. Para obtener más información, consulta la sección "Resolver problemas en dominios personalizados y en Páginas de GitHub".

  9. Opcionalmente, para requerir cifrado HTTPS para tu sitio, selecciona Requerir HTTPS. Puede tomar hasta 24 horas antes de que esta opción se encuentre disponible. Para obtener más información, consulta "Asegurar tu sitio de Páginas de GitHub con HTTPS". Opción de Requerir HTTPS para dominios personalizados

Configurar un dominio de apex y la variante de subdominio www

Cuando utilizas un dominio apex, te recomendamos configurar tu sitio de Páginas de GitHub para hospedar contenido tanto en el dominio de apex como en la variante de subdominio www.

Para configurar un subdominio www junto con el dominio de apex, primero debes configurar un dominio de apex, el cual creará un ALIAS, NOMBRE o registro A con tu proveedor de DNS. Para obtener más información, consulta la sección Configurar un dominio de apex".

Después de configurar el domnio apex, debes configurar un registro de CNAME con tu proveedor de DNS.

  1. Navega a tu proveedor de DNS y crea un registro de CNAME que apunte a www.example.com al dominio predeterminado de tu sitio: <user>.github.io o <organization>.github.io. No incluyas el nombre de repositorio. Para obtener más información acerca de cómo crear el registro correcto, consulta la documentación de tu proveedor de DNS. Para obtener más información acerca del dominio predeterminado para tu sitio, consulta la sección "Acerca de Páginas de GitHub".
  2. Para confirmar que tu registro de DNS se configuró correctamente, utiliza el comando dig, reemplazando a WWW.EXAMPLE.COM con tu variante de subdominio www.
    $ dig WWW.EXAMPLE.COM +nostats +nocomments +nocmd
        > ;WWW.EXAMPLE.COM.                     IN      A
        > WWW.EXAMPLE.COM.              3592    IN      CNAME   YOUR-USERNAME.github.io.
        > YOUR-USERNAME.github.io.      43192   IN      CNAME    GITHUB-PAGES-SERVER .
        >  GITHUB-PAGES-SERVER .         22      IN      A       192.0.2.1

Eliminar un dominio personalizado

  1. En GitHub, navega al repositorio de tu sitio.

  2. Debajo de tu nombre de repositorio, da clic en Configuración. Botón de configuración del repositorio

  3. En la barra lateral izquierda, da clic en Páginas. Pestaña de página en la barra lateral izquierda

  4. Debajo de "Dominio personalizado", haz clic en Eliminar. Botón de guardar dominio personalizado

Leer más

¿Te ayudó este documento?

Política de privacidad

¡Ayúdanos a hacer geniales estos documentos!

Todos los documentos de GitHub son de código abierto. ¿Notas algo que esté mal o que no sea claro? Emite una solicitud de cambios.

Haz una contribución

O, aprende cómo contribuir.