{"meta":{"title":"Solução de problemas de erros 404 para sites do GitHub Pages","intro":"Este guia ajudará você a solucionar problemas comuns que acarretam em um erro 404.","product":"GitHub Pages","breadcrumbs":[{"href":"/pt/pages","title":"GitHub Pages"},{"href":"/pt/pages/getting-started-with-github-pages","title":"Introdução"},{"href":"/pt/pages/getting-started-with-github-pages/troubleshooting-404-errors-for-github-pages-sites","title":"Solucionar erros 404"}],"documentType":"article"},"body":"# Solução de problemas de erros 404 para sites do GitHub Pages\n\nEste guia ajudará você a solucionar problemas comuns que acarretam em um erro 404.\n\n## Solução de erros 404\n\nNeste guia, veja algumas causas comuns para a exibição de um erro 404 durante a criação de um site do GitHub Pages.\n\n* ```\n            [Página Status do GitHub](#githubs-status-page)\n  ```\n* [Configuração de DNS](#dns-setup)\n* [Cache do navegador](#browser-cache)\n* [Arquivo `index.html`](#indexhtml-file)\n* [Conteúdo do diretório](#directory-contents)\n* [Domínio personalizado](#custom-domain)\n* [Repositório](#repository)\n\n### Página de status do GitHub\n\nSe um erro 404 for exibido durante a criação de um site do GitHub Pages, verifique primeiro se a [Página de status](https://githubstatus.com) do GitHub contém algum incidente ativo.\n\n### Configuração de DNS\n\nVerifique se os registros DNS do GitHub estão configurados corretamente com o provedor DNS. Para saber mais, confira [Gerenciando um domínio personalizado para seu site GitHub Pages](/pt/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site).\n\n### Cache do navegador\n\nQuando o site do GitHub Pages é privado e um erro 404 é exibido, pode ser necessário limpar o cache do navegador. Para obter mais informações sobre limpeza do cache, consulte a documentação do navegador.\n\n### Arquivo `index.html`\n\nO GitHub Pages procurará um arquivo `index.html` como o arquivo de entrada para o site.\n\n* Tenha um arquivo `index.html` no repositório do site no GitHub. Para saber mais, confira [Criando um site de páginas GitHub](/pt/pages/getting-started-with-github-pages/creating-a-github-pages-site#creating-your-site).\n\n* O arquivo de entrada deve estar no nível superior da fonte de publicação escolhida. Por exemplo, se a fonte de publicação for o diretório `/docs` do branch `main`, o arquivo de entrada deverá estar no diretório `/docs` de um branch chamado `main`.\n\n  Se a fonte de publicação for um branch e um diretório, o arquivo de entrada deverá estar no nível superior do diretório de origem no branch de origem. Por exemplo, se a fonte de publicação for o diretório `/docs` do branch `main`, o arquivo de entrada deverá estar no diretório `/docs` de um branch chamado `main`.\n\n  Se a fonte de publicação for um fluxo de trabalho do GitHub Actions, o artefato que você implantar precisará incluir o arquivo de entrada na parte superior do artefato. Em vez de adicionar o arquivo de entrada ao repositório, há a opção de fazer com que o fluxo de trabalho do GitHub Actions gere esse arquivo de entrada ao ser executado.\n\n* O nome do arquivo `index.html` diferencia maiúsculas de minúsculas. Por exemplo, `Index.html` não funcionará.\n\n* O nome do arquivo deve ser `index.html`, não `index.HTML` ou qualquer outra variação.\n\n### Conteúdo do diretório\n\nVerifique se o conteúdo do diretório está no diretório raiz.\n\n### Domínio personalizado\n\nSe você estiver usando um domínio personalizado, verifique se ele está configurado corretamente. Para saber mais, confira [Sobre domínios personalizados e páginas de GitHub](/pt/pages/configuring-a-custom-domain-for-your-github-pages-site/about-custom-domains-and-github-pages).\n\n* O registro `CNAME` deve sempre apontar para `<USER>.github.io` ou `<ORGANIZATION>.github.io`, excluindo o nome do repositório. Para obter mais informações sobre como criar o registro correto, consulte a documentação do provedor do DNS.\n* Se você consegue acessar sua página de destino, mas encontra links quebrados, é provável que isso ocorra porque você não tinha um nome de domínio personalizado antes ou está revertendo a utilização de um nome de domínio personalizado. Nesses casos, alterar o caminho de roteamento não inicia uma reconstrução da página. A solução recomendada é garantir que o site seja reconstruído automaticamente ao adicionar ou remover um nome de domínio personalizado. Isso pode envolver a configuração de um autor de commit e a modificação das configurações de nome de domínio personalizado.\n\n### Repositório\n\nVerifique se o repositório atende aos requisitos a seguir.\n\n* O branch que você está usando para publicar o site deve ser `main` ou o branch padrão.\n* O repositório deve ter um commit enviado a ele por alguém com as respectivas permissões de administrador, como o proprietário do repositório.\n* Mudar a visibilidade do repositório de público para privado ou vice-versa mudará a URL do site do GitHub Pages, o que resulta em links desfeitos até a reconstrução do site.\n* Se você estiver usando um repositório privado para o site GitHub Pages, verifique se sua assinatura do GitHub Pro, GitHub Team ou GitHub Enterprise Cloud ainda está ativa. Se você renovar o plano, o site GitHub Pages será reimplantado automaticamente. Caso contrário, você poderá alterar a visibilidade do seu repositório para público a fim de continuar usando o GitHub Pages gratuitamente.\n\nSe o erro 404 continuar sendo exibido, inicie uma [discussão na comunidade do GitHub Community](https://github.com/orgs/community/discussions/categories/pages) na categoria Páginas."}