Содержание

Что такое GitHub Pages

GitHub Pages берёт файлы из твоего репозитория и раздаёт их как статический сайт. Работает с HTML, CSS, JavaScript. Бесплатно, домен по умолчанию — username.github.io.

Идеально для: портфолио, документации, блогов, лендингов. (Этот блог тоже живёт на Pages — деплой настроен через GitHub Actions.)

Шаг 1 — Создай репозиторий

Имя репозитория должно быть строго username.github.io, где username — твой логин на GitHub.

💡 Для проекта (не персонального сайта) имя может быть любым — он будет доступен по адресу username.github.io/repo-name.

Шаг 2 — Добавь index.html

GitHub Pages ищет точку входа — файл index.html в корне репозитория. Вот минимальный файл:

<!DOCTYPE html>
<html lang="ru">
<head>
  <meta charset="UTF-8">
  <title>Мой сайт</title>
</head>
<body>
  <h1>Привет, мир!</h1>
</body>
</html>

Шаг 3 — Включи Pages в настройках

  1. Открой Settings репозитория
  2. В левом сайдбаре найди Pages
  3. Source: Deploy from branch
  4. Выбери ветку — main или master, папку — / (root)
  5. Нажми Save

GitHub начнёт деплой — обычно занимает 1–2 минуты.

Шаг 4 — Открой сайт

После деплоя в разделе Pages появится адрес: https://username.github.io.

Кастомный домен

Чтобы подключить свой домен:

  1. В настройках Pages введи домен в поле Custom domain
  2. У регистратора добавь DNS-запись: CNAME @ username.github.io
  3. Подожди распространения DNS — от 5 минут до нескольких часов

✅ HTTPS включается автоматически через Let's Encrypt — ничего настраивать не нужно.

Частые проблемы

Сайт не обновляется после push — проверь, что пушишь в ту ветку, которую указал в настройках. Если верная — подожди несколько минут, CDN кэшируется.

Страница 404 — убедись, что файл называется именно index.html (строчными) и лежит в корне, а не в подпапке.

⚠️ GitHub Pages не поддерживает серверную логику (Node.js, PHP, Python). Только статика: HTML, CSS, JS. Если нужен бэкенд — смотри деплой на VPS.

Поделиться: