跳转到内容
搜索文档

你的第一个 Worker

最后更新 查看 MarkdownAgent 设置

构建并部署你的第一个 Worker

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

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

通过 Cloudflare 仪表板

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

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

    Go to Workers & Pages ↗
  2. 选择 Create application(创建应用程序)

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

通过 C3 和 Wrangler

先决条件

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

Node.js 版本管理器

使用 Voltanvm 等 Node 版本管理器,以避免权限问题并切换 Node.js 版本。本指南后续将介绍的 Wrangler 需要 Node 版本 16.17.0 或更高。

创建并部署你的第一个 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?,选择 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.jsonnpm 文档
  5. node_modules:请参阅 node_modulesnpm 文档

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

总结

你已了解到如何:

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

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

相关资源

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

这篇文档对您有帮助吗?