HSTS 配置方法实战:max-age 灰度、includeSubDomains 与 preload 的 Nginx/Apache/IIS 全流程
HSTS 配置方法的核心是:在 443 端口的 HTTPS 响应中下发 Strict-Transport-Security: max-age=31536000; includeSubDomains; preload,并按 300 → 86400 → 2592000 → 31536000 秒四段灰度,每段观察 24 小时以上再提升。 Nginx 必须写 add_header Strict-Transport-Security '...' always;(always 自 1.7.5 起支持),漏掉 always 时 4xx/5xx 响应不带该头,且子级 location 只要出现任意 add_header 就会切断父级继承。 includeSubDomains 会覆盖全部子域,只要有 1 个子域不支持 HTTPS 就会直接不可访问;preload 要求 max-age ≥ 31536000 秒,且退出周期以月计,提交前要按「不可回退」评估。 验证命令:curl -sI https://example.com | grep -i strict-transport-security;浏览器端用 chrome://net-internals/#hsts 查询 max-age 与 include_subdomains;SSL Labs 拿 A+ 要求 max-age ≥ 15768000 秒。 回滚只能下发 max-age=0,且必须等已缓存的用户再次成功访问一次 HTTPS 才清除,服务器无法单方面撤销。
为什么 HSTS 配置方法不只是加一行响应头?问题背景与根本原因
很多人把 HSTS 配置方法理解成”在 Nginx 里加一行 add_header Strict-Transport-Security“,然后在浏览器里看到地址栏变 https 就以为完事了。问题恰恰出在这里:HSTS 不是服务器侧的重写规则,而是 RFC 6797 定义的浏览器端状态机。服务器只做一件事——在响应头里下发策略;真正的 HTTP→HTTPS 强制跳转由浏览器本地执行,Chrome 中表现为地址栏里的 307 Internal Redirect,请求根本没有到达你的服务器。
这解释了一个让运维非常困惑的现象:HSTS 配错了,服务器 access.log 里一行异常都没有。没有 301、没有 4xx、没有握手失败记录,因为浏览器在本地就把请求改写掉了,或者压根没接受你的头。排查困难的根源不在 Nginx/Apache/IIS,而在于”生效点”和”观测点”分离。你必须换一套验证手段:
# 1) 确认响应头确实下发(这是服务器侧唯一能验证的事)
curl -sI https://example.com | grep -i strict-transport-security
# 期望输出示例:strict-transport-security: max-age=300
# 2) 确认头是否写在 HTTPS(443)响应里 —— 这是最高频的失败原因
curl -sI http://example.com | grep -i strict-transport-security
# 正确结果应为空。写在 80 端口的 STS 头会被 UA 直接忽略
# 3) 用 openssl 确认 TLS 链路正常(HSTS 只作用于可信任的 TLS 响应)
openssl s_client -connect example.com:443 -servername example.com /dev/null | openssl x509 -noout -dates
# 4) 查 Chrome 本地状态机是否真的记住了策略
# Linux: ~/.config/google-chrome/Default/TransportSecurity
# macOS: ~/Library/Application Support/Google/Chrome/Default/TransportSecurity
# Firefox: profile 目录下的 SiteSecurityServiceState.txt
grep -a example.com ~/.config/google-chrome/Default/TransportSecurity | head
据 RFC 6797 §7.2 明确规定,UA 只接受通过 TLS 传输的响应中的 STS 头。这直接对应上表第 2 条命令:如果你的 add_header 写在 server { listen 80; } 块里,或者写在未加 always 参数的 location 中导致 4xx/5xx 响应不带该头,浏览器一律视而不见。这是”明明配了 HSTS 却不生效”的第一名原因。
第二个容易被低估的特性是不可撤销性。max-age 一旦被浏览器接收就落盘保存,到期前服务器无法单方面收回。想提前失效,只能在 HTTPS 响应里下发 max-age=0,且必须等浏览器”下次成功访问”时才清零——用户不来,策略就一直生效。这就是为什么生产环境绝不能一上来就写两年,而要走灰度。
| 指令 | 默认值 / 取值范围 | 作用域与风险 | 可逆性 |
|---|---|---|---|
max-age |
无默认值(缺失即不生效);单位秒,常用 300 / 86400 / 31536000 / 63072000 | 仅当前主机名 | 可逆,需下发 max-age=0 且用户回访 |
includeSubDomains |
无默认值(缺失=不包含子域) | 扩散至全部子域,含 Jenkins、老监控面板、SaaS 的 CNAME 子域 | 移除指令后,已缓存的策略仍按原 max-age 生效 |
preload |
无默认值;须同时满足 max-age ≥ 31536000、includeSubDomains、preload | 随 Chromium 版本内置发布,首次访问前即生效 | 单向门,据 hstspreload.org 文档移除申请以月计 |
开启 includeSubDomains 后,那些只跑 HTTP 的内部系统会立刻”失联”:浏览器的 http:// 请求被本地改写成 https://,而目标端口根本没有 TLS 监听,用户看到的不是 301 而是连接失败,且你无法通过改服务器配置救回——只能等 max-age 到期或引导用户清缓存。
与证书生命周期的错配是第二大风险。据 Let’s Encrypt 文档,其证书有效期 90 天、依赖 ACME 自动续期。若你同时设置 max-age=63072000(2 年),一次续期失败叠加用户长期不访问,就会出现”证书已过期 + 浏览器禁止点击继续访问”的死锁——HSTS 生效期间,用户连”高级 → 继续前往”的逃生通道都没有。合理的顺序是:先跑通 ACME 自动续期与到期告警,再谈长 max-age。
preload 更要把前面所有坑都走完再碰。据 hstspreload.org 文档,提交需同时满足 max-age ≥ 31536000、includeSubDomains、preload 三个条件,且列表随浏览器版本内置发布,意味着策略在你的服务器之外、在用户的第一次请求之前就已经生效。
HSTS 配置方法的 6 步上线流程:从域名盘点走到回滚预案
为什么不能一步到位?因为 HSTS 一旦下发,浏览器在 max-age 窗口内会强制把 http:// 请求在本地改写成 https://,服务器端没有任何补救余地——RFC 6797 明确说明该策略由 UA 存储,站点无法远程撤销。所以下面的 6 步流程本质上是把不可逆的窗口一步步放大,每步都有可验证的退出条件。
步骤 1|盘点域名:哪些子域根本扛不住 includeSubDomains?
# 1) 看解析:CNAME 到 SaaS 的子域要单独记入白名单
dig +short A sub.example.com
dig +short CNAME sub.example.com
# 2) 看协议:只打印状态行,判断 443 是否真的有监听
curl -sI --max-time 5 http://sub.example.com | head -1
curl -sI --max-time 5 https://sub.example.com | head -1
若第二条返回 curl: (7) Failed to connect ... port 443,该子域就是 includeSubDomains 的地雷。Shopify、Zendesk、GitHub Pages 这类 CNAME 托管域通常不允许你注入自定义响应头,据 GitHub Pages 文档,其自定义域仅支持 HTTPS 强制但不可控 HSTS 头,因此必须列入白名单或提前迁出。
步骤 2|先修证书与 80→443 跳转,否则 HSTS 只是放大故障面
# 检查证书链是否完整(缺中间证书是最常见的坑)
openssl s_client -connect example.com:443 -servername example.com -showcerts &1
| grep -E "Verify return code|verify error"
# 期望:Verify return code: 0 (ok)
# 常见失败:verify error:num=21:unable to verify the first certificate
# 检查 80 端口是否 301 到 https(而不是 302 / 直接关停)
curl -sI http://example.com | grep -Ei "^(HTTP|location)"
据 Let’s Encrypt 文档,中间证书需与站点证书一起在服务端下发;链不完整时桌面浏览器可能”能用”(缓存过中间证书),移动端却报 NET::ERR_CERT_AUTHORITY_INVALID。先把 SSL Labs 评分跑到 A,再谈 HSTS。
步骤 3|灰度 5 分钟:max-age=300
# Nginx(需 1.7.5+ 才支持 add_header 的 always 参数,否则 4xx/5xx 不带该头)
# /etc/nginx/conf.d/hsts.conf
add_header Strict-Transport-Security "max-age=300" always;
# Apache httpd 2.4+(需启用 mod_headers)
Header always set Strict-Transport-Security "max-age=300"
# IIS 10 / web.config
<system.webServer><httpProtocol><customHeaders>
<add name="Strict-Transport-Security" value="max-age=300" />
</customHeaders></httpProtocol></system.webServer>
curl -sI https://example.com | grep -i strict-transport-security
# 期望输出:strict-transport-security: max-age=300
观察 24–48 小时,重点盯三处:DevTools 的 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure resource 告警、CDN 回源 4xx 曲线、以及内部系统报”打不开”。这一步是唯一零风险的窗口。
步骤 4|阶梯提升:每次只动一个变量
| 阶段 | max-age | 等效时长 | 最短观察期 | 进入下一档的条件 |
|---|---|---|---|---|
| 灰度 | 300 | 5 分钟 | 24–48 小时 | 无新增混合内容告警 |
| 一档 | 86400 | 1 天 | 3 天 | 4xx/5xx 与基线持平 |
| 二档 | 2592000 | 30 天 | 7 天 | 无子域投诉、CDN 回源正常 |
| 终档 | 31536000 | 1 年 | — | preload 的最低门槛 |
每次提升都要记录变更时间戳:回滚时你需要用它对照”哪些用户还在旧窗口内”。hstspreload.org 要求 max-age 至少 31536000 秒且包含 includeSubDomains,否则提交会被直接拒。
步骤 5|最后加 includeSubDomains,80 端口保持 301
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
先在 test.example.com 单独验证一轮再全量。切记不要把 80 端口关停——那样老书签用户看到的是 ERR_CONNECTION_REFUSED,而保留 301 才能让他们被正常送到 HTTPS,这也是 HSTS 生效的前提。
步骤 6|preload 与回滚开关
# 回滚:把 max-age 置 0 覆盖浏览器已存策略(RFC 6797 §6.1)
add_header Strict-Transport-Security "max-age=0" always;
提交 preload 前请确认 2–3 年内不打算回退 HTTP:Chromium 的 preload 移除流程以月计。而 max-age=0 只对”能再次成功访问到 HTTPS 的客户端”生效——已断网、已离线的用户仍会带着旧策略回来。这正是上面这套 hsts 配置方法必须阶梯推进的原因:每一步的可逆成本,都由上一步的 max-age 决定。
Nginx、Apache、Tomcat、IIS、Cloudflare 的 HSTS 配置方法示例
同一份 HSTS 策略写在五处,效果差别在哪?据 RFC 6797 §7.2,浏览器必须在非安全传输上忽略 STS 头,因此配置位置决定的不是”要不要发”,而是”能否覆盖 4xx/5xx、重定向和错误页”。先看选型对比:
| 平台 | 配置位置 | 版本要求 | 覆盖 4xx/5xx | 默认值 / 陷阱 |
|---|---|---|---|---|
| Nginx | server{} 的 443 块 |
1.7.5+(always 参数) |
需显式加 always |
子级 location 出现任意 add_header 即丢失继承 |
| Apache | <VirtualHost *:443> |
2.4 + mod_headers | Header always set 才覆盖 |
Header set 只作用于 onsuccess 表 |
| Tomcat | conf/web.xml 过滤器 |
8.0+ | 是(Filter 层) | hstsEnabled 默认 false |
| IIS | 站点主页 → HSTS | 10(Server 2016/2019) | 是 | 8.5 及更早无原生支持 |
| Cloudflare | SSL/TLS → Edge Certificates | — | 是(边缘层) | Max-Age 默认 6 个月(15768000) |
Nginx 怎么写才不会被 location 吃掉?把 HSTS 抽成可 include 的片段,因为 Nginx 的 add_header 只在当前层级完全没有同类指令时才向上继承:
# /etc/nginx/conf.d/hsts.conf —— 片段文件,供各层级重复 include
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload" always;
# /etc/nginx/sites-enabled/example.conf
server {
listen 443 ssl;
server_name example.com;
include conf.d/hsts.conf; # 父级声明一次
location /api/ {
add_header Cache-Control "no-store" always; # 本层一旦有 add_header
include conf.d/hsts.conf; # 父级 HSTS 就丢了,必须再 include
}
}
# nginx -t && systemctl reload nginx
# 验证:curl -sI https://example.com/ | grep -i strict-transport-security
Apache 为什么必须用 always?Header set 写入的是 onsuccess 响应表,Apache 自己生成的 404/500 走 error 表,不会带上 HSTS;Header always set 才同时覆盖两张表(见 Apache httpd mod_headers 文档)。
<VirtualHost *:443>
ServerName example.com
Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains"
</VirtualHost>
# apachectl configtest && systemctl reload apache2
Tomcat 内嵌容器怎么开?Tomcat 8.0+ 自带 HttpHeaderSecurityFilter,但它默认 hstsEnabled=false,不显式打开不会下发任何 HSTS 头;且该过滤器仅对 request.isSecure() 为真的请求生效,前置反代未传 X-Forwarded-Proto 时会静默失效。
<!-- $CATALINA_BASE/conf/web.xml -->
<filter>
<filter-name>httpHeaderSecurity</filter-name>
<filter-class>org.apache.catalina.filters.HttpHeaderSecurityFilter</filter-class>
<init-param><param-name>hstsEnabled</param-name><param-value>true</param-value></init-param>
<init-param><param-name>hstsMaxAgeSeconds</param-name><param-value>31536000</param-value></init-param>
<init-param><param-name>hstsIncludeSubDomains</param-name><param-value>true</param-value></init-param>
<init-param><param-name>hstsPreload</param-name><param-value>true</param-value></init-param>
</filter>
<filter-mapping><filter-name>httpHeaderSecurity</filter-name><url-pattern>/*</url-pattern></filter-mapping>
IIS 10 图形界面点几下就行,老版本怎么办?IIS 10 在站点主页 → HSTS 中勾选 Enable、Max-Age=31536000、Include Sub Domains、Preload、Redirect Http To Https 即可;IIS 8.5 及更早只能退回 web.config 自定义头,且错误响应不一定带:
<system.webServer>
<httpProtocol>
<customHeaders>
<add name="Strict-Transport-Security" value="max-age=31536000; includeSubDomains" />
</customHeaders>
</httpProtocol>
</system.webServer>
Cloudflare 上开启后报 ERR_TOO_MANY_REDIRECTS 是什么原因?加密模式仍是 Flexible 时,边缘用 HTTP 回源、源站 301 跳 HTTPS,形成死循环。必须先改成 Full (strict),再进 SSL/TLS → Edge Certificates → HSTS;Max-Age 按 Cloudflare 文档建议从 6 个月(15768000 秒)起步,Include Sub Domains 与 Preload 分两次勾选——Preload 一旦生效,回滚需要数月且要逐个提交移除。
典型报错:
ERR_TOO_MANY_REDIRECTS(Chrome)/The page isn’t redirecting properly(Firefox)。排查:curl -sI http://example.com看是否 301 到 https,再看curl -sI https://example.com是否又 301 回 http。
应用层也配了会怎样?Spring Security 5.x 的 HstsHeaderWriter、Helmet.js 7.x 的 hsts 中间件都会独立写头。若前置 Nginx 已下发,响应里会出现两条同名 Strict-Transport-Security,浏览器按 RFC 6797 只采纳第一条,灰度时极易误判。原则是只保留最外层一层:应用侧显式关闭——Spring Security 用 http.headers(h -> h.httpStrictTransportSecurity(s -> s.disable())),Helmet 用 app.use(helmet({ hsts: false }))。更多 max-age 灰度与 preload 提交细节,可对照 Let’s Encrypt 与 hstspreload.org 的提交要求(max-age ≥ 31536000、含 includeSubDomains、含 preload)逐项核对。
HSTS 配置方法参数对比:max-age 取值与下发位置怎么选
max-age 填多少,本质是”你能在多长时间内修好一次证书事故”的量化答案。先看阶梯取值:
| max-age(秒) | 时长 | 适用阶段 | 主要风险 |
|---|---|---|---|
| 300 | 5 分钟 | 首次灰度 | 覆盖用户少,验证价值有限 |
| 86400 | 1 天 | 小流量验证 | 当天出问题当天可见 |
| 2592000 | 30 天 | 稳定运行期 | 手工续费团队的上限 |
| 15768000 | 6 个月 | SSL Labs A+ 门槛 | 需配套到期监控 |
| 31536000 | 1 年 | preload 最低要求 | 续期失败影响面大 |
| 63072000 | 2 年 | 极少建议 | 证书事故恢复窗口过长 |
为什么 31536000 是分水岭?据 hstspreload.org 的提交规则,进入 Chromium 预加载列表要求 max-age ≥ 31536000、包含 includeSubDomains、包含 preload,且主域与所有子域都能完成 HTTPS 跳转;而 15768000(6 个月)对应 Qualys SSL Labs 评分细则里 HSTS 一项的满分门槛。RFC 6797 §6.1.1 明确规定 max-age 是”强制 HTTPS 的秒数”,且浏览器不提供任何撤销按钮——这就是 63072000 几乎不该用的原因:一旦证书过期,Chrome 会直接报 NET::ERR_CERT_DATE_INVALID 并提示 “You cannot visit … because the website uses HSTS”,用户连”继续前往”都点不了。
选型第一条看证书自动化程度。Let’s Encrypt + certbot/acme.sh 自动续期 + 到期前 21 天告警,可以上 31536000;手工续费的商业证书先停在 2592000,把续期流程自动化后再提升。第二条看子域规模。子域少于 10 个且全部自建,可以开 includeSubDomains;存在 SaaS CNAME、仅支持 HTTP 的 IoT 设备、借用公网后缀的内网域名时,一律不开。
| 下发位置 | 版本要求 | 覆盖错误响应 | 典型坑 |
|---|---|---|---|
Nginx add_header |
1.7.5+(always) | 是 | location 覆盖导致丢失 |
Apache mod_headers |
2.4 | 是(always set) |
误用 Header set |
| Tomcat Filter | 8.0+ | 是 | hstsEnabled 默认 false |
| IIS 原生 HSTS | IIS 10 | 是 | 低版本无此功能 |
| Cloudflare 边缘 | 全版本 | 是 | Flexible 模式重定向循环 |
最隐蔽的坑在 Nginx 的继承规则:只要某个 location 里出现任意 add_header,父级 http/server 层的 add_header 就全部失效;always(1.7.5+)只保证 4xx/5xx 也下发,并不能救回继承丢失。所以建议把 HSTS 单独成文件并在 server 层 include:
# /etc/nginx/conf.d/hsts.conf —— 适用 nginx 1.7.5+,旧版本去掉 always
# 灰度:先 300 秒,观察日志确认无协议回退依赖
# add_header Strict-Transport-Security "max-age=300" always;
# 稳定:一年 + 覆盖子域(浏览器会按此值缓存,下发即不可撤回)
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
# Apache httpd 2.4+(a2enmod headers)必须用 always set,
# 用 Header set 时 4xx/5xx 响应不带 HSTS,等价于漏配
# Header always set Strict-Transport-Security "max-age=2592000"
# 验证下发结果(含错误页)
curl -sI https://example.com/ | grep -i strict-transport-security
curl -sI https://example.com/no-such-page | grep -i strict-transport-security
# 期望:strict-transport-security: max-age=31536000; includeSubDomains
preload 只对”品牌主域 + 长期不做协议回退”的站点有意义;测试域名、灰度域名、即将下线的业务域名不要提交,据 hstspreload.org 说明,加入与移除都要经过浏览器版本发布周期,下线后仍会被强制 HTTPS 访问数月。
最后区分职责:HSTS 只负责首跳(HTTP→HTTPS)升级,CSP 的 upgrade-insecure-requests 负责子资源升级,OCSP Stapling 负责握手性能。用 HSTS 去解决混合内容问题,是这三者最常见的误用。
HSTS preload 的申请与退出:配置方法里最容易踩坑的一环
提交 preload 前,一条 curl 能查出哪些不合格项?
hstspreload.org 的自动检查逐项扫描,任何一项失败都会在页面上列出具体原因。手动预检只需三条命令,据 hstspreload.org 的提交要求,响应头必须同时含 max-age ≥ 31536000(一年,单位是秒;RFC 6797 规定 max-age=0 表示删除策略)、includeSubDomains、preload 三个要素,缺一不可:
# 1) 主域响应头:三要素必须同时出现
curl -sI https://example.com | grep -i '^strict-transport-security'
# 期望输出:strict-transport-security: max-age=31536000; includeSubDomains; preload
# 2) 裸域与所有子域的 HTTP 访问都必须 301 到 HTTPS
curl -sI http://example.com | head -n1 # 期望 HTTP/1.1 301 Moved Permanently
curl -sI http://www.example.com | head -n1 # 子域同样要跳转
curl -sI http://legacy.example.com | head -n1 # 任意子域,包括历史遗留的业务域名
# 3) 查询官方状态 API(只读,无需鉴权)
curl -s 'https://hstspreload.org/api/v2/status?domain=example.com'
# 返回示例:{"status":"pending","bulk":false}
# status 取值:unknown(未提交)/ pending(已入队未进浏览器)/ preloaded(已在内置列表)
注意 includeSubDomains 一旦生效,所有子域(含 test.example.com、intranet.example.com)都必须能提供有效证书,否则浏览器直接硬失败、用户无法点击”继续访问”。这是 preload 决策里最常被低估的风险点。
从 pending 到真正生效要多久?不能假设”提交即生效”
- Wildcard 通配符 SSL 证书安装部署续费申请
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
- APP/小程序 HTTPS · SSL网站加密证书 · CA证书配置
- 服务器维护 · 网站代维护 · 服务器托管代维
据 Chromium 文档,preload 列表硬编码在浏览器二进制里,只能随版本发布更新。Chromium 约每 6 周一个里程碑,从 pending 到 preloaded 常见 1–3 个月;其它浏览器以 Chromium 维护的列表为上游,但导入节奏各自独立。
| 浏览器 / 列表来源 | 生效延迟 | 移除延迟 | 备注 |
|---|---|---|---|
| Chrome / Edge / Opera / Brave(Chromium 内置列表) | 约 1–3 个里程碑(6 周/个) | 同样以里程碑计,常需 2 个以上 | 上游列表,改动先落在这里 |
| Firefox | 跟随其导入版本,通常滞后一个周期 | 同左 | 不同步导入 Chromium 列表 |
| Safari / WebKit(macOS、iOS) | 随系统或 Safari 更新,可能更久 | 受系统版本更新节奏拖累 | 旧系统设备上残留时间最长 |
退出 preload 为什么被称作”不可回退”?
退出要两步同时做:在 hstspreload.org 提交 removal,并把响应头改成 max-age=0。前者把你从列表里摘掉,后者清掉已下发到用户 HSTS 缓存里的策略。但据 Chromium 文档,列表移除同样要等浏览器版本更新,周期以月计,这段时间内用户仍被强制 HTTPS。因此典型事故是:域名曾在实验期被 preload,后来要迁到不支持 HTTPS 的老 CDN 或对象存储自定义域,迁移当天全站不可访问且无法回滚。
# 退出阶段的 Nginx 过渡配置(add_header 的 always 参数需 nginx ≥ 1.7.5,
# 否则 4xx/5xx 响应不会带上该头)
server {
listen 443 ssl;
server_name example.com;
# 去掉 includeSubDomains 与 preload,max-age 归零以清除浏览器缓存中的策略
add_header Strict-Transport-Security "max-age=0" always;
# 迁移窗口内确认不再无条件强制跳转
# return 301 https://$host$request_uri;
}
Apache 对应写法为 Header always set Strict-Transport-Security "max-age=0"(需启用 mod_headers);IIS 则在 web.config 的 <system.webServer><httpProtocol><customHeaders> 中增删同名条目,改完执行 iisreset 或回收应用程序池。
把 preload 当性能优化是方向性错误吗?
是。preload 不提升 SEO 排名,也不减少 TLS 握手开销,它唯一的收益是消除首次访问时的明文请求(Chrome 中那次 307 Internal Redirect),把一次 RTT 的重定向省掉。真正的性能项是 OCSP Stapling、TLS 1.3、HTTP/2 与证书链精简——preload 只值最后那几毫秒,代价却是长期的不可逆约束。
HSTS 配置方法常见错误与真实报错排查
为什么开了 HSTS 后浏览器报 ERR_TOO_MANY_REDIRECTS,而服务器日志里只有一个 301?这类重定向环几乎都发生在”边缘已加密、回源却是明文 HTTP”的架构里。典型组合是 Cloudflare 的 SSL/TLS 加密模式为 Flexible:边缘对访客返回 301 到 https,回源时却用 http 请求源站,源站的 HSTS 配置方法里通常又写了一条 80→443 的 301,应用据此再次跳转,浏览器看到的就是无限环。先看跳转链再动手:
# 分别观察明文与 HTTPS 入口的响应头,重点看 Location 与 Strict-Transport-Security
curl -sI http://example.com | grep -iE '^(HTTP/|location|strict-transport-security)'
curl -sI https://example.com | grep -iE '^(HTTP/|location|strict-transport-security)'
# 若源站应用依赖反向代理传来的协议判断是否跳转,检查该头是否被 LB 丢掉
curl -sI https://example.com -H 'X-Forwarded-Proto: https'
如果 http:// 返回 301 而 https:// 仍返回 301,且源站日志记录的请求协议是 http,就基本可确认是 X-Forwarded-Proto 丢失或边缘加密模式为 Flexible。把 Cloudflare 的加密模式改为 Full (strict)(回源使用 HTTPS 并校验证书),并在 Nginx 中显式传递协议头。据 Mozilla SSL Configuration Generator 与 Let’s Encrypt 文档,回源链路的证书同样需要有效,否则 Full (strict) 会直接 526。
HSTS 生效后证书过期,为什么用户”无法添加例外”?这不是浏览器 bug。据 RFC 6797 §12.1,UA 对处于 HSTS 策略内的主机遇到证书错误必须终止连接,且不得提供”继续访问”的旁路入口,所以 Chrome 报 NET::ERR_CERT_DATE_INVALID、Firefox 报 SSL_ERROR_BAD_CERT_DOMAIN 时用户只能等修复。运维应在证书到期前用命令自查,而不是等告警:
# 输出了 Not After 与 SAN,就能确认是否临期、域名是否漏配
openssl s_client -connect example.com:443 -servername example.com /dev/null
| openssl x509 -noout -dates -subject -ext subjectAltName
头明明配了,curl 里却搜不到 Strict-Transport-Security?按四个方向顺序排查:
- 写错了 server 块——写在
listen 80的块里等于没写,浏览器只在 HTTPS 响应上采纳该头; - Nginx 的
add_header继承被切断:location 内出现任何add_header后,server 级的所有add_header都不再下发,需要在该 location 内补一份,并加always保证 4xx/5xx 也带上; - CDN 或反向代理剥离了该响应头(部分 WAF 默认不转发未知安全头);
- 应用层输出了同名头把边缘的值覆盖掉。
server {
listen 443 ssl;
server_name example.com;
# 灰度起步:先给 300 秒,验证无跳转环后再逐步放大到 31536000
add_header Strict-Transport-Security "max-age=300" always;
location /api/ {
add_header Cache-Control "no-store" always;
# location 内一旦出现 add_header,server 级的 HSTS 会被切断,必须重写
add_header Strict-Transport-Security "max-age=300" always;
}
}
Apache 侧对应写法是 Header always set Strict-Transport-Security "max-age=300"(always 不可省,否则 3xx/4xx 响应不带该头),需 mod_headers 已启用。
curl 输出两行同名头怎么办?Nginx 与应用各下发一份时,浏览器只处理第一条,灰度阶段极易误判实际生效的 max-age。用计数确认,期望值为 1:
curl -sI https://example.com | grep -ci strict-transport-security
HSTS 已生效但控制台还报 Mixed Content?HSTS 只把导航请求升级到 HTTPS,页面内 <img>、<script>、XHR 的绝对 http:// 地址不会被改写。据 MDN 文档,应配合 CSP 的 upgrade-insecure-requests 指令,或直接改资源地址:add_header Content-Security-Policy "upgrade-insecure-requests" always;。
测试域名打不开、浏览器又不给跳过?说明它已被 includeSubDomains 覆盖,例如主域下发 max-age=31536000; includeSubDomains 后,test.example.com 同样受策略约束。临时方案是换一个不在覆盖范围内的域名验证;长期方案是把测试域拆到独立注册域,或在灰度期先不加 includeSubDomains、不加 preload——preload 名单移除周期长,写入前务必确认所有子域(含内网、邮件、IoT 面板)都已全站 HTTPS。
| 报错 / 现象 | 根因 | 定位命令 |
|---|---|---|
| ERR_TOO_MANY_REDIRECTS | 边缘 Flexible 回源 + 源站 301,或 X-Forwarded-Proto 丢失 | curl -sI http://example.com 看 Location 链 |
| NET::ERR_CERT_DATE_INVALID | HSTS 策略内证书过期,RFC 6797 禁止绕过 | openssl s_client ... | openssl x509 -noout -dates |
| grep 不到 HSTS 头 | 写在 80 块、add_header 继承被切断、代理剥离 | curl -sI https://example.com | grep -i strict |
| 出现两行同名头 | Nginx 与应用各一份,浏览器只认第一条 | curl -sI ... | grep -ci strict-transport-security |
| Mixed Content | HSTS 不升级页面内子资源 | 加 CSP upgrade-insecure-requests |
上面每一条都指向同一个原则:HSTS 配置方法的难点不在写对那一行头,而在于确认”哪一层真正把这一行头送到了浏览器”。灰度期把 max-age 压到 300 秒、用 grep -ci 保证只有一条、逐条核对 Location 链,比事后回滚要便宜得多。
HSTS 配置方法的效果验证:确认配置真正生效的 4 种手段
上一节给出的 hsts 配置方法只解决”指令怎么写进响应头”,而 HSTS 本质是浏览器端策略:头没到客户端、没进本地 STS 存储,就等于没配。下面 4 种手段从服务端逐层收口到浏览器,建议按顺序执行,最后补一条多节点回归。
手段一:curl 查响应头与跳转
# 1) HTTPS 响应里必须带完整指令;头名不区分大小写,grep -i 即可
curl -sI https://example.com | grep -i strict-transport-security
# 期望:strict-transport-security: max-age=31536000; includeSubDomains
# 2) HTTP 侧必须 301 且 Location 以 https:// 开头
curl -sI http://example.com | sed -n '1p;/^[Ll]ocation/p'
# 期望:HTTP/1.1 301 Moved Permanently / Location: https://example.com/
据 RFC 6797 §8.1,浏览器只处理”安全传输上收到”的 STS 头,HTTP 响应里的 HSTS 头会被直接丢弃——所以第 2 步只能验跳转,不能验 HSTS。Nginx 有个高频坑:add_header 默认只对 200/201/204/206/301/302/303/304/307/308 生效,错误页上不会带该头,需加 always(Nginx 1.7.5+ 起支持):add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
手段二:TLS 会话内验证,排除”只在首页下发”
# 用真实握手对深路径发 HEAD,验证头不是只挂在 location / 上(-alpn 需 OpenSSL 1.0.2+)
printf 'HEAD /account/settings HTTP/1.1rnHost: example.comrnConnection: closernrn'
| openssl s_client -connect example.com:443 -servername example.com -alpn http/1.1 -quiet 2>/dev/null
| grep -i strict-transport-security
# 顺带确认 ALPN 协商结果(HSTS 与 h2 无耦合,同一次握手可一并查)
openssl s_client -connect example.com:443 -servername example.com -alpn h2 /dev/null | grep -i "ALPN protocol"
# 期望:ALPN protocol: h2
与 curl 的区别在于:s_client 绕开了 ~/.curlrc 里的代理、HTTP/2 连接复用和 curl 缓存,能证明头是从这条 TLS 连接的应用数据里读出来的。
手段三:浏览器本地 STS 存储
- Chrome:访问
chrome://net-internals/#hsts,在 “Query HSTS/PKP domain” 输入域名,应看到max-age、include_subdomains、preloaded三个字段。再在地址栏输入http://example.com,应直接变 https,DevTools 网络面板显示307 Internal Redirect(Non-Authoritative HSTS)——注意该请求不落服务器访问日志,用它判断”服务端没收到请求”是否正常。 - Firefox:
about:support→ 打开配置文件夹 →SiteSecurityServiceState.txt,可看到形如example.com:HSTS 0 1735689600000 1,1的条目,第三列是毫秒级过期时间戳,倒推即可核对 max-age 是否与配置一致。该文件在关闭标签页后落盘,验证前先关掉站点页面。
手段四:第三方复核与 preload 状态
据 Qualys SSL Labs 评分文档,HSTS 一项需为绿色;拿 A+ 要求 max-age ≥ 15768000 秒(6 个月)并带 includeSubDomains。而据 hstspreload.org,提交进 Chrome preload 列表的门槛更高:max-age ≥ 31536000(1 年)+ includeSubDomains + preload 三者齐备,且所有子域可正常 HTTPS 访问,否则会被退回。
| 手段 | 验证层次 | 入口 | 能证明 | 盲区 |
|---|---|---|---|---|
| curl -sI | HTTP 响应头 | 命令行 | 头名、指令拼写、跳转链 | 可能走代理/缓存;只测了首页 |
| openssl s_client | TLS 会话内应用数据 | 命令行 | 真实握手、深路径同样下发 | 不验证浏览器是否存储 |
| net-internals / SiteSecurityServiceState | 浏览器 STS 存储 | Chrome / Firefox | 已解析的 max-age、子域、preloaded | 只反映本机当前 profile |
| SSL Labs / hstspreload.org | 公网扫描与列表 | 网页 | 公网可达性、评分、preload 收录 | 结果有缓存,可能滞后数小时 |
灰度期必做:按节点直连回归
# --resolve 跳过 DNS 与 CDN 缓存,逐个节点核对(curl 7.21.3+)
for ip in 1.2.3.4 5.6.7.8; do
printf '== %s ' "$ip"
curl --resolve example.com:443:$ip -sI https://example.com | grep -i strict-transport-security || echo "缺失!该节点未生效"
done
每次调整 max-age 或追加 includeSubDomains 后都跑一遍这套 hsts 配置方法的验证链:只要有一个节点输出为空,就说明灰度没走完,此时若已提交 preload 申请,撤回成本会远高于等待。
HSTS 配置方法与相关安全头的组合、监控与长期维护
HSTS 能不能顺便把页面里的 http:// 子资源也管住?不能,这是最常见的误解。HSTS 定义在 RFC 6797,作用范围只有「浏览器对该主机的后续导航请求」——它把用户手输的 http://example.com、旧书签、外部 HTTP 链接在发请求之前就改写成 HTTPS,消掉的是首跳的 301 明文窗口。页面内 <img src="http://cdn..."> 这类混合内容属于 CSP 的 upgrade-insecure-requests 管辖;握手阶段的 OCSP 查询延迟则由 OCSP Stapling 解决。三者作用层不同,必须分别配置,不能互相替代。
| 机制 | 作用层 | 解决的问题 | 配置位置 | 配错代价 |
|---|---|---|---|---|
| HSTS(RFC 6797) | 浏览器导航 | 首跳明文、书签降级 | 响应头 | max-age 内无法回退 HTTP |
CSP upgrade-insecure-requests |
页面子资源 | 混合内容 | 响应头 / <meta> |
低,删掉即恢复 |
| OCSP Stapling | TLS 握手 | 吊销查询延迟与隐私泄露 | ssl_stapling on; |
低,失败时降级为不装订 |
| HPKP(RFC 7469) | 证书固定 | CA 误签 | 响应头 | 极高,已废弃 |
| CAA(RFC 8659) | CA 签发授权 | 任意 CA 误签 | DNS | 中,写错会导致签发被拒 |
为什么不要顺手配 HPKP?RFC 7469 定义的 Public-Key-Pins 自 Chrome 69(2018 年 9 月)起已移除支持,Firefox 也默认禁用;它要求你在 max-age 窗口内始终持有至少一个备用 SPKI 指纹,一旦备份密钥丢失或轮换失误,站点在窗口期内对所有曾访问过的浏览器完全不可访问,且无法远程撤销。新项目直接跳过,用 CAA 记录替代「只允许指定 CA 签发」这一诉求。
; BIND 区域文件示例:与 HSTS 组成「只能 HTTPS + 只能指定 CA」双保险
; TTL 300 便于出错时快速修正;CAA 由 Let's Encrypt 在每次签发时检查(RFC 8659)
example.com. 300 IN CAA 0 issue "letsencrypt.org"
example.com. 300 IN CAA 0 issuewild "letsencrypt.org" ; 未写 issuewild 时 issue 同样约束通配符证书
example.com. 300 IN CAA 0 iodef "mailto:security@example.com"
监控要盯哪三项,阈值为什么这么定?Let’s Encrypt 证书有效期 90 天、官方在剩余 30 天时自动续期,所以到期告警设在 提前 21 天——正常续期不会触发,一旦触发就说明 ACME 流程已失败,而你还有 21 天在 HSTS max-age 窗口内修复。再加每 5 分钟一次的 HTTPS 200 拨测与证书链完整性检查:
# 1) 到期时间(告警阈值:剩余 < 21 天)
openssl s_client -connect example.com:443 -servername example.com /dev/null
| openssl x509 -noout -subject -enddate
# 2) 链完整性:必须输出 "Verify return code: 0 (ok)"
# 常见故障:verify error:num=21:unable to verify the first certificate(缺中间证书)
openssl s_client -connect example.com:443 -servername example.com -showcerts &1
| grep -E "Verify return code|verify error"
# 3) 拨测:返回 "200 0.123" 即正常
curl -sS -o /dev/null -w '%{http_code} %{time_total}n' --max-time 5 https://example.com/
怎么避免手工改 Nginx 造成的配置漂移?把 HSTS 头写进模板,值走变量,并在 CI 里做语法门禁。add_header 的 always 参数(Nginx 1.7.5+)不可省——缺省时该头只对 2xx/3xx 生效,4xx/5xx 页面不会带 HSTS:
# roles/nginx/templates/hsts.conf.j2
# hsts_max_age 默认 300(灰度),目标 63072000(2 年)
# 提交 preload 列表要求 max-age >= 31536000 且同时含 includeSubDomains 与 preload
add_header Strict-Transport-Security "max-age={{ hsts_max_age }}; includeSubDomains{{ '; preload' if hsts_preload else '' }}" always;
# 上线前门禁
nginx -t # 期望:configuration file /etc/nginx/nginx.conf test is successful
apachectl configtest # 期望:Syntax OK
交接时最该留下的是什么?不是配置文件本身,而是运维手册里这几项状态:当前 max-age 数值与灰度计划表、includeSubDomains 是否开启(以及是否已核查全部子域都有证书)、是否已提交 preload、提交日期,以及 removal 流程(preload 移除需在 hstspreload.org 提交申请并等待浏览器版本更新,周期以月计)。据 Chromium 的 HSTS preload 提交规范,移除请求的处理时间远长于添加,这一条必须写进变更评审。
灰度期用 300 秒,稳定后按 86400 → 2592000 → 31536000 秒阶梯提升,每段至少观察 24 小时到 7 天。只有需要提交 preload 时才必须 ≥ 31536000 秒;证书续期尚未自动化的团队建议先停在 2592000 秒(30 天)。
301 是服务器端行为,用户第一次输入 http:// 时仍会发出一次明文请求,可能被 SSL Strip 类攻击劫持;HSTS 是浏览器本地记住策略,后续直接走 HTTPS,Chrome 中表现为 307 Internal Redirect,不再发出明文请求。两者要一起用,HSTS 不能替代 301。
不能。HSTS 站点在证书错误(过期、域名不匹配、自签名)时,Chrome 和 Firefox 都会移除绕过入口,用户只能看到 NET::ERR_CERT_DATE_INVALID 之类的错误页。所以配 HSTS 前必须先把证书自动续期和到期告警做起来。
如果 SSL/TLS 模式是 Flexible,边缘对用户是 HTTPS、回源是 HTTP,源站再 301 到 HTTPS 就会形成无限重定向,浏览器报 ERR_TOO_MANY_REDIRECTS。正确做法是把模式改成 Full (strict)、给源站装好证书,再开启 HSTS。
可以撤销,但要两步:在 hstspreload.org 提交 removal,同时把响应头改成 max-age=0。据 Chromium 文档,移除要等浏览器版本更新,周期以月计,期间用户仍被强制 HTTPS,所以提交前要按「不可回退」评估。
常见原因有四个:头加在了 80 端口的 server 块里、Nginx 子级 location 的 add_header 切断了继承、没加 always 导致 4xx/5xx 响应不带头、CDN 或反向代理剥离了该响应头。先用 curl -sI https://example.com 看状态码,再逐项排除。
HPKP 不要配,RFC 7469 的 Public-Key-Pins 自 Chrome 69 起已移除支持,误配风险很高。OCSP Stapling 与 HSTS 无依赖关系,但能减少握手时的吊销查询,建议在 Nginx 上用 ssl_stapling on 配合。HSTS 只负责强制 HTTPS,混合内容要靠 CSP 解决。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。