跳到主要内容
基础知识

TrustAsia 通配符证书只覆盖一级子域?多级子域、SAN 组合与 HAProxy/Envoy 部署排错

trustasia 通配符证书 — TrustAsia 通配符证书只覆盖一级子域?多级子域、SAN 组合与 HAProxy/Envoy 部署排错
核心结论

TrustAsia 通配符证书(*.example.com)只匹配一级子域,不覆盖 example.com 本身,也不覆盖 a.b.example.com;一张证书通常只含一个通配符 SAN,DV 渠道价约 1,200–2,800 元/年,实际有效期以签发页为准。 申请时 CSR 用 OpenSSL 3.0 生成 RSA 3072 或 ECDSA P-256 密钥,SAN 至少写 DNS:*.example.com;若主域也要用,追加 DNS:example.com,否则 apex 仍会报名称不匹配。 DCV 走 DNS TXT/CNAME 时,把 TTL 设为 60,用 dig +short TXT _dnsauth.example.com @8.8.8.8 和权威 NS 双向确认;CAA 需放行 trustasia.com,否则 CA 会拒绝签发。 部署到 HAProxy 2.8 时把 fullchain 与私钥 cat 成单个 PEM,执行 haproxy -c -f 检查;验证用 openssl s_client -servername ... -status,确认 Verify return code: 0 (ok) 且 OCSP Response Status: successful。

为什么 *.example.com 装上了还是报证书不匹配?——问题背景与根本原因

先说结论:证书本身没坏,HAProxy 和 Envoy 也没有配错。当浏览器或客户端提示 certificate is not valid for a.b.example.com 时,九成以上的原因是通配符的匹配边界只由证书 SAN 决定,与你写在 bind 或 filter_chains 里的主机名无关。据 RFC 6125 第 6.4.3 节,通配符只替换最左侧的一个标签,并且不得匹配公共后缀或跨注册域。

证书 SAN 访问的主机名 是否匹配 原因
*.example.com api.example.com ✅ 只替换最左一个标签
*.example.com example.com ❌ 通配符不覆盖裸域
*.example.com a.b.example.com ❌ 多级子域需 *.b.example.com
*.example.com api.example.com.cn ❌ 不同注册域,属于另一张证书

验证证书实际的 SAN 与有效期时,不要只看 CN:Chrome 58 起已完全忽略 CN。

# 查看本地证书文件的 SAN、生效/失效时间(关键行:subjectAltName 才是匹配依据)
openssl x509 -in trustasia.crt -noout -subject -dates -ext subjectAltName
# 输出示例:
# notBefore=Mar  1 00:00:00 2026 GMT
# notAfter=Sep 17 23:59:59 2026 GMT        <-- 约 200 天
# X509v3 Subject Alternative Name:
#     DNS:*.example.com, DNS:example.com

# 查看服务端实际下发的叶子证书 SAN(排查“装错证书/装到别的 vhost”)
openssl s_client -connect api.example.com:443 -servername api.example.com 
  -showcerts </dev/null 2>/dev/null | openssl x509 -noout -ext subjectAltName

# 校验链完整性:缺中间证书时,Android 7.1、Java 8u301 会报
# unable to get local issuer certificate / PKIX path building failed
openssl verify -untrusted chain.pem leaf.pem

据 TrustAsia 产品文档,一张 trustasia 通配符证书默认只保护一个通配符域名(*.example.com),裸域 example.com 不在其中。若要同时覆盖主域和二级业务域,需在下单时把 example.com、*.api.example.com 追加进 SAN,或改买多域名 SAN 证书;控制台通常以“通配符 + 主域”组合下单,订单页会列出最终 SAN 清单,以该清单为准。另需注意有效期约束:CA/Browser Forum SC-081 规定自 2026-03-15 起公开信任 TLS 证书最长有效期降至 200 天,续期节奏从“每年一次”变成“约每 60 天检查一次、到期前 30 天更换”,TrustAsia 实际签发时长以订单页显示为准。

证书链问题最容易被误判成“通配符失效”:只把叶子证书贴进 HAProxy 的 crt 文件而漏掉中间证书时,桌面浏览器可能因缓存或 AIA 抓取而正常,但 Android 7.1、Java 8u301 直接报 unable to get local issuer certificate。TrustAsia RSA 常见链为 TrustAsia TLS RSA CA → DigiCert Global Root CA,下载包需拼接 fullchain,具体以实际下载包为准。

最后一个隐患是共享通配符:一张 *.example.com 私钥被 20 个业务复用,任一测试环境泄露就得全量轮换。建议按环境拆分为 *.prod.example.com 与 *.staging.example.com,并在证书台账中记录 SAN 列表、到期日、负责人和关联 DNS 记录,这样在 HAProxy 多 crt-list 或 Envoy 多 DownstreamTlsContext 场景下才能快速定位是哪张证书在报错。

从域名盘点、CSR 到 DCV:TrustAsia 通配符证书申请与签发的 6 个步骤

问:从决定买 TrustAsia 通配符证书到拿到可用的证书文件,中间到底要做哪些事?

把流程拆成六步:盘点主机名 → 选型 → 生成 CSR → 提交订单 → 完成 DCV 与 CAA → 下载核对。前两步决定你买什么,后四步决定证书能不能一次签发成功。

步骤 1:盘点所有需要 HTTPS 的主机名

通配符 *.example.com 只匹配一级子域(api.example.com),不匹配 a.b.example.com,也不匹配 apex example.com——这是后续 SAN 组合设计的根因。先用日志反查真实使用过的主机名:

# 从 Nginx 访问日志提取 Host,并按域名层级分组(首列 1=apex,2=一级子域,3=多级子域)
awk -F'"' '{print $2}' access.log | awk '{print $2}' | sort -u 
  | awk -F. '{print NF-1, $0}' | sort -n

# 中文域名必须先转 punycode,否则 CSR 里的 SAN 会被 CA 拒收
idn2 例子.中国          # 输出 xn--fsqu00a.xn--fiqs8s(idn2 来自 libidn2-utils)

盘点结论要落成三张清单:一级子域(进通配符)、apex 与多级子域(进 SAN 或另买证书)、必须独立私钥的主机(如支付回调、跨团队隔离的网关),后者不能用共享通配符私钥。

步骤 2:DV 还是 OV?

对比项 DV 通配符 OV 通配符 EV 通配符
验证方式 仅域名控制权(DNS/HTTP) 域名控制权 + 营业执照 + 电话回访 —
签发时长 通常几分钟到数小时 通常 1–3 个工作日 —
证书主题是否含组织 否(仅 CN/SAN) 是(O、C 字段) 是
是否签发通配符 是 是 业界普遍不签发,不要按 EV 通配符询价
适用场景 纯一级子域、预算敏感 需在证书中展示企业主体 不适用

步骤 3:生成 CSR(OpenSSL 3.0.13 实测)

# -addext 需要 OpenSSL 1.1.1+;Ubuntu 24.04 默认 3.0.13
# 一次性把通配符和 apex 都写进 SAN,避免签发后才发现缺 apex
openssl req -new -newkey rsa:3072 -sha256 -nodes 
  -keyout example.com.key -out example.com.csr 
  -subj '/CN=*.example.com' 
  -addext 'subjectAltName=DNS:*.example.com,DNS:example.com'

chmod 600 example.com.key      # 私钥权限收紧到仅属主可读
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'

CSR 只含公钥与主题信息,可安全提交给渠道;私钥永远不出服务器。

步骤 4:提交订单

在 TrustAsia 合作渠道控制台粘贴上面的 CSR(或让平台代生成,但代生成意味着私钥经手第三方,不建议)。提交前逐项确认:SAN 列表是否含 *.example.com 与 example.com、证书链类型(是否需要交叉链兼容老客户端)、是否附带中间证书。保存订单号——DCV 重试、重签、发票都靠它。

步骤 5:完成 DCV 与 CAA 检查

据 Let’s Encrypt 文档,通配符证书必须走 DNS-01 验证;TrustAsia 商业通配符同样以 DNS TXT/CNAME 为主,HTTP-01 无法验证通配符。按控制台给出的记录名添加,TTL 设 60 秒便于快速重试:

# 1) 校验 DCV 记录是否已生效(以控制台给出的 _dnsauth 主机名为准)
dig +short TXT _dnsauth.example.com @8.8.8.8

# 2) 检查 CAA(RFC 8659):无记录=不限 CA;有记录则必须放行签发 CA
dig +short CAA example.com @8.8.8.8
# 若返回:0 issue "letsencrypt.org"
# 需追加一条:0 issue "trustasia.com"
# 注意:通配符签发优先查 issuewild,未配置时回落到 issue;
# 保险做法是 issue 与 issuewild 同时放行。

CAA 未放行时,订单会一直卡在”验证中”或直接报 CAA 校验失败,且往往不提示是哪条记录拦的——这是最高频的排错点。

步骤 6:下载与核对

openssl x509 -in fullchain.crt -noout -subject -issuer -dates -ext subjectAltName
# 期望输出(节选):
# subject=CN = *.example.com
# issuer=C = CN, O = "TrustAsia Technologies, Inc.", CN = TrustAsia TLS RSA CA
# notBefore=...  notAfter=...
# X509v3 Subject Alternative Name:
#     DNS:*.example.com, DNS:example.com

三处必查:SAN 是否同时含通配符与 apex、Issuer 是否为 TrustAsia 对应中间 CA(而非根 CA,说明 fullchain.crt 已带中间证书)、有效期是否符合预期。核对通过后再替换 HAProxy/Envoy 的证书文件,否则会踩到”浏览器信任但 Java 客户端握手失败”的缺链问题。

证书落地:OpenSSL 3.0、HAProxy 2.8 与 Envoy 1.29 的配置示例

问:HAProxy 为什么不能直接读我下载的 .crt 和 .key?

因为 HAProxy 的 crt 参数只接受”单个 PEM 文件”,OpenSSL 从文件里按出现顺序查找证书与私钥。顺序必须是叶子证书 → 中间证书 → 私钥;把私钥写在最前面,或漏掉中间证书,haproxy -c 会直接抛出 unable to load SSL private key from PEM file。据 HAProxy 2.8 配置手册,该文件同时用于 SSL_CTX_use_certificate_chain_file 与 SSL_CTX_use_PrivateKey_file,所以顺序不可随意。

# 顺序固定:leaf(通配符叶子证书) → intermediate → private key
cat fullchain.crt example.com.key > /etc/haproxy/certs/example.com.pem
chmod 600 /etc/haproxy/certs/example.com.pem
# 自查:PEM 内应有 3 个 BEGIN CERTIFICATE 块 + 1 个 BEGIN PRIVATE KEY
grep -c 'BEGIN CERTIFICATE' /etc/haproxy/certs/example.com.pem

问:HAProxy 2.8.5 的最小可用 HTTPS 配置长什么样?

global
    log stdout format raw local0
    # HAProxy 2.2+ ssl-min-ver 默认已是 TLSv1.2,显式声明防配置漂移
    # no-tls-tickets 关闭会话票据(票据默认开启),便于轮换密钥后立即失效
    ssl-default-bind-options ssl-min-ver TLSv1.2 no-tls-tickets

defaults
    mode http
    timeout connect 5s
    timeout client  30s
    timeout server  30s

frontend fe_https
    bind *:443 ssl crt /etc/haproxy/certs/example.com.pem alpn h2,http/1.1
    default_backend be_app

backend be_app
    server app1 127.0.0.1:8080 check
haproxy -c -f /etc/haproxy/haproxy.cfg   # 期望输出 Configuration file is valid
systemctl reload haproxy                 # 不要 restart,reload 才不断连
openssl s_client -connect 127.0.0.1:443 -servername a.example.com -alpn h2 </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates

问:OCSP stapling 怎么开?为什么日志一直刷 OCSP update failed?

HAProxy 2.8 支持异步 OCSP 更新,但必须走 crt-list:bind ... ssl crt-list /etc/haproxy/certs/crt-list.txt,文件内容为 /etc/haproxy/certs/example.com.pem ocsp-update on。前提有两个:PEM 里必须含签发者证书(用于构造 OCSP 请求),且证书须带 AIA OCSP URL。若你用的 TrustAsia 通配符证书签发链未提供 OCSP 响应地址(部分 CA 已转向 CRL/短有效期),强行开启只会反复报 OCSP update failed,应直接关闭。

问:Envoy 1.29.2 怎么写 DownstreamTlsContext?

