跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

你的第一个 Worker

最后更新 查看 MarkdownAgent 设置

构建并部署你的第一个 Worker

你可以通过 Cloudflare 仪表板或在终端中使用编程方式部署你的第一个 Worker。

你必须拥有 Cloudflare 账户才能创建 Worker。要开始使用 Cloudflare,请参阅创建账户。

通过 Cloudflare 仪表板

使用 Cloudflare 仪表板创建你的第一个 Worker:

  1. 在 Cloudflare 仪表板中,转到 Workers & Pages 页面。

    前往 Workers & Pages ↗
  2. 选择 Create application(创建应用程序)。

  3. 选择 Create Worker(创建 Worker) > Deploy(部署)。

通过 C3 和 Wrangler

先决条件

  1. 注册 Cloudflare 账户 ↗。
  2. 安装 Node.js ↗。

Node.js 版本管理器

使用 Vite+ (vp env) ↗ 安装和管理 Node.js 版本。

有关支持的 Node.js 版本,请参阅 Wrangler 系统要求。

创建并部署你的第一个 Worker

C3 (create-cloudflare-cli) ↗ 是一个命令行工具,旨在帮助你在 Cloudflare 上设置和部署新应用程序。除了速度之外,它还利用官方开发的 Workers 模板和特定于框架的设置指南,确保你设置的每个新应用程序都遵循 Cloudflare 以及任何第三方在 Cloudflare 网络上部署的最佳实践。

要创建你的 Worker 项目,请运行:

npm create cloudflare@latest -- first-worker

这将提示你安装 create-cloudflare ↗ 包,并引导你完成设置。

设置时,选择以下选项:

  • 对于 What would you like to start with?(希望从什么开始?),选择 Hello World example。
  • 对于 Which template would you like to use?(希望使用哪个模板?),选择 Worker only。
  • 对于 Which language do you want to use?(希望使用哪种语言?),选择 JavaScript。
  • 对于 Do you want to use git for version control?(是否使用 Git 进行版本控制?),选择 Yes。
  • 对于 Do you want to add an AGENTS.md file to help AI coding tools understand Cloudflare APIs?(是否添加 AGENTS.md 文件以帮助 AI 编程工具理解 Cloudflare API?),选择 Yes。
  • 对于 Do you want to deploy your application?(是否部署应用?),选择 No(部署前还需要进行一些修改)。

系统会询问你是否要将项目部署到 Cloudflare。

  • 如果选择部署,系统将要求你进行身份验证(如果尚未登录),你的项目将被部署到 Cloudflare 全球网络,并在你的自定义 workers.dev 子域名 上可用。

  • 如果选择不部署,请转到新创建的项目目录开始编写代码。通过运行 wrangler deploy 命令部署你的项目。

请参阅如何运行 Wrangler 命令了解如何根据你的包管理器运行 Wrangler 命令。

在你的 Worker 项目目录中,C3 已生成了以下文件:

  1. wrangler.jsonc:你的 Wrangler 配置文件。
  2. index.js(位于 /src 中):以 ES module 语法编写的最小化 'Hello World!' Worker。
  3. package.json:最小化的 Node 依赖项配置文件。
  4. package-lock.json:请参阅 package-lock.json 的 npm 文档 ↗。
  5. node_modules:请参阅 node_modules 的 npm 文档 ↗。

要继续构建你的 Worker,请打开 index.js 文件来编写你的代码。请参阅示例使用你可以试验的开箱即用代码。

总结

你已了解到如何:

  • 通过 Cloudflare 仪表板以及在终端中使用编程方式创建并部署 Worker 项目。

在下一节中,你可以观看视频教程,创建你的第一个 Cloudflare Workers 应用程序。

相关资源

  • 入门指南 - 通过 Cloudflare Workers 入门指南创建新的 Worker。

这篇文档对您有帮助吗?