Como conecto meu domínio ao GitHub Pages?

O que preciso antes de conectar um nome de domínio ao GitHub Pages?

O DotAlmanac é um guia de extensões de domínio e registrador: compare todas as extensões, registre a sua sem KYC e pague com cripto. Para seguir este guia, você precisa de três coisas.

• Um nome de domínio nos nameservers do DotAlmanac. A aba Nameservers do domínio deve mostrar "Our nameservers". Se o domínio usa outros nameservers, adicione os mesmos registros nesse provedor de DNS.
• Um repositório com o GitHub Pages ativado. Ele pode publicar a partir de um branch ou de um workflow do GitHub Actions.
• Seu nome de usuário ou organização do GitHub. Ele vai no registro www. O nome do repositório nunca vai.

Muitos desenvolvedores escolhem .dev ou .app para um site de projeto. Confira primeiro a renovação: segundo a tabela de preços do DotAlmanac, .dev renova 44% acima do preço do primeiro ano e .app 67% acima, em 29 de outubro de 2026. Um .dev custa US$ 8,99/ano, depois US$ 12,99/ano. As duas extensões exigem HTTPS, que o GitHub Pages fornece. Compare-as em .app vs .dev.

Posso colar os registros como arquivo de zona?

Sim. Abra DNS › Importar / exportar › Importar arquivo de zona, escolha "Adicionar aos registros existentes" e cole as linhas abaixo. Substitua octocat pelo seu próprio nome de usuário. A importação lê a sintaxe padrão BIND, mostra uma prévia e não envia nada antes de você salvar.

@    3600  IN  A      185.199.108.153
@    3600  IN  A      185.199.109.153
@    3600  IN  A      185.199.110.153
@    3600  IN  A      185.199.111.153
@    3600  IN  AAAA   2606:50c0:8000::153
@    3600  IN  AAAA   2606:50c0:8001::153
@    3600  IN  AAAA   2606:50c0:8002::153
@    3600  IN  AAAA   2606:50c0:8003::153
www  3600  IN  CNAME  octocat.github.io.

Devo usar o domínio raiz ou o www com o GitHub Pages?

Configure os dois e informe no repositório o que você preferir. Quando os registros do domínio raiz e do www estiverem corretos, o GitHub Pages redireciona o outro para ele.

O GitHub aceita um domínio raiz ou um nome www por site. Não aceita dois domínios raiz, dois nomes www, nem um domínio raiz combinado com outro subdomínio personalizado. Para um projeto em um subdomínio, como docs.example.com, adicione um CNAME de docs para USERNAME.github.io e ignore os registros A.

Quanto tempo até meu domínio funcionar no GitHub Pages?

Depende do TTL dos registros que os resolvedores viram antes da sua alteração. TTL é o número de segundos que um resolvedor mantém uma resposta no cache.

• Um nome sem registro anterior resolve assim que você salva.
• Um registro substituído mantém o valor antigo em alguns caches até o TTL antigo expirar. Os registros do modelo usam 3600 segundos, ou seja, uma hora.
• Planeje uma migração com antecedência: reduza o TTL dos registros antigos para 300 segundos um dia antes da alteração.

A própria documentação do GitHub diz que alterações de DNS podem levar até 24 horas para propagar. O certificado HTTPS vem depois que a verificação de DNS é bem-sucedida.

Por que o GitHub diz que meu domínio não está configurado corretamente?

Na maioria dos casos, um registro antigo ainda responde pelo mesmo nome. Verifique estes pontos na ordem:

• Registros remanescentes. Um registro A, AAAA ou ALIAS antigo em @, ou um registro de estacionamento, compete com os do GitHub. O modelo os remove; edições manuais costumam deixar um para trás.
• Nome do repositório no CNAME. O destino do www é somente USERNAME.github.io.
• Registro curinga. O GitHub avisa que um registro como *.example.com cria risco de tomada de controle do domínio. Exclua-o.
• Outros nameservers. Se o domínio usa outro provedor de DNS, os registros na aba DNS do DotAlmanac não são servidos.
• Registros CAA. Se você publica registros CAA, o GitHub exige pelo menos um com o valor letsencrypt.org para HTTPS.

Teste o resultado com dig example.com +short ou qualquer consulta de DNS online.