运行 · 安全策略与 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 的交付检查。