transport_socket:
  name: envoy.transport_sockets.tls
  typed_config:
    "@type": type.googleapis.com/envoy.extensions.transport_sockets.tls.v3.DownstreamTlsContext
    common_tls_context:
      tls_params:
        tls_minimum_protocol_version: TLSv1_2   # 枚举值写法是 TLSv1_2,不是 "TLSv1.2"
        tls_maximum_protocol_version: TLSv1_3
      alpn_protocols: ["h2", "http/1.1"]
      tls_certificates:
      - certificate_chain: { filename: /etc/envoy/certs/fullchain.pem }  # 叶子+中间
        private_key:       { filename: /etc/envoy/certs/example.com.key }
envoy --mode validate -c /etc/envoy/envoy.yaml   # 期望 configuration '...' OK

问:RSA 还是 ECDSA?

据 Mozilla Server Side TLS 5.7,现代客户端在 ALPN 协商中优先 ECDSA,但兼容性边界真实存在:

算法 典型握手字节 不支持场景 建议
RSA 3072 较大(ServerHello + Certificate ≈ 4–5 KB) 几乎无 老 Java 8(8u161 前)、IoT、老旧网关
ECDSA P-256 约 1.5 KB Java 8 早期版本、部分 Android 5 设备 现代 Web / 移动端主用
双证书并行 — — HAProxy 用 crt-list 挂两张证书,Envoy 在 tls_certificates 放两个条目

问:重载会不会断连?

HAProxy 的 systemctl reload 走无缝重载(新旧进程通过 socket 传递监听句柄)。Envoy 则是热重启:envoy --restart-epoch N -c /etc/envoy/envoy.yaml,epoch 必须递增,且要配合前置 L4 负载均衡逐台摘流(先打 admin /healthcheck/fail,再 --drain-time-s 60),否则一次性热重启会掐断长连接。每次重载后都用上面的 openssl s_client 抽检 SNI 命中,确认多级子域(如 a.b.example.com)确实落到预期证书,而不是回退到默认证书——这正是 TrustAsia 通配符证书只覆盖一级子域时最容易暴露的坑。

通配符、SAN 多域名与多级子域怎么选?参数对比与选型表

问:买一张 *.example.com 的通配符证书,能不能同时覆盖 api.example.com 和 a.b.example.com?

不能。按 RFC 6125 与 RFC 9525 的定义,通配符只匹配最左侧的单个标签(label),* 不能跨越 .。所以 *.example.com 覆盖 api.example.com、www.example.com,但不覆盖 a.b.example.com;它也不覆盖裸域 example.com,后者需要单独加一条 SAN。同理,*.api.example.com 只覆盖 x.api.example.com 这一层。这就是很多人买了 TrustAsia 通配符证书之后,多级子域仍然报主机名不匹配的根本原因——不是证书坏了,而是名字超出了覆盖范围。

上线前用 OpenSSL 验证一遍,不要靠肉眼数星号:

# 1) 查看线上实际下发的证书覆盖了哪些主机名(OpenSSL 1.1.1 / 3.x 通用)
openssl s_client -connect api.example.com:443 -servername api.example.com /dev/null 
  | openssl x509 -noout -text 
  | grep -A1 "Subject Alternative Name"
# 典型输出:DNS:*.example.com, DNS:example.com

# 2) 直接判定某个主机名是否被覆盖,避免人眼误判
#    -checkhost 需 OpenSSL >= 1.1.0,输出只有 match / does not match 两种
openssl x509 -in fullchain.pem -noout -checkhost a.b.example.com
# Hostname a.b.example.com does not match certificate

# 3) 握手阶段校验(-verify_hostname 需 OpenSSL >= 1.0.2,默认关闭,必须显式开启)
openssl s_client -connect api.example.com:443 -servername api.example.com 
  -verify_hostname a.b.example.com -verify_return_error </dev/null
# Verify return code: 62 (Hostname mismatch)

问:那到底该买通配符、SAN 多域名,还是拆成多张证书?

先把真实需要的主机名清单列全,再对照下表。价格为 2026 年常见渠道区间,实际以下单页为准。

方案 覆盖范围 价格区间(元/年) 验证/有效期 适用场景
TrustAsia DV 通配符 *.example.com,可加 example.com SAN 1,200–2,800 DNS-01,约 10 分钟–2 小时 一级子域多、预算中等
TrustAsia OV 通配符 同上,含组织信息 3,000–8,000 组织验证 1–3 工作日 对外展示企业身份
多域名 SAN DV(5 个) 指定 5 个主机名 600–1,500 DNS / HTTP 文件 域名少且固定
Let’s Encrypt 通配符 *.example.com 0 DNS-01,90 天 自动化能力强、可接受 90 天
多级子域拆证 *.api.example.com 等 按张数叠加 各自 DCV 多级子域、权限隔离

问:免费的 Let’s Encrypt 不香吗,为什么要花钱?

差别不在价格,而在责任边界与运维形态。据 Let’s Encrypt 官方文档,其证书有效期 90 天、不提供商业 SLA,也没有工单和发票;TrustAsia 提供中文工单与增值税发票,适合需要合规报销的国内企业;DigiCert 等国际品牌通配符常见 3,000–10,000 元/年,卖点是品牌背书与海外客户认知。已有 cert-manager 或 acme.sh、能接受 90 天自动轮换的团队,用 Let’s Encrypt 通配符(只能走 DNS-01)成本最低。

问:续期频率以后会怎么变?

据 CA/Browser Forum 通过的 SC-081 提案,公开信任 TLS 证书最长有效期自 2026-03-15 起降为 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。按“年”做预算时,要把一年 2 次(未来更多次)签发、灰度与回滚的人力算进去;通配符私钥复用得越多,轮换时的爆炸半径越大,这正是不少团队给 *.api.example.com 单独拆证、做权限隔离的理由。

问:内部域名也能用公共通配符吗?

技术上可以,但会被公开记录。公开信任证书一律写入 Certificate Transparency 日志,任何人在 crt.sh 搜 example.com 就能看到你签发过的全部名字。内部系统(如 *.internal.example.com)应改用私有 CA 或内网证书,别等子域被收录进 CT 日志才发现问题。

真实报错与排查:从 no alternative certificate subject name 到 OCSP 失败

curl 报 no alternative certificate subject name matches target host name,第一步该看什么?

先别动服务器配置,先确认证书本身覆盖了哪些名字。据 RFC 6125 第 6.4.3 节,通配符只匹配最左一个标签,*.example.com 匹配 a.example.com,但不匹配 a.b.example.com——这正是 trustasia 通配符证书最常见的误用场景。

# OpenSSL 1.1.1+ 才有 -ext;1.0.2 请改用 -text 加 grep
openssl x509 -in fullchain.crt -noout -ext subjectAltName
# 输出示例:
# X509v3 Subject Alternative Name:
#     DNS:*.example.com, DNS:example.com
# 旧版本替代写法
openssl x509 -in fullchain.crt -noout -text | grep -A1 "Subject Alternative Name"

如果 SAN 里只有 *.example.com,说明二级子域根本不在覆盖范围内,只能重签:把 DNS:*.b.example.com 加进 SAN,或直接为 a.b.example.com 单独签发。TrustAsia 支持在同一张证书里混用通配符与具体域名,SAN 数量受套餐限制,下单前先确认。

为什么 openssl verify 报 error 20?跟私钥有关吗?

无关。error 20 是”找不到签发者”,即中间证书缺失,浏览器能容忍是因为会自动补链(AIA fetching),而 curl、Java、Go 默认不会。据 Mozilla Server Side TLS 指南,服务端应发送完整链。

openssl verify -CAfile chain.pem cert.pem
# cert.pem: error 20 at 0 depth lookup: unable to get local issuer certificate
# 正确姿势:根 + 中间链
openssl verify -CAfile ca_bundle.crt -untrusted chain.pem cert.pem
# cert.pem: OK

修复方式是把 fullchain.crt 里的域名证书在前、中间证书在后按顺序拼接,或从 TrustAsia 下载包重新取 ca_bundle.crt,切勿把根证书也拼进去(会增大握手包)。

HAProxy 启动报 unable to load SSL private key from PEM file 怎么办?

HAProxy 要求 .pem 内同时含私钥、域名证书、中间证书。先用公钥指纹比对是否配对(RSA 用 modulus,ECDSA 没有 modulus,必须用 pubkey):

# RSA 证书
openssl x509 -in example.com.pem -noout -modulus | openssl md5
openssl rsa  -in example.com.pem -noout -modulus | openssl md5
# ECDSA 证书(TrustAsia 默认签发 ECC 时用这条)
openssl x509 -in example.com.pem -noout -pubkey | openssl md5
openssl pkey -in example.com.pem -pubout      | openssl md5
# 两次 md5 不一致 = 证书与私钥不配对

