Domínios personalizados suportados
Dica
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 saber mais, confira Verificando seu domínio personalizado para páginas de GitHub.
GitHub Pages funciona com dois tipos de domínios: subdomínios e domínios apex. Para obter uma lista de domínios personalizados sem suporte, confira Solução de problemas de domínios personalizados e páginas de GitHub.
| Tipo de domínio personalizado compatível | Exemplo |
|---|---|
Subdomínio www | www.example.com |
| Subdomínio personalizado | blog.example.com |
| Domínio Apex | example.com |
Você pode definir configurações de apex e de subdomínio www para seu site. Para obter mais informações sobre domínios apex, consulte Como usar um domínio apex para seu GitHub Pages site.
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 saber mais, confira Gerenciando um domínio personalizado para seu site GitHub Pages.
Usar um domínio personalizado em vários repositórios
Por padrão, se você definir um domínio personalizado para um site de usuário ou site da organização, esse 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 O que é GitHub Pages?.
Por exemplo, se o domínio personalizado do seu site de usuário for www.octocat.come você tiver um site de projeto sem nenhum domínio personalizado configurado que seja publicado de um repositório chamado octo-project, o GitHub Pages site desse 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.
Observação
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 sites publicados privadamente, consulte Alterando a visibilidade do seu site do GitHub Pages na GitHub Enterprise Cloud documentação.
Para remover o domínio personalizado padrão, remova-o do site do usuário ou da organização.
Usando um subdomínio para seu GitHub Pages site
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 saber mais, confira Gerenciando um domínio personalizado para seu site 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.
www os subdomínios são o tipo mais estável de domínio personalizado porque www os subdomínios não são afetados por alterações nos endereços IP dos GitHubservidores.
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.
Usando um domínio raiz para seu site 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 saber mais, confira Gerenciando um domínio personalizado para seu site 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. Se você, em vez disso, configurar example.com como o domínio personalizado, www.example.com será redirecionado para example.com. Redirecionamentos automáticos também se aplicam a outros subdomínios, assim como www.blog.example.com redirecionará para blog.example.com ou vice-versa. Não é possível configurar um domínio que comece com www.www.. Para obter mais informações, consulte Gerenciando um domínio personalizado para seu site GitHub Pages.
Proteção do domínio personalizado do seu site 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 obter mais informações, consulte Verificando seu domínio personalizado para páginas de GitHub e Gerenciando um domínio personalizado para seu site GitHub Pages.
Há alguns motivos para que seu site possa ser desabilitado automaticamente.
- Se você fizer downgrade de GitHub Pro para GitHub Free, todos os sites GitHub Pages que estão atualmente publicados a partir de repositórios privados na sua conta serão despublicados. Para saber mais, confira Downgrade do plano da sua conta.
- Se você transferir um repositório privado para uma conta pessoal que está usando GitHub Free, o repositório perderá o acesso ao recurso GitHub Pages, e o site GitHub Pages atualmente publicado deixará de ser publicado. Para saber mais, confira Transferir um repositório.