Cloudflare应用如何选择你的Worker 项目骨架
Cloudflare Worker模板主要针对不同应用场景提供预置项目结构。核心模板包括:1)Worker only(纯净版,适合学习或简单API);2)Static site(静态网站托管);3)SSR/full-stack(前后端一体化应用);4)Durable Objects系列(实时状态管理);5)Workflow/Queue(异步任务处理);6)API starter(标准REST AP
·
Cloudflare work这几种模板又都代表什么类型?该如何选择?
Which template would you like to use?
○ Worker only
○ Static site
● SSR / full-stack app
○ Worker + Durable Objects
○ Worker + Durable Objects + Assets
○ Workflow
○ Scheduled Worker (Cron Trigger)
○ Queue consumer & producer Worker
○ API starter (OpenAPI compliant)
这几类模板,其实是 Cloudflare 官方帮你预装不同场景的 Worker 项目骨架。我帮你把它们拆解成 场景 → 代码结构 → 适用人群 三个角度来讲:
1. Worker only
- 场景:最纯粹的 Cloudflare Worker,没有额外功能。
- 代码结构:只有
src/index.ts+wrangler.toml。你要自己写路由、逻辑。 - 适合人群:想完全掌握 Worker 原理、逐步接入 KV/D1/R2 的人(对你这种要写后台 API,很合适,干净无负担)。
2. Static site
- 场景:托管静态网站(HTML/CSS/JS),类似 GitHub Pages。
- 代码结构:生成一个
public/文件夹,自动配置好部署到 Cloudflare Pages/Workers。 - 适合人群:要快速发布纯前端网页的人。但你想写后台 API → 不推荐。
3. SSR / full-stack app ✅(最重)
- 场景:完整的前后端一体化应用(SSR 渲染、API、路由都有)。
- 代码结构:通常集成 React/Remix/SvelteKit 之类的框架,Worker 只是运行时。
- 适合人群:要写“前端 + 后端一起跑”的大应用。
- 缺点:太重,你只是要一个管理后台 API → 没必要。
4. Worker + Durable Objects
- 场景:需要 强一致存储 / 状态管理,比如聊天室、多人协作、游戏房间。
- 代码结构:除了普通 Worker,还会生成一个
DurableObject类(每个实例维护一个独立状态)。 - 适合人群:需要“实时房间状态”的应用。音乐后台用不上,完全不必选。
5. Worker + Durable Objects + Assets
- 场景:上一个的扩展版,还带静态资源托管(如前端代码)。
- 适合人群:要做“带前端+状态的实时应用”。
- 对你:过重,不需要。
6. Workflow
- 场景:专门跑异步工作流(任务编排),Cloudflare 推的新功能。
- 适合人群:数据处理、队列执行、复杂后台任务。
- 对你:未来大规模音乐处理可以考虑,但现在不必。
7. Scheduled Worker (Cron Trigger)
- 场景:定时任务(每天凌晨3点更新缓存、每小时清理数据库)。
- 适合人群:需要周期性后台任务。
- 对你:未来想定时更新
songs.json,可能会用到;现在不急。
8. Queue consumer & producer Worker
- 场景:消息队列场景(类似 Kafka),处理大规模异步任务。
- 适合人群:海量事件处理、日志管道。
- 对你:目前没必要。
9. API starter (OpenAPI compliant)
- 场景:Cloudflare 官方给的“API 模板”,符合 OpenAPI 规范,带文档/路由。
- 适合人群:想写“标准 API 服务”,并且希望以后直接生成 Swagger 文档。
- 对你:如果后台管理系统就是一堆 REST API,这个其实很合适!
🥁 结论:你该怎么选?
- 想最简洁、从 0 搭后台 API → 选 Worker only,逐步接入 D1/R2。
- 想马上写 REST API,并带 OpenAPI 文档 → 选 API starter。
- 想以后扩展成 SSR 前后端一体应用 → 选 SSR/full-stack。
👉 建议你当前阶段(管理后台 API + Cloudflare 免费额度):
选 Worker only 或 API starter。
- 如果你想学习 Worker 原理和保持控制 → Worker only。
- 如果你想快速有一个“API 骨架” → API starter。
更多推荐

所有评论(0)