o4x.org / инструкцияКоманды обновления ↓

От пустой папки до своего домена

Сайт с нуля.
GitHub → Cloudflare Pages.

Создаём обычную HTML-страницу, сохраняем её в GitHub и подключаем Cloudflare напрямую. После каждого push в main сайт обновляется автоматически.

Windows · PowerShellОбычный HTMLБез GitHub Actions

Проверено на примере o4x.org · интерфейс на 18 ноября 2026 года. На скриншотах оставлены только рабочие области настроек.

01 · Один раз

Что подготовить

  • Аккаунт GitHub — для хранения файлов и истории изменений.
  • Аккаунт Cloudflare — для публикации сайта.
  • Git for Windows и любой текстовый редактор. После установки Git откройте новый PowerShell.
  • Свой домен — только если нужен адрес вроде www.example.com. Сначала можно проверить сайт на бесплатном адресе *.pages.dev.

Проверка установки Git:

git --version

Вместо примеров o4x.org, o4x-org и YOUR_LOGIN используйте свой домен, свободное имя проекта и логин GitHub. YOUR_NAME и YOUR_EMAIL ниже — данные автора коммитов.

02 · Один раз

Создать папку и страницу

В PowerShell создайте новую папку. Если выбрали другое расположение, замените путь во всех командах.

New-Item -ItemType Directory -Path C:\Projects\o4x.org\public -Force
Set-Location C:\Projects\o4x.org

Откройте папку в редакторе и создайте файл public/index.html. Сохраните его в кодировке UTF-8:

<!doctype html>
<html lang="ru">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Мой первый сайт</title>
</head>
<body>
  <h1>Hello World!</h1>
  <p>Первая версия сайта.</p>
</body>
</html>

Рядом с папкой public создайте файл .gitignore. Это имя целиком, без окончания .txt. Его содержимое:

.env
.env.*
!.env.example
node_modules/
.wrangler/

Начальная структура:

o4x.org/
├── .gitignore
└── public/
    └── index.html

Все файлы сайта — HTML, CSS, изображения — размещайте в public/. Именно эту папку мы укажем Cloudflare для публикации. Откройте index.html в браузере и убедитесь, что виден текст Hello World.

03 · Один раз

Создать локальный Git-репозиторий

Выполните в корне проекта. Команды git config задают имя и email автора только для этого репозитория:

git init -b main
git config user.name "YOUR_NAME"
git config user.email "YOUR_EMAIL"
git add .gitignore public/
git commit -m "Create test page"

В качестве email можно использовать адрес noreply из GitHub → Settings → Emails. Имя и email записываются в историю коммитов; выбирайте их с учётом того, кто будет видеть репозиторий.

git init создаёт историю проекта. git add выбирает изменения для сохранения. git commit создаёт сохранённую версию. На этом этапе файлы ещё находятся только на вашем компьютере.

04 · Один раз

Создать репозиторий в GitHub

  1. Войдите в GitHub и откройте Create a new repository.
  2. В Repository name введите имя, например o4x.org.
  3. Выберите Private, если исходники должны быть закрытыми. Сайт при этом будет доступен посетителям — видимость репозитория и видимость сайта настраиваются отдельно.
  4. Оставьте Add README выключенным, .gitignore — No .gitignore, лицензию — No license. Файлы уже подготовлены локально, нужен пустой удалённый репозиторий.
  5. Нажмите Create repository. Скопируйте HTTPS-адрес репозитория.
GitHub: закрытый репозиторий Private, README выключен, .gitignore и лицензия не выбраны
Настройки пустого репозитория. Область с владельцем аккаунта исключена из кадра. Нажмите на изображение, чтобы открыть оригинал.

В PowerShell подключите созданный репозиторий. Замените YOUR_LOGIN своим логином GitHub:

git remote add origin https://github.com/YOUR_LOGIN/o4x.org.git
git push -u origin main

Если Git предложит вход, завершите авторизацию GitHub в открывшемся браузере. Обычный пароль GitHub не используется как пароль для HTTPS push. Git for Windows обычно открывает вход через Git Credential Manager.

Обновите страницу репозитория в GitHub: должны появиться .gitignore и папка public с index.html. Ключ -u в первом push запоминает связь локальной ветки с удалённой.

05 · Один раз

Подключить Cloudflare Pages к GitHub

  1. Войдите в Cloudflare Dashboard и выберите нужный аккаунт.
  2. Откройте Compute → Workers & Pages → Create application.
  3. На общем экране создания найдите внизу ссылку Continue to Pages. Она открывает именно Pages.