拼接顺序建议:私钥 → 域名证书 → 中间证书,文件权限 600,属主为 haproxy 用户。

CAA、DCV、OCSP 三类签发期报错怎么定位?

# 1) CAA 拦截
dig +short CAA example.com
# 0 issue "letsencrypt.org"   ← 缺 TrustAsia,CA 直接拒绝
# 追加:0 issue "trustasia.com"  TTL=300,等 5–10 分钟再重试,别反复下单

# 2) DCV 的 DNS problem: NXDOMAIN looking up TXT for _dnsauth.example.com
dig +short TXT _dnsauth.example.com @1.1.1.1   # 注意控制台常自动补主域后缀
dig +short CNAME _dnsauth.example.com @1.1.1.1 # 用 CNAME 委派时查这里
dig +short NS example.com                       # 确认权威 NS 已同步

# 3) OCSP 报 Response Verify Failure / Responder Error: unauthorized
openssl ocsp -issuer chain.pem -cert cert.pem 
  -url http://ocsp.trustasia.com -resp_text -noverify
# 关注 "Response verify OK" 与 Cert Status: good

OCSP 失败的根因通常是 issuer 不匹配:-issuer 必须传实际签发者(中间证书),不是根证书。HAProxy 2.8 起支持 ocsp-update on,但它依赖 PEM 内的完整链,缺中间证书会导致更新任务长期失败而日志只在 startup 报一次。

报错关键字 出错层 首查命令 典型修复
no alternative certificate subject name 名字匹配 openssl x509 -ext subjectAltName 重签,加 DNS:*.b.example.com
error 20 unable to get local issuer certificate 证书链 openssl verify -CAfile 拼接中间证书
unable to load SSL private key 私钥配对 -modulus | md5 换回匹配的私钥或重签
CAA record prevents issuance DNS 策略 dig +short CAA 加 0 issue "trustasia.com"
NXDOMAIN looking up TXT DCV 记录 dig +short TXT @1.1.1.1 修正记录名后缀 / 等 NS 同步
Responder Error: unauthorized OCSP openssl ocsp -resp_text issuer 传中间证书

如何确认配置生效?openssl s_client、curl 与 testssl.sh 验证清单

证书已 reload,怎么用一条命令确认主机名匹配、而且多级子域确实不在覆盖范围内?

按 RFC 6125 与 CA/B Forum 基线要求,通配符只替换最左一个标签,所以 *.example.com 对 a.b.example.com 必须匹配失败。这个“失败”本身就是验证项:它证明你买到并部署的 TrustAsia 通配符证书边界符合预期,而不是故障。

# 1) 一级子域:应匹配(OpenSSL 1.1.1+,-checkhost 自 1.0.2 起提供)
openssl s_client -connect api.example.com:443 -servername api.example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -checkhost api.example.com
# 期望输出:Hostname api.example.com does match certificate

# 2) 二级子域:应失败,用于证明通配符边界正确
openssl s_client -connect a.b.example.com:443 -servername a.b.example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -checkhost a.b.example.com
# 期望输出:Hostname a.b.example.com does NOT match certificate

链和 OCSP 怎么一次看完?加上 -showcerts -status,重点看两行:

openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts -status </dev/null
# Verify return code: 0 (ok)
# OCSP Response Status: successful (0x0)

出现 Verify return code: 21 (unable to verify the first certificate),基本可以断定 HAProxy 的 crt 只放了叶证书、漏了中间证书——拼接顺序必须是“叶证书 + 中间证书”,根证书不要放。OCSP 返回 tryLater 或空响应时,先确认证书是否带 AIA 扩展,而不是急着换 CA。

到期时间如何在命令行和监控里各查一次?

openssl x509 -in /etc/haproxy/certs/example.com.pem -noout -checkend 2592000; echo $?
# 退出码 0 = 30 天内不会过期;1 = 即将过期
# blackbox_exporter 0.25:probe_ssl_earliest_cert_expiry 是 Unix 时间戳,无默认阈值
- alert: SSLCertExpiringSoon
  expr: probe_ssl_earliest_cert_expiry - time() < 21 * 86400
  for: 1h

