Cloudflare Workers 入门与实践

这篇笔记记录一下 Cloudflare Workers 的基本概念、开发流程、本地测试以及部署方法。

一、什么是 Cloudflare Workers？

Cloudflare Workers 允许你在 Cloudflare 的全球网络边缘运行 JavaScript、Rust、C 和 C++ 代码。这意味着你的代码可以非常靠近你的用户，从而减少延迟。

二、准备工作

1. Cloudflare 账户：你需要一个 Cloudflare 账户。
2. Node.js 和 npm：确保你安装了 Node.js (通常会附带 npm)。
3. Wrangler CLI：Cloudflare Workers 的官方命令行工具。
   

   npm install -g wrangler
   # 或者使用 yarn
   # yarn global add wrangler

   
   登录 Wrangler:
   

   wrangler login

三、创建和开发 Worker

1. 创建项目:
   使用 Wrangler CLI 创建一个新的 Worker 项目：
   

   wrangler init my-worker
   cd my-worker

   
   这将生成一个包含基本结构的项目。

2. 编写代码 (src/index.js 或 src/index.ts):
   一个简单的 “Hello World” Worker 可能如下所示：
   

   // src/index.js
   export default {
     async fetch(request, env, ctx) {
       return new Response('Hello World!');
     },
   };

3. 本地测试:
   使用 Wrangler CLI 在本地运行和测试你的 Worker：
   

   wrangler dev

   
   这通常会在 http://localhost:8787 启动一个本地服务器。
   • 对于更复杂的调试，可以在浏览器中访问本地 Worker 时使用浏览器的开发者工具 (Network, Console)。

四、部署 Worker

1. 部署到 .workers.dev 子域名:
   

   wrangler deploy

   
   首次部署时，Wrangler 可能会提示你一些信息。成功后，你的 Worker 会部署到一个 your-worker-name.your-subdomain.workers.dev 的 URL。

2. 部署到自定义域名:
   如果你想将 Worker 部署到你自己的域名 (例如 api.example.com)，你需要在 Cloudflare Dashboard 中配置相应的 DNS 记录和路由。

   然后再次运行 wrangler deploy。请查阅最新的 Cloudflare Workers 文档以获取准确的配置方法。

五、总结

Cloudflare Workers 提供了一种强大且高效的方式来构建和部署无服务器应用程序。通过 Wrangler CLI，开发、测试和部署流程都变得相对简单。