跳到主要内容
基础知识

HSTS Preload 提交怎么做:从响应头到浏览器收录的完整实操指南

hsts preload 提交 — HSTS Preload 提交怎么做:从响应头到浏览器收录的完整实操指南
核心结论

直接回答:HSTS Preload 提交不是单独提交动作,而是先让 https://example.com 返回 Strict-Transport-Security: max-age=31536000; includeSubDomains; preload,再到 hstspreload.org 提交根域名;Chrome 收录通常要等数周至数月,并非提交后立即生效。 最低合规参数是 max-age≥31536000 秒(1 年)、包含 includeSubDomains 与 preload;hstspreload.org 还要求 HTTP→HTTPS 跳转、证书有效、所有子域可 HTTPS 访问。 Nginx 1.25.x 用 add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains; preload' always;,Apache 2.4.58 用 Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains; preload",改完用 curl -sSI 与 openssl s_client 验证。 提交前用 for h in www api static; do curl -sSI https://$h.example.com; done 扫子域;提交后在 hstspreload.org 查状态,并在 chrome://net-internals/#hsts 查询域名策略。 回滚比上线慢:HSTS 预加载列表移除需提交删除请求并等待浏览器版本更新,max-age=0 只能影响未预加载的客户端,不能立即清除已预加载域名。

为什么 HSTS Preload 提交后浏览器仍可能不走 HTTPS?问题背景与根本原因

问:为什么我明明配了 HSTS,浏览器第一次访问还是先发 HTTP?

因为 HSTS 不是”安装即生效”的开关,而是服务器通过 HTTPS 响应头下发的一条策略缓存。据 RFC 6797 §6.1,Strict-Transport-Security 头只有三个参数:max-age(必需,单位秒)、includeSubDomains、preload。浏览器在第一次成功收到该头之前没有任何记忆,首个请求仍可能以 http:// 发出,并在到达服务器前被中间人降级——这正是 Preload 要解决的问题:把域名硬编码进浏览器自带的预加载列表,让”第一次”也强制走 HTTPS。反过来说,响应头里不写 max-age 等于根本没启用 HSTS;写 max-age=0 是撤销指令,不是”关闭开关”。

问:hstspreload.org 是配置页面吗?我在上面点了提交为什么没反应?

它不是配置面板,而是资格检查 + 提交入口。它只做两件事:校验你的域名是否满足 Chromium 的收录条件,然后把域名写进待审队列。检查项包括:根域必须能从 HTTP 301/308 跳到 HTTPS;max-age ≥ 31536000(一年);包含 includeSubDomains 与 preload;证书有效且覆盖所有子域;所有子域均可通过 HTTPS 访问。任一项不满足就会给出具体报错,例如 The HSTS header's max-age is less than 31536000.、The `includeSubDomains` directive is missing.。据 Chromium HSTS Preload 文档,提交的是域名本身,不接受带路径、端口或 www. 前缀的地址——提交 https://www.example.com/ 是无效的,应提交 example.com。

问:为什么源站 curl 有头,浏览器/线上却看不到?

最常见的四个根因,按排查顺序排列:

  • 只在 www 或某个 location 下发头。Nginx 的 add_header 继承规则是”仅当本层级没有任何 add_header 时才继承上层”,据 Nginx 官方文档,location 里只要写了一条任意 add_header,server 级的 HSTS 就不再下发。需要在每个写了 add_header 的层级重复声明,或改用 map + headers-more 模块统一注入。
  • CDN / 负载均衡 / WAF 覆盖、剥离或缓存了该头。必须分别验证边缘与源站,不能只看某一台回源机。
  • 子域、证书或混合内容不达标。includeSubDomains 一旦随 Preload 生效,所有子域都被强制 HTTPS;证书 SAN 缺子域、子域 HTTPS 跳回 HTTP、页面里残留 http:// 资源都会让检查失败。
  • 把”提交成功”当成”立即生效”。提交后通常先显示 pending,之后随 Chrome/Edge 版本发布才进入列表,Firefox 的列表更新节奏完全独立。移除同样要走删除请求并等版本更新,max-age=0 清不掉已经预加载的域名。
