Cloudflare 基础概念

Pages

Cloudflare Pages 适合部署静态站点和前端项目。它支持：

• 从 Git 仓库自动构建和部署。
• 使用 Pages Functions 添加服务端 API。
• 通过全球边缘网络分发内容。

在这个项目中，Pages 负责承载 VitePress 文档站点。

Workers

Workers 是 Cloudflare 的边缘函数。它可以在离用户更近的位置运行代码，适合：

• API 接口
• 鉴权逻辑
• 请求转发
• 轻量计算
• 与 R2、KV、D1 等服务绑定

本项目使用 Pages Functions 作为 Workers 的入口。

R2

R2 是 Cloudflare 的对象存储服务，兼容 S3 API。适合：

• 图片、视频、文档存储
• 用户上传文件
• 静态资源备份
• 日志归档

本项目中，Workers 通过 DEMO_BUCKET 绑定直接读写 R2，不需要在代码里写 S3 密钥。

Pages、Workers、R2 的关系

浏览器
  |
  | 访问 Pages 页面
  v
Cloudflare Pages
  |
  | fetch('/api/demo')
  v
Pages Functions / Workers
  |
  | DEMO_BUCKET.put/get/delete
  v
Cloudflare R2

这个关系很重要：前端页面不直接暴露 R2 密钥，而是通过 Workers 访问 R2。