Cloudflare Pages 部署
使用 Cloudflare Pages 托管 Docusaurus 的静态构建产物。
构建设置
在 Cloudflare Pages 中使用下面的配置：
| 配置项 | 值 |
|---|---|
| 框架预设 | None |
| 构建命令 | npm run build |
| 构建输出目录 | build |
| 根目录 | / |
| Node.js 版本 | 22 |
构建过程
npm run build 会先构建 Docusaurus，再生成 Pagefind 索引：
npm run build:site
npm run index:search
生成的 build/pagefind/ 目录会和其他静态文件一起部署。
GitHub 部署流程
- 将代码推送到
main分支。 - Cloudflare Pages 根据
package-lock.json安装依赖。 - Cloudflare Pages 执行
npm run build。 - Cloudflare Pages 发布生成的
build/目录。
SEO 发布检查
生产构建应生成 sitemap.xml、robots.txt、llms.txt 和 llms-full.txt。Markdown 源文件不应被复制进 build/，公开入口以渲染后的 HTML 页面为准。