# Como conecto meu domínio ao GitHub Pages?

> Conecte um domínio ao GitHub Pages: 4 registros A (185.199.108.153–111.153), 4 AAAA e um CNAME www, em um template da DotAlmanac. Sem KYC, pague com cripto.

- URL: https://dotalmanac.com/pt/how-to-connect-a-domain-to-github-pages/
- Última atualização: 2026-10-29
- Editor: DotAlmanac (https://dotalmanac.com)

Os registros DNS exatos que o GitHub publica, a ordem dos passos que evita domain takeovers e o que verificar quando o GitHub diz que o domínio não está configurado.

**Resposta rápida — Como conecto um nome de domínio ao GitHub Pages?**

Para conectar um nome de domínio ao GitHub Pages, aponte o domínio raiz para os 4 registros A do GitHub (185.199.108.153 a 185.199.111.153) e o www para o seu nome usuario.github.io, depois insira o domínio nas configurações de Pages do repositório. O template de GitHub Pages do **DotAlmanac** prepara todos os 9 registros de uma vez, em 29 de outubro de 2026.

## DNS do GitHub Pages em resumo

| Atributo | Valor |
| --- | --- |
| Registros A (@) | 185.199.108.153 · 185.199.109.153 · 185.199.110.153 · 185.199.111.153 |
| Registros AAAA (@) | 2606:50c0:8000::153 · 2606:50c0:8001::153 · 2606:50c0:8002::153 · 2606:50c0:8003::153 |
| www | CNAME para `USERNAME.github.io`, sem o nome do repositório |
| Onde inserir o domínio | Repositório › Settings › Pages › Custom domain |
| Verificação do domínio | Registro TXT `_github-pages-challenge-USERNAME`, em Settings › Pages do seu perfil |
| HTTPS | "Enforce HTTPS" nas configurações de Pages, assim que o GitHub emitir o certificado |
| TTL dos registros do template | 3600 segundos (1 hora) |
| Hospedagem DNS | Grátis com todo nome de domínio DotAlmanac |

## 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](https://dotalmanac.com/pt/app-vs-dev/ "Devo usar .app ou .dev para meu projeto?").

## Como conectar seu nome de domínio ao GitHub Pages em 6 passos

1. **Verifique primeiro o domínio no GitHub** — No seu perfil do GitHub, abra Settings › Pages › Add a domain. O GitHub mostra um registro TXT com o nome _github-pages-challenge-USERNAME e um valor. Adicione-o na aba DNS do domínio e clique em Verify.
2. **Abra o template do GitHub Pages** — Na área do cliente, abra o domínio e vá em DNS › Templates › GitHub Pages. Insira seu nome de usuário ou organização do GitHub, por exemplo octocat.
3. **Revise a prévia e salve** — A prévia lista 4 registros A, 4 AAAA e 1 CNAME. Ela substitui os registros A, AAAA, CNAME e ALIAS de @ e www, e não mexe nos registros MX e TXT. Nada é enviado antes de você salvar.
4. **Insira o domínio personalizado no repositório** — No repositório, abra Settings › Pages › Custom domain, digite o domínio e clique em Save. Publicar a partir de um branch adiciona um arquivo CNAME a ele; um workflow do GitHub Actions não precisa desse arquivo.
5. **Aguarde a verificação de DNS do GitHub** — O GitHub verifica os registros e mostra o resultado em Custom domain. A espera depende do TTL dos registros que os resolvedores guardaram em cache antes da sua alteração.
6. **Ative o Enforce HTTPS** — Assim que o GitHub emitir o certificado, marque Enforce HTTPS nas mesmas configurações de Pages. Para .dev e .app, o site não carrega até o HTTPS funcionar.

## Quais são os registros DNS exatos do GitHub Pages?

Estes são os valores que o GitHub publica para domínios raiz e para www. O template do DotAlmanac adiciona exatamente estes 9 registros.

*Registros do GitHub Pages, conforme publicados na GitHub Docs (verificado em 29 de outubro de 2026)*

| Tipo | Nome | Valor | TTL |
| --- | --- | --- | --- |
| A | @ | 185.199.108.153 | 3600 |
| A | @ | 185.199.109.153 | 3600 |
| A | @ | 185.199.110.153 | 3600 |
| A | @ | 185.199.111.153 | 3600 |
| AAAA | @ | 2606:50c0:8000::153 | 3600 |
| AAAA | @ | 2606:50c0:8001::153 | 3600 |
| AAAA | @ | 2606:50c0:8002::153 | 3600 |
| AAAA | @ | 2606:50c0:8003::153 | 3600 |
| CNAME | www | USERNAME.github.io | 3600 |

Substitua USERNAME pelo seu usuário ou nome de organização do GitHub. A documentação do GitHub e as configurações de Pages do seu repositório são a referência: se o GitHub mostrar outros valores para o seu site, use esses.

## 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.

*Registros do GitHub Pages para example.com (usuário: octocat)*

```text
@    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.

## GitHub Pages e domínios personalizados: perguntas frequentes

### Preciso dos 4 registros A para o GitHub Pages?

Sim. O GitHub publica 4 endereços por redundância, e o modelo adiciona todos eles. O GitHub também recomenda os 4 registros AAAA para visitantes em IPv6, junto com os registros A.

### Por que verificar o domínio antes de adicioná-lo ao repositório?

A verificação impede que outros usuários do GitHub reivindiquem seu domínio para o próprio site no Pages. Sem ela, um repositório excluído ou um site do Pages desativado pode deixar o domínio aberto a tomada de controle. Verifique primeiro e depois adicione o domínio ao repositório.

### Posso manter meu e-mail ao apontar o domínio para o GitHub Pages?

Sim. O modelo do GitHub Pages altera apenas os registros A, AAAA, CNAME e ALIAS de @ e www. Seus registros MX, SPF e outros TXT permanecem como estão.

### A hospedagem de DNS para o GitHub Pages é cobrada à parte no DotAlmanac?

Não. A hospedagem de DNS, os modelos e a importação de arquivo de zona são gratuitos com todo domínio. Você paga apenas o domínio, por exemplo US$ 11,99/ano por um .com, conforme listado na [página de preços](https://dotalmanac.com/pt/pricing/ "Quanto custa um nome de domínio por ano?").

### Qual extensão é indicada para um site de projeto no GitHub Pages?

Qualquer extensão funciona com o GitHub Pages. Desenvolvedores costumam escolher .dev, .io ou .com; compare-as em [melhor extensão de domínio para desenvolvedores](https://dotalmanac.com/pt/best-domain-extension-for-developers/ "Qual é a melhor extensão de domínio para um desenvolvedor?"). Confira o preço de renovação, não só o do primeiro ano.

## Fontes

1. [Gerenciando um nome de domínio personalizado para seu site no GitHub Pages](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site) — GitHub Docs (verificado em 2026-10-29)
2. [Verificando seu domínio personalizado para o GitHub Pages](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site/verifying-your-custom-domain-for-github-pages) — GitHub Docs (verificado em 2026-10-29)
3. [Solução de problemas com domínios personalizados e GitHub Pages](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages) — GitHub Docs (verificado em 2026-10-29)

**Precisa de um domínio para seu site no GitHub Pages?** Registre sem KYC, pague com cripto e aplique o modelo do GitHub Pages na aba DNS. [Pesquisar um domínio](https://dotalmanac.com/app/domains/?lang=pt) · [Ver todos os preços](https://dotalmanac.com/pt/pricing/ "Quanto custa um nome de domínio por ano?")

---

DotAlmanac: O DotAlmanac é um guia de extensões de domínio e registrador: compare todas as extensões e registre a sua sem KYC, pagando com cripto. Um .com custa US$ 11,99/ano.
