AI 参与说明(Agent:Codex):本页由 Codex 根据站内已校验的 Cloudflare 技术文档维护阅读顺序、跨平台专题入口和交互式学习地图。产品状态、API、限额和部署方式会变化,请以对应专题页的一手来源和资料日期为准。
这里集中维护 Cloudflare 产品与工程实践的长期技术资料。新增与 Workers、KV、Durable Objects、Containers、Sandbox、Workflows 等能力直接相关的文档时,放入本目录,并同步更新本页导航。
Cloudflare 文档学习地图(Kumo PoC)#
这是本站 Cloudflare 专题的学习路径:基础 → 执行边界 → 可恢复编排。每张卡片都链接到相应文章;完整导航保留在下方。
推荐阅读顺序#
- Workers:运行时 API、Bindings 与执行模型:先分清 handler、Runtime API、
envbinding、平台产品与控制面 API 的职责边界。 - Cloudflare Workers KV:架构、一致性、API 与选型边界:理解 central stores 与多层缓存、eventual consistency、读写 API、价格限额,以及何时应改用 Durable Objects、D1 或 R2。
- Cloudflare Workers Rate Limiting API:用法、业务维度与选型边界:区分 Cloudflare 控制面 API 配额、Worker 代码内业务限流、WAF 入口防护,以及严格计费应使用的状态模型。
- Durable Objects 使用方式与接口整理:先建立有状态协调、对象身份、私有 SQLite、Alarm 与 WebSocket 的基础认知。
- Convex Agent Component 与 Cloudflare Agents SDK:关页后继续生成并恢复聊天:比较 durable ACK、断线续流、重启恢复与失败重试,并给出 Workers + TanStack Start 的落地架构。
- Queues:生产者、消费者、批量处理与重试实战:从消息生产、消费确认到延迟重试、DLQ、幂等与监控,建立可靠异步处理模型。
- Dynamic Workers、Containers 与 Sandbox:关系、区别与使用方式:先分清动态 Worker、完整 Linux Container 和 Sandbox SDK 的选型边界。
- Dynamic Workers:Worker Loader、受控 Binding 与安全执行:从 Loader、WorkerCode、WorkerStub 到 capability 与 egress control,建立可落地的安全执行模型。
- Durable Object Facets:概念、使用场景与 Durable Objects 对比:理解动态子代码如何在受控的 parent DO 下获得隔离 SQLite,并判断何时仍应直接使用普通 DO。
- Sandbox SDK:命令、文件、进程与会话 API 实战:按命令、文件、session、解释器、进程和 Tunnel API 使用隔离 Linux 环境。
- Cloudflare Computer 技术解析:持久 Workspace、执行后端与 Agent 集成:在掌握 Durable Objects、Dynamic Workers 与 Sandbox 后,理解 Durable Workspace 如何组合文件状态和多种执行后端。
- Cloudflare OS:产品形态、Gadgets、Gatekeepers 与 Workers 架构:把 Durable Objects、Dynamic Workers、Gadget 和 Gatekeeper 组合成 Agent 驱动的企业工作区,核对部署拓扑、capability security 边界、适用场景与渐进式使用策略。
- Workflows 与 Dynamic Workflows:概念、使用方式与适用场景:理解持久化编排与运行时动态代码的职责边界。
- Workflows:实例、步骤、事件与恢复 API 实战:用订单、webhook、等待事件和补偿走完一个可恢复流程。
- Dynamic Workflows:多租户动态代码如何跨休眠恢复:了解如何将实例 metadata 路由回创建时的不可变租户代码版本。
- Convex Workflows、Cloudflare Workflows 与 Dynamic Workflows:区别、场景与使用方式:从流程代码所有权、持久化模型和动态代码能力选择合适的编排方式。
- Cloudflare R2 Data Catalog:它是什么,以及旧图片 bucket 为什么会出现在其中:区分 R2 object storage、Apache Iceberg catalog 与查询引擎,并判断旧 bucket 是候选资源还是已启用 catalog。
- Cloudflare R2 图片上传到 Hugo 博客:安全、可验证的 AWS CLI 流程:用最小权限的 R2 API token、
YYYY/filename.ext键、显式 MIME/缓存元数据和 CDN HEAD 校验,完成可复现的图片上传。
收录原则#
以 Cloudflare 产品能力为主线、可长期维护的资料归入本专题;只将 Cloudflare 作为案例的跨云对比、Serverless 通识或行业观察文章,仍保留在原有主题与时间线中。