# 1) 直连源站,确认头确实存在(把 IP 换成源站真实地址,绕过 CDN)
curl -sSI --resolve example.com:443:203.0.113.10 https://example.com 
  | grep -i '^strict-transport-security'
# 期望输出:strict-transport-security: max-age=31536000; includeSubDomains; preload

# 2) 走 CDN 边缘,确认没有被剥离或改写(两者输出必须一致)
curl -sS -o /dev/null -D - https://example.com | grep -i '^strict-transport-security'

# 3) 确认 HTTP 是 301/308 跳 HTTPS,而不是 200 或 302
curl -sSI http://example.com | head -n 3

# 4) 抽查子域,includeSubDomains 一旦预加载就没有退路
for h in www api static; do
  echo "== $h.example.com"; curl -sSI "https://$h.example.com" | head -n 1
done

Nginx 侧的正确写法(always 参数自 1.7.5 起可用,保证 4xx/5xx 响应也带头;不加则只在 2xx/3xx 生效):

server {
    listen 443 ssl;
    server_name example.com www.example.com;

    # server 级:所有"自己没有 add_header"的 location 会继承这一行
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload" always;

    location /assets/ {
        add_header Cache-Control "public, max-age=86400";
        # 本层出现了 add_header,上面那行不再继承,必须原样重复
        add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload" always;
    }
}
检查项 通过条件 典型失败表现
max-age ≥ 31536000 秒 报错 max-age is less than 31536000
includeSubDomains 头中显式出现 报错 directive is missing;子域仍可 HTTP 访问
preload 头中显式出现 hstspreload.org 拒绝提交
HTTP 跳转 根域 301/308 → HTTPS 302 临时跳转、跳转链过长
证书 SAN 覆盖根域与全部在用子域 curl 报 certificate subject name does not match
提交格式 纯域名,无路径/端口/www 提交被忽略或提示格式无效

一句话判断标准:只有当边缘节点和源站、根域和每个子域、HTTP 与 HTTPS 三条链路都返回同一个合格的头时,做 hsts preload 提交才有意义;否则提交上去也只是拿到一个 pending 后长期不动的记录。

HSTS Preload 提交完整实操步骤:从子域盘点到 hstspreload.org 收录

第一步:你的域名资产里有没有只能跑 HTTP 的子域?HSTS 的 includeSubDomains 一旦生效,所有子域(含已下线但 DNS 仍在解析的旧活动页、测试环境、内网穿透入口)都会被浏览器强制走 HTTPS;而 preload 名单的移除要等浏览器版本更新,往往数月。所以先批量探测,别凭记忆:

# 逐个探测子域能否完成 TLS 握手,只看状态行
for h in www api static mail legacy-test promo2021; do
  echo "== $h"
  curl -sSI --max-time 10 "https://$h.example.com" | head -n 1
done
# 无输出 / 超时 / curl: (60) SSL certificate problem = 该子域不能上 HTTPS
# 处理顺序:先迁移或下线(删除 DNS 记录并确认无流量),再谈提交

据 Chrome 的 HSTS Preload 提交页(hstspreload.org)说明,提交即表示你确认所有子域都支持 HTTPS。注意 includeSubDomains 与 preload 都是显式 opt-in 指令,默认不存在;max-age 没有默认值,不发头就等于不启用 HSTS(RFC 6797 §6.1.1)。

第二步:跳转和证书链干净吗?两个方向都要查——HTTP 必须跳 HTTPS,HTTPS 不能反向跳回 HTTP(否则形成重定向循环,浏览器会报 ERR_TOO_MANY_REDIRECTS):

