跳到主要内容
安装配置教程

HSTS 配置方法实战:max-age 灰度、includeSubDomains 与 preload 的 Nginx/Apache/IIS 全流程

hsts 配置方法 — 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 到真正生效要多久?不能假设”提交即生效”

据 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?按四个方向顺序排查:

  1. 写错了 server 块——写在 listen 80 的块里等于没写,浏览器只在 HTTPS 响应上采纳该头;
  2. Nginx 的 add_header 继承被切断:location 内出现任何 add_header 后,server 级的所有 add_header 都不再下发,需要在该 location 内补一份,并加 always 保证 4xx/5xx 也带上;
  3. CDN 或反向代理剥离了该响应头(部分 WAF 默认不转发未知安全头);
  4. 应用层输出了同名头把边缘的值覆盖掉。
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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。