青蛙小白
博客 / 2025/05

Cloudflare Wrangler 快速入门指南

2025/05/03 · — 字 · 阅读约 — 分钟 ·
目录

wrangler 是 Cloudflare 提供的官方命令行工具，用于构建、开发和部署 Cloudflare Workers 应用。

wrangler 就像是 Cloudflare Workers 的 “npm + dev server + deploy” 工具集合：

  • 初始化项目 - 快速生成 Cloudflare Workers 项目模板
  • 本地开发 - 提供 wrangler dev 本地调试环境（自动代理 Cloudflare 环境）
  • 构建打包 - 使用 Webpack/Vite 等打包 Worker 代码
  • 部署上线 - 一条命令将代码部署到 Cloudflare Workers
  • KV/存储/路由配置 - 配置绑定的 KV、R2、Durable Objects、环境变量等
  • 生产预览环境 - 支持 preview 预览 URL，方便测试

安装Cloudflare Wrangler

npm install -g wrangler

安装完后，查看版本：

wrangler --version

登录到Cloudflare

wrangler login

创建项目

# 初始化一个新项目
wrangler init my-worker

wrangler init初始化项目时的交互界面会首先引导我们选择项目类型：

 What would you like to start with?
  ○ Hello World example
  ● Framework Starter
  ○ Application Starter
  ○ Template from a GitHub repo
  ◁ Go back
选项说明适用场景
Hello World example生成最基本的 Cloudflare Worker 示例，仅返回 “Hello World”。快速测试 Workers 如何运行
Framework Starter提供对主流 Web 框架（如 Hono、Qwik、SolidStart、Remix 等）的支持和集成。现代框架开发 Edge App
Application Starter提供一整套包含 KV、R2、环境变量等功能的 Worker 应用骨架。构建功能完整的应用（类似模板工程）
Template from a GitHub repo你可以输入一个 GitHub 仓库 URL，它会从中克隆模板项目。已找到想用的 Worker 项目模板

对于Framework Starter

Hono 是面向边缘和 Serverless 的后端 Web 框架，轻量且快。如果想做纯后端 API，Hono 是非常合适且轻量的选择.

开发和部署

开发

启动本地的开发服务器:

wrangler dev --ip 0.0.0.0

默认情况下，wrangler dev 会：

  • 在本地开发环境（本地 Node.js 模拟器）运行的 Worker；
  • 更快、响应更快；
  • 但有些行为和线上不完全一致（比如 KV、R2、D1、环境变量等可能是模拟的或不可用）。

wrangler dev --remote会让 Worker 直接运行在Cloudflare 的真实全球边缘网络。使用真实绑定资源（如 KV、R2、D1、Durable Objects 等），环境更接近生产部署效果。

环境更接近生产部署效果。

部署

部署到cloudflare：

wrangler deploy --minify
评论