curl -sSI http://example.com | head -n 5        # 期望 301 或 308,且 Location: https://example.com/
curl -sSI https://example.com | grep -i '^location'   # 不应出现 Location: http://
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null
# 期望输出包含:Verify return code: 0 (ok)
# 若为 21 (unable to verify the first certificate),说明没发中间证书

证书文件按 Let’s Encrypt 文档的约定使用 fullchain.pem(叶子证书 + 中间证书)配 privkey.pem,只发 leaf 会让 Android 7 及部分 Java 客户端直接握手失败。

第三步:max-age 为什么要灰度?因为它是单向阀——已经收到头的浏览器在 max-age 内不会回退。下表是实际可用的四档节奏:

阶段 Strict-Transport-Security 取值 建议观察期 回滚成本
灰度 max-age=300 24–48 小时 极低,改头即生效
扩大 max-age=86400 24–48 小时 低
生产 max-age=31536000; includeSubDomains 7 天 高,只能下发 max-age=0 等旧策略过期
提交前 max-age=31536000; includeSubDomains; preload ≥7 天且无告警 极高,名单移除需等版本更新

灰度期重点盯三件事:证书自动续期是否成功、旧客户端(XP/Win7 老浏览器、老旧 SDK)报错量、监控探针是否因强制 HTTPS 失联。hstspreload.org 要求 max-age 至少 31536000 秒(1 年),低于此值会被直接拒收。

第四步:加 preload 后怎么确认每个入口都生效?用循环比对,值必须完全一致:

# 根域、www 与至少 3 个子域应返回同一行头部
for h in example.com www.example.com api.example.com static.example.com mail.example.com; do
  printf '%-24s ' "$h"
  curl -sSI "https://$h" | grep -i '^strict-transport-security' || echo 'MISSING'
done

用 CDN 时先清边缘缓存;Cloudflare 的 HSTS 开关(SSL/TLS → Edge Certificates)会自己写头并覆盖源站,需在面板里同样勾选 includeSubDomains + preload 并设 max-age ≥ 31536000,或关闭该开关交由源站下发。

第五步:hstspreload.org 到底填什么?只填根域 example.com——不要填 https:// 前缀、不要带 :443、不要填 www.example.com(子域由 includeSubDomains 覆盖)。页面会逐条校验并阻断,典型提示形如 “Error: The HSTS header must contain the preload directive.”“Error: The max-age must be at least 31536000 seconds.”“Warning: The following subdomains are not served over HTTPS”。多 CDN 区域或多负载均衡入口的站点,逐入口验证后再提交。

第六步:提交后怎么跟踪与回滚?记录提交日期、根域、负责人和状态页快照;状态会从 pending 变为 preloaded,进入 Chrome 稳定版通常要数周到数月,取决于发布节奏。这段时间不要删除 HTTP→HTTPS 跳转,也不要用 302 代替 301/308。若发现子域故障,优先修证书或彻底下线该子域(清空 DNS 并确认无流量),再评估在 hstspreload.org/removal 提交移除请求——移除同样要等浏览器更新,且已内置名单的客户端在策略过期前仍会强制 HTTPS。最后提醒:preload 是加速首次访问的补充手段,提交后仍需持续下发 HSTS 响应头。

配置与命令示例:Nginx、Apache、OpenSSL 与 preload 参数怎么写

为什么我明明加了 add_header,线上却看不到 HSTS 头?大概率是 Nginx 的继承规则在作怪。先看一份可直接落地的 Nginx 1.25.x 配置:

# /etc/nginx/conf.d/example.com.conf(Nginx 1.25.x)
server {
    listen 443 ssl;
    http2 on;                                  # 1.25.1+ 新语法,替代 listen ... http2
    server_name example.com www.example.com;

    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    # always 自 Nginx 1.7.5 起可用:让 4xx/5xx 响应也带上 HSTS
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload" always;

    location / { try_files $uri $uri/ =404; }
}

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;       # 先把 80 全部收敛到 HTTPS
}

