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 está disponível em repositórios públicos com GitHub Free e GitHub Free para organizações, e em repositórios públicos e privados com GitHub Pro, GitHub Team, GitHub Enterprise Cloud e GitHub Enterprise Server. Para obter mais informações, consulte "produtos de GitHub

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.

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

  2. No nome do seu repositório, clique em Configurações. Botão de configurações do repositório

  3. Na barra lateral esquerda, clique em Pages (Páginas). Page tab in the left-hand sidebar

  4. 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. Botão Salvar domínio personalizado

  5. 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 GitHub Pages em um dos subdomínios que você tem.

  6. Abra TerminalTerminalGit Bash.

  7. 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
  8. 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".

  9. 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". Opção de aplicar HTTPS para domínios personalizados

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. 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. Para obter mais informações, consulte "Configurar um subdomínio".

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

  2. No nome do seu repositório, clique em Configurações. Botão de configurações do repositório

  3. Na barra lateral esquerda, clique em Pages (Páginas). Page tab in the left-hand sidebar

  4. 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. Botão Salvar domínio personalizado

  5. 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 registros A, aponte seu domínio apex para os endereços IP para 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 GitHub Pages em um dos subdomínios que você tem.

  6. Abra TerminalTerminalGit Bash.

  7. 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
  8. 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".

  9. 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". Opção de aplicar HTTPS para domínios personalizados

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 de www junto com o domínio apex, você deve primeiro configurar um domínio apex, que irá criar um ALIAS, ANAME ou registro A junto ao seu provedor DNS. Para obter mais informações, consulte "Configurar um domínio apex".

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

  1. 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".
  2. 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

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

  2. No nome do seu repositório, clique em Configurações. Botão de configurações do repositório

  3. Na barra lateral esquerda, clique em Pages (Páginas). Page tab in the left-hand sidebar

  4. Em "Domínio personalizado, clique em Remover. Botão Salvar domínio personalizado

Leia mais

Esse documento ajudou você?Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.