Cloudflare Workers 入门与实践:基础介绍与上手指南

全面探索 Cloudflare Workers 无服务器计算能力。本详细指南将带您从零起步,深入剖析 Workers 特有的边缘运行时机制、Wrangler CLI 环境基础配置方案和各开发项目结构,并最终完全掌握从本地端调试直到迈入全球化生产部署的最新 Serverless 工作流程实操技巧。

Alex Chen
Alex Chen
June 1, 202610 min read
其他语言:Deutsch · English

概览: Cloudflare Workers 是一个无服务器执行环境,能够在全球 330 多个城市的边缘节点上运行 JavaScript 代码。本指南涵盖了 Workers 运行时、Wrangler CLI 配置、项目结构、本地开发和部署相关流程。完整教程请访问 tanstackship.com。


介绍

Cloudflare Workers 可在 Cloudflare 的全球网络上运行您的代码,自动实现从零到数百万次请求的弹性缩放。有别于传统的无服务器架构(例如 AWS Lambda),Workers 能同时在每一个数据中心内运行,让所有的计算都发生在距离任何层级用户仅数毫秒之微的地方。如需详细了解各个边缘计算平台之间的差异,请查阅我们的 Edge Computing: Workers vs Lambda@Edge 指南。


Wrangler CLI 配置

bash
# 全局安装 Wrangler
npm install -g wrangler

# 登录 Cloudflare 账户
wrangler login

# 创建一个全新的 Workers 项目
npx create-cloudflare my-worker

# 启动本地开发环境
wrangler dev

# 部署至生产环境
wrangler deploy

基础 Worker

ts
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<5ms330+ 个节点128MB$0.30/百万请求
AWS Lambda200ms-1s特定区域 (Regions)10GB$0.20/百万请求
Vercel Edge<50ms100+ 个节点128MB免费额度内包含
Deno Deploy<10ms35+ 个节点256MB$0.10/百万请求

总结

Cloudflare Workers 提供了极速高效的无服务器运行时环境。凭借近乎零的冷启动时间和极其广泛的全球分布网络,它非常适合用于构建 API、中间件极其服务器端渲染(SSR)应用。将其与 TanStack Start 强强结合,您将获得一个运行在完全 Workers 之上的极其强大的全栈框架体系。如需进行生产环境部署,请参阅我们的 TanStack Start Deployment Guide。为了正确配置您的 TypeScript 开发环境,也可同时查看 Cloudflare Workers TypeScript Setup 核心指南。