Skip to main content

Solucionar problemas de domínios personalizados e do GitHub Pages

Você pode verificar os erros comuns para resolver problemas com domínios personalizados ou HTTPS no seu site do GitHub Pages.

GitHub Pages está disponível em repositórios públicos com GitHub Free e GitHub Free para organizações, e em repositórios públicos e privados com GitHub Pro, GitHub Team, GitHub Enterprise Cloud e GitHub Enterprise Server. Para obter mais informações, confira "produtos de GitHub".

Erros de CNAME

Se você estiver publicando de um fluxo de trabalho personalizado de GitHub Actions, qualquer arquivo CNAME será ignorado e não será necessário.

Se você estiver publicando de um branch, os domínios personalizados serão armazenados em um arquivo CNAME na raiz da fonte de publicação. que pode ser adicionado ou atualizado manualmente ou por meio das configurações do repositório. Para obter mais informações, confira "Como gerenciar um domínio personalizado para seu site do GitHub Pages".

Para que o seu site seja renderizado no domínio correto, verifique se o arquivo CNAME ainda existe no repositório. Por exemplo, muitos geradores de site estáticos forçam o push para o repositório, o que pode substituir o arquivo CNAME que foi adicionado ao repositório quando você configurou o domínio personalizado. Se você compilar o site localmente e enviar arquivos gerados por push para o GitHub Enterprise Cloud, efetue pull do commit que adicionou o arquivo CNAME para o repositório local primeiro, para que o arquivo seja incluído no build.

Em seguida, verifique se o arquivo CNAME está formatado corretamente.

  • O nome do arquivo CNAME precisa estar todo em maiúsculas.
  • O arquivo CNAME pode conter apenas um domínio. Para apontar vários domínios para o site, é preciso configurar um redirecionamento por meio do provedor DNS.
  • O arquivo CNAME precisa conter apenas o nome de domínio. Por exemplo, www.example.com, blog.example.com ou example.com.
  • O nome de domínio precisa ser único em todos os sites de GitHub Pages. Por exemplo, se o arquivo CNAME de outro repositório contiver example.com, não será possível usar example.com no arquivo CNAME para o repositório.

Configuração incorreta do DNS

Se você tiver problemas para apontar o domínio padrão do site para o domínio personalizado, entre em contato com seu provedor DNS.

Você também pode usar um dos seguintes métodos para testar se os registros DNS do seu domínio personalizado estão configurados corretamente:

Nomes de domínios personalizados que não são compatíveis

Se o seu domínio personalizado não for compatível, talvez você precise alterá-lo para um que tenha suporte. Você também pode entrar em contato com seu provedor DNS para ver se ele oferece serviços de encaminhamento para nomes de domínio.

Verifique se o seu site não:

  • Usa mais de um domínio apex. Por exemplo, example.com e anotherexample.com.

  • Use mais de um subdomínio www. Por exemplo, www.example.com e www.anotherexample.com.

  • Usa um domínio apex e um subdomínio personalizado. Por exemplo, example.com e docs.example.com.

    A única exceção é o subdomínio www. Se ele estiver configurado corretamente, o subdomínio www será redirecionado automaticamente para o domínio apex. Para obter mais informações, confira "Como gerenciar um domínio personalizado para seu site do GitHub Pages".

Aviso: é altamente recomendável não usar registros DNS curinga, como *.example.com. O registro DNS curinga permite que qualquer pessoa hospede um site do GitHub Pages em um dos subdomínios que você tem, mesmo quando eles são verificados. Para obter mais informações, confira "Como verificar seu domínio personalizado do GitHub Pages".

Para ver uma lista dos domínios personalizados compatíveis, confira "Sobre os domínios personalizados e o GitHub Pages".

Erros de HTTPS

Os sites do GitHub Pages que usam do domínios personalizados e que estão configurados corretamente com registros DNS CNAME, ALIAS, ANAME ou A podem ser acessados por HTTPS. Para obter mais informações, confira "Como proteger seu site do GitHub Pages com HTTPS".

Depois que você configurar seu domínio personalizado, pode levar até uma hora para o seu site ser disponibilizado por HTTPS. Após a atualização das configurações DNS existentes, talvez seja necessário remover o domínio personalizado e tornar a adicioná-lo ao repositório do site para acionar o processo de habilitação do HTTPS. Para obter mais informações, confira "Como gerenciar um domínio personalizado para seu site do GitHub Pages".

Se você estiver usando registros de CAA (Autorização da Autoridade de Certificação), pelo menos, um registro CAA precisará existir com o valor letsencrypt.org para que o seu site seja acessível por HTTPS. Para obter mais informações, confira "CAA (Autorização da Autoridade de Certificação)" na documentação do Let's Encrypt.

Formatação de URL no Linux

Se a URL para o seu site incluir um nome de usuário ou de organização que começa ou termina com um traço ou contiver traços consecutivos, as pessoas que navegam com Linux receberão um erro de servidor quando tentarem visitar o site. Para corrigir isso, remova caracteres não alfanuméricos do seu nome de usuário do GitHub Enterprise Cloud. Para obter mais informações, confira "Como alterar seu nome de usuário do GitHub".

Cache do navegador

Se você tiver alterado ou removido recentemente seu domínio personalizado e não conseguir acessar a nova URL no navegador, talvez precise limpar o cache do navegador para alcançar a nova URL. Para obter mais informações sobre limpeza do cache, consulte a documentação do navegador.