HTTP 层和外部扫描呢?用 --resolve 把域名固定到新入口,绕过 DNS 缓存,观察 SNI 与 SAN 是否命中:

curl -vI https://api.example.com --resolve api.example.com:443:10.0.0.10 2>&1 
  | grep -E 'SSL certificate verify|subjectAltName|TLS'
# 期望:SSL certificate verify ok. 且 subjectAltName 含 DNS:*.example.com
curl -vI --tlsv1.2 --tls-max 1.2 https://api.example.com   # 验证老协议兼容性

testssl.sh --protocols --headers --certificate --server-defaults https://api.example.com   # 3.2 版
nmap -p443 --script ssl-cert,ssl-enum-ciphers api.example.com

testssl.sh 3.2 的判据是:无 TLS 1.0/1.1、无 RC4、证书链完整(“Chain of trust OK”);nmap 的 ssl-enum-ciphers 给出 A/B/C 评级作为交叉验证。

怎么确认新证书已入 CT 日志、流量也切了?

# crt.sh 返回顺序不保证,按 not_before 排序取最新一条
curl -s 'https://crt.sh/?q=%25.example.com&output=json' 
  | jq -r 'sort_by(.not_before) | last | [.not_before,.not_after] | @tsv'
dig +short api.example.com   # 必须指向新入口,否则只是换了证书没切流量
工具 检查层级 能否验证链/OCSP 可否脚本化判断 典型用途
openssl s_client + x509 握手与证书本身 能(-showcerts -status) 能,非 0 退出码 CI 与发布前检查
curl HTTP over TLS 仅链(verify ok) 能,配合 –fail 验证 SNI 与入口路由
testssl.sh 3.2 协议、套件、漏洞 能 能,支持 –severity 上线前合规扫描
blackbox_exporter 0.25 持续探测 仅暴露指标 否,走 Prometheus 告警 到期与可用性长期监控

这套清单的顺序有意义:先用 -checkhost 定边界,再用 -status 定信任链,最后用 curl 与 CT/DNS 定流量——任何一步跳过,都可能出现“证书装对了但请求仍打到旧节点”的假成功。

续期与密钥轮换:通配符证书如何避免一次过期影响全部子域?

问:一张 trustasia 通配符证书过期,为什么可能同时打挂上百个子域?因为 *.example.com 被所有一级子域共享,没有第二张证书作为后备时,续期失败就会造成全部子域同时故障。据 CA/Browser Forum Ballot SC-081(2025 年 3 月通过),公网 TLS 证书最长有效期将于 2026-03-15 缩短至 200 天、2027-03-15 至 100 天、2029-03-15 至 47 天;续期频率只会越来越高,把续期当成一次性任务,必然无法持续。

问:提前量怎么排?按 200 天上限倒排:签发后第 140 天(到期前 60 天)启动重签,第 170 天(前 30 天)完成灰度,第 193 天(前 7 天)全量。别只依赖 CA 邮件,因为邮件可能进垃圾箱,也可能发给已离职同事;必须自建两条监控轨道。

# 轨道一:直接读证书到期时间(OpenSSL 1.0.2+ 通用)
openssl x509 -enddate -noout -in /etc/haproxy/certs/fullchain.crt
# 输出示例:notAfter=Nov 12 23:59:59 2025 GMT

# 轨道二:机器可判定的过期检查;返回 0 表示安全,非 0 表示已过期或剩余不足
# 5184000 秒 = 60 天
openssl x509 -checkend 5184000 -noout -in /etc/haproxy/certs/fullchain.crt 
  || echo "CRITICAL: 剩余不足 60 天"

# 同时核对 SAN 是否仍覆盖实际在用的子域(通配符只覆盖一级)
openssl x509 -noout -text -in /etc/haproxy/certs/fullchain.crt 
  | grep -A1 "Subject Alternative Name"

把 -checkend 的结果接入 Prometheus textfile collector 或 Zabbix trapper,比解析邮件可靠得多。

问:私钥要不要每次换?要。据 OpenSSL 文档与 Mozilla Server Side TLS 指南,定期轮换密钥能缩小历史私钥泄露造成的影响;复用旧 key 等于让一次泄露长期有效。

