跳转到内容
搜索文档

workers.dev

最后更新 查看 MarkdownAgent 设置

Cloudflare Workers 账户附带可在 Cloudflare 仪表板中配置的 workers.dev 子域名。workers.dev 子域名让您无需先将自定义域名接入 Cloudflare 即可快速部署 Workers。

建议在生产环境中使用 Workers 路由或自定义域名 运行 Worker,而不是 workers.dev 子域名。workers.dev 子域名被视为免费网站,适用于非业务关键的个人或爱好项目。

配置 workers.dev

workers.dev 子域名格式为:<YOUR_ACCOUNT_SUBDOMAIN>.workers.dev。要更改 workers.dev 子域名:

  1. 在 Cloudflare 仪表板中,前往 Workers & Pages 页面。

    Go to Workers & Pages ↗
  2. 选择 Your subdomain(你的子域名) 旁的 Change(更改)

所有 Worker 在创建或重命名时都会按照 <YOUR_WORKER_NAME>.<YOUR_SUBDOMAIN>.workers.dev 语法分配 workers.dev 路由。Worker 配置中的 name 字段用作已部署 Worker 的子域名。

管理对 workers.dev 的访问

启用后,workers.dev URL 可公开访问。您可以使用 Cloudflare Access 要求访问者在访问 workers.dev URL 之前进行身份验证。您可以将访问限制为自己、团队成员、组织或访问策略 中指定的任何其他人。

要将 workers.dev URL 限制为仅授权邮箱:

  1. 在 Cloudflare 仪表板中,前往 Workers & Pages 页面。

    Go to Workers & Pages ↗
  2. Overview(概览) 中,选择您的 Worker。

  3. 前往 Settings(设置) > Domains & Routes(域和路由)

  4. 对于 workers.dev,点击 Enable Cloudflare Access(启用 Cloudflare Access)

  5. (可选)要配置 Access 应用程序,点击 Manage Cloudflare Access(管理 Cloudflare Access)。在那里,您可以更改要授权的邮箱地址。查看 Access policies 了解如何配置替代规则。

  6. 使用提供的受众(aud)标签和 JWKs URL 在 Worker 脚本中验证 Access JWT

禁用 workers.dev

在仪表板中禁用 workers.dev

要禁用 Worker 的 workers.dev 路由:

  1. 在 Cloudflare 仪表板中,前往 Workers & Pages 页面。

    Go to Workers & Pages ↗
  2. Overview(概览) 中,选择您的 Worker。

  3. 前往 Settings(设置) > Domains & Routes(域和路由)

  4. workers.dev 上点击 "Disable"。

  5. 确认要禁用。

在 Wrangler 配置文件中禁用 workers.dev

要禁用 Worker 的 workers.dev 路由,请在 Worker 的 Wrangler 配置文件 中包含以下内容:

{
	"workers_dev": false
}
workers_dev = false

使用此更改重新部署 Worker 后,workers.dev 路由将被禁用。Preview URL 默认与 workers_dev 设置匹配,除非显式配置。如果您显式启用了 Preview URL,请单独禁用它们

如果您未指定 workers_dev = false 但在 Wrangler 配置文件 中添加了 routes 组件,则下次部署时 workers_dev 的值将推断为 false

限制

部署启用了 workers.dev 子域名的 Worker 时,Worker 名称必须满足以下要求:

  • 必须为 63 个字符或更少
  • 只能包含字母数字字符(a-zA-Z0-9)和短划线(-
  • 不能以短划线(-)开头或结尾

这些限制适用是因为 Worker 名称在 workers.dev URL 中用作 DNS 标签。DNS 标签最大长度为 63 个字符,且不能以短划线开头或结尾。

相关资源

这篇文档对您有帮助吗?