坑点在继承:据 Nginx 官方 ngx_http_headers_module 文档,add_header 仅在”当前层级没有任何 add_header 指令”时才继承上一级。也就是说,一旦你写了 location / { add_header X-Frame-Options SAMEORIGIN; },server 级的 HSTS 就整个消失了。稳妥做法是把 HSTS 抽成片段,在每个声明过 add_header 的 location 里 include 一次:

# /etc/nginx/snippets/hsts.conf
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload" always;

# 在 location 中复用:include /etc/nginx/snippets/hsts.conf;

Apache 2.4.58 的等价写法(Header always set 同样能覆盖错误响应,普通 Header set 在 4xx/5xx 上会丢):

sudo a2enmod headers ssl                       # 两个模块缺一不可
# /etc/apache2/sites-available/example.com.conf
<VirtualHost *:443>
    ServerName example.com
    ServerAlias www.example.com
    SSLEngine on
    SSLCertificateFile    /etc/letsencrypt/live/example.com/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
    Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains; preload"
</VirtualHost>
<VirtualHost *:80>
    ServerName example.com
    ServerAlias www.example.com
    Redirect permanent / https://example.com/
</VirtualHost>

改完怎么验证?三条命令覆盖头、跳转、TLS 三个层面:

sudo nginx -t && sudo nginx -s reload        # Apache:sudo apachectl -t && sudo systemctl reload apache2

curl -sSI https://example.com | grep -i '^strict-transport-security'
# 期望:strict-transport-security: max-age=31536000; includeSubDomains; preload

curl -sSI -o /dev/null -w '%{http_code} %{redirect_url}n' http://example.com
# 期望:301 https://example.com/

openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null
# 关注两行:Verify return code: 0 (ok) 与 Protocol: TLSv1.3

如果你的站点在 CDN 后面,注意边缘与源站只能保留一处权威配置,或保持取值完全一致。Cloudflare 在 SSL/TLS → Edge Certificates → HSTS 中把 Max-Age 设为 31536000、勾选 Include subdomains 与 Preload;AWS ALB 没有原生 HSTS 开关,只能在 listener 规则里返回固定响应头,或交给应用层统一注入。常见故障是两个值混用(边缘 86400、源站 31536000)——浏览器取较短值,而且据 hstspreload.org 的提交要求,max-age 必须 ≥ 31536000 且同时含 includeSubDomains 与 preload 才会被受理。

部署位置 配置方式 关键注意点
Nginx 1.25.x add_header ... always 子级 location 出现 add_header 即断开继承
Apache 2.4.58 Header always set 需 a2enmod headers,否则静默失效
Cloudflare Edge Certificates → HSTS 勾 Preload 等同 preload 指令,源站勿再重复下发冲突值
AWS ALB Listener 固定响应 / 应用层 无原生 HSTS 参数,易与 CDN 配置双重下发

HSTS Preload 与 301 跳转、Cloudflare HSTS 怎么选?参数对比表

先把结论摆在前面:301/308 跳转解决的是”用户输入 http:// 时被引导到 https://”,HSTS 响应头解决的是”浏览器记住以后不再发明文请求”,而 HSTS Preload 解决的是”浏览器第一次访问就知道只能走 HTTPS”。三者不是替代关系,而是叠加关系;真正需要你决策的只有一件事——要不要把 includeSubDomains 和 preload 一起打开,因为这等于把全部子域的可用性押在你的证书自动化上。

方案 关键配置 首次访问是否受保护 子域覆盖 回滚速度 适用场景
仅 HTTP→HTTPS 301/308 return 301 https://$host$request_uri; 否,首个请求仍可能明文 需逐域配置 快 过渡期、无法控制子域
HSTS 响应头 max-age=31536000 首次 HTTPS 后生效 可选 includeSubDomains 中,等 max-age 过期或置 0 大多数站点
HSTS Preload max-age=31536000; includeSubDomains; preload 是,浏览器内置列表命中即强制 HTTPS 强制覆盖所有子域 慢,需从列表移除并等浏览器版本更新 域名资产可控、证书自动化完善
Cloudflare HSTS 边缘开关 max-age / includeSubDomains / preload 取决于边缘与客户端缓存 可覆盖代理(橙云)子域 中 已全站走 Cloudflare 的站点
HPKP 已废弃,不建议 不适用 不适用 不可控 不推荐