# 新建 3072 位 RSA 私钥并生成 CSR(-addext 需 OpenSSL 1.1.1+)
openssl req -new -newkey rsa:3072 -nodes 
  -keyout wildcard.example.com.2025q4.key 
  -out    wildcard.example.com.2025q4.csr 
  -subj   "/CN=*.example.com" 
  -addext "subjectAltName=DNS:*.example.com,DNS:example.com"

# 提交 CA 前自检 CSR 的 SAN(最终 SAN 以 CA 签发结果为准)
openssl req -noout -text -in wildcard.example.com.2025q4.csr 
  | grep -A1 "Subject Alternative Name"

旧证书与旧 key 保留 7 天回滚窗口;确认没有客户端做证书 pin(移动 App、IoT 固件最常见)后再删除。

问:灰度怎么走?顺序是 *.staging.example.com → 单台 HAProxy/Envoy → 10% 流量 → 全量。每一步都用真实 SNI 拨测,而不是只看进程是否活着:

# 指定 SNI,验证某台后端实际下发的证书序列号与有效期
openssl s_client -connect 10.0.1.11:443 -servername api.example.com 
  -showcerts /dev/null 
  | openssl x509 -noout -serial -dates -subject

HAProxy 替换 crt 文件后需 reload(2.6+ 可用 runtime API set ssl cert 热更新);Envoy 通过 SDS 下发可免 reload。若一次性替换全部节点,出问题时就没有对照组了。

问:渠道有 API 时,脚本要校验什么?用订单号 + 新 CSR 重新签发,写入密钥库前必须验证三项:openssl x509 -checkend 0 返回 0、SAN 列表与预期逐项一致、证书链完整。没有 API 就把 CSR 生成、DCV 记录(DNS-01 TXT)、CAA 检查写成 runbook。

维度 复用旧私钥 每次续期新建私钥
私钥泄露后的影响 新证书同样可被冒用 仅限旧证书剩余有效期
部署动作 只换 crt crt + key 成对更新并 reload
回滚复杂度 低 中(须成对回滚)
合规参考 不推荐 符合 NIST SP 800-57 的密钥周期建议

问:私钥放哪、谁来管?用 Vault 1.15 的 PKI 引擎或云 KMS 托管,按 staging/prod 分权,禁止私钥进 Git。台账至少记录序列号、SAN、签发时间、到期时间、负责人、关联子域清单;每季度审计一次“哪些子域还在用旧 trustasia 通配符证书”,并把多级子域(如 *.api.example.com 这类一级通配符覆盖不到的场景)单独列成清单,避免下次续期时才发现覆盖缺口。

默认不覆盖。*.example.com 只匹配一级子域,example.com 本身必须作为独立 SAN 加入;下单时勾选主域或在 CSR 中写 DNS:example.com,否则访问 https://example.com 仍会报名称不匹配。

一级子域数量通常不限制,但只覆盖一级,且受 CA 策略与订单条款约束;a.b.example.com 属于二级子域,不在 *.example.com 范围内,需要加 DNS:*.b.example.com 或单独签发。

需要中文工单、发票、OV 组织信息展示,选 TrustAsia,DV 通配符常见 1,200–2,800 元/年;能接受 90 天有效期、有 DNS API 做自动化,选 Let's Encrypt,费用为 0。两者都要求 DNS-01 验证通配符。

目标主机名不在证书 SAN 中。*.example.com 不匹配 a.b.example.com 和 example.com;用 openssl x509 -in fullchain.crt -noout -ext subjectAltName 确认 SAN,再重签追加对应 DNS 名称。

需要。只装叶子证书时,部分客户端会报 error 20 unable to get local issuer certificate;应使用 fullchain,HAProxy 把 fullchain 与私钥合并成单个 PEM,并用 openssl s_client -showcerts 确认至少返回 2 张证书。

技术上可以,运维上不建议。私钥泄露会影响全部一级子域;至少把生产与测试拆成 *.prod.example.com、*.staging.example.com,私钥放 Vault 1.15 或 KMS,按团队授权并记录轮换时间。

公开信任证书受 CA/Browser Forum SC-081 约束,2026-03-15 起最长有效期降至 200 天;TrustAsia 实际签发有效期以订单页为准,续期流程应按 60 天检查、到期前 30 天更换来设计。


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

内容审核

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