概览: Cloudflare Workers 是一个无服务器执行环境,能够在全球 330 多个城市的边缘节点上运行 JavaScript 代码。本指南涵盖了 Workers 运行时、Wrangler CLI 配置、项目结构、本地开发和部署相关流程。完整教程请访问 tanstackship.com。
介绍
Cloudflare Workers 可在 Cloudflare 的全球网络上运行您的代码,自动实现从零到数百万次请求的弹性缩放。有别于传统的无服务器架构(例如 AWS Lambda),Workers 能同时在每一个数据中心内运行,让所有的计算都发生在距离任何层级用户仅数毫秒之微的地方。如需详细了解各个边缘计算平台之间的差异,请查阅我们的 Edge Computing: Workers vs Lambda@Edge 指南。
Wrangler CLI 配置
# 全局安装 Wrangler
npm install -g wrangler
# 登录 Cloudflare 账户
wrangler login
# 创建一个全新的 Workers 项目
npx create-cloudflare my-worker
# 启动本地开发环境
wrangler dev
# 部署至生产环境
wrangler deploy
基础 Worker
export default {
async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {
const url = new URL(request.url)
if (url.pathname === '/api/hello') {
return new Response(JSON.stringify({ message: 'Hello from the edge!' }), {
headers: { 'Content-Type': 'application/json' },
})
}
return new Response('Not Found', { status: 404 })
},
}
Workers 与其他计算平台对比
| 平台 | 冷启动 | 节点位置 | 内存 | 价格 |
|---|---|---|---|---|
| Cloudflare Workers | <5ms | 330+ 个节点 | 128MB | $0.30/百万请求 |
| AWS Lambda | 200ms-1s | 特定区域 (Regions) | 10GB | $0.20/百万请求 |
| Vercel Edge | <50ms | 100+ 个节点 | 128MB | 免费额度内包含 |
| Deno Deploy | <10ms | 35+ 个节点 | 256MB | $0.10/百万请求 |
总结
Cloudflare Workers 提供了极速高效的无服务器运行时环境。凭借近乎零的冷启动时间和极其广泛的全球分布网络,它非常适合用于构建 API、中间件极其服务器端渲染(SSR)应用。将其与 TanStack Start 强强结合,您将获得一个运行在完全 Workers 之上的极其强大的全栈框架体系。如需进行生产环境部署,请参阅我们的 TanStack Start Deployment Guide。为了正确配置您的 TypeScript 开发环境,也可同时查看 Cloudflare Workers TypeScript Setup 核心指南。