大网数据广告活动
Web 标准与前端开发

Content-Security-Policy:upgrade-insecure-requests 指令

· 52CE 我爱测

HTTP Content-Security-Policy(CSP)的 **`upgrade-insecure-requests`** 指令指示user agent将站点的所有不安全 URL(通过 HTTP 提供的 URL)视为已被替换为安全 URL(通过 HTTPS 提供的 URL)。该指令适用于需要重写大量不安全旧版 URL 的网站。

HTTP Content-Security-Policy(CSP)的 upgrade-insecure-requests 指令指示user agent将站点的所有不安全 URL(通过 HTTP 提供的 URL)视为已被替换为安全 URL(通过 HTTPS 提供的 URL)。该指令适用于需要重写大量不安全旧版 URL 的网站。

upgrade-insecure-requests 指令无法确保通过第三方站点上的链接访问你站点的用户会在顶级导航中被升级到 HTTPS,因此它不能替代 Strict-Transport-Security(HSTS)标头。后者仍应设置适当的 max-age,以确保用户不会遭受 SSL 剥离攻击。

语法

Content-Security-Policy: upgrade-insecure-requests;

示例

使用 HTTP 标头

Content-Security-Policy: upgrade-insecure-requests;

使用 HTML meta 元素

<meta
  http-equiv="Content-Security-Policy"
  content="upgrade-insecure-requests" />

在希望从 HTTP 迁移到 HTTPS 的域名 example.com 上设置上述标头后,非导航性的不安全资源请求会自动升级(包括第一方和第三方请求)。

<img src="http://example.com/image.png" />
<img src="http://not-example.com/image.png" />

这些 URL 会在发起请求之前被重写,这意味着不会有不安全请求进入网络。请注意,如果所请求的资源实际上无法通过 HTTPS 获得,请求将会失败,且不会回退到 HTTP。

<img src="https://example.com/image.png" />
<img src="https://not-example.com/image.png" />

对第三方资源的导航升级带来破坏的可能性显著更高,因此它们不会被升级:

<a href="https://example.com/">首页</a>
<a href="http://not-example.com/">首页</a>

查找不安全请求

借助 Content-Security-Policy-Report-Only 标头和 report-uri 指令,你可以像这样同时设置强制策略和仅报告策略:

Content-Security-Policy: upgrade-insecure-requests; default-src https:
Content-Security-Policy-Report-Only: default-src https:; report-uri /endpoint

这样,你仍会在安全站点上升级不安全请求,但只有监控策略会被违反,并向你的端点报告不安全资源。

规范

浏览器兼容性

参见

  • Content-Security-Policy
  • Upgrade-Insecure-Requests 标头
  • Strict-Transport-Security(HSTS)标头
  • 混合内容

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。