Cloudflare Workers 账户附带可在 Cloudflare 仪表板中配置的 workers.dev 子域名。workers.dev 子域名让您无需先将自定义域名接入 Cloudflare 即可快速部署 Workers。
建议在生产环境中使用 Workers 路由或自定义域名 运行 Worker,而不是 workers.dev 子域名。workers.dev 子域名被视为免费网站 ↗,适用于非业务关键的个人或爱好项目。
workers.dev 子域名格式为:<YOUR_ACCOUNT_SUBDOMAIN>.workers.dev。要更改 workers.dev 子域名:
-
在 Cloudflare 仪表板中,前往 Workers & Pages 页面。
Go to Workers & Pages ↗ -
选择 Your subdomain(你的子域名) 旁的 Change(更改)。
所有 Worker 在创建或重命名时都会按照 <YOUR_WORKER_NAME>.<YOUR_SUBDOMAIN>.workers.dev 语法分配 workers.dev 路由。Worker 配置中的 name 字段用作已部署 Worker 的子域名。
启用后,workers.dev URL 可公开访问。您可以使用 Cloudflare Access 要求访问者在访问 workers.dev URL 之前进行身份验证。您可以将访问限制为自己、团队成员、组织或访问策略 中指定的任何其他人。
要将 workers.dev URL 限制为仅授权邮箱:
-
在 Cloudflare 仪表板中,前往 Workers & Pages 页面。
Go to Workers & Pages ↗ -
在 Overview(概览) 中,选择您的 Worker。
-
前往 Settings(设置) > Domains & Routes(域和路由)。
-
对于
workers.dev,点击 Enable Cloudflare Access(启用 Cloudflare Access)。 -
(可选)要配置 Access 应用程序,点击 Manage Cloudflare Access(管理 Cloudflare Access)。在那里,您可以更改要授权的邮箱地址。查看 Access policies 了解如何配置替代规则。
-
使用提供的受众(
aud)标签和 JWKs URL 在 Worker 脚本中验证 Access JWT。
要禁用 Worker 的 workers.dev 路由:
-
在 Cloudflare 仪表板中,前往 Workers & Pages 页面。
Go to Workers & Pages ↗ -
在 Overview(概览) 中,选择您的 Worker。
-
前往 Settings(设置) > Domains & Routes(域和路由)。
-
在
workers.dev上点击 "Disable"。 -
确认要禁用。
要禁用 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-z、A-Z、0-9)和短划线(-) - 不能以短划线(
-)开头或结尾
这些限制适用是因为 Worker 名称在 workers.dev URL 中用作 DNS 标签。DNS 标签最大长度为 63 个字符,且不能以短划线开头或结尾。