配置

将 Git 仓库连接到 Worker 时，可以自定义构建和部署 Worker 所需的配置。

当提交推送到已连接的仓库时，Workers Builds 运行两步流程：

1. Build command（构建命令） (optional) - 编译项目（例如 Next.js 或 Astro 等框架的 npm run build）
2. Deploy command（部署命令） - 将 Worker 部署到 Cloudflare（默认为 npx wrangler deploy）

对于预览构建（推送到非生产分支的提交），部署命令会被预览部署命令（默认为 npx wrangler versions upload）替换，该命令创建预览版本而不将其提升为生产版本。

构建设置可在 Worker 内的 Settings（设置） > Build（构建） 中找到。

请注意，更新并保存构建设置后，更新的设置将应用于_下一次_构建。当你_重试_构建时，将应用重试构建时存在的构建配置。

你可以使用选择的包管理器运行部署命令。

如果你在 package.json 中将 Wrangler 部署命令添加为脚本，可以通过将其设置为部署命令来运行它。例如 npm run deploy。

你可以设置的其他部署命令示例包括：

非生产分支部署命令仅在你启用了非生产分支构建时适用。

它默认为 npx wrangler versions upload，生成预览 URL。与构建和部署命令一样，可以自定义为运行任何命令。

你可以设置的其他非生产分支部署命令示例包括：

如果你的仓库没有 Wrangler 配置文件，部署命令（wrangler deploy）将触发自动项目配置。这会检测你的框架，创建必要的配置，并打开拉取请求供你审查。合并 PR 后，项目即已配置，后续构建将正常部署。

Workers Builds 中的 API 令牌定义授予 Workers Builds 与账户资源交互的访问权限。目前仅支持用户令牌，账户拥有的令牌支持即将推出。

选择 Create new token（创建新令牌） 时，将自动创建具有以下权限的新 API 令牌：

• Account: Account Settings (read), Workers Scripts (edit), Workers KV Storage (edit), Workers R2 Storage (edit)
• Zone: Workers Routes (edit) for all zones on the account
• User: User Details (read), Memberships (read)

你可以通过导航到 My Profile（我的个人资料） > API Tokens（API 令牌） 来配置此 API 令牌的权限。

建议在所有 Worker 的上传和部署中始终使用相同的 API 令牌，以保持一致访问权限。

静态资源和框架现已在 Cloudflare Worker 中受支持。在框架指南中学习设置 Worker 项目和每个框架的命令：

• Web 应用
  • React + Vite
  • Astro
  • React Router（原 Remix）
  • Next.js
  • Vue
  • RedwoodSDK
  • TanStack Start
  • SvelteKit
  • 微前端
  • Vike
  • 更多指南...
    • Analog
    • Angular
    • Docusaurus
    • Gatsby
    • Hono
    • Nuxt
    • Qwik
    • Solid
    • Waku
• 部署现有项目
• 移动应用
  • Expo
• API
  • FastAPI
  • Hono
• AI 与智能体
  • Agents SDK
  • LangChain

你可以为构建提供自定义环境变量。

{
	"$schema": "./node_modules/wrangler/config-schema.json",
	"name": "my-worker-dev",
	"vars": {
		"API_HOST": "example.com",
		"API_ACCOUNT_ID": "example_user",
		"SERVICE_X_DATA": {
			"URL": "service-x-api.dev.example",
			"MY_ID": 123
		}
	}
}

"$schema" = "./node_modules/wrangler/config-schema.json"
name = "my-worker-dev"

[vars]
API_HOST = "example.com"
API_ACCOUNT_ID = "example_user"

  [vars.SERVICE_X_DATA]
  URL = "service-x-api.dev.example"
  MY_ID = 123

以下系统环境变量默认注入（但可以覆盖）：