Nginx中HSTS响应头必须仅出现在HTTPS响应中,配置需满足:位置在443端口server块内、含always参数确保全状态码生效、max-age≥31536000且includeSubDomains启用前须确认所有子域已支持HTTPS。

直接验证 Nginx 返回的 HSTS 响应头是否合规,关键不是“有没有”,而是“值是否合理、位置是否正确、行为是否可控”。它必须出现在 HTTPS 响应中,且参数设置需匹配实际运维能力。
一、确认响应头存在且仅在 HTTPS 下发出
用 curl 检查真实响应,排除配置错位:
- 执行
curl -I https://your-domain.com,确认输出中包含 Strict-Transport-Security 头,且值形如max-age=31536000; includeSubDomains - 再执行
curl -I http://your-domain.com,该响应里不应出现该头——HSTS 在 HTTP 响应中无效,若出现说明配置写在了 80 端口 server 块,属于错误做法 - 注意:加
always参数(如add_header Strict-Transport-Security "max-age=31536000" always;)可确保 404/500 等非 200 响应也携带 HSTS,避免策略意外中断
二、检查参数是否符合最小安全要求
HSTS 的三个常见参数各有约束,不能照搬模板:
- max-age 至少设为 300(5 分钟)才具备实际防护意义;生产环境建议 ≥ 31536000(1 年),但上线初期应从低值起步,验证无误后再延长
- includeSubDomains 启用前,必须确保所有子域(如 api.your-domain.com、cdn.your-domain.com)均已部署有效 HTTPS 证书并可稳定访问,否则会导致子域完全不可用
- preload 是高风险动作,仅当满足全部预加载条件(max-age ≥ 10886400、含 includeSubDomains、全站 HTTPS 稳定运行超 48 小时)后才考虑添加;未提交到 hstspreload.org 前,无需加此参数
三、验证浏览器端是否按预期生效
服务端配置正确 ≠ 客户端已遵守,需交叉验证:
- 打开 Chrome 或 Edge,访问
chrome://net-internals/#hsts - 在 “Query domain” 输入你的域名,点击 Query —— 若返回 Found,说明浏览器已记录策略,max-age 值应与你配置一致
- 换无痕窗口重新访问 HTTP 地址(
http://your-domain.com),观察是否被自动跳转至 HTTPS;若仍能打开 HTTP 页面,说明 HSTS 未生效或已被清除
四、排查常见“看似合规实则失效”的情况
以下问题不会导致响应头缺失,但会让 HSTS 失去防护价值:
- 证书不信任(自签、过期、域名不匹配):浏览器拒绝建立 HTTPS 连接,自然收不到 HSTS 头
- HTTP → HTTPS 跳转未配好:用户首次访问
http://时 404 或超时,根本到不了 HTTPS server 块,HSTS 永远无法种下 - CDN 或反向代理覆盖了响应头:比如 Cloudflare 默认开启 HSTS,可能屏蔽了 Nginx 自己的配置;需确认中间层是否透传或覆盖了 Strict-Transport-Security
- 响应头被重复添加:多个 add_header 指令叠加可能导致语法错误或头被截断,建议统一在单个 location 或 server 块中定义











