Документы · Инструкция
GitHub Pages custom domain не работает: как проверить DNS и CNAME
У custom domain есть отдельные слои: DNS у провайдера и настройка домена в GitHub Pages. `CNAME` внутри репозитория важе
Короткий ответ
Проверьте тип DNS-записей и настройку custom domain в Pages. Для subdomain CNAME должен указывать на `USERNAME.github.io`/`ORGANIZATION.github.io`. Файл `CNAME` нужен при публикации из ветки; custom Actions workflow его игнорирует.
Что делать
- Проверьте домен в Pages: Settings → Pages должен показывать именно ожидаемый custom domain.
- Проверьте DNS: Используйте `dig`/`nslookup` и убедитесь, что записи резолвятся в ожидаемые значения.
- Проверьте CNAME только при branch publish: Если Pages публикуется из ветки, файл `CNAME` в корне source должен содержать один домен. При custom Actions workflow этот файл игнорируется и не требуется.
- Исключите конфликтующие записи: Уберите старые A/AAAA/CNAME, которые направляют тот же host в другое место.
- Дождитесь применения и перепроверьте HTTPS: После корректного DNS проверьте Pages settings и HTTPS. Сертификат выпускается не мгновенно; не добавляйте конфликтующие A/AAAA/CNAME.
Важно
Не используйте wildcard DNS для Pages: GitHub предупреждает о риске takeover. При отключении Pages удалите старые DNS-записи.
Что учитывать
Не используйте wildcard DNS для Pages: GitHub предупреждает о риске takeover. При отключении Pages удалите старые DNS-записи.
Источники и проверка
Фактическая часть сверена по первичным источникам (в т.ч. Troubleshooting custom domains and GitHub Pages). Пример и формулировки — редакция N1RO на 2026-09-17.