Static HTML

Cloudflare 支持将任意静态 HTML 网站部署到 Cloudflare Pages。如果你在不使用框架或静态站点生成器的情况下管理网站，或者你的框架未列在框架指南中，仍可使用本指南部署。

继续之前

所有框架指南都假定你已具备 Git ↗ 的基础知识。如果你是 Git 新手，请参阅这份精简 Git 手册 ↗，了解如何在本地设置 Git。

如果你使用 SSH 克隆，则必须在每台用于向 GitHub 推送或拉取的计算机上生成 SSH 密钥 ↗。

创建 GitHub 仓库

访问 repo.new ↗ 创建新的 GitHub 仓库。创建新仓库后，进入新创建的项目目录，在终端中运行以下命令，准备并将本地应用推送到 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 页面。
Go to Workers & Pages ↗
选择 Create application（创建应用程序）。
选择 Pages 选项卡。
选择 Import an existing Git repository（导入现有 Git 仓库）。
选择你创建的新 GitHub 仓库，然后选择 Begin setup（开始设置）。
在 Set up builds and deployments（设置构建和部署） 部分，提供以下信息：

配置选项	值
Production branch	`main`
Build command (optional)	`exit 0`
Build output directory	`<YOUR_BUILD_DIR>`

与许多框架指南不同，站点的构建命令和构建输出目录将完全自定义。如果不使用预设且不需要构建站点，请使用 exit 0 作为 Build command（构建命令）。Cloudflare 建议使用 exit 0 作为 Build command（构建命令） 以使用 Pages Functions 等功能。Build output directory（构建输出目录） 是应用内容所在的位置。

配置站点后，即可开始首次部署。你的自定义构建命令（如果提供）将运行，Pages 将部署静态站点。

部署站点后，你将在 *.pages.dev 上获得项目的唯一子域名。Cloudflare Pages 将自动重新构建并部署项目。你还可以在新 pull request 上获得预览部署，在部署到生产环境之前预览更改效果。

在 *.pages.dev 上出现 404 错误？

如果访问 *.pages.dev 域名时出现 404 错误，请确保网站有顶层的 index.html 文件。Pages 将在未指定页面时在 apex 上提供此 index.html。

了解更多

完成本指南后，你已成功将站点部署到 Cloudflare Pages。要开始使用其他框架，请参阅框架指南列表。