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.

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 os "produtos do GitHub".

Domínios personalizados compatíveis

O GitHub Pages trabalha com dois tipos de domínio: subdomínios e domínios apex. Para obter uma lista de domínios personalizados não compatíveis, consulte "Solução de problemas de domínios personalizados e 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 as duas configurações apex e subdomínio de www para o seu site. Para obter mais informações sobre domínios apex, consulte "Usar um domínio apex para o seu site GitHub Pages".

É recomendável sempre usar um subdomínio www, mesmo se você também usar um domínio apex. Ao criar um novo site com um domínio apex, tentamos proteger automaticamente o subdomínio www para uso ao servir 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, nós tentaremos proteger automaticamente o domínio apex associado. Para obter mais informações, consulte "Gerenciar um domínio personalizado para seu site do GitHub Pages".

Depois que você configurar um domínio personalizado para um site de usuário ou organização, o domínio personalizado substituirá a parte <user>.github.io ou <organization>.github.io da URL para qualquer site de projeto de propriedade da conta que não tenha um domínio personalizado configurado. Por exemplo, se o domínio personalizado para o site de usuário for www.octocat.com e você tiver um site de projeto sem domínio personalizado configurado que seja publicado de um repositório chamado octo-project, o site do GitHub Pages para esse repositório estará disponível em www.octocat.com/octo-project.

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, consulte "Gerenciar um domínio personalizado para seu site do GitHub Pages".

Subdomínios www

Um subdomínio www é o tipo de subdomínio usado com mais frequência. 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, pois os subdomínios www não são afetados pelas 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, consulte "Gerenciar um domínio personalizado para seu site do GitHub Pages".

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 "Gerenciar um domínio personalizado para o seu site de GitHub Pages".

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

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 o seu domínio personalizado para GitHub Pages" e "Gerenciando um domínio personalizado para o site do seu 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, consulte "Fazer downgrade do plano de cobrança do GitHub".
  • 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, consulte "Transferir um repositório".

Leia mais