Workers · Pages · D1 · R2 · Workers AI · 2026

Cloudflare 边缘全栈开发完全指南

Cloudflare 把全栈应用跑在离用户最近的 300+ 个数据中心:Workers 无服务器计算,D1 边缘 SQLite,R2 零出口费对象存储,Durable Objects 有状态协调,Queues 异步解耦,Workers AI 免部署 LLM 推理。10 章带你写出真正在边缘运行的应用。

Workers Pages D1 SQLite R2 Storage KV Durable Objects Workers AI

章节目录

01

Cloudflare 边缘架构

为什么是边缘?V8 Isolates vs 容器、冷启动 < 5ms、0ms 加载策略、Anycast 路由,理解 Cloudflare 这套与众不同的计算模型。

EdgeV8 IsolateAnycast
02

第一个 Worker:Hono + wrangler

用 wrangler 初始化、写路由、本地 dev、线上部署。覆盖 fetch handler、Request/Response、环境变量、wrangler.toml。

wranglerHono部署
03

D1:全球边缘 SQLite

D1 建库、Drizzle 绑定、只读副本、迁移管理。read replicas、Sessions API、分析查询与事务边界。

D1Drizzle迁移
04

R2 对象存储:零出口费

R2 bucket、S3 兼容 API、Presigned URL、事件通知。对比 S3 定价,讲清为什么静态资产/数据湖要搬家。

R2S3 兼容CDN
05

KV 与 Cache:边缘键值

KV 的最终一致性特性、写延迟、Cache API 与 fetch cache。什么放 KV、什么放 D1、什么只进 Cache。

KVCache API一致性
06

Durable Objects:有状态边缘

单例对象 + 强一致性 storage。实现协同编辑、游戏房间、速率限制、WebSocket hibernation。

DOActorWebSocket
07

Queues、Cron 与 Workflows

Queues 解耦生产消费,Cron Triggers 定时任务,Workflows 持久化长流程——失败自动重试,横跨数天的业务流。

QueuesCronWorkflows
08

Pages + Full-stack 框架

Pages 部署 Next.js / SvelteKit / Remix,Functions 自动识别,Bindings 直连 D1/R2。Git 集成与 Preview 环境。

PagesNext.jsPreview
09

Workers AI 与 Vectorize

在边缘调 Llama/Mistral/嵌入模型,Vectorize 向量索引,AI Gateway 做 LLM 观测。RAG 全链路在 Cloudflare 跑完。

Workers AIVectorizeRAG
10

可观测与生产部署

Logs、Tail、Traces、Analytics Engine、Wrangler CI/CD、多环境 secrets、回滚策略。上生产前的最后一张检查单。

ObservabilityCI/CD生产