内容安全策略(CSP):如何在您的网站上检查、修复并配置它
学习如何在 Apache、Nginx、WordPress 和 Joomla 上检查、添加并修复内容安全策略头,配合实用的诊断工具和托管指南。
内容安全策略 (CSP):如何在您的网站上检查、修复和配置它
HTTPS 和软件更新至关重要,但它们无法防止访客浏览器中运行的所有恶意脚本。内容安全策略 (CSP) 为页面可能加载和执行的资源添加了浏览器强制的限制。它有助于缓解某些跨站脚本 (XSS) 攻击,但不能替代上下文输出转义、输入验证或依赖项更新。
本实用教程展示了如何检查当前策略、查找其来源、安全地引入更改,并在 Apache、Nginx、WordPress 和 Joomla 上修复问题。
1. 检查现有的 CSP
Chrome 或 Firefox: 打开页面,按 F12,选择 Network,重新加载,点击 HTML 文档,检查 Response Headers。查找 Content-Security-Policy(强制)或 Content-Security-Policy-Report-Only(仅诊断)。在 Console 中检查违规情况。
命令行: 运行 curl -I https://example.com/。在 macOS/Linux 上,使用 curl -sSI https://example.com/ | grep -i content-security-policy 过滤响应。HEAD 响应可能与 GET 响应不同,因此请使用浏览器开发者工具确认。
在线工具: SecurityHeaders.com 检查安全标头;Google CSP Evaluator 会标记策略中的弱点。两者都不能证明整个网站安全。
某个响应中没有 CSP 标头并不表明每个页面都没有 CSP。还要检查任何 <meta http-equiv="Content-Security-Policy"> 标记:meta 策略有局限性,包括不支持 frame-ancestors 或 Report-Only。
2. 查找策略定义位置
| 环境 | 可能位置 |
|---|---|
| Apache / 兼容的 LiteSpeed | .htaccess、虚拟主机或服务器配置 |
| Nginx | server / location 配置 |
| PHP | 使用 header() 的应用程序代码 |
| WordPress | 插件、自定义代码、反向代理或主机 |
| Joomla | System – HTTP Headers 插件、服务器或代理 |
| Cloudflare | 响应头转换规则 |
| 托管主机 | 托管面板或提供商管理的配置 |
在添加另一个标头之前,先检查现有响应标头。 浏览器会累积强制执行多个 CSP 策略;新的宽松标头不会取消现有的限制性标头。还要检查 CDN 和托管规则。
3. 在 Apache 中使用 .htaccess 添加 CSP
使用主机的文件管理器或 SFTP (FileZilla/WinSCP),找到包含 index.php 的公共目录,通常是 public_html 或 httpdocs。启用隐藏文件以查看 .htaccess。下载备份,避免将自定义规则放在 CMS 管理的重写块中。
如果启用了 Apache 的 mod_headers 且主机允许这些指令,请添加:
<IfModule mod_headers.c>
Header always set Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'"
</IfModule>
重新加载并在 Network → Headers 下验证标头。在 Console 中检查违规情况。Report-Only 报告可能的限制但不会阻止资源。此示例为诊断用,而非完整的部署策略。
如果报告了可信的 CDN 脚本,请先确认其用途和所有权。您可能会将指令调整为 script-src 'self' https://cdn.example.com;不要盲目添加每个被阻止的主机。与设计良好的 nonce/哈希策略相比,主机允许列表对 XSS 的防御力较弱。
在测试登录、表单、结账、编辑器和其他工作流后,您可以将 Content-Security-Policy-Report-Only 替换为 Content-Security-Policy 以强制执行您 测试过的 策略。如果网站出问题,恢复备份文件,清除服务器/CDN 缓存并重新测试。编辑后出现 HTTP 500 表明语法或服务器权限问题。