Экран создания приложения Cloudflare: внизу находится ссылка Continue to Pages
Нужная ссылка — Continue to Pages под карточкой создания приложения.

В Pages выберите Import an existing Git repository → Get started. Загрузка файлов вручную создаёт проект Direct Upload — для этой инструкции выбираем Git с самого начала.

Cloudflare Pages: выбор Import an existing Git repository вместо Drag and drop your files
Выберите верхнюю карточку — импорт существующего Git-репозитория.
  1. Нажмите Connect GitHub. При первом подключении GitHub предложит авторизовать приложение Cloudflare Workers and Pages.
  2. На странице установки выберите Only select repositories и только нужный репозиторий. Просмотрите запрашиваемые права и подтвердите Install & Authorize.
  3. После возврата в Cloudflare выберите аккаунт GitHub, отметьте свой репозиторий и нажмите Begin setup.

Если приложение уже установлено, повторная установка может не понадобиться. Если репозитория нет в списке, откройте ссылку настройки доступа приложения GitHub на этой странице и добавьте нужный репозиторий в выбранные.

06 · Один раз

Настроить первую публикацию

На экране Set up builds and deployments укажите:

ПолеЗначение
Project nameo4x-org или другое свободное имя
Production branchmain
Framework presetNone
Build commandОставить пустым: готовому HTML сборка не нужна
Build output directorypublic
Root directoryОставить пустым — корень репозитория
Environment variablesДля этой страницы не нужны

Нажмите Save and Deploy. Cloudflare скачает файлы из GitHub и опубликует содержимое папки public. Дождитесь успешного завершения и откройте выданный адрес *.pages.dev.

Готовые настройки Cloudflare Pages: Build output public, Production branch main, Automatic deployments Enabled
Проверка после создания: Settings → Build. Build output — public, ветка — main, автопубликация — Enabled.

Имя проекта определяет адрес на pages.dev. Если желаемое имя занято, Cloudflare может предложить другой адрес с суффиксом. В дальнейшем используйте точный адрес из вашего проекта, а не адрес из примера.

На вкладке Deployments должны быть ссылка на репозиторий, ветка main и сообщение Automatic deployments enabled. Это подтверждает прямое подключение GitHub.

07 · Один раз · по желанию

Подключить свой домен и www

Этот раздел описывает вариант, в котором DNS домена управляется Cloudflare. Адрес без www и адрес с www подключаются отдельно.

Сначала подготовить домен

  1. Если домен ещё не добавлен в Cloudflare, откройте Domains, добавьте свой зарегистрированный домен и выберите подходящий план.
  2. Проверьте импортированные DNS-записи, особенно если уже работают почта или другие сервисы.
  3. Cloudflare выдаст два nameserver. Укажите именно их у регистратора домена и дождитесь статуса зоны Active. Выданные nameserver индивидуальны — не копируйте значения из чужой инструкции.

Добавить оба адреса в Pages

  1. Откройте свой Pages-проект → Custom domains → Set up a custom domain.
  2. Введите основной домен, например example.com, и нажмите Continue.
  3. Проверьте предложенный CNAME на адрес вашего Pages-проекта и нажмите Activate domain. Для зоны в том же аккаунте Cloudflare предложит создать или обновить DNS-запись.
  4. Повторите эти шаги для www.example.com.
  5. Дождитесь у обоих адресов статуса Active и пометки SSL enabled. При необходимости раскройте Complete DNS setup и нажмите Check DNS records.

Для нашего примера итоговые записи выглядят так. Если интерфейс уже создал их, дублировать записи вручную не нужно:

ТипИмяЦель
CNAME@ — o4x.orgo4x-org.pages.dev
CNAMEwwwo4x-org.pages.dev
Домены o4x.org и www.o4x.org имеют статус Active и SSL enabled в Cloudflare Pages
Оба адреса подключены к одному проекту. В кадре нет данных аккаунта.

Откройте оба адреса с https://. Они должны показывать одну страницу. Автоматический редирект с одного адреса на другой здесь не настраивается.

08 · При каждом обновлении

Менять сайт и отправлять изменения

Открыв новый PowerShell, перейдите в проект. Это нужно один раз на сессию терминала, пока вы не сменили рабочую папку:

cd C:\Projects\o4x.org

