发布时间:2026-10-01 05:01 更新时间:2026-10-01 05:01 阅读量:9
给站点加上 X-Frame-Options、X-Content-Type-Options、Content-Security-Policy 这类安全响应头,现在几乎是上线标配。不少站长在 Nginx 的 server 块里写好了 add_header,用 curl -I 一看也确实有,于是就放心了。可过一阵子换台机器、或者用在线检测工具扫一遍,却发现首页有、某个子目录没有,图片或 API 路径干脆一个头都不剩。这类问题十有八九不是配置写错,而是踩到了 add_header 的继承规则,再叠加 location 嵌套,头就被一层层覆盖掉了。
Nginx 的 add_header 指令在 http、server、location、if in location 这些层级都允许出现。它的继承逻辑和很多人直觉相反:如果当前层级自己定义了任意一条 add_header,那么上一层的 add_header 全部不再继承,而不是合并。也就是说,父层写了五条安全头,子层只写了一条 Cache-Control,最终响应里就只剩这一条,其余五条统统消失。
更隐蔽的是,这个“作废”是按层级整体生效的,不分指令内容。哪怕子层写的是完全无关的 expires 或 add_header X-Test 1,只要子层出现了 add_header,父层的安全头就会被丢弃。此外,add_header 默认只对 200、201、204、206、301、302、303、304、307、308 这些状态码生效,遇到 4xx、5xx 响应时,如果没加 always 参数,头同样不会出现——这也是“首页有、404 页没有”的常见原因。
先做一个最小验证。假设配置大致如下:
server {
listen 443 ssl;
server_name www.example.com;
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-Content-Type-Options "nosniff" always;
location /static/ {
add_header Cache-Control "public, max-age=2592000";
root /www/wwwroot/example;
}
}
访问首页时 curl -I 能看到两个安全头,但请求 /static/logo.png 时,响应里只有 Cache-Control。原因就是 /static/ 这个 location 自己写了 add_header,server 层的两条被整体屏蔽。这个行为在 Nginx 官方文档的 add_header 条目下有明确说明,建议对照自己当前使用的版本确认,具体以官方文档为准。
真实站点的配置往往比上面复杂得多,location 会嵌套,还会有 include 进来的伪静态、缓存、防盗链片段。以下几种结构最容易让安全头莫名消失。
第一种,静态资源单独开缓存。为了给 css、js、图片加长缓存,很多人会写一个 location ~* \.(js|css|png|jpg)$ 并配 add_header Cache-Control。这个 location 一旦存在,server 层所有安全头对它全部失效。图片站、带 CDN 的站点尤其容易被扫出来“部分资源缺安全头”。
第二种,include 的伪静态文件里带 add_header。宝塔面板生成的 WordPress 伪静态、ThinkPHP 伪静态,有些模板里会顺手加 add_header 或 expires。这类文件被 include 进 location 后,效果等同于在该 location 里直接写,同样会顶掉父层。排查时不要只看主配置,要把 include 的文件逐个打开看。
第三种,location 里套 if。例如想做 UA 判断、Referer 判断,在 if 块里写了 add_header。这种写法不仅容易触发 Nginx 的 if 陷阱,也让头的来源变得难以追踪。能用 map 解决的判断,尽量放到 map 里做变量,再在统一位置输出头。
第四种,反代 location 与静态 location 并存。反代到上游的那段往往要加 proxy_set_header、proxy_cache 相关指令,顺手也会加 add_header。结果就是动态页面有头、静态文件没头,或者反过来。检查时按路径分类请求,才能看清哪一段丢了。
排查的第一步是拿到证据,而不是凭印象改配置。可以先用下面几条命令把“哪个 URL 缺哪个头”固定下来:
# 只看响应头,-s 静默 -I 取 HEAD
curl -sI https://www.example.com/ | grep -i -E 'x-frame|x-content-type|content-security|cache-control'
对比静态资源
curl -sI https://www.example.com/static/logo.png | grep -i -E 'x-frame|x-content-type|cache-control'
看 404 响应是否带头(验证 always 是否生效)
curl -sI https://www.example.com/not-exist-page | grep -i -E 'x-frame|x-content-type'
定位配置来源:确认某段配置在哪个文件哪一行
nginx -T 2>/dev/null | grep -n -E 'add_header|location'
其中 nginx -T 会把主配置和所有 include 的文件合并后完整打印,配合 grep 能快速看到 add_header 一共出现在哪些层级。改完配置记得先 nginx -t 校验语法,再 nginx -s reload 平滑重载,避免线上直接中断。
知道规则之后,处理思路其实很清楚:要么保证每个写了 add_header 的层级都补齐全套安全头,要么把安全头挪到一个不会被覆盖的位置。前者维护成本高,一旦新增 location 就容易漏;后者更省心。
推荐做法是把安全头定义成一个独立片段,然后在所有需要的层级 include 进来。例如新建 /www/server/nginx/conf/security_headers.conf:
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-Content-Type-Options "nosniff" always;
add_header Referrer-Policy "strict-origin-when-cross-origin" always;
然后在 server 层和每一个自己写了 add_header 的 location 里都 include 一次:
server {
listen 443 ssl;
server_name www.example.com;
include /www/server/nginx/conf/security_headers.conf;
location /static/ {
include /www/server/nginx/conf/security_headers.conf;
add_header Cache-Control "public, max-age=2592000";
root /www/wwwroot/example;
}
}
这样即使子层因为缓存需求写了 add_header,安全头也不会丢。注意 CSP 这类策略头通常要按站点实际情况定制,不要直接照抄别人的规则,写太严会把站内统计、CDN、字体等正常资源一起拦掉,建议先用 Report-Only 模式观察。另外,如果站点前面还有 CDN,源站的头不一定会原样透传到边缘,有些 CDN 会覆盖或追加同名头,建议在源站用 curl 确认一遍,再在 CDN 侧确认一遍,两边都对上才算真的落地。
最后提醒一点:安全头只是加固的一环,不要指望加了 X-Frame-Options 就万事大吉。改完配置后,用浏览器开发者工具的 Network 面板或命令行工具抽查首页、列表页、静态资源、404 页四类响应,确认头都在、状态码都正常,才算收工。把这份检查做成上线前的一个固定动作,后面新增 location 时就不会再被“头悄悄消失”坑第二次。
| 📑 | 📅 |
|---|---|
| 宝塔面板防盗链误伤自家CDN:白名单与空Referer放行 | 2026-10-01 |
| 宝塔面板站点被降权前的征兆:抓取频次、收录量与Nginx日志交叉观察 | 2026-10-01 |
| 宝塔多版本PHP站点选错版本:fastcgi_pass与.user.ini排查 | 2026-09-30 |
| Nginx 限流不生效排查:zone、层级与 CDN 真实 IP 三个坑 | 2026-09-30 |
| WordPress数据库MyISAM转InnoDB:引擎、行格式与写入观察 | 2026-09-30 |
| WordPress上传图片自动生成多尺寸缩略图:禁用与冗余清理 | 2026-10-01 |
| 宝塔面板反代后端走HTTPS出现502:SNI、证书校验与proxy_ssl参数配置 | 2026-10-01 |
| 企业官网从零搭栏目结构:首页产品案例关于联系五块怎么定 | 2026-10-03 |
| 企业官网移动端适配检查清单:十个细节逐屏验收 | 2026-10-03 |
| 企业网站首屏加载优化:图片尺寸、字体加载与关键CSS的落地顺序 | 2026-10-03 |