CSP 头部生成器
通过指令、hash 与 nonce 构建 Content-Security-Policy 头部。含严格模式模板、Report-Only 调试模式以及 Express、Nginx 片段。在浏览器中运行。
- 在浏览器中处理
- 工具不会把输入上传到 ZeroTool 服务器
- 免费 · 无需注册
用微信扫描以下二维码即可分享
示例、说明与常见问题 带实际输出的示例、与同类工具的差别,以及常见问题。
Strict CSP 起步配置
Strict 预设采用 web.dev 介绍的基于 nonce 的 strict CSP。HTTP 头部页签输出:
Content-Security-Policy: default-src 'self'; script-src 'nonce-{RANDOM}' 'strict-dynamic'; style-src 'self'; img-src 'self' data:; font-src 'self'; connect-src 'self'; object-src 'none'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'; upgrade-insecure-requests
'nonce-{RANDOM}' 是占位符,不是可用的值。服务器必须在每次响应时把它换成至少 128 位的新随机值,并把同一个值写进它渲染的每个 <script> 的 nonce="…"。只要策略里还有占位符,工具就会显示警告。不要把一个固定的 nonce 写进静态配置:任何人看到一次就能在注入的脚本里重复使用。
这个预设早期写的是 'self',现在换成了占位符。原因是有 'strict-dynamic' 时,CSP Level 3 会拦截 HTML 解析器插入的所有脚本,除非带有匹配的 nonce 或 hash,并且不再检查 'self' 和主机源(CSP3 §8.2)。所以单独的 script-src 'self' 'strict-dynamic' 在当前的 Chrome、Firefox、Safari 里一个脚本都不会执行,工具现在会对这种组合给出警告。如果站点是无法设置 nonce 的静态构建,删掉占位符,用 hash 计算器为每段内联脚本加 hash,或者从「适中」预设开始。
Express (helmet) 页签替你完成按响应生成这一步:它加一个中间件,把 crypto.randomBytes(16).toString('base64') 存进 res.locals.cspNonce,并给 script-src 传一个函数,这是 helmet README 里的写法。模板仍要把这个值输出到每个 script 标签上。Nginx 页签保留占位符并加一行注释,因为 Nginx 无法把同一个 nonce 写进应用渲染出的 HTML。
接入微信 JS-SDK 的页面
微信 JS-SDK 文档的「步骤二:引入JS文件」给出的地址是 res.wx.qq.com/open/js/jweixin-1.6.0.js,并写明主地址不可访问时改用 res2.wx.qq.com,两个都支持 https(JS-SDK 使用说明)。所以 script-src 要同时放行这两个主机。选「适中」预设,在 script-src 的输入框里一次粘贴两个地址,中间用空格隔开,工具会拆成两个源。切到 Nginx 页签:
add_header Content-Security-Policy "default-src 'self'; script-src 'self' https://res.wx.qq.com https://res2.wx.qq.com; style-src 'self' 'unsafe-inline'; img-src 'self' data: https:; font-src 'self' data:; connect-src 'self'; object-src 'none'; base-uri 'self'; frame-ancestors 'self'; upgrade-insecure-requests" always;
同一文档的「步骤三」要求页面调用 wx.config,参数里的 timestamp、nonceStr、signature 由服务器生成。如果服务器每次请求都生成新值,这段内联脚本的文本每次都不一样,用 hash 计算器算出的固定 hash 对不上。这种页面要么改用 Strict 预设的 nonce,由服务器在同一次响应里同时写头部和 <script nonce>;要么把配置写成 JSON 数据,由 'self' 下的外部脚本读取。
中文域名要先转成 punycode
CSP Level 3 的源语法里,主机名只能由 ASCII 字母、数字和连字符组成(§2.3.1)。直接把中文域名写进策略,这一项不符合语法。在工具里输入中文域名,会按浏览器的 URL 解析规则转成 xn-- 开头的写法,状态栏显示转换结果。下面在「适中」预设的 script-src 里加入 https://静态资源.example(.example 是保留给示例用的顶级域):
Content-Security-Policy: default-src 'self'; script-src 'self' https://xn--t7tz73ay9w64i.example; style-src 'self' 'unsafe-inline'; img-src 'self' data: https:; font-src 'self' data:; connect-src 'self'; object-src 'none'; base-uri 'self'; frame-ancestors 'self'; upgrade-insecure-requests
用中文输入法时容易把冒号、斜杠打成全角(https://)。这种写法转换不了,工具会拒绝并在状态栏说明,不会写进策略。
容易踩的坑
'none'只能单独使用。 与其他源同列时'none'不起作用,其他源照常放行。- 有些指令只在 HTTP 头部生效。 CSP3 §3.3 规定
<meta>里的frame-ancestors、report-uri、sandbox无效,也没有 Report-Only 模式。工具会在<meta>页签去掉它们并提示。 'strict-dynamic'必须搭配 nonce 或 hash。 没有时页面上的脚本会全部被拦截,工具会提示。- hash / nonce 会让
'unsafe-inline'失效。 现代浏览器会优先采用更安全的策略。 - 务必声明
default-src。 缺失的 fetch 指令会回退到default-src;没有它,未来新增的指令也得不到任何兜底。 - 自定义主机不能包含分号。 分号会终止策略,把后续指令一并破坏。
Hash 还是 Nonce?
对于静态内联内容(埋点片段、关键 CSS、服务端渲染的辅助脚本),用 hash。它和静态 HTML、边缘缓存兼容,不需要每次请求都生成新值。
对于动态渲染内容,用 nonce。服务端在头部里写 'nonce-XYZ',并在所有 <script nonce="XYZ"> 上盖同一个值。把 nonce 与 'strict-dynamic' 组合使用,可以让被信任脚本的子脚本继承信任,而你不必维护庞大的主机白名单。
部署速查
- Nginx:把 Nginx 页签的内容粘贴到
server块并 reload。always标志让错误响应也带上头部。 - Apache:在
.htaccess或httpd.conf里写Header always set Content-Security-Policy "..."。 - Express / Node:粘贴 helmet 片段。片段里已写
useDefaults: false,请保留,否则 helmet 会把它的默认指令加进你的策略。 - Cloudflare Pages / Vercel / Netlify:把 HTTP header 写进各自的 headers 配置(
_headers、vercel.json、netlify.toml)。
限制
- 只生成,不检测。工具不会访问你的网站,不读取已有的头部,也不知道第三方脚本运行后还会加载哪些主机。缺什么要靠 Report-Only 的报告来找。
- 对源的检查很少。只拒绝分号;空格拆分多个源;非 ASCII 主机转成 punycode。
https//cdn.example.com这类拼写错误会原样写进策略。不是主机的值不做转换:trusted-types的策略名只能用 Trusted Types §4.2.2 允许的字符,sandbox令牌和report-to端点名必须是 ASCII,否则会被拒绝。 - hash 必须逐字一致。浏览器对脚本或样式文本的 UTF-8 字节计算 hash(CSP3 §6.7.3.3),与页面用什么编码保存无关;多一个空格或换行,hash 就不同。
- nonce 要靠服务器。工具只写
'nonce-{RANDOM}'占位符,只有 Express 页签会按响应生成新值;HTTP 头部、meta 和 Nginx 输出都要由应用程序替换。 - 过时的指令。
prefetch-src和navigate-to不在 2026 年 9 月 16 日的 CSP3 工作草案里,工具已不再提供;以前保存的策略里如果有这两项,打开页面时会去掉,并在状态栏提示一次。block-all-mixed-content开关仍保留,但这条指令被 Mixed Content §6.1 列为过时,理由是无法自动升级的混合内容现在一律被拦截;打开开关时,输出下方会提示。 - Report-Only 下的 upgrade-insecure-requests 不起作用(Upgrade Insecure Requests §3.1)。工具仍把它写进 Report-Only 头部,同时在输出下方提示这一点。
FAQ
什么是 Content Security Policy?
CSP 是一类 HTTP 响应头部,用于声明浏览器可以信任的脚本、样式、图片、字体、iframe 等内容来源。它代替不了输出编码,作用是在注入漏洞漏网时减小损失:例如拦下没有匹配 nonce 或 hash 的注入脚本;frame-ancestors 则控制谁能把页面嵌进 iframe。
上线时应该先用 Enforce 还是 Report-Only?
先用 `Content-Security-Policy-Report-Only` 配合 `report-uri`(或 `report-to`)端点,观察真实流量,把误伤改完,再切到强制生效的 `Content-Security-Policy`。注意 `upgrade-insecure-requests` 写在 Report-Only 头部里不起作用,要在强制模式下验证。
我必须用 'unsafe-inline' 才能写 inline script / style 吗?
不必。现代 CSP 支持按内容计算的 hash(`'sha256-...'` 等)以及按请求生成的 nonce(`'nonce-...'`),优先使用这两种方式。直接用页面里的 hash 计算器即可。
'strict-dynamic' 起什么作用?
它允许已经被 nonce 或 hash 信任的脚本在运行时再加载其他脚本,而无需一一列出 CDN 主机。这是现代应用推荐的模式,会覆盖基于主机的白名单,从而堵住绕过路径。
生成的头部应该部署到哪里?
请从源站发出 `Content-Security-Policy`(Nginx `add_header`、Apache `Header set`、Cloudflare Transform Rules、Vercel `headers` 等都可以)。HTML `<meta http-equiv>` 仅作为静态托管的兜底;CSP Level 3 规定 `<meta>` 里的 `frame-ancestors`、`report-uri`、`sandbox` 无效,工具在该页签中会去掉它们。`report-to` 在 `<meta>` 中仍有效,但它的端点要由 `Reporting-Endpoints` 头部定义。
我写的策略会被发送或保存吗?
输入的内容不会发送到服务器:策略、各种输出和 hash 都在页面里生成,hash 用浏览器的 Web Crypto API 计算。策略本身(预设、模式、两个传输开关,以及所有指令和源,包括 hash)会保存在本浏览器的 localStorage,下次打开时恢复;Ctrl/⌘+L 只清空文本框和计算出的 hash,保留已保存的策略。hash 计算器里的文本不保存。与其他工具页一样,本页加载 Google Analytics 和 AdSense;每次修改策略记录一次 `generate` 事件,只含工具名和操作,不含策略内容。