# 内容安全策略（CSP）：如何限制您的网站可以加载的内容？

> 内容安全策略（CSP）用来告诉浏览器：您的网站有权加载哪些脚本、图片和框架。本文介绍各项指令、仅报告模式、配置示例以及常见错误，帮助您把这道防线配置好。

更新于 2026年10月15日 · https://app.pilotiko.com/zh/glossary/content-security-policy

内容安全策略（Content Security Policy，简称 CSP）是网站发送给浏览器的一组指令，最常见的方式是通过 Content-Security-Policy HTTP 标头，用来限制页面可以加载的资源以及页面可以执行的操作。它主要用于降低脚本注入（XSS）和点击劫持所造成的损害。

## 要点
- 策略是一系列以分号分隔的指令，例如 default-src 'self'。
- 它必须随所有响应一起发送，而不只是主页面。
- frame-ancestors 可以阻止其他网站在框架中显示您的页面。
- Content-Security-Policy-Report-Only 标头可以在不阻止任何内容的情况下进行测试。
- Google Analytics 要求在 script-src-elem、img-src 和 connect-src 中允许特定的域名。

## CSP 能防范哪些威胁？

根据 MDN，CSP 的主要用途是控制文档允许加载的资源，尤其是 JavaScript，以此防御跨站脚本注入（XSS）[1]。在 XSS 攻击中，攻击者设法让自己的代码在您的页面中执行，例如通过过滤不严的表单字段或网址参数。这些代码随后可以读取或修改内容，或者以访客的名义发送请求 [1]。

MDN 强调：首要的防御手段仍然是净化输入数据；CSP 是纵深防御，在净化失败时限制损害 [1]。它还可以防范点击劫持（恶意网站把您的网站放进不可见的框架中），并强制以 HTTPS 加载资源 [1]。

参考规范由 W3C 发布；Content Security Policy Level 3 版本目前处于工作草案（Working Draft）状态 [2]。

## CSP 中常见哪些指令？

策略通过 Content-Security-Policy 响应标头发送，并且必须随所有响应发送 [1]。也可以把它放在 <meta http-equiv> 标签中，但这种方式并不支持全部功能 [1]。MDN 将 frame-ancestors 视为旧标头 X-Frame-Options 更灵活的替代方案 [1]。

| 指令 | 控制的内容 | 展示型网站的稳妥取值 |
|---|---|---|
| default-src | 所有资源类型的兜底规则 | 'self'（仅限同源） |
| script-src | 允许加载的 JavaScript 文件 | 'self'，再加上实际使用的工具域名 |
| img-src | 图片来源 | 'self' 以及所需的图片域名 |
| connect-src | 脚本发出的请求 | 'self'，以及统计服务（如果有的话） |
| frame-ancestors（框架祖先） | 谁可以在框架中显示该页面 | 'none' 或 'self' |
| upgrade-insecure-requests（升级不安全请求） | 把以 http:// 调用的资源升级为 HTTPS | 如果仍有 http:// 链接，则启用 |

来源：MDN [1]。稳妥取值仅为建议，需根据各网站的情况调整。

## 如何部署 CSP 又不弄坏网站？

MDN 介绍了一种稳妥的做法：先通过 Content-Security-Policy-Report-Only 标头发布策略 [1]。这时浏览器只会报告它本来会阻止的内容，而不会真正阻止任何东西。先修正允许名单，再切换到正式标头。

对于直接嵌入 HTML 的脚本，Google 为 Tag Manager 推荐的方法是使用 nonce：这是服务器为每个响应生成的一个随机且无法猜测的值，并同时添加到指令和 <script> 标签中 [3]。'unsafe-inline' 选项确实存在，但 Google 将其列为最后手段，仅在 nonce 或哈希无法实现时使用 [3]。

## 添加统计工具需要允许什么？

**示例：圣伊亚森特（Saint-Hyacinthe）一家虚构的牙科诊所想添加 Google Analytics**

“Clinique dentaire Yamaska Exemple”的网站采用严格的 CSP：default-src 'self'。要在其中添加不含广告功能的 Google Analytics，Google 的文档指明了需要在三个指令中允许的域名 [3]。

