← Cloudflare Pages / pages / framework-guides

Статический HTML

Cloudflare позволяет развернуть на Cloudflare Pages любой статический HTML-сайт. Если вы ведёте сайт без фреймворка или генератора статических сайтов, либо ваш фреймворк не указан в Руководства по фреймворкам, вы всё равно можете развернуть его с помощью этого руководства.

Прежде чем продолжить

Все руководства по фреймворкам предполагают, что у вас уже есть базовое понимание Git ↗. Если вы новичок в Git, обратитесь к этому краткое руководство по Git ↗ о том, как настроить Git на локальном компьютере.

Если вы клонируете по SSH, необходимо сгенерировать ключи SSH ↗ на каждом компьютере, с которого вы отправляете или получаете данные из GitHub.

См. документация GitHub ↗ и Документация Git ↗, где это описано подробнее.

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

Создайте новый репозиторий GitHub, перейдя по адресу repo.new ↗. После создания нового репозитория перейдите в каталог только что созданного проекта, чтобы подготовить локальное приложение и отправить его в GitHub, выполнив в терминале следующие команды:

git init
git remote add origin https://github.com/<your-gh-username>/<repository-name>
git add .
git commit -m "Initial commit"
git branch -M main
git push -u origin main

Развернуть с помощью Cloudflare Pages

Чтобы развернуть сайт в Pages:

На панели управления Cloudflare перейдите к разделу Workers & Pages страницу.
Перейдите в Workers & Pages ↗
Выберите Создать приложение.
Выберите Pages на вкладке.
Выберите Импорт существующего репозитория Git.
Выберите созданный вами новый репозиторий GitHub, а затем нажмите Начало настройки.
В Настройка сборок и деплоев раздел и укажите следующую информацию:

Параметр конфигурации	Значение
Продакшен-ветка	`main`
Команда сборки (необязательно)	`exit 0`
Каталог вывода сборки	`<YOUR_BUILD_DIR>`

В отличие от многих руководств по фреймворкам, команда сборки и каталог вывода сборки для вашего сайта будут полностью произвольными. Если вы не используете пресет и вам не нужно собирать сайт, используйте exit 0 как ваш Команда сборки. Cloudflare рекомендует использовать exit 0 как ваш Команда сборки для доступа к таким функциям, как Pages Functions. Каталог вывода сборки хранит содержимое вашего приложения.

После настройки сайта вы можете запустить первый деплой. Запустится ваша пользовательская команда сборки (если она указана), и Pages развернёт ваш статический сайт.

После того как вы развернёте сайт, вы получите уникальный поддомен для своего проекта на *.pages.dev. Cloudflare Pages автоматически пересоберет ваш проект и развернет его. Вы также получите доступ к развёртывания предпросмотра для новых pull request, чтобы вы могли увидеть, как изменения выглядят на сайте, прежде чем разворачивать их в продакшен.

Получаете ошибки 404 на *.pages.dev?

Если вы получаете 404 ошибки при переходе на *.pages.dev домен, убедитесь, что на сайте есть файл верхнего уровня для index.html. Это index.html будет отдаваться Pages на корневом домене, если страница не указана.

Подробнее

После выполнения этого руководства вы успешно развернули свой сайт на Cloudflare Pages. Чтобы начать работу с другими фреймворками, обратитесь к списку руководств по фреймворкам.