跳转到内容
搜索文档

快速入门

最后更新 查看 MarkdownAgent 设置

对于大多数前端应用,建议使用框架。Workers 支持多种热门框架,它们提供开箱即用的组件、预定义且结构化的架构以及社区支持。查看框架专用指南以开始使用框架。

或者,若符合以下情况,你可能更愿意从零构建网站:

  • 希望通过自行实现核心功能来学习。
  • 正在做简单项目,可能不需要框架。
  • 希望减少外部依赖以优化性能。
  • 需要对应用的每个方面拥有完全控制。
  • 希望构建自己的框架。

本指南将引导你在 Workers 上设置并部署静态站点或全栈应用(无需框架)。

部署静态站点

本指南将引导你在 Workers 上设置并部署静态站点。

1. 使用 CLI 创建新的 Worker 项目

C3 (create-cloudflare-cli) 是一款命令行工具,用于帮助你在 Cloudflare 上设置并部署新应用。打开终端并运行 C3 创建 Worker 项目:

npm create cloudflare@latest -- my-static-site

进行设置时,请选择以下选项:

  • 对于 What would you like to start with?,选择 Hello World example
  • 对于 Which template would you like to use?,选择 Static site
  • 对于 Which language do you want to use?,选择 TypeScript
  • 对于 Do you want to use git for version control?,选择 Yes
  • 对于 Do you want to deploy your application?,选择 No(部署前我们还会做一些修改)。

项目设置完成后,运行以下命令切换目录:

cd my-static-site

2. 本地开发

创建 Worker 后,在项目目录中运行 wrangler dev 启动本地服务器,以便在开发期间本地预览项目。

npx wrangler dev

3. 部署项目

可将项目部署到 *.workers.dev 子域或自定义域,可从本机或任意 CI/CD 系统(包括 Cloudflare 自有系统)部署。

wrangler deploy 会构建并部署项目。若使用 CI,请相应更新「部署命令」配置。

npx wrangler deploy

部署全栈应用

本指南将引导你在 Cloudflare Workers 上设置并部署动态、交互式服务端渲染(SSR)应用。

构建全栈应用时,可使用任意 Workers 绑定(binding)包括静态资产自身的绑定)与 Cloudflare Developer Platform 上的资源交互。

1. 创建新的 Worker 项目

C3 (create-cloudflare-cli) 是一款命令行工具,用于帮助你在 Cloudflare 上设置并部署新应用。

打开终端并运行 C3 创建 Worker 项目:

npm create cloudflare@latest -- my-dynamic-site

进行设置时,请选择以下选项:

  • 对于 What would you like to start with?,选择 Hello World example
  • 对于 Which template would you like to use?,选择 SSR / full-stack app
  • 对于 Which language do you want to use?,选择 TypeScript
  • 对于 Do you want to use git for version control?,选择 Yes
  • 对于 Do you want to deploy your application?,选择 No(部署前我们还会做一些修改)。

项目设置完成后,运行以下命令切换目录:

cd my-dynamic-site

2. 本地开发

创建 Worker 后,在项目目录中运行 wrangler dev 启动本地服务器,以便在开发期间本地预览项目。

npx wrangler dev

3. 修改项目

新项目已生成并运行后,可以开始编写和编辑项目:

  • src/index.ts 文件包含示例代码。修改其内容以更改 Worker 的服务端行为。
  • public/index.html 文件包含示例代码。修改其内容或 public/ 中的其他文件以更改 Worker 的静态资产。

然后保存文件并刷新页面。项目输出将根据你的修改而变化。

4. 部署项目

可将项目部署到 *.workers.dev 子域或自定义域,可从本机或任意 CI/CD 系统(包括 Cloudflare 自有系统)部署。

wrangler deploy 会构建并部署项目。若使用 CI,请相应更新「部署命令」配置。

npx wrangler deploy

这篇文档对您有帮助吗?