运行 · 安全策略与 CSP

生成与配置

Banyan 为已启用的平台生成 CSP 响应头,并为外链脚本提供完整性信息。站点根 hugo.toml 须保留:

[minify]
disableJS = true

此设置防止 HTML 压缩再次改写脚本,使 CSP 哈希失效。

其他缓存、安全和权限头在 assets/site/delivery.toml 中维护。修改源配置后重新构建,不直接编辑生成的 _headers 或 edgeone.json。平台开关和路由见交付与缓存。

参考配置的 Permissions-Policy 关闭主题不需要的高权限能力。HSTS 使用 max-age=300,不包含 includeSubDomains 或 preload;是否扩大范围由站点决定。

自定义脚本

自定义模板中的裸内联 JS 不会自动获得 CSP 授权,优先使用外链脚本。新增第三方脚本或改变资源来源后,检查实际页面和部署响应头。

主题的内联脚本与原生预取规则由构建统一生成哈希,无需添加 unsafe-inline。预取配置见预取配置。

验证

swban check/delivery <build>                  #检查交付配置与指纹发布路径
swban check/csp <build>                       #检查哈希、integrity 和响应头
swban check/browser/csp <build> --page <path>  #检查浏览器实际 CSP 违规
swban check/http/security <url>               #检查已部署的响应头

本地检查不能代替部署后检查。尤其在 EdgeOne 上,应检查真实 HTTP 响应中的重叠规则结果。检查范围和准备步骤见浏览器检查及 Skill 的交付检查。

横向滚动 · 单击或按 Esc 退出