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.
-
Na barra lateral esquerda, clique em Pages (Páginas).
-
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". -
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
To set up an apex domain, such as example.com
, you must configure a CNAME file in your GitHub Pages repository and at least one ALIAS
, ANAME
, or A
record with your DNS provider.
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. For example, if you configure www.example.com
as the custom domain for your site, and you have GitHub Pages DNS records set up for the apex and www
domains, then example.com
will redirect to www.example.com
. Note that automatic redirects only apply to the www
subdomain. Automatic redirects do not apply to any other subdomains, such as blog
. For more information, see "Configuring a subdomain."
-
Em GitHub, acesse o repositório do seu site.
-
No nome do seu repositório, clique em Configurações.
-
Na barra lateral esquerda, clique em Pages (Páginas).
-
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
. Para obter mais informações sobre como criar o registro correto, consulte a documentação do provedor do DNS.- Para criar um registro
ALIAS
ouANAME
, 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". - 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
- Para criar um registro
-
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.$ 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
-
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".
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, which will create 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 to configure a CNAME record with your DNS provider.
- Navigate to your DNS provider and create a
CNAME
record that pointswww.example.com
to the default domain for your site:<user>.github.io
or<organization>.github.io
. Do not include the repository name. 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". - To confirm that your DNS record configured correctly, use the
dig
command, replacing WWW.EXAMPLE.COM with yourwww
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
-
Em GitHub, acesse o repositório do seu site.
-
No nome do seu repositório, clique em Configurações.
-
Na barra lateral esquerda, clique em Pages (Páginas).
-
Under "Custom domain," click Remove.