Este mini guia irá te ajudar no processo de configuração de um domínio personalizado para o seu site hospedado no GitHub Pages.

Pré-requisitos

  • Um repositório GitHub com GitHub Pages ativado
  • Um domínio próprio registrado (por exemplo, através de registradores como RegistroBR, Hostinger, etc.)
  • Acesso às configurações DNS do seu domínio (geralmente através do registrador ou de um serviço como Cloudflare)

Passo 1: Configurar o GitHub Pages

  1. Vá para o seu repositório no GitHub.

  2. Clique em “Settings” (Configurações).

  3. Navegue até a seção “Pages” no menu lateral.

  4. Em “Custom domain”, digite seu domínio personalizado (por exemplo, seudominio.com).

  5. Clique em “Save” (Salvar).

Passo 2: Configurar os Registros DNS

Agora, você precisa configurar os registros DNS para apontar para os servidores do GitHub Pages. Você tem duas opções (recomendo que faça as duas):

Opção A: Configurar um Subdomínio (por exemplo, www)

  1. Adicione um registro CNAME:
    • Tipo: CNAME
    • Host: www
    • Valor: seu-usuario-github.github.io
    • TTL: 3600 ou Auto

Opção B: Configurar o Domínio Raiz

Adicione um registro A:

  1. Tipo: A
    • Host: @ (ou deixe em branco)
    • Valor: 185.199.108.153
    • TTL: 3600 ou Auto

Passo 3: Verificar a Configuração

  1. Aguarde alguns minutos para que as alterações de DNS se propaguem.
  2. No GitHub, volte à seção “Pages” nas configurações do repositório.
  3. Deve aparecer uma mensagem confirmando que seu domínio está configurado corretamente.

Passo 4: Forçar HTTPS

  1. Ainda na seção “Pages”, marque a caixa “Enforce HTTPS”.
  2. Isso pode levar alguns minutos para ser ativado.

Resolução de Problemas

  • Se o site não ficar disponível imediatamente, aguarde algumas horas para a propagação completa do DNS.
  • Verifique se não há conflitos entre registros CNAME e A para o mesmo host.

Conclusão

Seguindo estes passos, seu site GitHub Pages deve estar acessível através do seu domínio personalizado. Lembre-se de que alterações no DNS podem levar algum tempo para se propagar globalmente.


Se encontrar algum problema durante o processo, consulte a documentação oficial do GitHub