最常见错误是全局配置add_header导致非html响应误加x-frame-options;应仅在location ~ .php$中精准设置deny或sameorigin,并避免与csp的frame-ancestors冲突。

直接在 phpEnv 的 Nginx 配置中加 add_header X-Frame-Options SAMEORIGIN 是最常见做法,但多数人配完发现部分页面失效、某些接口报错,或百度统计点击图不工作——问题不在指令本身,而在它被套用的位置和语义边界。
为什么全局 server 块里加一行就出问题
Nginx 的 add_header 不继承、不覆盖、不条件生效,只在当前作用域响应时“追加”。你在 server 块顶层写一句:
add_header X-Frame-Options SAMEORIGIN;
结果所有响应——包括 /healthz(返回 204)、/api/login(JSON 接口)、甚至静态 JS/CSS 文件——全带上了这个头。而浏览器对非 HTML 响应加 X-Frame-Options 属于语义错误,部分安全扫描器会标为高危;更实际的是,百度统计的“热点追踪”依赖 iframe 加载你的页面,SAMEORIGIN 拦住了它,导致功能白屏。
-
add_header在location外定义时,对所有子 location 生效,无法排除 API 或静态资源 - 它不会跳过 304/204 等无 body 响应,加了也无效,还污染响应头
- 若你同时在 PHP 中用
header()设置该头,Nginx 和 PHP 双重设置,Chrome 可能拒绝渲染
应该只在 location ~ \.php$ 里设,且优先用 DENY
点击劫持只针对可渲染的 HTML 页面,PHP 脚本生成的页面才是目标。所以头必须精准落在 PHP 执行路径上,而非泛泛而谈“所有响应”。
在 phpEnv 的站点配置文件(通常是 /phpenv/nginx/vhosts/your-site.conf)中,找到类似这样的 location 块:
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
include fastcgi.conf;
# 在这里加,且仅对 PHP 输出生效
add_header X-Frame-Options DENY;
}
- 登录页、密码重置页、后台首页等敏感 HTML 页面,一律用
DENY——它们根本不该被任何 frame 套用 - 如果确实有同站嵌套需求(比如控制台内嵌仪表盘),改用
SAMEORIGIN,但必须确认该 PHP 路由不处理用户凭证类操作 - 别碰
ALLOW-FROM:Chrome/Firefox 已废弃,IE11 是最后支持者,不值得为兼容它引入配置复杂度
和 CSP 的 frame-ancestors 冲突怎么办
现代项目往往同时配了 Content-Security-Policy: frame-ancestors 'self'。这时 X-Frame-Options 不是补充,而是干扰源——当两者共存,浏览器以 CSP 为准,但旧版 IE(≤10)完全无视 CSP,只认 X-Frame-Options。所以二者不是“多加一层更安全”,而是“按需共存”:
- 如果你明确不支持 IE10 及更早版本(2026 年绝大多数业务已如此),可直接删掉
X-Frame-Options,只留 CSP - 若需兼容老 IE,则保留
X-Frame-Options,但必须确保它和 CSP 的策略一致:比如 CSP 设了frame-ancestors 'none',那X-Frame-Options就得是DENY,否则行为不可预测 - 绝对不要在同一个响应里让两个头策略冲突,例如 CSP 允许
'self'却配了X-Frame-Options: DENY——这会让老浏览器锁死,新浏览器却按 CSP 放行,测试时极易漏掉
真正容易被忽略的点是:phpEnv 默认可能已通过 fastcgi_params 或全局 conf 注入过该头,你新加的那行未必生效;务必用 curl -I https://yoursite.com/login.php 实测响应头,并用含 iframe 的测试页验证是否真被拦截——光看 header 存在,不等于防住了点击劫持。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











