Skip to main content
Publicamos actualizaciones para la documentación con frecuencia y es posible que aún se esté traduciendo esta página. Para obtener la información más reciente, visite la documentación en inglés.
 

 

Managing a custom domain for your GitHub Pages site

En este artículo

You can set up or update certain DNS records and your repository settings to point the default domain for your GitHub Pages site to a custom domain.

GitHub Pages 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, GitHub Enterprise Cloud, y GitHub Enterprise Server. Para más información, vea "Productos de GitHub".

People with admin permissions for a repository can configure a custom domain for a GitHub Pages site.

About custom domain configuration

Make sure you add your custom domain to your GitHub Pages site before configuring your custom domain with your DNS provider. Configuring your custom domain with your DNS provider without adding your custom domain to GitHub Enterprise Cloud could result in someone else being able to host a site on one of your subdomains.

The dig command, which can be used to verify correct configuration of DNS records, is not included in Windows. Before you can verify that your DNS records are configured correctly, you must install BIND.

Note: DNS changes can take up to 24 hours to propagate.

Configuring a subdomain

To set up a www or custom subdomain, such as www.example.com or blog.example.com, you must add your domain in the repository settings. After that, configure a CNAME record with your DNS provider.

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

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

  3. In the "Code and automation" section of the sidebar, click Pages.

  4. Under "Custom domain", type your custom domain, then click Save. If you are publishing your site from a branch, this will create a commit that adds a CNAME file to the root of your source branch. If you are publishing your site with a custom GitHub Actions workflow , no CNAME file is created. For more information about your publishing source, see "Configuring a publishing source for your GitHub Pages site." Save custom domain button

Note: If your custom domain is an internationalized domain name, you must enter the Punycode encoded version.

For more information on Punycodes, see Internationalized domain name.

  1. Navigate to your DNS provider and create a CNAME record that points your subdomain to the default domain for your site. For example, if you want to use the subdomain www.example.com for your user site, create a CNAME record that points www.example.com to <user>.github.io. If you want to use the subdomain another.example.com for your organization site, create a CNAME record that points another.example.com to <organization>.github.io. The CNAME record should always point to <user>.github.io or <organization>.github.io, excluding the repository name. Para obtener más información acerca de cómo crear el registro correcto, consulta la documentación de tu proveedor de DNS. Para más información sobre el dominio predeterminado del sitio, vea "Acerca de GitHub Pages".

    Advertencia: Se recomienda encarecidamente no usar registros DNS con caracteres comodín, como *.example.com. Un registro DNS comodín permitirá a cualquiera hospedar un sitio de GitHub Pages en uno de los subdominios, incluso aquellos que están verificados. Para más información, vea "Comprobación de un dominio personalizado para GitHub Pages".

  2. Abra TerminalTerminalGit Bash.

  3. To confirm that your DNS record configured correctly, use the dig command, replacing WWW.EXAMPLE.COM with your subdomain.

    $ 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

  4. Si usa un generador de sitios estáticos para crear el sitio localmente e inserta los archivos generados a GitHub Enterprise Cloud, extraiga la confirmación que ha agregado el archivo CNAME al repositorio local. Para más información, vea "Solución de problemas de dominios personalizados y GitHub Pages".

  5. Opcionalmente, para aplicar cifrado HTTPS en el sitio, seleccione Enforce HTTPS. Puede tomar hasta 24 horas antes de que esta opción se encuentre disponible. Para más información, vea "Protección del sitio de GitHub Pages con HTTPS". Opción Enforce HTTPS para dominios personalizados

Configuring an apex domain

To set up an apex domain, such as example.com, you must configure a custom domain in your repository settings and at least one ALIAS, ANAME, or A record with your DNS provider.

