Gerenciar um domínio personalizado do seu site do GitHub Pages

Pessoas com permissões de administrador para um repositório podem configurar um domínio personalizado de um site do GitHub Pages.

Sobre a configuração de domínio personalizado

Lembre-se de adicionar o domínio personalizado ao seu site do GitHub Pages antes de configurar o domínio personalizado com o provedor DNS. Se você configurar o domínio personalizado com o provedor DNS sem adicioná-lo ao GitHub, outra pessoa conseguirá hospedar um site em um dos seus subdomínios.

Configurando um subdomínio

Para configurar um www ou subdomínio personalizado, como www.example.com ou blog.exemplo.com, é preciso criar um arquivo CNAME no repositório do site e configurar um registro CNAME com o provedor DNS.

1. Em GitHub, acesse o repositório do seu site.

2. No nome do seu repositório, clique em Configurações.

   

3. Navegue até o provedor DNS e crie um registro CNAME que aponte seu subdomínio para o domínio padrão do seu site. Por exemplo, se você quiser usar o subdomínio www.example.com para seu site de usuário, crie um registro CNAME que aponte www.example.com para <user>.github.io. Se você desejar usar o subdomínio www.anotherexample.com no seu site da organização, crie um registro CNAME que aponte www. notherexample.com para <organization>.github.io. O registro CNAME sempre deve apontar para <user>.github.io ou <organization>.github.io, excluindo o nome do repositório. Para obter mais informações sobre como criar o registro correto, consulte a documentação do provedor do DNS. Para obter mais informações sobre o domínio-padrão de seu site, consulte "Sobre o GitHub Pages".

   Aviso: é altamente recomendável não usar registros DNS curingas, como *.example.com. O registro DNS curinga permite que qualquer pessoa hospede um site do em um dos subdomínios que você tem.

4. Abra TerminalTerminalGit Bash.

5. Para confirmar que o registro DNS foi configurado corretamente, use o comando dig, substituindo WW.EXAMPLE.COM pelo seu subdomínio.

   $ 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

6. Se usar um gerador de site estático para criar seu site localmente e fizer push dos arquivos gerados para GitHub, faça pull do commit que adicionou o arquivo CNAME ao seu repositório local. Para obter mais informações, consulte "Solucionar problemas de domínios personalizados e GitHub Pages".

7. Opcionalmente, para aplicar criptografia de HTTPS no seu site, selecione Exigir HTTPS. Pode levar até 24 horas para que esta opção fique disponível. Para obter mais informações, consulte "Proteger seu site do GitHub Pages com HTTPS".

   

Configurando um domínio apex

Para configurar um domínio apex, como example.com, você deve configurar um arquivo CNAME no repositório do GitHub Pages e um registro ALIAS, ANAME ou A com o provedor DNS.

Se você estiver usando um domínio apex como seu domínio personalizado, recomendamos também configurar um subdomínio www. Se você configurar os registros corretos para cada tipo de domínio através do seu provedor DNS, GitHub Pages irá automaticamente criar redirecionamentos entre os domínios. Por exemplo, se você configurar www.example.com como seu domínio personalizado para o seu site, e você tem os registros ALIAS e CNAME configurados para os domínios apex e www. Logo, example.com irá redirecionar para www.exemplo.com. Para obter mais informações, consulte "Gerenciar um domínio personalizado para seu site do GitHub Pages".

1. Em GitHub, acesse o repositório do seu site.

2. No nome do seu repositório, clique em Configurações.

   

3. Navegue até o provedor DNS e crie um registro ALIAS, ANAME ou A. Para obter mais informações sobre como criar o registro correto, consulte a documentação do provedor do DNS.

   • Para criar um registro ALIAS ou ANAME, aponte o domínio apex para o domínio padrão do seu site. Para obter mais informações sobre o domínio-padrão de seu site, consulte "Sobre o GitHub Pages".
   • Para criar um registro A, aponte o domínio apex para os endereços IP do GitHub Pages.

     185.199.108.153
     185.199.109.153
     185.199.110.153
     185.199.111.153

   Aviso: é altamente recomendável não usar registros DNS curingas, como *.example.com. O registro DNS curinga permite que qualquer pessoa hospede um site do em um dos subdomínios que você tem.

4. Abra TerminalTerminalGit Bash.

5. Para confirmar que o registro DNS foi configurado corretamente, use o comando dig, substituindo WW.EXAMPLE.COM pelo domínio apex. Confirme que os resultados correspondem aos endereços IP do GitHub Pages acima.

   $ dig EXAMPLE.COM +noall +answer
   > 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

6. Se usar um gerador de site estático para criar seu site localmente e fizer push dos arquivos gerados para GitHub, faça pull do commit que adicionou o arquivo CNAME ao seu repositório local. Para obter mais informações, consulte "Solucionar problemas de domínios personalizados e GitHub Pages".

7. Opcionalmente, para aplicar criptografia de HTTPS no seu site, selecione Exigir HTTPS. Pode levar até 24 horas para que esta opção fique disponível. Para obter mais informações, consulte "Proteger seu site do GitHub Pages com HTTPS".

   

Leia mais

• "Solucionar problemas de domínios personalizados e do GitHub Pages"