Q:能不能先只加 max-age,不加 includeSubDomains?能,而且这是默认推荐。如果你无法在 30 天内逐一确认 mail、旧后台、第三方托管子域都支持 HTTPS,就先只用 max-age=31536000。原因很直白:据 hstspreload.org 的提交规则,preload 指令必须与 includeSubDomains 同时出现,并且 max-age 不得小于 31536000(一年),否则提交会被直接判为不合格。也就是说,一旦你决定做 hsts preload 提交,全部子域就一起进入强制 HTTPS 状态。

# /etc/nginx/conf.d/example.conf —— Nginx 1.18+ / OpenSSL 1.1.1+ 验证
server {
    listen 80;
    server_name example.com www.example.com;
    # 301 可能被客户端改写为 GET;对 API 场景用 308 保留方法
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    server_name example.com www.example.com;

    # 阶段一:只加 max-age,观察 30 天,always 保证错误响应也带该头
    add_header Strict-Transport-Security "max-age=31536000" always;

    # 阶段二(子域全部确认后)替换为下面这行,再去提交 preload
    # add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload" always;
}

Q:预加载之后证书过期会怎样?所有子域在浏览器里直接报错、且无法”点继续访问”绕过——这是 HSTS Preload 最容易被低估的代价。所以证书续期不能只靠”certbot 装了就会自动续”,必须把校验步骤放进部署钩子。据 Let’s Encrypt 文档,certbot 2.x 使用 --deploy-hook 在成功续期后执行动作:

# 先演练,避免消耗 Let's Encrypt 的重复证书速率限制(每周每注册域 5 张)
sudo certbot renew --dry-run

# 仅在续期成功后重载;nginx -t 失败则不 reload,避免把坏配置推上去
sudo certbot renew --deploy-hook "nginx -t && systemctl reload nginx"

# /etc/cron.d/certbot 每日两次随机延迟执行(官方推荐节奏)
# 0 3 * * * root certbot renew -q --deploy-hook "nginx -t && systemctl reload nginx"

上线前用两条命令自检,别凭感觉:

# 1) 确认 HTTPS 响应里确实带上了 HSTS 头
curl -sI https://example.com | grep -i strict-transport-security
# 期望输出:strict-transport-security: max-age=31536000; includeSubDomains; preload

# 2) 抽查子域证书到期时间(mail、旧后台等都要过一遍)
openssl s_client -connect mail.example.com:443 -servername mail.example.com /dev/null 
  | openssl x509 -noout -subject -dates

Q:已经全站接了 Cloudflare,还要自己配 HSTS 吗?Cloudflare 在 SSL/TLS → Edge Certificates → HSTS 提供边缘开关,max-age 可选 6 个月(15552000,默认)到 12 个月(31536000),并可勾选 includeSubDomains 与 preload。注意两点:一是它只对代理记录(橙云)生效,DNS-only 的子域不受保护却仍会被 preload 覆盖;二是边缘下发与源站下发可能冲突,建议二者只保留一处,避免 max-age 值互相覆盖导致回滚判断失准。回滚时把 max-age 置 0 只是让浏览器”逐步忘记”,已缓存的一年期限不会立刻失效。

成本与时间:hstspreload.org 提交本身免费;证书可用 Let’s Encrypt 免费,OV 单域常见约 200–800 元/年、通配符约 800–3000 元/年(以 CA 与代理商报价为准)。真正花钱的是子域盘点、证书自动化改造和回滚窗口——这三项做不扎实,免费方案反而最贵。

Q:能不能用 HPKP 加固?不要。据 Chromium 官方公告,Chrome 69(2018 年 9 月)起移除 HPKP 支持,RFC 7469 亦已被 IETF 重新分类为 Historic。误配 HPKP 曾导致大量站点在证书轮换后彻底不可访问,且没有可控的回滚手段。当前更可控的强制 HTTPS 路径就是 HSTS + Preload,同时配合 CAA 记录限制签发源、保持 TLS 1.2/1.3、检查完整证书链(openssl s_client -showcerts 确认中间证书已下发)。

如果你的子域清单已经理清、证书续期有 dry-run 与到期前 30/14/7 天告警,那么按上面”阶段一 → 观察 30 天 → 阶段二”的顺序推进,hsts preload 提交才是一次低风险操作,而不是一次不可撤销的赌注。

HSTS Preload 提交常见错误与排查:真实报错信息对照

hstspreload.org 的校验是按固定顺序逐条执行的,一次只返回一条错误,所以修完一条必须重新提交才能看到下一条。这也是为什么很多人的 hsts preload 提交 会卡在同一页面反复失败。下面按报错出现频率排列,每条给出可直接复制的验证命令。

报错 “No HSTS header was found.” 是怎么回事?

三类根因:只给 HTTP 响应加了头(据 RFC 6797 第 8.1 节,浏览器必须忽略通过非安全传输收到的 STS 头);Nginx 中 location 块内的 add_header 会覆盖 server 级配置(子级一旦出现任意 add_header,就不再继承父级全部头);CDN 剥离或未透传该头。排查要点是对比边缘与源站:

# 1) 看边缘节点(走 DNS/CDN)返回的头
curl -sSI https://example.com | grep -i strict-transport-security

# 2) 绕过 DNS 直连源站 IP 对比(203.0.113.10 换成你的源站地址)
curl -sSI --resolve example.com:443:203.0.113.10 https://example.com | grep -i strict-transport-security

# 仅第 1 条无输出 → CDN 剥离/未透传;两条都无输出 → 源站配置问题

报错 “The HSTS header’s max-age is less than 31536000.”

说明 max-age 还停留在 300、86400 或 2592000 这类灰度值。据 hstspreload.org 提交要求(Chromium 项目 HSTS 预加载文档),max-age 至少 31536000 秒(1 年),实践中推荐 63072000(2 年),为撤回留出窗口。改完 nginx -t && systemctl reload nginx,清 CDN 缓存后再用 curl 确认所有入口取值一致。

# Nginx 1.7.5+ 支持 always 参数,保证 4xx/5xx 响应也带该头
add_header Strict-Transport-Security "max-age=63072000; includeSubDomains; preload" always;
报错原文(hstspreload.org 原样) 典型根因 一条命令验证
No HSTS header was found. HTTP 才带头 / location 覆盖 / CDN 剥离 curl -sSI https://example.com | grep -i strict
max-age is less than 31536000. 仍是灰度值 300/86400/2592000 curl -sSI https://example.com | grep -o 'max-age=[0-9]*'
does not contain includeSubDomains. 头值被拆成多行,或 CDN 只下发 max-age curl -sSI https://example.com | grep -ci strict(返回 >1 即重复头)
does not redirect from HTTP to HTTPS. 80 端口返回 200 或跳到 www 的 HTTP curl -sSI -o /dev/null -w '%{http_code} %{redirect_url}n' http://example.com
has a redirect from HTTPS to HTTP. 应用层 force HTTPS 与边缘协议判断冲突 curl -sSIL https://example.com | grep -i '^location'

报错缺 includeSubDomains 或 preload 指令怎么办?

先看是否出现两行同名头——多个 add_header 会生成多个 Strict-Transport-Security,浏览器按第一个处理。补齐前必须先跑子域扫描:preload 生效后所有子域都必须能完成 HTTPS 握手且证书 SAN 覆盖,否则整域被浏览器硬编码拒绝,撤回要等数月。

for h in www api mail dev staging; do
  printf '%s: ' "$h"; curl -sSI -o /dev/null -w '%{http_code}n' "https://$h.example.com" || echo FAIL
done

报错 “The site does not redirect from HTTP to HTTPS.” 怎么修?

80 端口返回 200,或 302 到 http://www.example.com 都算不合格,期望是 301 + https://。Nginx 用 return 301 https://$host$request_uri;,Apache 用 Redirect permanent / https://example.com/;CDN 侧开启 Always Use HTTPS / Force HTTPS 开关。

报错 “The site has a redirect from HTTPS to HTTP.” 与证书报错

用 curl -sSIL 看完整跳转链,确保没有 Location: http://;重点查 X-Forwarded-Proto(Nginx:proxy_set_header X-Forwarded-Proto $scheme;)与框架的强制 HTTPS 开关(Laravel APP_URL、Django SECURE_SSL_REDIRECT),避免边缘 HTTPS、回源 HTTP 后应用再跳回 HTTP 形成循环。出现 curl: (60) SSL certificate problem: unable to get local issuer certificate 或 openssl verify error:num=20 时,检查链顺序为“站点证书 + 中间证书”:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
openssl verify -CAfile chain.pem cert.pem   # 复验拼接后的 fullchain

浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID 则确认该子域已列入证书 SAN。全部通过后,用 https://hstspreload.org/api/v2/status?domain=example.com 查询 status 字段(unknown / pending / preloaded),Chromium 大约每 6–12 周随版本发布更新一次预加载列表,这就是 hsts preload 提交 从“通过校验”到“浏览器真正收录”之间的等待期。

效果验证:如何确认 HSTS Preload 已生效

先回答一个常见误区:curl 能看到 preload 指令,只代表服务器声明,不代表浏览器已收录。完成 hsts preload 提交 后,要分四层验证:响应头、跳转链、TLS、提交状态与真实首访。

1. 响应头:根域和关键子域都要查

# 适用:curl 7.x+;对根域、www、api、static 逐个执行
for h in example.com www.example.com api.example.com static.example.com; do
  echo "== $h =="
  curl -sSI --max-time 10 "https://$h" | grep -i '^strict-transport-security'
done
# 期望输出(max-age 至少 31536000 秒,即 1 年;常见推荐 63072000 秒)
# strict-transport-security: max-age=31536000; includeSubDomains; preload

如果某个子域缺失,先修该子域再谈 hsts preload 提交;据 hstspreload.org 要求,根域必须返回 max-age 至少 31536000、includeSubDomains 和 preload,且所有子域都应支持 HTTPS。未返回该头即无 HSTS,max-age=0 表示撤销;常见报错如 max-age must be at least 31536000 seconds。

2. 跳转链:不能只修一个入口

# 看 HTTP 是否 301/308 到 HTTPS;-o /dev/null 丢弃正文
curl -sSI -o /dev/null -w '%{http_code} %{redirect_url}n' http://example.com
curl -sSI -o /dev/null -w '%{http_code} %{redirect_url}n' http://www.example.com
# 跟随整条链,最终应为 200,且不能出现 HTTPS→HTTP
curl -sSIL --max-time 10 http://example.com | grep -Ei '^(HTTP/|location:)'

期望首跳为 301 或 308,Location 指向 https://。据 RFC 6797,HSTS 只对已建立 HTTPS 的宿主生效;HTTP 首跳若返回 200 或 302 到 HTTP,提交页会报 redirect 错误。

3. TLS:预加载后证书过期影响面会扩大

# OpenSSL 1.1.1/3.x 均适用;-verify_return_error 让校验失败直接报错
openssl s_client -connect example.com:443 -servername example.com 
  -verify_return_error </dev/null 2>/dev/null | grep -E 'Verify return code|Protocol'
# 期望:Verify return code: 0 (ok) / Protocol : TLSv1.3(或 TLSv1.2)
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates

检查 notAfter,预加载后浏览器不会给“继续访问”的例外入口,证书过期等于全站不可达。据 OpenSSL 文档,-verify_return_error 会在证书链校验失败时中止;据 Let’s Encrypt 文档,证书默认有效期 90 天,务必自动续期。

4. 提交状态与浏览器实测

# 打开提交页查询根域(不要带 www)
https://hstspreload.org/?domain=example.com
# Chrome/Edge 地址栏输入,Query HSTS/PKP domain 填 example.com
chrome://net-internals/#hsts
状态 含义 下一步
unknown 未提交、域名不匹配或查询了子域 用根域重新提交
pending 已进入待处理队列,尚未随浏览器版本发布 等待列表更新,保留提交截图
preloaded 已写入 Chromium HSTS preload 列表 用新浏览器资料做首访验证

页面若列出 max-age、includeSubDomains、preload、redirect 错误,按项修复后重新提交;据 Chromium 文档,列表随 Chrome 版本发布,pending 不代表已生效。

5. 首访验证:curl 证明不了预加载列表

用从未访问过该域名的浏览器资料(新用户资料比无痕更干净;无痕仍共享预加载列表,但不能替代列表更新),地址栏只输入 example.com,DevTools Network 的第一个请求应为 HTTPS。若仍出现 HTTP 请求,说明浏览器版本尚未包含该域名,或状态仍是 pending。记录浏览器版本号与验证日期,例如 Chrome 126.0.6478.127 / 2025-06-01,便于复核。

提交后状态通常先变为 pending,表示已进入待审核/待发布流程,不是 DNS 生效。Chromium 系浏览器一般要等新版本发布才带入预加载列表,常见等待数周至数月;Firefox 的列表更新节奏独立。期间必须保持 HTTP→HTTPS 跳转、证书有效和所有子域可 HTTPS 访问。

hstspreload.org 要求 max-age 至少 31536000 秒(1 年),生产常见 31536000 或 63072000(2 年)。灰度阶段可以用 300 或 86400,但不要加 preload;确认子域、证书续期和监控都稳定后,再改为 31536000; includeSubDomains; preload。

301/308 只解决“收到请求后跳转”,首个请求仍可能是 HTTP;HSTS 响应头让浏览器在首次 HTTPS 后记住强制 HTTPS;Preload 把域名写进浏览器列表,首次访问也强制 HTTPS。Cloudflare HSTS 是边缘下发策略,适合已全站走 Cloudflare 的站点,但仍要保证源站、子域和证书一致,不能替代子域盘点。

先确认 HTTPS 响应头实际值包含 includeSubDomains,而不是只改了配置文件未 reload 或被 CDN 覆盖。用 curl -sSI https://example.com | grep -i strict 检查,再逐个子域验证 HTTPS。若仍有子域只支持 HTTP,不要为了过检强行添加 includeSubDomains,应先迁移或拆分域名。

会。includeSubDomains 覆盖该根域下所有子域,预加载后 mail、api、旧后台、测试子域都会被浏览器强制 HTTPS。hstspreload.org 提交的是根域名,不能只提交 www;如果无法控制全部子域,建议先不加 includeSubDomains 和 preload,或把不可控业务迁到独立域名。

可以提交 removal 请求,但不会立即清除。已进入浏览器预加载列表的域名要等新版本发布后才移除,通常同样需要数周至数月;max-age=0 只能让未预加载的客户端尽快过期,不能覆盖预加载列表。提交前应把回滚窗口和子域责任人写进变更记录。

常见原因是 add_header 继承被 location 覆盖、只改了 80 端口、CDN 剥离头或配置未 reload。检查 nginx -t 后是否 nginx -s reload,确认 HSTS 写在 443 server 或对应 location,并用 curl -sSI https://example.com 与直连源站 –resolve 对比。若 location 内已有 add_header,需要在该层级重复 HSTS 或用 map 统一注入。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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