4. 在 Nginx 上配置 CSP
Nginx 忽略 .htaccess。如果您管理服务器,请检查其活动配置(通常是 /etc/nginx/sites-available/ 或 /etc/nginx/conf.d/)。在相关的 server 块中,使用:
add_header Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'" always;
使用 sudo nginx -t 进行测试,然后使用 sudo systemctl reload nginx 重新加载。注意 add_header 继承以及更具体位置中的规则。在没有 Nginx 配置访问权限的托管主机上,使用提供商的控制面板或支持。
5. WordPress:插件或小型自定义集成
无代码路径: 首先检查您的主机或现有安全标头插件是否已发送 CSP。选择明确支持 CSP 且最好支持 Report-Only 的维护良好的插件;不要假设常规安全插件支持其中任何一项。在其设置中启用 Report-Only,从保守的诊断策略开始,保存,并在强制执行前测试公共页面和 wp-admin。
开发者路径: 创建 wp-content/plugins/ceikay-csp/ceikay-csp.php:
<?php
/**
* Plugin Name: CeiKay CSP Example
* Description: CSP diagnostics on the WordPress frontend.
*/
add_action('send_headers', function () {
if (is_admin()) {
return;
}
header(
"Content-Security-Policy-Report-Only: "
. "default-src 'self'; "
. "script-src 'self'; "
. "object-src 'none'; "
. "base-uri 'self'"
);
});
在 Plugins → Installed Plugins 中激活它,然后确认响应标头。它不会替代来自 Web 服务器、CDN 或其他插件的现有 CSP。它故意排除了 wp-admin,且不提供完整的强制执行策略。
故障排除: 如果 CAPTCHA 失败,请检查被阻止的 script-src、frame-src 和 connect-src 请求,并咨询 CAPTCHA 提供商的集成指南。如果页面生成器报告被阻止的内联脚本,请检查是否支持 CSP nonces 或 hashes。不要自动添加 'unsafe-inline'。对于每个响应的 nonce,请确保全页缓存不会在访客之间重复使用相同的 nonce 和 HTML。
6. Joomla:使用原生 HTTP Headers 插件
在 Joomla 管理后台,打开 System → Plugins,搜索 HTTP Headers,打开 System – HTTP Headers。确切的菜单措辞因 Joomla 版本和语言而异。
启用其 CSP 选项,并在公共站点上先从 Report-Only 开始。首先诊断类似 script-src 'self' 的指令;保存并检查 Console。测试模板、页面生成器、编辑器、联系表单、CAPTCHA、支付集成和媒体功能。
如果看到 Refused to execute inline script,请确定哪个模板或扩展生成了它。在支持的情况下,首选兼容的 nonce 或哈希方法;在授权前验证脚本是否合法。分别测试管理后台,不要与前端混淆。如果服务器已设置 CSP,请协调配置,而不是叠加冲突的策略。
有关您安装版本支持的选项,请参阅 Joomla HTTP Headers 文档。
7. 修复实际违规,而非整个策略
| 违规 | 要调查的内容 | 典型修复 |
|---|---|---|
script-src |
外部或内联 JavaScript | 验证来源;使用适当的 nonce/哈希或范围较窄的来源 |
style-src |
样式表或内联 CSS | 检查生成的样式;使用批准的来源或兼容的哈希/nonce |
img-src |
外部图像或 data URL | 仅在需要时允许经过验证的图像主机 |
connect-src |
fetch/XHR/WebSocket | 验证 API 源并添加范围较窄的权限 |
frame-src |
嵌入式视频/CAPTCHA/支付框架 | 按照提供商文档的域名 |
form-action |
表单提交目标 | 允许合法的提交源 |
frame-ancestors |
其他网站嵌入您的页面 | 明确允许预期的父级源,或使用 'none' |
例如,如果位于 https://images.example.com/photo.webp 的合法图像被 img-src 'self' 阻止,请在确认该主机受信任后,将相关指令更改为 img-src 'self' https://images.example.com。不要仅为了修复一个图像而削弱 default-src。

有些指令,包括 frame-ancestors 和 form-action,不会回退到 default-src。在需要时明确包含它们。
8. 托管是否影响 CSP 配置?
是的——CSP 浏览器标准保持不变,但您对响应标头的控制会发生变化。 Apache 共享托管可能公开 .htaccess;托管 Nginx 可能需要提供商面板;VPS 管理员可以修改服务器配置;CDN 可能会在应用程序生成响应后添加标头。
在选择托管服务之前,请询问:我无需 root 权限即可设置和删除 CSP 标头吗?我可以使用 Report-Only 吗?我可以检查最终响应吗?我的套餐中是否提供自定义标头?支持能否解释与 CDN 或应用程序规则的冲突?
Cloudways:托管级 HTTP 标头控件
Cloudways 记录了 Web Rules → Header Rules,用于管理 HTTP 响应标头,包括 CSP。这提供了编辑应用程序文件的托管级替代方案,取决于您的应用程序和套餐中可用的功能。它 不会 自动创建安全的 CSP;您仍需测试和维护您的指令。
9. 基于 nonce 的 CSP 提供更强保护
严格的 CSP 使用不可预测的 nonce 或哈希,而不仅仅依赖域名允许列表。简化的 PHP 示例:
<?php
$nonce = base64_encode(random_bytes(16));
header(
"Content-Security-Policy: "
. "script-src 'nonce-{$nonce}' 'strict-dynamic'; "
. "object-src 'none'; "
. "base-uri 'none'"
);
在 HTML 模板中:
<script nonce="<?= htmlspecialchars($nonce, ENT_QUOTES, 'UTF-8') ?>">
console.log('Trusted script');
</script>
为每个响应生成全新的不可预测 nonce。保持标头和 HTML nonce 一致,并围绕反向代理和全页缓存进行规划。使用 'strict-dynamic' 时,可信脚本可能会加载更多脚本,因此要仔细审计可信加载器。这只是一个示例,而不是适用于所有应用程序的即插即用完整策略。
10. 最终部署清单
- 识别所有现有的 CSP 标头和 meta 策略。
- 备份服务器和 CMS 配置。
- 清点脚本、样式、框架、API、图像和外部服务。
- 先部署 Report-Only 策略。
- 调查每个违规情况,仅授权受信任且必要的行为。
- 测试前端、管理后台、登录、结账、表单和集成。
- 检查缓存、nonces、CDN 行为和重复标头。
- 逐步启用强制执行,并在软件更新后进行监控。
结论
有用的 CSP 并非简单地从清单中复制一个标头。检查当前配置,找到其定义位置,以 Report-Only 模式测试,修复精确的兼容性问题,然后才强制执行适合您网站的策略。WordPress 和 Joomla 管理员可以从 CMS 工具开始;开发人员可以使用 Apache、Nginx 或 PHP;托管平台可能提供直接的标头控制。
CSP 减少了攻击机会,但仍然是与安全编码、更新、身份验证和监控并存的一层防护。