本目录是一套围绕 Cloudflare 开发者平台(Workers 生态) 系统整理的中文参考文档,参照官方手册结构编写、并做了符合中文阅读习惯的重组与演绎。
数据截至 2026-10,所有配额与价格以 Cloudflare 官方文档 最新页面为准。
1. 这套文档在讲什么
Cloudflare 开发者平台把「计算、存储、数据库、AI、网络」都搬到了离用户最近的边缘节点。你不必再管理服务器,只要写代码、配置绑定(Binding),就能在全球部署。本索引把相关产品拆成多篇独立文档,每篇都按统一框架展开:
定位 → 核心概念 → 架构原理 → 快速开始 → 配额与限制 → 定价 → 最佳实践 → 适用场景与选型
一句话区分四款核心产品:Workers 跑代码、D1 存关系型数据、R2 存文件对象、KV 存极简键值;其余都是围绕它们的增强能力。
2. 文档导航
2.1 核心四件套(任何项目的基础)
| 文档 | 一句话定位 | 链接 |
|---|---|---|
| Workers | 边缘无服务器计算(V8 Isolate),一切的运行载体 | Workers |
| D1 | Serverless SQLite 数据库,按行计费 | D1 |
| R2 | S3 兼容对象存储,零出网费 | R2 |
| KV | 全球键值存储,最终一致,适合配置/缓存 | KV |
2.2 关联产品(按需叠加的能力)
| 文档 | 一句话定位 | 链接 |
|---|---|---|
| Durable Objects | 强一致、带持久存储的状态协调原语 | Durable Objects |
| Queues | 保证投递、零出网费的消息队列 | Queues |
| Workflows | 可暂停、自动重试、跨天持久化的多步编排 | Workflows |
| Workers AI | Serverless GPU 推理,50+ 开源模型 | Workers AI |
| Vectorize | 全球向量数据库,做语义搜索 / RAG | Vectorize |
| Hyperdrive | 为既有 Postgres/MySQL 做边缘加速 | Hyperdrive |
| AI Gateway | 统一 AI 网关:可观测、缓存、限流、回退 | AI Gateway |
| CDN & Cache API | 全球边缘缓存层,默认零出网费 | Cache API |
| Images | 边缘图像处理:实时缩放/优化 | Images |
| Browser Run | 边缘无头浏览器:截图/PDF/抓取/自动化(原 Browser Rendering) | Browser Run |
2.3 综合与实战
| 文档 | 说明 | 链接 |
|---|---|---|
| 完整指南(合并版) | 四核心产品速览 + 横向对比选型 | 完整指南 |
| yuebin.uk 配合分析 | 以 yuebin CMS 为例,剖析 D1/R2/KV 的实际分工与实战注意点 | 实战分析 |
3. 横向选型速查
| 你想做的事 | 优先选择 | 备注 |
|---|---|---|
| 跑后端逻辑 / API | Workers | 一切的运行载体 |
| 存结构化数据、要 SQL | D1 | 单库上限 500 MB,适合中小规模 |
| 存图片/视频/备份等大文件 | R2 | 零出网费,S3 兼容 |
| 存配置、开关、会话类极简数据 | KV | 最终一致,读极快,list 昂贵 |
| 协调共享状态、强一致 | Durable Objects | 单对象持久存储,有 SQLite 后端 |
| 异步任务 / 削峰填谷 | Queues | 保证投递,无出网费 |
| 长流程、多步、可暂停 | Workflows | 自动重试与持久化 |
| 跑开源大模型推理 | Workers AI | 按 token(Neurons)计费 |
| 语义搜索 / RAG | Vectorize + Workers AI | 向量索引 + 嵌入模型 |
| 加速外部数据库 | Hyperdrive | 连你已有的 Postgres/MySQL |
| 统一管控所有 AI 调用 | AI Gateway | 叠加在 Workers AI / 第三方之上 |
| 加速静态资源分发 | CDN & Cache API | 默认零出网费 |
| 实时图片缩放优化 | Images | R2 存图 + Images 转换最经济 |
| 截图 / PDF / 抓取 | Browser Run | 边缘无头 Chrome |
4. 阅读建议
- 新手:先看 Workers 建立「绑定 + 边缘运行」的心智模型,再按需看存储类(D1/R2/KV)。
- 做站点 / CMS:重点看 R2 + Cache + Images + Workers,可对照 实战分析。
- 做 AI 应用:看 Workers AI → Vectorize → AI Gateway 这条链路。
- 做后台任务:看 Queues → Workflows → Durable Objects。
5. 数据来源与说明
- 内容综合自 Cloudflare 官方文档仓库(
production分支)的 Overview / Limits / Pricing 等页面,并结合实际使用场景做了演绎与重组。 - 配额与价格随时间调整,正式上线前请以官方最新页面为准。
- 代码示例为稳定用法示例,实际 API 以官方最新 SDK 为准。