Компьютеры · Инструкция
GitHub Pages отдаёт 404: index.html, publishing source и ветка
404 после включения Pages обычно означает, что GitHub публикует не ту ветку/папку, не находит entry file или custom doma
Короткий ответ
Проверьте publishing source и наличие `index.html` в корне выбранного источника. Имя файла чувствительно к регистру; для Actions-deploy `index.html` должен быть в корне публикуемого artifact.
Что делать
- Проверьте Pages settings: Убедитесь, что выбран ожидаемый source: branch/folder или GitHub Actions.
- Проверьте entry file: В корне source должен быть `index.html` с точным регистром.
- Проверьте последний deploy: Откройте Actions/Deployments и убедитесь, что публикация завершилась успешно.
- Если custom domain: Временно проверьте стандартный `*.github.io` URL и отдельно DNS.
- Повторите build: Сделайте изменение, которое запускает публикацию, и проверьте новый deployment.
Важно
Не путайте 404 сайта с 404 конкретного маршрута SPA — это разные причины.
Что учитывать
Не путайте 404 сайта с 404 конкретного маршрута SPA — это разные причины.
Источники и проверка
Фактическая часть сверена по первичным источникам (в т.ч. Troubleshooting 404 errors for GitHub Pages sites). Пример и формулировки — редакция N1RO на 2026-09-17.