Cloudflare Pages 部署

本文档介绍如何将 OpenHuman 部署到 Cloudflare Pages。

前提条件

• Cloudflare 账号
• GitHub 仓库
• 域名（可选）

部署步骤

1. 连接 GitHub

1. 登录 Cloudflare Dashboard
2. 进入 Workers & Pages
3. 点击 Create application
4. 选择 Pages → Connect to Git

2. 配置构建

设置	值
Production branch	main
Build command	npm run build
Build output directory	build

3. 环境变量

在 Pages 设置中添加：

NODE_VERSION = 18

4. 自定义域名

1. 进入 Custom domains
2. 点击 Add custom domain
3. 输入您的域名
4. 配置 DNS（CNAME 或 A 记录）

部署配置

在 docusaurus.config.ts 中配置：

const config: Config = {
  url: 'https://openhumanwiki.com',
  baseUrl: '/',
  organizationName: 'bigwei08028',
  projectName: 'openhumanwiki',
};

使用 Wrangler 部署

npm install -g wrangler
wrangler pages deploy build --project-name=openhumanwiki

持续部署

每次推送到 main 分支，Cloudflare Pages 会自动：

1. 拉取最新代码
2. 运行构建
3. 部署到全球 CDN

常见问题

构建失败

检查 package.json 中的构建命令是否正确。

域名验证失败

确保 DNS 记录已传播（等待 24-48 小时）。

缓存问题

在 Cloudflare Dashboard 中清除缓存。

下一步

• Docker 部署 - 使用 Docker 部署
• Vercel 部署 - 使用 Vercel 部署