Nginx 的 add_header 子目录全丢 X-Frame-Options 为什么不生效

安全扫描报告出来,37 个 URL 缺 X-Frame-Options,全集中在 /shop/ 和 /api/ 两个前缀下。首页和文章页都有头,curl -I 能看到的差异只有路径。

第一反应是漏配。翻 /etc/nginx/conf.d/site.conf,server 块里明明有一行 add_header X-Frame-Options SAMEORIGIN always,写了两年前,没人动过。

把 /shop/ 的 location 贴出来对比,里面多了一条 add_header Cache-Control "public, max-age=600"。nginx 的规则是:子级一旦出现任意 add_header,父级的所有 add_header 全部作废,不是合并。安全头就是这么丢的。

试过在每个 location 里复制一遍安全头,配到第 14 处时又新加了一个 location,扫描再跑还是漏 2 个。复制粘贴在配置增长时必然再犯。

也试过 add_header_inherit merge,nginx -t 直接报 unknown directive,1.24.0 不支持,要升到 1.29 才有。为一个头升级运行版本,风险比收益大,放弃。

落地做法是把公共头抽成 SNIppets/headers.conf,每个 location 里 include 一次,Cache-Control 之类放在 include 之后。新增 location 漏了 include 会被 CI 里的 nginx -T 检查拦下,脚本比对 location 数量和 include 数量。

location /shop/ {
    include snippets/headers.conf;
    add_header Cache-Control "public, max-age=600";
    proxy_pass http://shop_upstream;
}

# snippets/headers.conf
add_header X-Frame-Options SAMEORIGIN always;
add_header X-Content-Type-Options nosniff always;

确认:对 20 条路径批量取头,20 条全含 X-Frame-Options 和 X-Content-Type-Options;扫描器复测 37 项归零。静态目录和反代目录都覆盖到了。

顺带发现 /api/ 的 OPTIONS 预检也受过影响,补上 include 后 204 的响应头齐全,前端跨域报错少了一半。

您可以还会对下面的文章感兴趣: