Cloudflare Pages 部署
本文档介绍如何在 Cloudflare Pages 上部署静态网站。
部署方式
方式一：直接连接 Git 仓库（推荐）
- 登录 Cloudflare Dashboard
- 进入「Workers & Pages」→「创建应用程序」
- 选择「Pages」选项卡
- 点击「连接到 Git 仓库」
- 选择您的 GitHub 仓库
- 配置构建设置：
- 框架预设：Docusaurus
- 构建命令：
npm run build - 构建输出目录：
build
- 点击「部署」
方式二：手动上传
- 本地运行
npm run build - 在 Cloudflare Dashboard 创建 Pages 项目
- 直接上传
build目录
构建设置
构建命令
npm run build
输出目录
build
环境变量
如需在构建时添加：
| 变量名 | 值 |
|---|---|
| NODE_VERSION | 20 |
自定义域名
添加域名
- 进入 Pages 项目 → 「自定义域」
- 点击「添加自定义域」
- 输入您的域名
openhumanwiki.com - Cloudflare 会自动验证和配置 DNS
DNS 配置
如果域名在其他注册商：
类型 名称 内容
CNAME www your-project.pages.dev
部署配置
创建 cloudflare-pages.json：
{
"name": "openhumanwiki",
"compatibility_date": "2024-01-01",
"routes": [
{ "pattern": "openhumanwiki.com", "zone_name": "openhumanwiki.com" }
]
}
预览部署
每次 PR 都会自动创建预览部署，方便在合并前查看效果。
缓存清理
部署后如需清理缓存：
- 进入 Pages 项目 → 「缓存」
- 点击「清理缓存」
常见问题
构建失败
检查构建日志，确认依赖安装成功。
域名验证失败
确保 DNS 配置正确传播（可能需要几分钟）。
部署后页面空白
检查是否正确设置了 baseUrl 配置。