Skip to main content

Sobre domínios personalizados e GitHub Pages

O GitHub Pages permite o uso de domínios personalizados, ou a alteração da raiz do URL do seu site do padrão, como octocat.github.io, para qualquer domínio que você possua.

Quem pode usar esse recurso?

O GitHub Pages está disponível em repositórios públicos com o GitHub Free e o GitHub Free para organizações, e em repositórios públicos e privados com o GitHub Pro, o GitHub Team, o GitHub Enterprise Cloud e o GitHub Enterprise Server. Para mais informações, confira "Planos do GitHub".

O GitHub Pages agora usa o GitHub Actions para executar a compilação Jekyll. Ao usar uma ramificação como a origem da sua compilação, o GitHub Actions deverá estar habilitado em seu repositório se você quiser usar o fluxo de trabalho interno do Jekyll. Como alternativa, se o GitHub Actions não estiver disponível ou estiver desabilitado, adicionar um .nojekyll arquivo à raiz da ramificação de origem ignorará o processo de compilação do Jekyll e implantará o conteúdo diretamente. Para mais informações sobre ativar o GitHub Actions, confira "Gerenciando as configurações do GitHub Actions para um repositório".

Domínios personalizados compatíveis

Tip

Recomendamos verificar seu domínio personalizado antes de adicioná-lo ao seu repositório, a fim de aprimorar a segurança e evitar ataques de aquisição. Para obter mais informações, confira "Verificando seu domínio personalizado para o GitHub Pages".

O GitHub Pages trabalha com dois tipos de domínio: subdomínios e domínios apex. Para obter uma lista de domínios personalizados sem suporte, confira "Solucionar problemas de domínios personalizados e do GitHub Pages".

Tipo de domínio personalizado compatívelExemplo
Subdomínio wwwwww.example.com
Subdomínio personalizadoblog.example.com
Domínio Apexexample.com

Você pode definir configurações de apex e de subdomínio www para seu site. Para obter mais informações sobre os domínios apex, confira "Como usar um domínio apex para seu site do GitHub Pages".

Recomendamos sempre usar um subdomínio www, mesmo que você também use um domínio apex. Quando você cria um site com um domínio apex, tentamos proteger automaticamente o subdomínio www para uso ao fornecer o conteúdo do seu site, mas você precisa fazer as alterações de DNS para usar o subdomínio www. Se você configurar um subdomínio www, tentaremos proteger automaticamente o domínio apex associado. Para obter mais informações, confira "Gerenciar um domínio personalizado do seu site do GitHub Pages".

Usar um domínio personalizado em vários repositórios

Se você definir um domínio personalizado para um site de usuário ou organização, por padrão, o mesmo domínio personalizado será usado para todos os sites de projeto pertencentes à mesma conta. Para obter mais informações sobre tipos de site, confira "Sobre o GitHub Pages".

Por exemplo, se o domínio personalizado para seu site de usuário for www.octocat.com e você tiver um site de projeto sem domínio personalizado configurado que seja publicado em um repositório chamado octo-project, o site do GitHub Pages para esse repositório estará disponível em www.octocat.com/octo-project.

É possível substituir o domínio personalizado padrão adicionando um domínio personalizado ao repositório individual.

Note

As URLs para sites de projeto publicados de maneira privada não são afetadas pelo domínio personalizado do site do usuário ou da organização. Para obter mais informações sobre os sites publicados no modo privado, confira "Alterar a visibilidade do site do GitHub Pages" na documentação do GitHub Enterprise Cloud.

Para remover o domínio personalizado padrão, remova-o do site do usuário ou da organização.

Usar um subdomínio para seu site do GitHub Pages

Um subdomínio é a parte de um URL antes do domínio raiz. Você pode configurar seu subdomínio como www ou como uma seção distinta do seu site, como blog.example.com.

Os subdomínios são configurados com um registro CNAME por meio do provedor DNS. Para obter mais informações, confira "Gerenciar um domínio personalizado do seu site do GitHub Pages".

Subdomínios www

Um subdomínio www é o tipo de subdomínio mais usado. Por exemplo, www.example.com inclui um subdomínio www.

Os subdomínios www são o tipo mais estável de domínio personalizado porque os subdomínios www não são afetados por alterações nos endereços IP dos servidores do GitHub.

Subdomínios personalizados

Um subdomínio personalizado é um tipo de subdomínio que não usa a variante padrão www. Os subdomínios personalizados são usados mais frequentemente quando você deseja duas seções distintas do site. Por exemplo, você pode criar um site chamado blog.example.com e personalizar essa seção independentemente de www.example.com.

Usar um domínio apex para seu site do GitHub Pages

Um domínio apex é um domínio personalizado que não contém um subdomínio, como example.com. Os domínios apex também são conhecidos como domínios base, bare, naked, apex raiz ou apex de zona.

Um domínio apex é configurado com um registro A, ALIAS ou ANAME por meio do provedor DNS. Para obter mais informações, confira "Gerenciar um domínio personalizado do seu site do GitHub Pages".

Se você estiver usando um domínio apex como seu domínio personalizado, recomendaremos 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 o domínio personalizado para seu site e tiver os registros DNS do GitHub Pages configurados para o apex e os domínios www, example.com fará o redirecionamento para www.example.com. Observe que os redirecionamentos automáticos só se aplicam ao subdomínio www. Os redirecionamentos automáticos não se aplicam a nenhum outro subdomínio, como blog. Para obter mais informações, confira "Gerenciar um domínio personalizado do seu site do GitHub Pages".

Protegendo o domínio personalizado para o seu site do GitHub Pages

Se o site do GitHub Pages estiver desabilitado, mas tiver um domínio personalizado configurado, ele correrá o risco de uma tomada de controle de domínio. 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.

Verificar seu domínio personalizado impede que outros usuários do GitHub usem seu domínio com os repositórios deles. Se o seu domínio não for verificado e o seu site do GitHub Pages estiver desabilitado, você deverá atualizar ou remover imediatamente seus registros DNS com o provedor DNS. Para saber mais, confira "Verificando seu domínio personalizado para o GitHub Pages" e "Gerenciar um domínio personalizado do seu site do GitHub Pages".

Há alguns motivos para que seu site possa ser desabilitado automaticamente.

  • Se você fizer downgrade do GitHub Pro para o GitHub Free, qualquer site do GitHub Pages que esteja publicado no momento usando repositórios privados em sua conta terão a publicação cancelada. Para obter mais informações, confira "Downgrade do plano da sua conta".
  • Se você transferir um repositório privado para uma conta pessoal que esteja usando o GitHub Free, o repositório perderá o acesso ao recurso GitHub Pages e o site do GitHub Pages atualmente publicado terá a publicação cancelada. Para obter mais informações, confira "Transferir um repositório".

Leitura adicional