跳转到内容
搜索文档

从零开始

最后更新 查看 MarkdownAgent 设置

本指南展示如何快速从零开始新的 Workers Sites 项目。

快速入门

  1. 确保已安装最新版本的 gitNode.js

  2. 在终端中,克隆 worker-sites-template 入门仓库。 以下示例创建一个名为 my-site 的项目:

    git clone --depth=1 --branch=wrangler2 https://github.com/cloudflare/worker-sites-template my-site
  3. 运行 npm install 安装所有依赖。

  4. 您可以通过运行 wrangler dev 命令预览站点:

    wrangler dev
  5. 将站点部署到 Cloudflare:

    npx wrangler deploy

项目布局

模板项目包含以下文件和目录:

  • public:项目的静态资源。默认包含 index.htmlfavicon.ico
  • src:配置用于提供资源的 Worker。您无需编辑此文件,但如果您想了解其工作原理或为 Worker 添加更多功能,可以编辑 src/index.ts
  • wrangler.jsonc:包含项目配置的文件。 bucket 属性告诉 Wrangler 在哪里找到静态资源(例如 site = { bucket = "./public" })。
  • package.json/package-lock.json:定义所需的 Node.js 依赖。

自定义 wrangler.jsonc 文件:

  • name 属性更改为项目名称:

    {
      "$schema": "./node_modules/wrangler/config-schema.json",
      "name": "my-site"
    }
    "$schema" = "./node_modules/wrangler/config-schema.json"
    name = "my-site"
  • 考虑将 compatibility_date 更新为今天的日期,以访问最新的 Workers 功能:

    {
      "compatibility_date": "yyyy-mm-dd"
    }
    compatibility_date = "yyyy-mm-dd"
  • 将站点部署到您拥有且已作为 Cloudflare zone 附加的自定义域名

    {
      "route": "https://example.com/*"
    }
    route = "https://example.com/*"

了解配置项目的更多信息。

这篇文档对您有帮助吗?