Preview URLs 可以使用自定义域名、workers.dev，或两者。至少启用一个主机才能获得 Preview URL。
| 主机 | Preview URL | 唯一部署 URL |
|---|---|---|
| 自定义域名 | <preview-name>.app.example.com |
<deployment-id>-<preview-name>.app.example.com |
workers.dev |
<preview-name>-<worker-name>.<subdomain>.workers.dev |
<deployment-id>-<worker-name>.<subdomain>.workers.dev |
在管理自定义域名的同一系统中配置 Previews：
| 管理方式 | 配置 |
|---|---|
| Wrangler | 使用 Wrangler 选项卡，然后运行 npx wrangler deploy。 |
| 仪表板 | 使用 Dashboard（仪表板） 选项卡。 |
| Terraform | 更新并应用你的 Terraform 配置。 |
以下示例仅为 Preview 流量配置 app.example.com。添加 previews_enabled 并将 enabled 设为 false，然后运行 npx wrangler deploy 以应用配置。
{
"routes": [
{
"pattern": "app.example.com",
"custom_domain": true,
"previews_enabled": true,
"enabled": false
}
]
}[[routes]]
pattern = "app.example.com"
custom_domain = true
previews_enabled = true
enabled = false选择自定义域名提供的流量：
| 流量 | previews_enabled |
enabled |
|---|---|---|
| 仅 Preview | true |
false |
| 生产和 Preview | true |
省略或设为 true |
-
在 Cloudflare 仪表板中，前往 Workers & Pages 并选择你的 Worker。
前往 Workers & Pages ↗ -
在 Domains（域名） 选项卡的 Custom Domains and Routes（自定义域名和路由） 下，选择 + Add Domain（添加域名）。
-
输入你的域名。对于 Enable for（启用于），选择 Preview 或 Production and Preview（生产和 Preview）。然后选择 Add domain（添加域名）。
-
确认该域名出现在 Custom Domains and Routes（自定义域名和路由） 下。
DNS 和证书行为
Cloudflare 会为自定义域名创建通配符 DNS 记录和 SSL 证书，例如 *.app.example.com。创建第一个 Preview 后，证书签发可能需要一些时间。
如果生产域名已有子域名，请使用专用主机名，例如 previews.example.com。这样可以避免通配符冲突。
Preview URLs 会在主机名上再添加一个子域名。例如，app.preview.example.com 会创建 <preview-name>.app.preview.example.com。对于更深的主机名，你可能需要 Advanced Certificate Manager 配合 Total TLS，或其他覆盖 Preview 主机名的证书。
生产和 Preview 的 workers.dev URL 分开配置。
在 Wrangler 配置文件中设置 preview_urls，然后运行 npx wrangler deploy。
{
"preview_urls": true
}preview_urls = true如果省略 preview_urls，Wrangler 不会更改现有的 Preview URL 设置。如果不存在设置，其初始值取决于 workers_dev。显式设置 preview_urls 以更改 Preview URL 设置。
-
在 Cloudflare 仪表板中，前往 Workers & Pages 并选择你的 Worker。
前往 Workers & Pages ↗ -
在 Domains（域名） 选项卡的 Worker URL 下，打开 Preview。
要限制对自定义域名和 workers.dev Preview URLs 的访问，请使用 Cloudflare Access。这可以防止未经身份验证的用户和爬虫查看你的 Preview。
要保持 Preview 公开同时阻止搜索引擎索引，请添加 X-Robots-Tag: noindex 响应标头。Cloudflare 会自动将此标头添加到 workers.dev Preview URLs，但不会添加到自定义域名 Preview URLs。
对于静态资源，通过 _headers 文件 添加标头。对于 Worker 生成的响应，直接在 Worker 代码中添加。