Cloudflare

Cloudflare 集成

EasyStarter 的服务端运行在 Cloudflare 体系上，核心会用到：

• Cloudflare Workers
• Cloudflare D1
• Cloudflare R2

如果你要执行数据库迁移、部署服务端，或者配置对象存储，通常都需要先准备 Cloudflare 相关凭据。

所需环境变量

CLOUDFLARE_ACCOUNT_ID=
CLOUDFLARE_API_TOKEN=

• CLOUDFLARE_ACCOUNT_ID：Cloudflare 账号 ID
• CLOUDFLARE_API_TOKEN：访问 Cloudflare API 的令牌

这些值通常用于 apps/server/drizzle.config.ts，让 drizzle-kit 通过 D1 HTTP 驱动执行数据库命令。

获取 CLOUDFLARE_ACCOUNT_ID

官方文档：Find account and zone IDs

方式一：从 Account Home 获取

1. 登录 Cloudflare Dashboard。
2. 进入 Account Home。
3. 找到你的账号那一行。
4. 点击右侧菜单按钮。
5. 选择 Copy account ID。

复制出来的值就是 CLOUDFLARE_ACCOUNT_ID。

方式二：从 Workers & Pages 获取

1. 登录 Cloudflare Dashboard。
2. 进入 Workers & Pages。
3. 在 Account details 区域找到 Account ID。
4. 点击复制。

获取 CLOUDFLARE_API_TOKEN

官方文档：Create API token

推荐使用 API Token，不要使用旧的 Global API Key。

创建步骤

1. 登录 Cloudflare Dashboard。
2. 进入 My Profile > API Tokens。
3. 点击 Create Token。
4. 选择 Custom token。
5. 给 token 起一个清晰的名字，比如 easystarter-d1-migrate。
6. 在权限里添加：
   • Account -> D1 -> Edit
   • Account -> Workers R2 Storage -> Edit
   • Account -> Workers Scripts -> Edit
7. 在资源范围里，只选择当前项目所在的账号。
8. 点击 Continue to summary。
9. 检查权限和资源范围。
10. 点击 Create Token。
11. 复制生成出来的 token。

复制出来的值就是 CLOUDFLARE_API_TOKEN。

注意

• token 只会在创建成功时展示一次
• 丢了就只能重新生成，不能回看明文
• 这个值是敏感信息，只放到 .dev.vars、.env.production 或 CI secrets 中

放入位置

这些环境变量要位于 apps/server 目录下，并命名为 .dev.vars 或 .env.production。

CLOUDFLARE_ACCOUNT_ID=
CLOUDFLARE_API_TOKEN=

CLOUDFLARE_ACCOUNT_ID=
CLOUDFLARE_API_TOKEN=