Сайт на GitHub Pages не открывается — причины и решения

Если сайт, размещённый на GitHub Pages, не открывается, причина почти всегда в одном из трёх мест: временная недоступность самого GitHub, ошибка в настройках репозитория или проблема на стороне вашего DNS/браузера. Ниже — как быстро понять, что именно сломалось.

Сайт github.com сейчас отвечает и доступен.
Проверено 1 секунда назад автоматически.

Как проверить, доступен ли GitHub прямо сейчас

Сначала исключите глобальный сбой сервиса. Откройте официальную страницу статуса GitHub (githubstatus.com) — там видно, есть ли инциденты с Pages, Actions или CDN. Если статус зелёный, проблема локальная — либо в вашей сети, либо в самом репозитории.

  • Попробуйте открыть сайт с мобильного интернета, а не через Wi-Fi — так вы исключите блокировку на уровне провайдера или роутера.
  • Проверьте сайт через сервис проверки доступности из разных регионов — если он открывается не у всех, дело не в GitHub, а в вашем DNS или CDN перед сайтом.
  • Очистите кэш DNS (ipconfig /flushdns в Windows) и кэш браузера — старые записи иногда указывают на неактуальный IP.

Типичные причины, если дело не в GitHub

Чаще всего сайт на GitHub Pages «падает» после изменений в самом репозитории, а не из-за сбоя сервиса.

  • Файл index.html лежит не в корне ветки, указанной в настройках Pages (обычно main или gh-pages).
  • В разделе Settings → Pages репозитория отключена публикация или выбрана не та папка (/root вместо /docs, и наоборот).
  • Кастомный домен настроен, но файл CNAME в репозитории отсутствует или содержит неверное значение — тогда GitHub перестаёт отдавать сайт по этому адресу.
  • Включено принудительное HTTPS, а SSL-сертификат для домена ещё не выпущен — это может занять время после привязки домена.

Что делать, если сайт не работает больше суток

Проверьте вкладку Actions в репозитории — если сборка страницы завершилась с ошибкой, публикация не произойдёт вообще, даже если раньше всё работало.

Если последний деплой красный (failed), сайт останется на версии из предыдущего успешного билда или вовсе перестанет открываться — сначала чините сборку, а не настройки домена.

Если сборка проходит успешно, а домен свой, проверьте DNS-записи у регистратора: для GitHub Pages нужны либо A-записи на IP GitHub, либо CNAME на username.github.io. Неверная запись — самая частая причина «сайт то работает, то нет» при смене хостинга или регистратора.

Понравилась статья? Поделиться с друзьями: