Cloudflare Pages 部署官网
官网基于 Astro，构建后为静态文件，推荐使用 Cloudflare Pages 部署。
前置条件
- Cloudflare 账号
- GitHub 仓库已推送代码
1. 创建 Pages 项目
- 登录 Cloudflare Dashboard → Workers & Pages → Create
- 选择 Pages → Connect to Git
- 选择你的 GitHub 仓库
2. 构建配置
| 配置项 | 值 |
|---|---|
| 构建命令 | npm ci && npm run build --workspace=website |
| 输出目录 | website/dist |
| 根目录 | /（保持默认） |
| Node.js 版本 | 22 |
设置 Node.js 版本：在 Environment variables 中添加
NODE_VERSION = 22
3. 环境变量
在 Cloudflare Pages → Settings → Environment variables 中添加：
PUBLIC_BACK_END=https://api.yourdomain.com
PUBLIC_TITLE=ReadyStart
...完整环境变量列表参考 环境变量
4. 自定义域名
- Pages 项目 → Custom domains → Set up a custom domain
- 输入域名，如
yourdomain.com - Cloudflare 会自动添加 DNS 记录并申请 SSL 证书
部署触发
- 推送代码到主分支 → 自动构建部署
- 推送到其他分支 → 自动创建预览部署（Preview URL）
注意事项
- 构建命令中需要
npm ci安装依赖，因为 Cloudflare Pages 不会自动安装 monorepo 的依赖 - 如果构建失败，检查 Node.js 版本是否正确