CSP 策略生成器
逐条勾选 + 三种预设 + 头与 meta 双写法
如何使用本工具
- 先点一个预设:严格适合新项目,常用适合绝大多数站点,兼容老站会用 unsafe-inline,只建议过渡期临时用。
- 再逐条调整:勾上某条指令就启用,「self」代表同源,data: 允许 data URI 图片,https: 允许任意 https 来源。
- 右边会同时生成响应头写法和 meta 标签写法,meta 只对部分指令有效(frame-ancestors、report-uri 不支持)。
- 上线前先用 Content-Security-Policy-Report-Only 跑一周,从上报里补齐遗漏的来源,再切成正式策略。
常见问题
Q:为什么 style-src 里经常不得不写 unsafe-inline?
A:因为很多框架和第三方组件会把样式写进 style 属性或内联 style 标签,而 CSP 对内联样式只能靠 unsafe-inline 或 nonce 放开。React 的 style 属性本身受 CSP 约束较小,但内联 <style> 会中招,能改成外链样式表最好。
Q:meta 标签能完全替代响应头吗?
A:不能。frame-ancestors、report-uri、sandbox 这三个指令在 meta 里无效,且 meta 必须写在所有资源加载之前。有条件一律用响应头。
Q:配置之后页面样式或脚本全挂了怎么办?
A:看浏览器控制台里的 CSP 报错,它会明确写出被拦截的资源地址和违反的指令,把该来源加到对应指令下即可。别直接改成 * 了事。
Q:'self' 到底指什么?
A:指与当前文档同源(协议 + 域名 + 端口都相同)。注意 http://a.com 与 https://a.com 不同源,子域名也不算同源。
Q:nonce 和 hash 怎么选?
A:每段内联脚本的内容固定(比如一段初始化代码)用 hash,一劳永逸;内联脚本由服务端动态生成用 nonce,每次响应换一个随机值,但要保证不被缓存。