Устранение ошибок 404 для сайтов GitHub Pages

Это руководство поможет вам устранить распространенные причины, по которым может появиться ошибка 404.

GitHub Pages is available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see "GitHub’s plans."

Устранение ошибок 404

В этом руководстве вы найдете распространенные причины, по которым может появиться ошибка 404 при создании сайта GitHub Pages.

Страница состояния GitHub

Если при создании сайта GitHub Pages возникает ошибка 404, сначала проверьте страницу состояния GitHubдля любых активных инцидентов.

Настройка DNS

Убедитесь, что записи DNS GitHubнастроены правильно с помощью поставщика DNS. Дополнительные сведения см. в разделе "Управление личным доменом для сайта "Страницы GitHub"".

Кэш браузера

Если ваш сайт GitHub Pages является частным и отображается ошибка 404, может потребоваться очистить кэш браузера. Дополнительные сведения об очистке кэша см. в документации браузера.

Файл index.html

GitHub Pages будет искать index.html файл в качестве файла записи для вашего сайта.

  • Убедитесь, что у вас есть index.html файл в репозитории для сайта на GitHub. Дополнительные сведения см. в разделе "Создание сайта GitHub Pages".

  • Файл записи должен находиться на верхнем уровне выбранного источника публикации. Например, если источник публикации является каталогом /docs в main ветви, файл записи должен находиться в каталоге /docs в вызываемой mainветви.

    Если источник публикации является ветвью и каталогом, файл записи должен находиться на верхнем уровне исходного каталога в исходной ветви. Например, если источник публикации является каталогом /docs в main ветви, файл записи должен находиться в каталоге /docs в вызываемой mainветви.

    Если источник публикации — это рабочий процесс GitHub Actions, развертываемый артефакт должен содержать файл записи на верхнем уровне. Вместо добавления файла записи в репозиторий может потребоваться рабочий процесс GitHub Actions при запуске рабочего процесса.

  • Имя index.html файла учитывает регистр. Например, Index.html не будет работать.

  • Имя файла не должно быть index.htmlили index.HTML другим вариантом.

Содержимое каталога

Убедитесь, что содержимое каталога находятся в корневом каталоге.

Личный домен

Если вы используете личный домен, убедитесь, что он настроен правильно. Дополнительные сведения см. в разделе "Сведения о личных доменах и страницах GitHub".

  • Запись CNAME всегда должна указывать в <USER>.github.io или <ORGANIZATION>.github.io, за исключением имени репозитория. Дополнительные сведения о создании правильной записи см. в документации поставщика DNS.
  • Если вы можете получить доступ к целевой странице, но столкнулись с неисправными ссылками на протяжении всей страницы, скорее всего, это связано с тем, что у вас не было личного доменного имени до или возвращается обратно из имени личного домена. В таких случаях изменение пути маршрутизации не инициирует перестроение страницы. Рекомендуемое решение — обеспечить автоматическое перестроение сайта при добавлении или удалении имени личного домена. Это может включать настройку автора фиксации и изменение параметров имени личного домена.

Репозиторий

Проверьте, соответствует ли репозиторий следующим требованиям.

  • Ветвь, используемая для публикации сайта, должна быть ветвью main по умолчанию.
  • Репозиторий должен иметь фиксацию, отправленную пользователем с разрешениями администратора для репозитория, например владельца репозитория.
  • Переключение видимости репозитория с общедоступной на частную или наоборот изменит URL-адрес сайта GitHub Pages , что приведет к неработающих ссылках, пока сайт не будет перестроен.

Если вы по-прежнему получаете ошибку 404, запустите обсуждение GitHub Community в категории Pages.