文档导航

AI 参与说明（Agent：Codex）：本页由 Codex 根据站内已校验的 Cloudflare 技术文档维护阅读顺序和跨平台专题入口。产品状态、API、限额和部署方式会变化，请以对应专题页的一手来源和资料日期为准。

这里集中维护 Cloudflare 产品与工程实践的长期技术资料。新增与 Workers、KV、Durable Objects、Containers、Sandbox、Workflows、AI Search、Email Service、Artifacts、Wallets 等能力直接相关的文档时，放入本目录，并同步更新本页导航。

推荐阅读顺序

1. Workers：运行时 API、Bindings 与执行模型：先分清 handler、Runtime API、env binding、平台产品与控制面 API 的职责边界。
2. Cloudflare Workers KV：架构、一致性、API 与选型边界：理解 central stores 与多层缓存、eventual consistency、读写 API、价格限额，以及何时应改用 Durable Objects、D1 或 R2。
3. Cloudflare Workers Rate Limiting API：用法、业务维度与选型边界：区分 Cloudflare 控制面 API 配额、Worker 代码内业务限流、WAF 入口防护，以及严格计费应使用的状态模型。
4. Durable Objects 使用方式与接口整理：先建立有状态协调、对象身份、私有 SQLite、Alarm 与 WebSocket 的基础认知。
5. Convex 与 Cloudflare Durable Objects：状态模型、查询边界与选型：分清共享响应式数据库与单实例 Actor，避免把 Durable Objects 当成 Convex 的替代品。
6. Convex Agent Component 与 Cloudflare Agents SDK：关页后继续生成并恢复聊天：比较 durable ACK、断线续流、重启恢复与失败重试，并给出 Workers + TanStack Start 的落地架构。
7. Queues：生产者、消费者、批量处理与重试实战：从消息生产、消费确认到延迟重试、DLQ、幂等与监控，建立可靠异步处理模型。
8. Dynamic Workers、Containers 与 Sandbox：关系、区别与使用方式：先分清动态 Worker、完整 Linux Container 和 Sandbox SDK 的选型边界。
9. Dynamic Workers：Worker Loader、受控 Binding 与安全执行：从 Loader、WorkerCode、WorkerStub 到 capability 与 egress control，建立可落地的安全执行模型。
10. Durable Object Facets：概念、使用场景与 Durable Objects 对比：理解动态子代码如何在受控的 parent DO 下获得隔离 SQLite，并判断何时仍应直接使用普通 DO。
11. Sandbox SDK：命令、文件、进程与会话 API 实战：按命令、文件、session、解释器、进程和 Tunnel API 使用隔离 Linux 环境。
12. Cloudflare Computer 技术解析：持久 Workspace、执行后端与 Agent 集成：在掌握 Durable Objects、Dynamic Workers 与 Sandbox 后，理解 Durable Workspace 如何组合文件状态和多种执行后端。
13. Cloudflare OS：产品形态、Gadgets、Gatekeepers 与 Workers 架构：把 Durable Objects、Dynamic Workers、Gadget 和 Gatekeeper 组合成 Agent 驱动的企业工作区，核对部署拓扑、capability security 边界、适用场景与渐进式使用策略。
14. Workflows 与 Dynamic Workflows：概念、使用方式与适用场景：理解持久化编排与运行时动态代码的职责边界。
15. Workflows：实例、步骤、事件与恢复 API 实战：用订单、webhook、等待事件和补偿走完一个可恢复流程。
16. Dynamic Workflows：多租户动态代码如何跨休眠恢复：了解如何将实例 metadata 路由回创建时的不可变租户代码版本。
17. Convex Workflow、Cloudflare Workflows 与 Dynamic Workflows：区别、场景与使用方式：从流程代码所有权、持久化模型和动态代码能力选择合适的编排方式。
18. Cloudflare R2 Data Catalog：它是什么，以及旧图片 bucket 为什么会出现在其中：区分 R2 object storage、Apache Iceberg catalog 与查询引擎，并判断旧 bucket 是候选资源还是已启用 catalog。
19. Cloudflare R2 图片上传到 Hugo 博客：安全、可验证的 AWS CLI 流程：用最小权限的 R2 API token、YYYY/filename.ext 键、显式 MIME/缓存元数据和 CDN HEAD 校验，完成可复现的图片上传。
20. Cloudflare AI Search：功能、使用方式与最佳实践：把它看成托管的搜索与 RAG 流水线，分清 Instance、Data source、search() 与 chatCompletions()，并判断何时应改用 Vectorize。
21. Cloudflare Email Service：介绍、使用方式与开发接入：分清开发者收发信与 Email security，核对 SMTP 465、email() handler 与本地调试，并对照 Agentic Inbox 参考实现。
22. Cloudflare Artifacts：产品、概念、API 与最佳实践：把它看成账户拥有的可编程 Git 存储面，分清 Namespace、repo-scoped token、控制面与 Git 数据面，并按一任务一仓落地。
23. Cloudflare Wallets：Handle 预约、产品状态与现在能做什么：分清已开放的 Handle 预约与尚未开放的充值、Virtual Wallet、控制面 API，并对照今天就能用的 Agents SDK x402 付款路径。
24. EmDash CMS：技术原理、适用场景与架构取舍：理解数据库内容模型、Astro 请求时查询、Portable Text、插件隔离与 MCP，判断 Agent 内容维护是否适合采用，并核对 Cloudflare 自部署的更新、迁移与恢复机制。
25. Cloudflare Workers Builds：免费额度、超限处理与费用计算：区分免费套餐的构建上限、付费套餐的包含额度与超额单价，避免混淆构建时间和线上运行费用。
26. Workers Builds：能承担哪些工作，与 GitHub Actions 如何分工：按构建、测试、定时触发、运行环境与任务编排判断哪些工作可以迁移，并给出发布流程示例。

交叉主题

• OpenCode v2 在 Cloudflare 上怎么用：使用场景与 SDK 入门：从官方入口理解使用场景，完成 Durable Object 初始化、Session 调用和 Plugin 接入。

收录原则

以 Cloudflare 产品能力为主线、可长期维护的资料归入本专题；只将 Cloudflare 作为案例的跨云对比、Serverless 通识或行业观察文章，仍保留在原有主题与时间线中。