Эта версия GitHub Enterprise Server будет прекращена 2023-12-20. Исправления выпускаться не будут даже при критических проблемах безопасности. Для повышения производительности, повышения безопасности и новых функций выполните обновление до последней версии GitHub Enterprise Server. Чтобы получить справку по обновлению, обратитесь в службу поддержки GitHub Enterprise.

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

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

GitHub Pages доступен в общедоступных репозиториях при использовании GitHub Free и GitHub Free для организаций, а также в общедоступных и частных репозиториях при использовании GitHub Pro, GitHub Team, GitHub Enterprise Cloud и GitHub Enterprise Server.

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

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

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

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

Кэш браузера

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

Файл index.html

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

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

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

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

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

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

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

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

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

Репозиторий

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

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

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