Устранение ошибок 404 на сайтах GitHub Pages

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

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

        [GitHub страница](#githubs-status-page) состояния %}

        [Настройка](#dns-setup) DNS

        [Кэш браузера](#browser-cache)

        [
        `index.html` файл](#indexhtml-file)

        [Содержимое](#directory-contents) каталога

        [Личный домен](#custom-domain)

        [Репозиторий](#repository)

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

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

Настройка DNS

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

Кэш браузера

Если ваш сайт 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, за исключением имени репозитория.
Если вы можете получить доступ к целевой странице, но столкнулись с неисправными ссылками на протяжении всей страницы, скорее всего, это связано с тем, что у вас не было личного доменного имени до или возвращается обратно из имени личного домена. В таких случаях изменение пути маршрутизации не инициирует перестроение страницы. Рекомендуемое решение — обеспечить автоматическое перестроение сайта при добавлении или удалении имени личного домена. Это может включать настройку автор фиксации и изменение параметров имени личного домена.

Репозиторий

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

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

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

Устранение ошибок 404 на сайтах GitHub Pages

Кто может использовать эту функцию?