下面的统计数据来自该文档；这家企业为虚构。

- script-src-elem：需添加的域名 : 1个（www.googletagmanager.com）
- img-src：需添加的域名 : 2个（googletagmanager.com、*.google-analytics.com）
- connect-src：需添加的域名 : 3个（googletagmanager.com、*.google-analytics.com、*.google.com）
- 需添加到策略中的条目总数 : 6
- 若使用 Google Ads 广告功能 : 更多域名，其中包括 *.g.doubleclick.net
- **= 策略中多出六个条目，需要记录在案：每增加一个域名，就多一个可能执行代码或接收访客数据的第三方。**

## 使用内容安全策略应避免哪些错误？

- 在没有经过仅报告模式测试期的情况下发布严格策略：提交表单或地图会停止工作 [1]。
- 为图省事在 script-src 中添加 'unsafe-inline'，这会大大削弱对脚本注入的防护。
- 在不清楚其托管内容的情况下，用通配符（*）允许整个域名。
- 只在首页设置 CSP，而它本应随所有响应一起发送 [1]。
- 添加新工具（例如预约模块或 [Google Analytics 4](https://app.pilotiko.com/zh/glossary/google-analytics-4)）时忘记更新策略。
- 依赖 CSP，而不去验证和净化表单数据 [1]。

## CSP 与 Loi 25 有关系吗？

间接有关。在 connect-src 或 script-src 中允许的每个域名，都是可能接收访客数据的外部服务。保持这份清单的更新，有助于您了解哪些工具在收集个人信息，从而本着 [Loi 25](https://app.pilotiko.com/zh/glossary/quebec-law-25)（《第25号法》）的精神撰写准确的隐私政策。我们的 [Loi 25 指南](https://app.pilotiko.com/zh/guides/quebec-law-25-for-service-businesses)详细说明了相关义务；CSP 本身并不是其中一项义务。

## Pilotiko 如何运用内容安全策略？

由 [Pilotiko 托管的网站](https://app.pilotiko.com/zh/product/website)采用限制性的内容安全策略：default-src 'self'，脚本和样式表仅限网站自身，图片来自本站或使用 HTTPS，表单只提交到本站，并设置 frame-ancestors 'none' 和 base-uri 'none'。同时还发送 X-Frame-Options DENY 标头。网站不加载任何第三方脚本，目前也尚未提供添加 Google Analytics 的功能：该功能已预告即将推出。

## 常见问题

### CSP 对小型展示型网站有用吗？

有用，尤其是网站含有表单时。即使是简单的网站，也可能加载第三方脚本，或被其他网站放进框架中显示；CSP 能以很低的成本降低这些风险。

### CSP 会弄坏我的网站吗？

会，如果它阻止了必要的资源，例如地图或预约脚本。因此要先用 Content-Security-Policy-Report-Only 标头进行测试。

### CSP 用 meta 标签还是标头？

推荐使用 HTTP 标头，它支持全部功能。无法访问服务器时可以用 meta 标签应急，但有些指令在这种方式下无法生效。

### 有了 frame-ancestors 还需要 X-Frame-Options 吗？

MDN 将 frame-ancestors 视为 X-Frame-Options 更灵活的替代方案。同时发送两者也无妨，只要二者表达的意思一致即可。

### CSP 中的 'self' 是什么意思？

它指页面自身的来源，也就是您自己的网站。default-src 'self' 表示默认情况下，页面只加载来自您自己网站的资源。

## 资料来源

1. MDN Web Docs, « Content Security Policy (CSP) », https://developer.mozilla.org/fr/docs/Web/HTTP/Guides/CSP (查阅于 2026-10-15)
2. W3C, « Content Security Policy Level 3 (Working Draft) », https://www.w3.org/TR/CSP3/ (查阅于 2026-10-15)
3. Google Tag Platform, « Utiliser Tag Manager avec une Content Security Policy », https://developers.google.com/tag-platform/security/guides/csp?hl=fr (查阅于 2026-10-15)
