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 onlyAPI starter

  • 如果你想学习 Worker 原理和保持控制 → Worker only
  • 如果你想快速有一个“API 骨架” → API starter

Logo

火山引擎开发者社区是火山引擎打造的AI技术生态平台,聚焦Agent与大模型开发,提供豆包系列模型(图像/视频/视觉)、智能分析与会话工具,并配套评测集、动手实验室及行业案例库。社区通过技术沙龙、挑战赛等活动促进开发者成长,新用户可领50万Tokens权益,助力构建智能应用。

更多推荐