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 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."
Neste artigo
- Domínios personalizados compatíveis
- Usar um subdomínio para seu site do GitHub Pages
- Usar um domínio apex para seu site do GitHub Pages
- Atualizar domínios personalizados quando seu site do GitHub Pages é desabilitado
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ível | Exemplo |
---|---|
Subdomínio www |
www.example.com |
Subdomínio personalizado | blog.example.com |
Domínio apex | example.com |
Você pode configurar um ou dois tipos de domínio personalizado para seu site. É recomendável sempre usar um subdomínio www
, mesmo se você também usar um domínio apex. Para obter mais informações, consulte "Usar um domínio apex para seu site do GitHub Pages".
Depois de 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
do 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. Seu site também será carregado mais rapidamente, pois a proteção contra o ataque de Negação de Serviço (DoS, Denial of Service) pode ser implementada de maneira mais eficiente.
Subdomínios personalizados
Um subdomínio personalizado é um tipo de subdomínio que não usa o subdomínio 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".
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".
Atualizar domínios personalizados quando seu site do GitHub Pages é desabilitado
Se seu site do GitHub Pages estiver desabilitado, mas tiver um domínio personalizado configurado, você deverá atualizar ou remover imediatamente seus registros DNS com o provedor DNS a fim de evitar o risco de tomada de controle do 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. Para obter mais informações, consulte "Gerenciar um domínio personalizado para 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, 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".