Cloudflare on LYon's Blog

文档导航

Mon, 01 Jan 0001 00:00:00 +0000

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

Workers：运行时 API、Bindings 与执行模型

Fri, 07 Aug 2026 00:00:00 +0000

值得单独写一篇。Workers 是 Cloudflare 开发平台的运行时底座；不先分清 handler、ctx、env binding 与运行时 API，后续接触 Queues、Durable Objects、Workflows、Dynamic Workers 时，很容易把“触发方式”“资源能力”和“部署管理 API”混在一起。

Durable Objects 使用方式与接口整理

Mon, 13 Jul 2026 00:00:00 +0000

Cloudflare Durable Objects 是 Workers 体系里用来处理“有状态协调”的能力。普通 Worker 更像无状态函数：请求来了执行一段逻辑，执行完就结束；Durable Object 则像一个带身份、带内存状态、带私有存储的小型服务实例。

Dynamic Workers、Containers 与 Sandbox：关系、区别与使用方式

Fri, 07 Aug 2026 00:00:00 +0000

Cloudflare 的 Dynamic Workers、Containers 与 Sandbox SDK 很容易被误认为是三个平级的“沙箱产品”。实际并非如此：

Dynamic Workers：Worker Loader、受控 Binding 与安全执行

Fri, 07 Aug 2026 00:00:00 +0000

这是一篇“把 API 放回运行时”的实战页。Dynamic Workers 不是把一段字符串直接执行掉：先部署一个可信的 Loader Worker；Loader 再决定动态代码、它可拿到的 binding、网络出口和资源上限。真正重要的接口只有三层：WorkerLoader、WorkerCode 与 WorkerStub / entrypoint。

Sandbox SDK：命令、文件、进程与会话 API 实战

Fri, 07 Aug 2026 00:00:00 +0000

Sandbox SDK 的价值不是“替你执行一个命令”，而是把一套隔离 Linux 环境的生命周期、文件系统、进程、解释器与服务暴露能力，收敛为 Worker 中可调用的 TypeScript API。它建立在 Containers 与 Durable Objects 之上，适合 AI Agent、代码解释器、在线 IDE 和不可信代码执行。

Workflows 与 Dynamic Workflows：概念、使用方式与适用场景

Fri, 07 Aug 2026 00:00:00 +0000

Cloudflare 这里有三个很容易混在一起的概念：Workflows、Dynamic Workers 与 Dynamic Workflows。它们并不是三个同级、可互相替换的产品。

Workflows：实例、步骤、事件与恢复 API 实战

Fri, 07 Aug 2026 00:00:00 +0000

Workflows 最容易被误用成“把异步函数放到后台”。它真正提供的是可恢复的步骤边界：step.do() 成功后的可序列化结果会被保存；睡眠、等待事件、Worker 重启或暂时失败后，运行时从已完成步骤继续。本文用“订单等待付款后履约”走完创建、等待、投递事件、查询与补偿的完整闭环。

Dynamic Workflows：多租户动态代码如何跨休眠恢复

Fri, 07 Aug 2026 00:00:00 +0000

Dynamic Workers 解决“现在加载哪段代码”；Workflows 解决“这次流程在 sleep、重试或等待事件后如何继续”。Dynamic Workflows 解决二者结合后最棘手的问题：一个数天前创建的实例恢复时，怎样找回当时那一版租户代码，而不是不小心执行当前最新版本。

Convex Workflows、Cloudflare Workflows 与 Dynamic Workflows：区别、场景与使用方式

Fri, 07 Aug 2026 00:00:00 +0000

如果应用已经建立在 Convex 上，优先选 Convex Workflow；如果流程代码由团队随 Worker 一起部署，优先选 Cloudflare Workflows；只有当“流程实现本身”要按租户、用户或 Agent 在运行时加载时，才需要 Cloudflare Dynamic Workflows。

Queues：生产者、消费者、批量处理与重试实战

Fri, 07 Aug 2026 00:00:00 +0000

Queues 解决的是“请求到来时先可靠地收下工作，稍后再异步处理”。它适合削峰、异步发信、写入第三方服务、批处理和事件驱动管道；它不是严格 FIFO 队列，也不是能持久化多步骤状态机的 Workflow。它提供的是 at-least-once（至少一次）投递：消息不会因一次暂时故障轻易丢失，但消费者必须能接受重复投递。

Cloudflare R2 图片上传到 Hugo 博客：安全、可验证的 AWS CLI 流程

Fri, 07 Aug 2026 00:00:00 +0000

**结论：把博客图片上传到 R2 最稳妥的方式，是使用仅限目标 bucket 的 R2 专用 Object Read & Write token，通过 S3 兼容 endpoint 写入 YYYY/filename.ext，再用已启用的自定义 CDN 域名访问。**上传工具应显式写入 Content-Type 和 Cache-Control，默认拒绝同名覆盖，并在上传后同时校验 R2 元数据与 CDN URL。