使用X-Frame-Options可阻止页面被iframe嵌套,需正确配置DENY(彻底禁止)或SAMEORIGIN(仅同源允许),注意其已被CSP的frame-ancestors指令优先取代,且易因拼写错误、头被覆盖或CDN/WAF干扰而失效。

怎么用 X-Frame-Options 阻止页面被 iframe 嵌套
直接加响应头 X-Frame-Options 就能拦住大部分嵌套,但得选对值,且注意它已被现代浏览器逐步弃用。
常见错误是只在 Nginx 或 Apache 配置里写了,却没验证是否真生效;或者误以为 DENY 和 SAMEORIGIN 效果一样——其实 SAMEORIGIN 允许同协议、同域名、同端口的嵌套,DENY 是彻底禁止所有嵌套。
-
DENY:最严格,任何<iframe></iframe>都加载失败,适合登录页、密码重置页等敏感页面 -
SAMEORIGIN:允许同源嵌套,但要注意:若主站是https://a.com,而 iframe 源是http://a.com(协议不同),仍会被拒绝 -
ALLOW-FROM https://trusted.com:已基本不被 Chrome/Firefox 支持,别用
为什么设置后还是能被嵌套?常见失效原因
不是加了头就万事大吉。最常踩的坑是:头被覆盖、拼写错误、或被更高优先级策略覆盖。
- 检查响应头是否真实存在:用浏览器 DevTools 的 Network → Headers 标签页,确认响应中确实有
X-Frame-Options字段,而不是只在配置文件里写了但没生效 - 确保没有其他中间件(如反向代理、CDN、WAF)清除了或覆盖了该头;比如 Cloudflare 默认会删掉这个头
- 如果同时设置了
Content-Security-Policy的frame-ancestors指令,浏览器会忽略X-Frame-Options——这是标准行为,不是 bug - 拼写必须全大写、连字符不能少:
X-Frame-Options,写成X-Frame-Option或X-Frame-options都无效
现代替代方案:用 Content-Security-Policy 的 frame-ancestors
X-Frame-Options 是老协议,Chrome 97+、Firefox 95+ 已明确优先采用 Content-Security-Policy 中的 frame-ancestors 指令,且支持更细粒度控制。
立即学习“前端免费学习笔记(深入)”;
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
例如,想只允许来自 https://admin.example.com 和同源页面嵌套,可以这样设:
Content-Security-Policy: frame-ancestors 'self' https://admin.example.com;
注意:'self' 表示同源(含协议、域名、端口),不能写成 self(缺引号就失效);多个来源用空格分隔,末尾分号不能漏。
-
frame-ancestors 'none'等价于X-Frame-Options: DENY -
frame-ancestors 'self'等价于X-Frame-Options: SAMEORIGIN - 如果服务端同时发了
X-Frame-Options和frame-ancestors,后者胜出
Node.js / Express 中怎么安全设置
别手写 res.setHeader(),容易漏、容易错顺序。用现成中间件更稳,比如 helmet。
安装后默认就启用了 frameguard(即 X-Frame-Options),但你要主动配 contentSecurityPolicy 才能启用 frame-ancestors:
app.use(helmet({
contentSecurityPolicy: {
directives: {
'frame-ancestors': ["'self'", "https://trusted.com"]
}
}
}));
- 如果不用 helmet,自己 setHeader 要确保在所有可能修改响应头的中间件之后调用
- Express 的
res.set()和res.header()都可以,但别在异步逻辑(比如数据库查询后)才设,否则可能已发送响应头 - 开发时用 curl 验证:
curl -I https://yoursite.com,看返回头里有没有目标字段


