Si usa un dominio de vértice como el dominio personalizado, también se recomienda configurar un subdominio www. Si configuras los registros correctos para cada dominio, teclea a tu proveedor de DNS, GitHub Pages creará automáticamente redireccionamientos entre los dominios. Por ejemplo, si configura www.example.com como dominio personalizado para el sitio y tiene registros DNS de GitHub Pages configurados para los dominios de vértice y www, example.com se redirigirá a www.example.com. Tenga en cuenta que las redirecciones automáticas solo se aplican al subdominio www. Las redirecciones automáticas no se aplican a ningún otro subdominio, como blog. For more information, see "Configuring a subdomain."

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

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

  3. In the "Code and automation" section of the sidebar, click Pages.

  4. Under "Custom domain", type your custom domain, then click Save. If you are publishing your site from a branch, this will create a commit that adds a CNAME file to the root of your source branch. If you are publishing your site with a custom GitHub Actions workflow , no CNAME file is created. For more information about your publishing source, see "Configuring a publishing source for your GitHub Pages site." Save custom domain button

  5. Navigate to your DNS provider and create either an ALIAS, ANAME, or A record. You can also create AAAA records for IPv6 support. Para obtener más información acerca de cómo crear el registro correcto, consulta la documentación de tu proveedor de DNS.

    • To create an ALIAS or ANAME record, point your apex domain to the default domain for your site. Para más información sobre el dominio predeterminado del sitio, vea "Acerca de GitHub Pages".
    • To create A records, point your apex domain to the IP addresses for GitHub Pages. 
      185.199.108.153
185.199.109.153
185.199.110.153
185.199.111.153
    • To create AAAA records, point your apex domain to the IP addresses for GitHub Pages. 
      2606:50c0:8000::153
2606:50c0:8001::153
2606:50c0:8002::153
2606:50c0:8003::153

    Advertencia: Se recomienda encarecidamente no usar registros DNS con caracteres comodín, como *.example.com. Un registro DNS comodín permitirá a cualquiera hospedar un sitio de GitHub Pages en uno de los subdominios, incluso aquellos que están verificados. Para más información, vea "Comprobación de un dominio personalizado para GitHub Pages".

  6. Abra TerminalTerminalGit Bash.

  7. To confirm that your DNS record configured correctly, use the dig command, replacing EXAMPLE.COM with your apex domain. Confirm that the results match the IP addresses for GitHub Pages above.

    • For A records. 
      $ 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
    • For AAAA records. 
      $ 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 usa un generador de sitios estáticos para crear el sitio localmente e inserta los archivos generados a GitHub Enterprise Cloud, extraiga la confirmación que ha agregado el archivo CNAME al repositorio local. Para más información, vea "Solución de problemas de dominios personalizados y GitHub Pages".

  9. Opcionalmente, para aplicar cifrado HTTPS en el sitio, seleccione Enforce HTTPS. Puede tomar hasta 24 horas antes de que esta opción se encuentre disponible. Para más información, vea "Protección del sitio de GitHub Pages con HTTPS". Opción Enforce HTTPS para dominios personalizados

Configuring an apex domain and the www subdomain variant

When using an apex domain, we recommend configuring your GitHub Pages site to host content at both the apex domain and that domain's www subdomain variant.

To set up a www subdomain alongside the apex domain, you must first configure an apex domain by creating an ALIAS, ANAME, or A record with your DNS provider. For more information, see "Configuring an apex domain."

After you configure the apex domain, you must configure a CNAME record with your DNS provider.

  1. Navigate to your DNS provider and create a CNAME record that points www.example.com to the default domain for your site: <user>.github.io or <organization>.github.io. Do not include the repository name. Para obtener más información acerca de cómo crear el registro correcto, consulta la documentación de tu proveedor de DNS. Para más información sobre el dominio predeterminado del sitio, vea "Acerca de GitHub Pages".
  2. To confirm that your DNS record configured correctly, use the dig command, replacing WWW.EXAMPLE.COM with your www subdomain variant. 
    $ 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

Removing a custom domain

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

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

  3. In the "Code and automation" section of the sidebar, click Pages.

  4. Under "Custom domain," click Remove. Save custom domain button

Securing your custom domain

Si se inhabilita tu sitio de GitHub Pages pero este tiene configurado un dominio personalizado, está en riesgo de que lo tomen. La configuración de tu dominio personalizado con tu proveedor DNS mientras tu sitio está inhabilitado, podría hacer que alguien más aloje un sitio en un o de tus subdominios.

El verificar tu dominio personalizado previene que otros usuarios de GitHub lo utilicen con sus repositorios. Si tu dominio no está verificado y tu sitio de GitHub Pages está inhabilitado, deberías actualizar o eliminar tus registros de DNS inmediatamente con tu proveedor de DNS. For more information, see "Verifying your custom domain for GitHub Pages."

Further reading