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.
O comando dig
, que pode ser usado para verificar a configuração correta dos registros DNS, não está incluído no Windows. Antes de verificar se os registros DNS estão configurados corretamente, você deve instalar BIND.
Observação: as alterações no DNS podem levar até 24 horas para serem propagadas.
Configurando um subdomínio
Para configurar um www
ou um subdomínio personalizado como, por exemplo, www.example.com
ou blog.example.com
, você deve adicionar seu domínio nas configurações do repositório, o que criará um arquivo CNAME no repositório do seu site. Em seguida, configure um registro CNAME com seu provedor DNS.
-
Em GitHub, acesse o repositório do seu site.
-
No nome do seu repositório, clique em Configurações.
-
In the "Code and automation" section of the sidebar, click Pages.
-
Em "Domínio personalizado,", digite o seu domínio personalizado e clique em Salvar. Isso criará um commit que adiciona um arquivo CNAME à raiz da sua fonte de publicação.
-
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íniowww.example.com
para seu site de usuário, crie um registroCNAME
que apontewww.example.com
para<user>.github.io
. Se você desejar usar o subdomíniowww.anotherexample.com
no seu site da organização, crie um registroCNAME
que apontewww. notherexample.com
para<organization>.github.io
. O registroCNAME
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 GitHub Pages em um dos subdomínios que você tem. -
Abra TerminalTerminalGit Bash.
-
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
-
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".
-
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 seu repositório de GitHub Pages e pelo menos um ALIAS
, ANAME
ou um registro A
com seu 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 domínio personalizado do seu site, e você tiver registros de DNS de GitHub Pages configurados para os domínios apex e www
, example. om
irá redirecionar para www.example.com
. Note que redirecionamentos automáticos só se aplicam ao subdomínio www
. Redirecionamentos automáticos não se aplicam a nenhum outro subdomínio, como o blogue
. Para obter mais informações, consulte "Configurar um subdomínio".
-
Em GitHub, acesse o repositório do seu site.
-
No nome do seu repositório, clique em Configurações.
-
In the "Code and automation" section of the sidebar, click Pages.
-
Em "Domínio personalizado,", digite o seu domínio personalizado e clique em Salvar. Isso criará um commit que adiciona um arquivo CNAME à raiz da sua fonte de publicação.
-
Navegue até o provedor DNS e crie um registro
ALIAS
,ANAME
ouA
. Você também pode criar registros deAAAA
para suporte ao IPv6. 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](/articles/about-github-pages#types-of-github-pages-sites)". - Para criar registros `A`, aponte seu domínio apex para os endereços IP para GitHub Pages. <pre><code class="hljs language-shell">185.199.108.153 185.199.109.153 185.199.110.153 185.199.111.153</code></pre> - Para criar os registros de </code>AAAA`, aponte o seu domínio apex para os endereços IP para GitHub Pages.
2606:50c0:8000::153 2606:50c0:8001::153 2606:50c0:8002::153 2606:50c0:8003::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 GitHub Pages em um dos subdomínios que você tem. -
Abra TerminalTerminalGit Bash.
-
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.- Para 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 registros
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
- Para registros de
-
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".
-
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".
Configurar um domínio apex e a variante de subdomínio www
Ao usar um domínio apex, recomendamos que você configure o seu site de GitHub Pages para hospedar o conteúdo tanto no domínio apex quanto na variante de subdomínio www
.
Para configurar um subdomínio www
junto com o domínio apex, você deve primeiro configurar um domínio apex criando um ALIAS
, ANOME
ou um registro A
com o seu provedor DNS. Para obter mais informações, consulte "Configurar um domínio apex".
Depois de configurar o domínio apex, você deverá configurar um registro CNAME com seu provedor DNS.
- Acesse o provedor DNS e crie um registro
CNAME
que aponte www.example.com
para o domínio padrão do seu site: <user>.github.io
ou <organization>.github.io
. Não inclua 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".
- Para confirmar que o registro DNS foi configurado corretamente, use o comando
dig
substituindo WWW.EXAMPLE.COM pela sua variante de subdomínio 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
Remover um domínio personalizado
-
Em GitHub, acesse o repositório do seu site.
-
No nome do seu repositório, clique em Configurações. 
-
In the "Code and automation" section of the sidebar, click Pages.
-
Em "Domínio personalizado, clique em Remover. 
Protegendo seu domínio personalizado
If your GitHub Pages site is disabled but has a custom domain set up, it is at risk of a domain takeover. Ter um domínio personalizado configurado com o provedor DNS enquanto o site está desabilitado pode fazer com que outra pessoa acabe hospedando um site em um de seus subdomínios.
Verifying your custom domain prevents other GitHub users from using your domain with their repositories. If your domain is not verified, and your GitHub Pages site is disabled, you should immediately update or remove your DNS records with your DNS provider. Para obter mais informações, consulte "Verificando seu domínio personalizado para GitHub Pages".
Leia mais