跳转到内容
搜索文档

预览部署

最后更新 查看 MarkdownAgent 设置

预览部署允许你在不部署到生产的情况下预览项目的新版本。要查看预览部署:

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

    Go to Workers & Pages ↗
  2. 选择你的项目,找到要查看的部署。

每次在 GitHub 仓库中打开新的 pull request 时,Cloudflare Pages 都会创建一个唯一的预览 URL,并随你继续向分支推送新提交而保持更新。这仅适用于从仓库本身发起的 pull request。

GitHub 预览 URL

例如,若有一个名为 user-example 的仓库连接到 Pages,你将获得 user-example.pages.dev 子域。若 main 是默认分支,则对 main 分支的任何提交都会更新 user-example.pages.dev 的内容,以及附加到项目的任何 自定义域

User-example 仓库的部署状态与预览

开发 user-example 时,你可能会向 development 分支推送新更改。

在此示例中,创建新的 development 分支后,Pages 会自动为这些更改生成预览部署,可通过 373f31e2.user-example.pages.dev 访问——其中 373f31e2 是随机生成的哈希值。

你创建的每个新分支都会在 pages.dev 子域前收到一个新的随机哈希。

User-example 仓库新生成的预览部署链接与状态

development 分支的任何后续更改都会继续更新此 373f31e2.user-example.pages.dev 预览地址,直到 development 分支与 main 生产分支合并。

任何自定义域以及 user-example.pages.dev 站点都不会受到预览部署的影响。

自定义预览部署访问权限

你可以使用 Cloudflare Access 管理部署预览的访问权限。默认情况下,这些部署 URL 是公开的。启用访问策略将限制仅 Cloudflare 账户可查看项目部署。

启用后,你可以 设置多用户账户,允许团队其他成员查看预览部署。

默认情况下,预览部署已启用且公开可用。在项目设置中,你可以要求访客进行身份验证才能查看预览部署。这样可以将这些预览部署的访问权限限制为队友、组织或你通过 Access 策略 指定的任何人。

要通过 Cloudflare Access 保护预览部署:

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

    Go to Workers & Pages ↗
  2. 选择你的 Pages 项目。

  3. 前往 Settings(设置) > General(常规),选择 Enable access policy(启用访问策略)

请注意,这仅保护预览部署(例如 373f31e2.user-example.pages.dev 及每个其他随机生成的预览链接),不包括 *.pages.dev 域或自定义域。

预览别名

发布预览部署时,会分配一个基于哈希的唯一地址——例如 <hash>.<project>.pages.dev。这些是原子地址,将来始终可访问。但 Pages 还会为 git 分支名称创建别名,并更新该别名以始终映射到该分支的最新提交。

例如,若向 development 分支(未关联生产环境)推送更改,Pages 将部署到 abc123.<project>.pages.dev,并将 development.<project>.pages.dev 别名指向它。之后,你可能向 development 分支推送新内容,创建 xyz456.<project>.pages.dev 部署。此时 development.<project>.pages.dev 别名指向 xyz456 部署,但 abc123.<project>.pages.dev 仍可直接访问。

分支名称别名会转为小写,非字母数字字符替换为连字符——例如 fix/api 分支创建 fix-api.<project>.pages.dev 别名。

要在 Pages 项目中查看分支别名,选择任意预览部署的 View buildDeployment details 将显示与该部署关联的所有别名。

你可以通过 为分支添加自定义域 将预览别名附加到自定义域。

删除预览部署

要清理旧的预览部署,可以使用 Wrangler 删除:

npx wrangler pages deployment delete <DEPLOYMENT_ID> --project-name <PROJECT_NAME>

使用 --force(或 -f)标志跳过确认提示,并强制删除带别名的部署。运行 wrangler pages deployment list 可查找部署 ID。

搜索引擎对预览的索引

为保持健康的 SEO 配置,防止搜索引擎在网络上发现重复内容至关重要。由于预览部署设计为生产环境的精确副本,它们天然会造成这种情况。Cloudflare Pages 默认确保你的搜索排名不会因这些临时预览而受损。

预览部署上的 X-Robots-Tag: noindex

默认情况下,Cloudflare Pages 生成的每个预览部署都包含 X-Robots-Tag: noindex HTTP 响应标头。该标头作为对搜索引擎爬虫的明确指令,告知其忽略该页面,不将其纳入搜索结果。

你可以轻松确认预览部署已正确配置为阻止索引。在终端运行以下 curl 命令,将占位符替换为你的唯一预览 URL:

curl -I https://<your-preview-url>.pages.dev

检查输出中的 x-robots-tag: noindex 行,以验证预览站点未被索引。

这篇文档对您有帮助吗?