Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

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

É possível definir ou atualizar determinados registros DNS e as configurações de repositório para apontar o domínio padrão do seu site do GitHub Pages para um domínio personalizado.

GitHub Pages is available in public repositories with GitHub Free, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see "GitHub's products."

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

Neste artigo

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 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. On GitHub, navigate to your site's repository.

  2. Under your repository name, click Settings.

    Repository settings button

  3. Under "Custom domain", type your custom domain, then click Save. This will create a commit that adds a CNAME file in the root of your publishing source.

    Save custom domain button

  4. 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. For more information about how to create the correct record, see your DNS provider's documentation. For more information about the default domain for your site, see "About GitHub Pages."

  5. Abra Terminal (Terminal)Terminal (Terminal)Git Basho terminal.

  6. 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
  7. If you use a static site generator to build your site locally and push the generated files to GitHub, pull the commit that added the CNAME file to your local repository. For more information, see "Troubleshooting custom domains and GitHub Pages."

  8. Optionally, to enable HTTPS encryption for your site, select Enforce HTTPS. It can take up to 24 hours before this option is available. Para obter mais informações, consulte "Proteger seu site do GitHub Pages com HTTPS".

    Enforce HTTPS for custom domains option

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.

If you are using an apex domain as your custom domain, we recommend also setting up a www subdomain. If you configure the correct records for each domain type through your DNS provider, GitHub Pages will automatically create redirects between the domains. For example, if you configure www.example.com as your custom domain for your site, and you have ALIAS and CNAME records set up for the www and apex domains, then example.com will redirect to www.example.com. Para obter mais informações, consulte "Gerenciar um domínio personalizado para seu site do GitHub Pages".

  1. On GitHub, navigate to your site's repository.

  2. Under your repository name, click Settings.

    Repository settings button

  3. Under "Custom domain", type your custom domain, then click Save. This will create a commit that adds a CNAME file in the root of your publishing source.

    Save custom domain button

  4. Navegue até o provedor DNS e crie um registro ALIAS, ANAME ou A. For more information about how to create the correct record, see your DNS provider's documentation.

    • Para criar um registro ALIAS ou ANAME, aponte o domínio apex para o domínio padrão do seu site. For more information about the default domain for your site, see "About 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
  5. Abra Terminal (Terminal)Terminal (Terminal)Git Basho terminal.

  6. 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
  7. If you use a static site generator to build your site locally and push the generated files to GitHub, pull the commit that added the CNAME file to your local repository. For more information, see "Troubleshooting custom domains and GitHub Pages."

  8. Optionally, to enable HTTPS encryption for your site, select Enforce HTTPS. It can take up to 24 hours before this option is available. Para obter mais informações, consulte "Proteger seu site do GitHub Pages com HTTPS".

    Enforce HTTPS for custom domains option

Leia mais

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato