ECH 加密 ClientHello 怎么开启?Cloudflare、DNS HTTPS RR 与验证完整指南
ECH 加密 ClientHello 的核心结论:它只加密 TLS 1.3 握手里的内层 ClientHello(含真实 SNI),外层仍会露出 public_name;截至 2025 年,较常见的落地方式是用 Cloudflare 等边缘开启 ECH,并让 DNS HTTPS RR 下发 ech=AEX... 配置,而不是在 Nginx 里找 ssl_ech 指令。 Cloudflare 路径为 SSL/TLS > Edge Certificates > Encrypted Client Hello 开启,或 PATCH /zones/$ZONE_ID/settings/ech 设 value=on;Free 计划 $0,Pro 约 $20/月起,开启后通常 1-5 分钟生效,DNS TTL 建议 300-3600 秒。 验证时访问 https://crypto.cloudflare.com/cdn-cgi/trace,看到 sni=encrypted 且 tls=TLSv1.3 才说明 ECH 加密 ClientHello 生效;dig example.com HTTPS +short 应出现 ech=AEX 开头的长串。 底层必须满足 TLS 1.3 与 X25519:openssl s_client -connect example.com:443 -servername example.com -tls1_3 -alpn h2 -brief 应输出 Protocol version: TLSv1.3 和 Server Temp Key: X25519, 253 bits。 常见失败不是证书问题:DNS 未走 DoH、HTTPS RR 缺 ech、Cloudflare 未开橙云、客户端 network.dns.echconfig.enabled=false 都会导致 ECH 加密 ClientHello 不发起。
ECH 加密 ClientHello 是什么?为什么抓包仍能看到真实 SNI
问:我明明已经启用了 ECH,为什么用 tcpdump 抓包时,还是能看到 example.com 的 SNI?答:因为 ECH 的设计目标本来就不是把 SNI 完全隐藏掉。ECH 加密 ClientHello(Encrypted Client Hello,草案 draft-ietf-tls-esni)把 ClientHello 拆成两层:外层保持明文,SNI 填的是 public_name(CDN 提供的通用名,例如 Cloudflare 的 *.cloudflare-ech.com);内层才包含真实的 SNI、ALPN 和大部分扩展,并用 HPKE(RFC 9180)加密后塞进 encrypted_client_hello 扩展。因此,抓包看到外层 SNI 只能证明“这次连接走了 ECH 外层”,并不能证明 ECH 已经生效;正确判据是看服务端返回的 trace 中是否出现 sni=encrypted(Cloudflare 的 /cdn-cgi/trace 会返回该字段),或确认内层是否被成功解密。
先用两条命令把“DNS 有没有给配置”和“线上到底走没走 ECH”分开验证:
# 1) 查 HTTPS RR(RFC 9460,type 65)里有没有 ech= 参数
# 期望:ech=AEX+DQBB...(base64 的 ECHConfigList);只有 alpn=h3 而无 ech= 就是没开
dig +short example.com HTTPS
dig +short example.com HTTPS | grep -o 'ech=[^ ]*' # 无输出 = 客户端拿不到 ECHConfig
# 2) 抓包只能看到外层,SNI 等于 public_name 属于正常
sudo tcpdump -ni eth0 -s0 'tcp port 443' -w ech.pcap
# Wireshark 过滤:tls.handshake.extensions_server_name
# 3) 看服务端判定结果(Cloudflare 专用,无需登录)
curl -s https://example.com/cdn-cgi/trace | grep -E '^(sni|tls)=' # 期望 sni=encrypted
如果第 3 步返回 sni=plaintext,就说明 ech 加密clienthello 根本没有发出,问题出在下面五个环节之一:
| 根因 | 典型现象 | 验证方式 | 修复 |
|---|---|---|---|
HTTPS RR 未下发 ech= 或 TTL 过期 |
dig 看不到 ech= |
dig +short x HTTPS |
在边缘开启 ECH,等 TTL 过期 |
| 没走 DoH/安全 DNS | 本机能 dig 到,浏览器却发不出 ECH | Firefox about:config 看 network.trr.mode |
置为 2 或 3;Chrome 打开 Secure DNS |
| 边缘未启用 ECH 或记录是灰云 | 橙云域名正常,灰云域名全部明文 | 看 DNS 记录是否为橙云代理 | Cloudflare SSL/TLS → Edge Certificates → Encrypted Client Hello |
| 客户端版本/开关不满足 | 旧版浏览器只发普通 ClientHello | Firefox 需 ≥118,network.dns.echconfig.enabled=true |
升级浏览器或开启 flag |
| 误把 ESNI 当 ECH | 配置里找 esni=,永远配不出来 |
看 RR 里是 ech= 还是 esni= |
ESNI 已停止推进,改用 ech= + HPKE |
第二、四条最容易踩坑,关键配置如下(Firefox 118+ 默认开启 ECH,据 Mozilla 文档):
// Firefox about:config
network.dns.echconfig.enabled = true // 默认 true;false 时完全不发 ECH
network.trr.mode = 2 // 默认 0(关闭);2=DoH 优先可回退,3=仅 DoH
// 明文 DNS 会被中间盒剥离 HTTPS RR 中的 ech=
Cloudflare 侧要求同时满足两点:SSL/TLS → Edge Certificates 中 Encrypted Client Hello 开关为 On(所有套餐可用),且该 A/AAAA 记录是橙云代理;灰云直连源站时流量不经过边缘,自然不会做 ECH 终止。证书部分不用担心:据 Let’s Encrypt 文档,ECH 不改变证书签发流程,普通 DV/OV 证书照常使用,不需要任何额外的 ECH 字段。旧方案 ESNI 用的是 esni= 和不同的密钥封装,早已停止推进,配置项对不上时先确认自己查的是 ech= 而不是历史文档里的 esni=。
调试时还会遇到一个容易误判的信号:NSS 在 ECH 被服务端拒绝时会返回 SSL_ERROR_ECH_RETRY_WITHOUT_ECH 并自动回落重连——这属于“ECH 尝试过但未成功”,连接最终仍会建立,只是 trace 显示 sni=plaintext。另外,openssl s_client 目前不支持发送 ECH,用它验证会得出错误结论,请改用浏览器或 Cloudflare trace。
开启 ECH 加密 ClientHello 的完整实操步骤(1-6 步)
开启 ECH(Encrypted Client Hello)不是单个开关,而是”边缘开关 + DNS HTTPS RR 下发 + 客户端支持”三件事同时成立。下面 6 步按执行顺序排列,每步都给了可直接复制的命令;按 Cloudflare 官方文档,ECH 目前在其边缘对所有套餐免费开放,但只有解析走 Cloudflare 且代理状态为橙云的域名才会下发 ech= 参数。
- 前置检查:橙云、源站 443、证书有效期、SSL 模式
ECH 只在 Cloudflare 边缘终止,因此域名必须走代理。用下面的命令一次性确认三件事:
# 1) 解析是否走 Cloudflare 代理:应返回 104.16.x.x / 172.64.x.x 等 Anycast 网段,而非源站 IP dig +short example.com A # 2) 源站 443 直连可达且证书链可验证(把 203.0.113.10 换成你的源站 IP) curl -sS -o /dev/null -w 'http=%{http_code} verify=%{ssl_verify_result}n' --resolve example.com:443:203.0.113.10 https://example.com/ # 3) 证书有效期与签发者(ssl_verify_result=0 表示链验证通过) echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates -issuer随后在控制台把 SSL/TLS 模式设为 Full (strict),Edge Certificates 页把 TLS 1.3 置为 On,Minimum TLS Version 建议 1.2(要兼容老客户端)或 1.3(更严格)。若 Minimum TLS 设为 1.3,注意部分 IoT 与旧 Android 客户端会直接握手失败——这是回滚时最常见的”业务异常”来源。
- 开启边缘 ECH:控制台或 API
控制台路径:SSL/TLS → Edge Certificates → Encrypted Client Hello (ECH) → On。批量或自动化场景用 API,需要 API Token 具备 Zone Settings:Edit 权限:
# 开启 ECH;HTTP 200 且返回 result.value=on 表示设置已接受 curl -sS -X PATCH "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/settings/ech" -H "Authorization: Bearer $CF_API_TOKEN" -H "Content-Type: application/json" --data '{"value":"on"}' # 回读确认 curl -sS "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/settings/ech" -H "Authorization: Bearer $CF_API_TOKEN" | jq '.result.value'若返回
{"success":false,"errors":[{"code":10000,"message":"Authentication error"}]},是 Token 权限不足;返回code 10405则是套餐/区域不支持该设置。这一步只改变边缘行为,此时客户端仍拿不到 ECHConfig。 - 等待 DNS 下发并检查 HTTPS RR
据 RFC 9460,HTTPS 记录用
ech=携带 base64 编码的 ECHConfigList。Cloudflare 通常在 1–5 分钟内更新,TTL 常见 300 秒:# 直接查权威/递归结果;推荐显式指定 1.1.1.1 避开本地缓存 dig +short example.com HTTPS @1.1.1.1 # 期望输出形如: # 1 . alpn="h3,h2" ipv4hint=104.16.x.x ech=AEX+DQBB... # 若只看到 alpn 而没有 ech=,说明尚未生效,等 5 分钟再查dig 输出特征 含义 处理动作 含 ech=AEX…且alpn="h3,h2"ECHConfig 已下发 进入客户端验证 只有 alpn=,无ech=开关未生效或 DNS 未刷新 回读 API 的 result.value,等 TTL 过期 无 HTTPS 记录(NXDOMAIN/空) 域名未走 Cloudflare 代理 检查橙云状态 - 用支持 ECH 的客户端验证
Firefox 从 118 起默认支持 ECH,但依赖 DoH(TRR)获取 HTTPS RR。在
about:config中设置:network.dns.echconfig.enabled = true # 启用 ECHConfig 解析 network.dns.http3_echconfig.enabled = true network.trr.mode = 2 # 2=DoH 优先,失败回落系统 DNS;3=仅 DoH network.trr.uri = https://cloudflare-dns.com/dns-query重启浏览器后访问
https://crypto.cloudflare.com/cdn-cgi/trace,输出中sni=encrypted即表示 ECH 加密 ClientHello 成功;sni=plaintext说明仍在明文 SNI。命令行可用 curl 8.8.0+ 复验(低版本无--ech选项,会报option --ech: is unknown):curl --doh-url https://cloudflare-dns.com/dns-query --ech true -s https://crypto.cloudflare.com/cdn-cgi/trace | grep -E '^(sni|http)=' - 源站只做 TLS 1.3 就绪,不要找 ssl_ech
关键认知:ECH 在 Cloudflare 边缘终止,Cloudflare 回源是普通 TLS,源站无需也不感知 ECH。Nginx 不存在
ssl_ech指令,写了会直接启动失败(unknown directive "ssl_ech")。Nginx 1.27.3 只需保证 TLS 1.3 与 X25519 可用:server { listen 443 ssl; http2 on; # Nginx 1.25.1+ 写法,替代 listen ... http2 ssl_protocols TLSv1.2 TLSv1.3; # 默认值仅 TLSv1.2 TLSv1.3(1.23.4+) ssl_ecdh_curve X25519:prime256v1; # 默认 auto;显式写出便于审计 ssl_certificate /etc/nginx/ssl/fullchain.pem; ssl_certificate_key /etc/nginx/ssl/privkey.pem; }nginx -t && nginx -s reload # 验证 TLS 1.3 与密钥交换组 openssl s_client -connect example.com:443 -servername example.com -tls1_3 /dev/null | grep -E 'Protocol|Cipher|Server Temp Key' - 灰度与回滚:把 TTL 当开关用
上线前先把相关记录 TTL 降到 300 秒,观察 5–30 分钟,重点看
/cdn-cgi/trace的sni字段与业务错误率。出现异常时:# 关闭 ECH curl -sS -X PATCH "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/settings/ech" -H "Authorization: Bearer $CF_API_TOKEN" -H "Content-Type: application/json" --data '{"value":"off"}' # 每 30 秒复查一次,确认 ech 参数消失(5–10 分钟内应完成) watch -n 30 "dig +short example.com HTTPS @1.1.1.1 | grep -o 'ech=[^ ]*' || echo 'ech 已消失'"注意:已缓存 ECHConfig 的客户端在 TTL 到期前仍会尝试 ECH,Cloudflare 会通过 ECH fallback(服务端拒绝后客户端重试明文 SNI)保证可用性,因此回滚期间偶发的握手重试属正常现象。保留 Cloudflare Audit Log 变更记录与 trace 截图,便于事后归因。
ECH 加密 ClientHello 配置与命令示例:Cloudflare API、DNS HTTPS RR、Nginx TLS 1.3
先回答最常被问的那句:开启 ECH 加密 ClientHello 不是点一个开关就完事,它由三段链路串起来——边缘下发 HTTPS RR(含 ech= 参数)→ 客户端读 RR 后用 ECHConfig 封装内层 SNI → 源站支持 TLS 1.3 与 X25519。任何一段断掉,浏览器都会静默回退到明文 SNI,你在日志里看到的是”配置成功”却毫无加密效果。
第一步:用 Cloudflare API 打开 ECH 开关。该端点位于 Zone Settings 下,API Token 需要 Zone Settings:Edit 权限(据 Cloudflare API 文档):
# ZONE_ID 在域名概览页右下角;Token 需 Zone Settings:Edit
export CF_API_TOKEN="你的token" ZONE_ID="你的zone_id"
curl -s -X PATCH "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/settings/ech"
-H "Authorization: Bearer $CF_API_TOKEN"
-H "Content-Type: application/json"
--data '{"value":"on"}' | jq '{value:.result.value, err:.errors[0]}'
# 成功输出 {"value":"on","err":null}
# 失败看 errors[0].code:10000 = 认证失败(Token 权限或格式错误),先查权限再重试
前置条件是域名使用 Cloudflare 权威 DNS 且对应记录处于代理(橙云)状态,否则即便 value=on,边缘也不会签发 ECHConfig。
第二步:确认 HTTPS RR 真的下发了。据 RFC 9460,HTTPS 记录类型由 BIND 9.16+ 引入;旧版 dig 会直接报 ;; Type HTTPS is not supported,此时升级 bind-utils(RHEL 系)或 dnsutils(Debian 系):
dig @1.1.1.1 example.com HTTPS +short
# 期望形如:
# 1 . alpn="h2,h3" ipv4hint=104.16.x.x ech=AEX+DQBB...(数百字符 base64)
# 无 dig 或想验证 DoH 视角:
curl -sH 'accept: application/dns-json'
'https://cloudflare-dns.com/dns-query?name=example.com&type=HTTPS' | jq -r '.Answer[].data'
JSON 的 Answer[].data 里若找不到 ech= 字段,说明边缘尚未下发——优先排查代理状态、套餐/区域支持以及开关是否真为 on,而不是去动源站。
第三步:源站对齐 TLS 1.3 与曲线。Nginx 1.25.1 起用独立的 http2 on; 指令替代 listen ... http2,1.27.x 写法如下(ssl_ecdh_curve 默认值为 auto,即交给 OpenSSL 3.x 的默认组,显式写出可避免发行版差异):
server {
listen 443 ssl;
http2 on; # Nginx ≥1.25.1 语法
ssl_protocols TLSv1.2 TLSv1.3; # 1.3 是 ECH 内层握手的前提
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_ecdh_curve X25519:prime256v1; # 首选项 X25519
}
# 改完执行:
nginx -t && systemctl reload nginx
第四步:用 openssl 验证握手。-brief 需要 OpenSSL 1.1.1+:
openssl s_client -connect example.com:443 -servername example.com
-tls1_3 -alpn h2 -brief
| 探测项 | 期望输出 | 异常含义 |
|---|---|---|
| Protocol version | TLSv1.3 | 显示 TLSv1.2 → 源站未启用 1.3 或被中间设备降级 |
| Ciphersuite | TLS_AES_256_GCM_SHA384 | 其他 AEAD 套件属正常优先级差异,非故障 |
| Server Temp Key | X25519, 253 bits | 出现 secp256r1 → 曲线列表未含 X25519 |
证书与 ECH 没有耦合。继续用 Let’s Encrypt 90 天证书或商业 DV 证书即可;Cloudflare Full (strict) 只要求源站证书链完整、主机名匹配。ECHConfig 来自 HTTPS RR 而非证书扩展,把 ech= 写进 CSR 或 SAN 不会产生任何效果,只会让证书校验失败。想进一步压缩握手往返,可接着看 TLS 1.3 的 0-RTT 与会话恢复配置,这与 ECH 是两条独立的优化路径。
ECH 加密 ClientHello 方案对比与选型:Cloudflare、Nginx、Apache、Caddy
想给 SNI 加一层隐私,ECH 加密 ClientHello 该交给 CDN 还是自建?先看能力现状:截至 2025 年 9 月,能把 ECH 配置真正下发到浏览器的仍是 Cloudflare 这类边缘网络;Nginx、Apache、Caddy 都还没有服务端 ECH 指令。RFC 9849(2025 年 8 月发布,取代 draft-ietf-tls-esni)定义了协议与 HPKE(RFC 9180)封装方式,但“协议存在”和“你的服务器支持”是两件事。下表基于各项目公开文档与 nginx -V 实际核查:
| 方案(版本) | ECH 能力 | 开启方式 | 生效时间 | 成本 |
| Cloudflare 边缘 | 支持,自动发布 HTTPS RR(RFC 9460)中的 ech= |
控制台 SSL/TLS → Edge Certificates,或 API /settings/ech |
1–5 分钟(受 DNS TTL 与客户端配置缓存影响) | Free $0;Pro 约 $20/月起;Business 约 $200/月起;Enterprise 定制 |
| Nginx 1.27.3 | 无原生 ssl_ech(ngx_http_ssl_module 指令表无此项) |
需自建边缘,或换 BoringSSL 自写模块 | 0.5–2 人日 | 人力 + 持续跟随上游升级 |
| Apache 2.4.62 | 无(mod_ssl 无 ECH 配置项) | 同上 | 0.5–2 人日 | 同上 |
| Caddy 2.8.x | 无 | 常规 TLS 1.3 可用,但不解决 SNI 暴露 | — | — |
# Cloudflare 侧开启并验证(API Token 需 Zone Settings:Edit 权限)
ZONE_ID="<zone_id>"; CF_API_TOKEN="<token>"
# 1) 开启 ECH:value 默认 off,改为 on 后 1–5 分钟生效;返回 404 说明该 zone 未开放,改走控制台
curl -sS -X PATCH "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/settings/ech"
-H "Authorization: Bearer $CF_API_TOKEN"
-H "Content-Type: application/json"
--data '{"value":"on"}' | jq '.result'
# 2) 确认 HTTPS RR 已带 ech= 参数(Cloudflare 自动发布,无需手写 TXT)
dig +short HTTPS example.com
# 1 . alpn="h2,h3" ipv4hint=104.21.x.x,172.67.x.x ech=AEX+DQBB...
# 3) 客户端验证:curl 8.x 起提供 --ech(默认 false,可取值 true/grease/hard),
# 且 TLS 后端必须是 BoringSSL 或 OpenSSL ≥ 3.5,否则该选项直接报 "not built with ECH"
curl -sv --ech true https://example.com 2>&1 | grep -i 'ech'
# * ECH: result: status is ok
怎么证明真的加密了?别只看浏览器锁标,抓包看 ClientHello 扩展更直接:
sudo tcpdump -i any -s0 -w ch.pcap 'tcp port 443'
tshark -r ch.pcap -Y 'tls.handshake.extensions_server_name'
-T fields -e tls.handshake.extensions_server_name | sort -u
# ECH 生效时该字段为空(SNI 已被 HPKE 封装);回退明文时会打印域名
适用与不适用场景。内容站、SaaS 登录页、API 网关前置,最适合用 Cloudflare 把真实 SNI 藏在边缘之后;源站 Nginx 只要保持 TLS 1.3 即可,ECH 在边缘终止。反之,域名必须灰云直连、客户端大量为旧版 Android/IE/旧 curl、或内网 DNS 无法走 DoH 时,客户端取不到 HTTPS RR,ECH 只能 GREASE 或回退明文 SNI——建议先拿一个子域承接 5%–10% 流量灰度。
# 源站示例:Nginx 1.27.3 只负责 TLS 1.3,ECH 不在此终止
server {
listen 443 ssl;
http2 on; # nginx ≥ 1.25.1;旧版写 listen 443 ssl http2
ssl_protocols TLSv1.3; # 默认值为 TLSv1.2 TLSv1.3,此处收紧为仅 1.3
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
# nginx 1.27.3 无 ssl_ech 指令,写了会报 unknown directive
}
ECH 能省下证书钱吗?不能。它只加密 ClientHello 里的 SNI,身份认证与密钥交换仍依赖 X.509。据 Let’s Encrypt 文档,DV 证书免费、90 天一轮换;商业 DV 约 100–1000 元/年,OV/EV 更高,ECH 不影响任何一档价格。另外据 Cloudflare 文档,启用 ECH 的 zone 会同时下发 alpn="h2,h3";但只开 HTTP/3 不开 ECH 时,QUIC Initial 包里的 ClientHello 依旧携带明文 SNI,必须在 trace 中看到 sni=encrypted 才算真正生效。
ECH 加密 ClientHello 常见错误与排查(含真实报错)
排查 ECH 加密 ClientHello 的核心思路是“从浏览器错误码 → DNS 的 HTTPS RR → 边缘 TLS 配置”逐层缩小范围。下面六条覆盖了绝大多数真实故障,每条都给出可直接复制的验证命令。
1. Firefox 报 SSL_ERROR_ECH_RETRY_WITH_ECH / SSL_ERROR_ECH_RETRY_WITHOUT_ECH 怎么办?
这两个错误码来自 Firefox 的 ECH 重试状态机(参见 Mozilla Bug 1736151 与 RFC 9460 中 HTTPS RR 的 ech 参数定义):客户端拿到 ECHConfig 后加密握手失败,或明文握手被服务端拒绝后回退。根因多为 ECHConfig 已轮换而本地 DNS 缓存仍是旧值,或中间盒剥离了 ECH 扩展。处理顺序如下:
# 1) 在 Cloudflare DNS 面板把该 HTTPS RR 的 TTL 调到 300 秒(最小值 60,默认 Auto=300)
# 这样 ECHConfig 轮换后最多 5 分钟全网收敛,是缓解此类报错最有效的一步
# 2) 清空本机 DNS 缓存
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder # macOS
ipconfig /flushdns # Windows
# 3) Firefox:about:preferences#privacy → DNS over HTTPS → 最大保护
# 自定义填 https://cloudflare-dns.com/dns-query,确保 HTTPS RR 不被运营商 DNS 丢弃
2. Chrome 报 ERR_ECH_NOT_ENABLED 怎么修?
该错误表示浏览器知道站点发布了 ECHConfig,但本地未启用 ECH 或 Secure DNS 不可用——据 Chrome 的 ECH 设计说明,ECH 依赖 DoH 解析 HTTPS RR,明文 DNS 下不会启用。操作:chrome://flags 搜索 encrypted-client-hello 设为 Enabled;chrome://settings/security 打开“使用安全 DNS”并选 Cloudflare(1.1.1.1);完全退出重启后访问 https://cloudflare.com/cdn-cgi/trace,确认 sni 字段变为 encrypted。
3. dig 报 “Type HTTPS is not supported” 是版本问题
这是 dig 所在 BIND 版本低于 9.16、不认识 HTTPS 记录类型(RFC 9460)导致的,与 ECH 配置无关。先确认再升级:
dig -v # 输出形如 DiG 9.18.24;低于 9.16 必须升级
sudo apt install --only-upgrade bind9-dnsutils # Debian/Ubuntu 9.18+ 包名
sudo dnf upgrade bind-utils # RHEL / Rocky 系
dig example.com HTTPS +short
# 正常输出含:1 . alpn="h3,h2" ipv4hint=... ech=AEX+DQBB... ← 有 ech= 即已发布 ECHConfig
无法升级时改走 DoH JSON 接口:
curl -s -H 'accept: application/dns-json'
'https://cloudflare-dns.com/dns-query?name=example.com&type=HTTPS' | jq -r '.Answer[].data'
4~6. 其余高频报错速查
| 报错 / 现象 | 典型根因 | 一步验证 | 处置 |
|---|---|---|---|
curl: (35) ... handshake failure |
强制 --tlsv1.3 但源站未开 TLS1.3;或 Cloudflare 525/526(源站握手失败 / 证书链无效) |
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null 2>&1 | grep -E 'Protocol|Verify return code' |
看到 Protocol: TLSv1.3 与 Verify return code: 0 才正常;否则把 SSL/TLS 模式改为 Full (strict) 并修源站证书链 |
trace 里 sni=plaintext 或无 sni 字段 |
ECH 未真正生效,最常见是 DNS 的 HTTPS RR 缺少 ech= 参数 |
curl -s https://example.com/cdn-cgi/trace | grep sni 配合第 3 条 dig 查询 |
按序检查:橙云代理是否开启 → 边缘 ECH 开关 → HTTPS RR 的 ech 参数 → 客户端 DoH 是否可用 |
开启后部分用户 ERR_CONNECTION_RESET |
企业网关 / 运营商中间盒阻断 ECH 扩展或 DoH 流量 | 对比同一用户关闭 DoH 后的 trace 输出 | 保留可回滚开关,先对非核心子域灰度 5–30 分钟观察,必要时临时关 ECH 但保持 TLS1.3 不降级 |
判断 ech 加密clienthello 是否真正生效,唯一可靠的客观指标是
cdn-cgi/trace中sni=encrypted;DNS 里查到ech=只说明“已发布”,不等于“已协商成功”。据 Let’s Encrypt 与 Cloudflare 的部署文档,ECH 还要求客户端支持 DoH 且服务端同时提供 TLS1.3 与 HTTPS RR,缺一项就会回退到明文 SNI。
ECH 加密 ClientHello 与 TLS 1.3、DoH、HTTPS RR、SNI 的关系
先给结论:ECH 不是一个独立协议,而是 TLS 1.3 的一个扩展(encrypted_client_hello,扩展类型 0xfe0d)。它的密钥封装用 HPKE(RFC 9180),密钥派生复用 TLS 1.3 的 HKDF-SHA256,因此源站与边缘必须至少支持 TLS 1.3——TLS 1.2 及以下的 ClientHello 里根本没有这个扩展位置,服务端无法“降级兼容”。据 Cloudflare 文档,开启 ECH 后边缘对不支持 TLS 1.3 的客户端会自动回退为明文 SNI 握手,此时 ECH 形同未开。
| 依赖项 | 在 ECH 中的角色 | 关键参数 / 默认值 | 缺失或配错时的表现 |
|---|---|---|---|
| TLS 1.3 | 承载 encrypted_client_hello 扩展 |
OpenSSL 1.1.1+ / BoringSSL;MinProtocol=TLSv1.3 |
握手退回明文 SNI,ECH 不生效 |
| HTTPS RR(RFC 9460) | 下发 ech=ECHConfigList、alpn、ipv4hint |
Cloudflare 默认 TTL 300s(可至 3600s) | 客户端拿不到 ECHConfig,只能发明文握手 |
| DoH | 保证 ECHConfig 不被中间人篡改 | Firefox network.trr.mode:0 关闭、2 DoH 优先、3 仅 DoH |
明文 DNS 被改写 ech 字段 → 握手失败 |
| SNI / 证书 | 外层 SNI 为 public_name,内层才是真实域名 |
证书 SAN 需覆盖 public_name + 真实域名 | 外层握手证书不匹配,报 SSL_ERROR_BAD_CERT_DOMAIN |
| ESNI(已废弃) | ECH 的前身草案 | 旧方案用 _esni TXT 记录 |
照抄旧教程会查不到任何 ECHConfig |
HTTPS RR 到底怎么查?据 RFC 9460,ECHConfigList 以 base64 编码放在 HTTPS 记录的 ech= 参数里,Cloudflare 开启 ECH 后自动随记录下发。用 dig(BIND 9.16+ 才认识 HTTPS 类型,旧版本写 TYPE65)可直接验证:
# 查询 HTTPS RR,确认 ech= 字段存在(值通常以 AEX+ 开头)
dig +short HTTPS blog.example.com
# 输出示例:1 . alpn="h3,h2" ipv4hint=104.16.0.1 ech=AEX+DQBBuwAggC...
# 只提取 ech 字段
dig +short HTTPS blog.example.com | tr ' ' 'n' | grep '^ech='
# 查看 TTL(缓存有效期,Cloudflare 默认 300s)
dig HTTPS blog.example.com | grep -A2 'ANSWER SECTION'
注意 TTL 的含义:客户端在 TTL 到期前不会重新拉取 ECHConfig,服务端轮换密钥后旧配置在缓存窗口内仍然可用,这正是 Cloudflare 把 TTL 压在 300 秒量级的原因。
为什么非要 DoH?ECHConfig 必须从可信 DNS 获取——如果攻击者能篡改明文 DNS 响应,往里塞一份自己的 ech=,加密就失去意义。浏览器因此把 ECH 与 DoH 绑定。企业网络务必放行到 DoH 端点的 443,否则 Firefox 在 mode=3 下会直接解析失败并抛 NS_ERROR_UNKNOWN_HOST:
# 用 DoH 端点直接取 HTTPS RR,验证 ech 是否随 DoH 一起下发
curl -s -H 'accept: application/dns-json'
'https://cloudflare-dns.com/dns-query?name=blog.example.com&type=HTTPS'
| jq -r '.Answer[] | select(.type==65) | .data'
# Firefox about:config 中确认:
# network.trr.mode = 2 # 默认 0;2 = DoH 优先、失败回退系统 DNS;3 = 仅 DoH,无回退
SNI 是不是完全看不见了?不是。ECH 只隐藏内层 ClientHello 的真实 SNI,外层 ClientHello 的 SNI 仍是 public_name(如 Cloudflare 的 cloudflare-ech.com),抓包依旧可见。因此证书必须同时覆盖 public_name 与真实域名;Cloudflare 通用证书会自动处理这一点,源站证书无需改名,仍按真实域名签发即可。
看到 esni= 或 _esni TXT 记录的教程要不要跟?不要。ESNI 是 draft-ietf-tls-esni 的早期形态,已被 ECH 取代,记录位置也从 _esni TXT 迁到 HTTPS RR 的 ech=。排障时以 dig HTTPS 的 ech= 字段、Firefox about:networking#dns 里的 HTTPS 记录、以及 Cloudflare 官方文档三者交叉验证,比对照旧教程更可靠。
如何验证 ECH 加密 ClientHello 已生效:dig、Firefox 与 Cloudflare trace
ECH 能否生效,取决于“DNS 下发配置、客户端发送、边缘接受”三个环节是否都正常;其中任一环节断开,浏览器都会静默回落到明文 SNI,不报任何错。所以单看一个信号很容易误判,下面五条证据各自只能证明其中一段,请按顺序收集。
证据一:用 dig 查询 HTTPS RR,确认 DNS 确实下发了 ECHConfigList
# 期望输出形如:1 . alpn="h2,h3" ech=AEX+DQBB...
# ech= 后是 base64 编码的 ECHConfigList(RFC 9460 定义的 HTTPS RR),Cloudflare 生成的常以 AEX 开头
dig +short example.com HTTPS
# 间隔 60 秒连查两次,确认内容与 TTL 稳定(Cloudflare 面板 TTL=Auto 时默认 300s)
dig +noall +answer example.com HTTPS; sleep 60; dig +noall +answer example.com HTTPS
如果 ech= 消失,或输出只剩 alpn=,先检查两件事:该记录是否开启了橙云代理,因为只有代理记录才会下发 ech;以及 Cloudflare 控制台 SSL/TLS → Edge Certificates 里的 ECH 开关是否打开。据 Cloudflare 文档,ECH 自 2023 年 9 月起对免费版开放,但不会为灰云记录签发。
证据二:用 Firefox 访问 trace 页面,确认客户端侧确实发起了 ECH 加密 ClientHello
在 Firefox 中打开 https://crypto.cloudflare.com/cdn-cgi/trace,输出里应出现 sni=encrypted 与 tls=TLSv1.3。若显示 sni=plaintext,说明 ECH 加密 ClientHello 根本没有发起,或边缘没有接受。据 Mozilla 支持文档,Firefox 118 起 network.dns.echconfig.enabled 与 network.dns.use_https_rr_as_altsvc 默认即为 true,但前提是 DoH 开启;纯系统 DNS 解析拿不到 HTTPS RR,ECH 就无法启动。
证据三:用 curl 对照,注意别把它当否定证据
curl -s https://crypto.cloudflare.com/cdn-cgi/trace | grep -E 'sni|tls'
# 典型输出:sni=plaintext / tls=TLSv1.3
curl 8.x(含 8.9)尚未实现 ECH,libcurl 没有对应选项,返回 sni=plaintext 属正常现象,不能据此判断浏览器侧 ECH 失效。
证据四:用 openssl 只能验握手底座
openssl s_client -connect example.com:443 -servername example.com -tls1_3 -alpn h2 -brief
# 期望:Protocol version: TLSv1.3
# Peer Temp Key: X25519, 253 bits
OpenSSL 3.0、3.2、3.5 的 s_client 都没有 -ech 参数,硬加会报 s_client: Unknown option: -ech。这条命令只证明 TLS 1.3、X25519 与 ALPN 就绪,是 ECH 的必要非充分条件。
证据五:用 tcpdump 抓包对比
# 抓包留档,开启前后各抓一次做对比
sudo tcpdump -i any -s 0 -A 'tcp port 443' -w ech.pcap
# 快速筛外层 SNI:Cloudflare 的 ECH 外层 public_name 为 cloudflare-ech.com
sudo tcpdump -i any -s 0 -A 'tcp port 443' | grep -ai 'cloudflare-ech'
开启后仍能看到外层 public_name,但抓不到你的真实域名;Wireshark 4.2+ 能识别 ECH 扩展(type 0xfe0d)并标记 outer CH,但内层 ClientHello 需持有 ECHConfig 私钥才能解密。
| 证据 | 能证明 | 不能证明 / 常见误判 |
|---|---|---|
| dig HTTPS | DNS 已下发 ECHConfigList | 客户端是否真的用了 |
| Firefox trace | 端到端 ECH 成功(sni=encrypted) |
非 Firefox 客户端的表现 |
| curl trace | TLS 1.3 可用 | 不能证明 ECH 失败 |
| openssl s_client | TLS1.3 / X25519 / ALPN 就绪 | 与 ECH 无关 |
| tcpdump + Wireshark | 外层 SNI 已替换为 public_name | 内层内容(无法解密) |
验收标准:dig 有 ech=、Firefox trace 为 sni=encrypted、openssl 显示 TLSv1.3 + X25519,三项同时满足才算通过。只满足一项时按“DNS → 客户端 DoH → 边缘开关”顺序排查,因为上游缺配置时下游全部静默降级;单次验证至少重复 3 次并间隔 60 秒,避开 TTL 缓存与 CDN 节点差异带来的假阴性。
不需要。ECH 只是 TLS 握手扩展,身份认证仍靠普通 DV/OV 证书;Let's Encrypt 90 天证书继续可用,Cloudflare Full (strict) 要求源站证书链完整。ech= 来自 DNS HTTPS RR,不是证书字段。
抓包看到的是外层 ClientHello 的 public_name,不是内层真实 SNI。判断 ECH 加密 ClientHello 是否生效,应访问 https://crypto.cloudflare.com/cdn-cgi/trace 看 sni=encrypted,而不是只看 tcpdump 的 SNI 字段。
截至 Nginx 1.27.3 没有原生 ssl_ech 指令,Apache 2.4.62 与 Caddy 2.8.x 也未提供原生 ECH 开关。常见做法是 Cloudflare 等边缘终止 ECH,源站 Nginx 只保持 TLS 1.2/1.3、X25519 与正常证书链。
ESNI 是旧草案,已被 ECH 取代。ECH 使用 HPKE(RFC 9180)和 HTTPS RR 的 ech= 字段,不再使用 _esni TXT 或 esni= 参数;旧教程里的配置不要直接照搬。
先清空 DNS 缓存并把 HTTPS RR TTL 降到 300 秒,确认 network.trr.mode=2、network.dns.echconfig.enabled=true,再换一个 DoH 端点重试。若仍失败,临时关闭 Cloudflare ECH 开关,观察 5-10 分钟并抓取 trace 对比 sni 字段。
不会直接影响 SEO 排名;它改变的是 TLS 握手中的 SNI 可见性。证书续期仍按 Let's Encrypt 90 天或商业证书周期执行,但需保证边缘和源站 TLS 1.3 可用,旧客户端访问异常时要保留回滚开关。
在支持区域,Cloudflare Free 计划可用 $0 开启 ECH;Pro 公开价约 $20/月起,Business 约 $200/月起,Enterprise 定制。开启后通常 1-5 分钟在 HTTPS RR 下发 ech=,DNS TTL 常见 300 秒。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。