Измените public/index.html, например замените «Первая версия сайта» на «Вторая версия сайта». Сохраните файл в редакторе, затем выполните:

git status --short
git diff
git add public/
git commit -m "Update page"
git push origin main
КомандаЗачем нужна
git status --shortПоказывает изменённые, новые и удалённые файлы.
git diffПоказывает изменения в уже отслеживаемых файлах до добавления в коммит.
git add public/Добавляет все изменения внутри public: новые файлы, правки и удаления, включая подпапки. Выполняется заново перед каждым коммитом.
git commitСохраняет выбранные изменения локально. Сообщение можно менять по смыслу обновления.
git push origin mainОтправляет коммиты в GitHub. Этот push автоматически запускает публикацию в Cloudflare.

Картинки и CSS тоже кладите в public — они попадут в тот же коммит. Если меняете служебный файл вне этой папки, добавьте его отдельно, например git add .gitignore.

09 · После push

Убедиться, что обновление опубликовано

  1. GitHub: в ветке main должен появиться ваш новый коммит. Запомните его короткий идентификатор.
  2. Cloudflare → Pages-проект → Deployments: должна появиться новая публикация с тем же коммитом. Если нужно, обновите страницу панели.
  3. Дождитесь успешного завершения. При ошибке откройте Details и прочитайте лог конкретного этапа.
  4. Откройте https://www.example.com и проверьте новый текст. Если браузер показывает старую страницу, выполните Ctrl + F5.
  5. Проверьте также адрес без www. Он должен показать ту же версию.

Сам по себе успешный push означает только загрузку в GitHub. Итоговая проверка — успешный deployment нужного коммита и новый текст на опубликованном сайте.

В нашей схеме отсутствие workflow в GitHub Actions — нормальное состояние: сборку и публикацию выполняет Cloudflare Pages.

10 · Справка

Если что-то не работает

Git пишет «nothing to commit»

Проверьте, что сохранили файл в редакторе и находитесь в нужном проекте. Выполните git status. Если всё чисто, новых изменений для коммита нет.

«remote origin already exists»

Удалённый репозиторий уже настроен. Проверьте адрес командой git remote -v. Если он правильный, повторять git remote add не нужно. Если ошибочный, замените его:

git remote set-url origin https://github.com/YOUR_LOGIN/o4x.org.git
Git просит имя и email

Выполните команды git config user.name и git config user.email из шага 3 со своими значениями, затем повторите commit.

Push отклонён: на GitHub есть новые коммиты

Сначала сохраните локальные изменения коммитом. Затем загрузите удалённые изменения и повторите push:

git pull --rebase origin main
git push origin main

Если Git сообщает о конфликте, разрешите его в указанных файлах перед продолжением. Не используйте force push как обычный способ исправления.

Сайт возвращает 404

Проверьте, что файл называется index.html, лежит в public/ и уже отправлен в GitHub. В Pages поле Build output directory должно быть public, а успешный deployment — соответствовать последнему коммиту.

В Cloudflare написано «No Git connection»

Такой проект не связан напрямую с репозиторием. Проект Direct Upload нельзя переключить на Git integration: создайте новый проект через импорт Git-репозитория, проверьте его и перенесите домены. Старый проект удаляйте после проверки нового.

После push новая публикация не появляется

Проверьте ветку main, правильный удалённый репозиторий и настройку Settings → Build → Branch control → Automatic deployments: Enabled. У приложения Cloudflare в GitHub должен оставаться доступ к этому репозиторию. Проверьте, нет ли в сообщении коммита флага пропуска сборки вроде [skip ci].

pages.dev работает, а свой домен — нет

Проверьте, что домен добавлен в Custom domains нужного проекта, его DNS-запись указывает на точный адрес этого проекта, а nameserver у регистратора совпадают с выданными Cloudflare. Для www нужна отдельная запись и отдельное подключение в Pages. Дождитесь проверки DNS и активации SSL.

Картинки не загрузились

Проверьте путь и регистр букв: Photo.jpg и photo.jpg могут быть разными файлами на хостинге. Файл должен находиться в public, быть добавлен в коммит и отправлен в GitHub. Для текущей инструкции изображения находятся в public/guide/images/.

Нужно ли добавлять API-токен или .env?

Для описанной прямой публикации — нет. В нашем локальном проекте .env сохранён для административных операций через API, но Cloudflare Git-интеграция его не использует. В Git допустимо хранить только пустой шаблон .env.example, без настоящих значений секретов.

Официальные инструкции