跳到主要内容
基础知识

SAN 多域名证书是什么?从 CSR 到 Nginx 配置的完整实操与排错

san多域名证书是什么 — SAN 多域名证书是什么?从 CSR 到 Nginx 配置的完整实操与排错
核心结论

SAN 多域名证书是指在一张 X.509 证书的 subjectAltName 扩展中写入多个 DNS 名称或 IP 的证书;浏览器按 RFC 6125 校验 SAN,CN 从 Chrome 58 起不再作为回退,Let's Encrypt 单证书最多 100 个 identifier。 生成 CSR 可用 OpenSSL 1.1.1/3.x:openssl req -new -newkey rsa:2048 -nodes -keyout example.key -out example.csr -subj '/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com'。 Nginx 1.24/1.26 在 443 server 块中配置 fullchain.pem 与 privkey.pem,server_name 必须与 SAN 有交集;Nginx 1.25.1 起使用 http2 on;,旧版本写 listen 443 ssl http2;。 certbot 2.x 用 certbot certonly --nginx -d example.com -d www.example.com -d api.example.com --cert-name example.com 申请,新增名称用 --expand,续期后用 nginx -t && systemctl reload nginx 重载。 选型上,不同主域且名称数不超过 5 个优先 SAN 多域名证书;大量同级子域优先通配符;商业 DV SAN 多域名证书常见 100-800 元/年,通配符 DV 常见 300-1500 元/年,价格以 CA 订单页为准。

“证书明明配了,为什么浏览器还是报域名不匹配?”先分清两个字段:X.509 证书 subject 里的 CN(Common Name)只是历史遗留的展示字段,TLS 客户端真正用来校验主机名的是 v3 扩展 subjectAltName(SAN)。据 RFC 5280 第 4.2.1.6 节,SAN 是 non-critical 扩展,可容纳任意多个 dNSName、iPAddress 等 GeneralName;RFC 6125 第 6.4.2 节规定客户端应以 SAN 中的标识符为准做主机名匹配。所以 san 多域名证书是什么?就是把 example.com、www.example.com、api.example.com 等多个 FQDN 写进同一张证书的 SAN 列表,一次部署覆盖多个站点,而不必为每个域名单独签一张证书。

回退到 CN 的时代已经结束:Chrome 58(2017 年)起不再回退到 CN,Firefox 48 起同样要求 SAN 存在。证书里缺少目标域名时,Chrome 报 NET::ERR_CERT_COMMON_NAME_INVALID,curl 报 curl: (60) SSL: no alternative certificate subject name matches target host name 'api.example.com'。先用 OpenSSL 看清证书里到底有什么(OpenSSL 1.1.1 及以上支持 -ext):

# 直接列出 SAN 列表;OpenSSL 1.1.1 / 3.x 可用
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -ext subjectAltName
# 输出示例:
# X509v3 Subject Alternative Name:
#     DNS:example.com, DNS:www.example.com, DNS:api.example.com

# OpenSSL 1.0.2 等旧版本没有 -ext,用等价写法
openssl x509 -in fullchain.pem -noout -text | grep -A1 "Subject Alternative Name"

# 按 SNI 实际握手,验证 443 上返回的是哪张证书(-servername 决定虚拟主机)
openssl s_client -connect 203.0.113.10:443 -servername api.example.com /dev/null 
  | openssl x509 -noout -subject -ext subjectAltName

根本原因往往不是“证书没配”,而是 443 端口上的多站点复用依赖 SNI:Nginx/Apache 从 ClientHello 的 server_name 选择虚拟主机和证书,SNI 名称与证书 SAN 无交集时,要么握手失败,要么静默返回 default_server 的证书。

# /etc/nginx/conf.d/example.conf —— 适用于 nginx 1.11.0+ 的 listen ... ssl 写法
server {
    listen 443 ssl;              # 1.25.1 起推荐 listen 443 ssl; http2 on;
    server_name example.com www.example.com api.example.com;  # 必须与证书 SAN 一一对应
    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;  # 含中间证书
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_protocols       TLSv1.2 TLSv1.3;   # Mozilla 中间兼容配置的默认建议
}
# 若该 server 是默认站点,未匹配到 SNI 的请求会拿到这张证书,因此别把无关域名放进同一 server_name

容量与选型:单域名证书只含 1 个 DNS 名称;SAN 多域名证书可在一张证书里放多个 identifier,据 Let’s Encrypt 文档,当前单证书上限为 100 个名称,且每个名称都要单独通过 DCV(域名控制验证)。通配符 *.example.com 只覆盖一级子域,既不覆盖 example.com,也不覆盖 a.b.example.com;而 SAN 多域名证书可以把 example.com、*.example.com、api.example.com 混在同一张证书里。UCC(Unified Communications Certificate)是商业 CA 的营销叫法,技术上仍是 SAN 多域名证书,选型时看 SAN 数量、验证类型(DV/OV/EV)、价格和续期方式,不必为“UCC”标签付费。

证书类型 覆盖范围 典型 SAN 内容 续期与成本 适用场景
单域名 DV 恰好 1 个 FQDN DNS:example.com Let’s Encrypt 免费,90 天自动续期 单站点、内部服务
SAN 多域名 2–100 个 identifier(LE 上限) DNS:example.com, DNS:www.example.com, DNS:api.example.com 同上;商业 CA 按 SAN 数阶梯计价 多子域、多品牌共用一台入口
通配符 仅一级子域 *.example.com DNS:*.example.com, DNS:example.com LE 需 DNS-01 验证 子域数量多且动态
UCC(营销名) 技术等同 SAN 多域名 多个 FQDN 通常高于同 SAN 数的普通证书 Exchange/Skype 等历史场景

申请 SAN 多域名证书的 6 个实操步骤(OpenSSL 3.x + ACME)

先明确一个前提:san多域名证书是什么决定了你后面每一步要填什么——它不是”一张证书覆盖多个网站”,而是一张证书的 subjectAltName 扩展里挂多个 FQDN,浏览器只认 SAN,不再校验 CN(RFC 6125 已废弃 CN 匹配)。所以第 1 步做错,后面全白费。

第 1 步:盘点 FQDN,别把私名写进公网证书。列出必须覆盖的 example.com、www.example.com、api.example.com。确有 IP 需求时在 SAN 中写 IP:203.0.113.10,但据 Let’s Encrypt 官方文档,其不为 IP 地址签发证书,公网 IP SAN 只能走商业 CA;intranet.local、*.internal 这类不可公开验证的名称同样会被拒绝。DCV 方式的选择直接决定后面能不能批量:

验证方式 适用场景 前提 典型失败
HTTP-01 少量公网域名 每个域名 80 端口可达 Connection refused / 301 跳转丢 token
DNS-01 通配符、几十个域名的批量签发 能写 _acme-challenge TXT TXT 未生效、CAA 拦截
TLS-ALPN-01 只能用 443 的环境 443 独占 与现有 Web 服务抢端口

第 2 步:生成私钥与 CSR。OpenSSL 1.1.1 及 3.0.x/3.1.x/3.2.x 均支持 -addext(1.1.0 及更早不支持,需改用 openssl.cnf 的 [v3_req] 段写 subjectAltName):

# -nodes:私钥不加口令(便于服务自动读取);rsa:2048 为兼容性首选,可换 ec 曲线
openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.key -out example.csr 
  -subj '/CN=example.com' 
  -addext 'subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com'
# 老版本替代:openssl req -new -key example.key -out example.csr -config openssl.cnf -extensions v3_req

第 3 步:核对 CSR 里的 SAN。提交前务必自查,否则 CA 只按订单 identifier 签发,CSR 与订单不一致会被退回:

openssl req -in example.csr -noout -text | grep -A2 'Subject Alternative Name'
# 期望输出:DNS:example.com, DNS:www.example.com, DNS:api.example.com

第 4 步:完成 DCV。HTTP-01 把 token 文件放到 http://example.com/.well-known/acme-challenge/<token>;DNS-01 在 _acme-challenge.example.com 加 TXT。别忘 CAA,否则报 CAA record prevents issuance:

dig +short CAA example.com
# 期望:0 issue "letsencrypt.org"

第 5 步:下载并校验证书链。要拿到 leaf + 中间证书合并的 fullchain.pem,顺序必须是站点证书在前、中间证书在后:

openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName

第 6 步:部署与续期。certbot 2.x 由 systemd timer 每日检查(证书 90 天有效,剩余 30 天自动续),先演练再上线:

certbot renew --dry-run
# 续期后只 reload,不 restart,避免中断存量连接
nginx -t && systemctl reload nginx
# Apache:apachectl -t && systemctl reload apache2

更稳的做法是挂 deploy hook:certbot renew --deploy-hook "systemctl reload nginx",这样手动续期和定时续期都能自动生效。续期失败最常见的原因是第 4 步的 80 端口被防火墙或 CDN 回源规则挡住——ACME 走的是 RFC 8555 的 ACME v2 协议,验证请求永远从公网侧发起。

Nginx 1.24/1.26 与 Apache 2.4.58 配置示例:SAN 多域名证书怎么绑定多个站点

拿到一张 SAN 多域名证书(Subject Alternative Name,即一张证书的 SAN 扩展里列出多个域名)之后,最常见的疑问是:同一张证书能不能同时给多个站点、多个 server 块使用?答案是能,但前提是每个 server 块的 server_name 必须与该证书 SAN 列表有交集,否则浏览器会报 ERR_CERT_COMMON_NAME_INVALID,curl 则输出 curl: (60) SSL: no alternative certificate subject name matches target host name。下面按 Nginx 1.24/1.26 与 Apache 2.4.58 分别给出可直接复制的配置。

Nginx 1.24/1.26:http2 指令的版本分水岭。据 Nginx 官方文档,http2 独立指令自 1.25.1 引入,同时 listen ... http2 写法被标记为 deprecated,启动时会打印 the "listen ... http2" directive is deprecated, use the "http2" directive instead 警告。

# /etc/nginx/conf.d/example.conf  —— Nginx 1.25.1+ / 1.26 写法
server {
    listen 443 ssl;                 # 1.25.1 起 http2 不再写在 listen 里
    http2 on;                       # 1.24.x 请改为: listen 443 ssl http2;
    server_name example.com www.example.com api.example.com;  # 必须与证书 SAN 有交集

    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;  # 含中间证书
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    ssl_protocols TLSv1.2 TLSv1.3;  # 默认值自 nginx 1.23.4 起即为 TLSv1.2 TLSv1.3
    ssl_prefer_server_ciphers off;  # 默认 off,与 Mozilla 中间兼容配置一致
    ssl_session_cache shared:SSL:10m;
}

多个站点共享同一张证书时,ssl_certificate 既可写在每个 server 块内,也可写在 http 上下文统一继承(该指令的合法上下文为 http、server)。真正的坑在 SNI 缺失:若客户端未发送 SNI,Nginx 只能回落到 default_server 的证书,此时访问 api.example.com 就会拿到 example.com 的证书。可用 -noservername 复现(SNI 定义见 RFC 6066):

# 不带 SNI 发起握手,观察返回的证书 CN/SAN
openssl s_client -connect 127.0.0.1:443 -noservername </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -ext subjectAltName

Apache 2.4.58:fullchain 直接进 SSLCertificateFile。据 Apache mod_ssl 文档,自 2.4.8 起 SSLCertificateFile 允许把服务器证书与中间证书串联写入同一文件,独立的 SSLCertificateChainFile 已不推荐使用。

<VirtualHost *:443>
    ServerName example.com
    ServerAlias www.example.com api.example.com   # 等价于 SAN 覆盖范围
    SSLEngine on
    SSLCertificateFile    /etc/letsencrypt/live/example.com/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
    SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1        # 默认 all,此处显式禁用旧协议
</VirtualHost>
配置项 Nginx 1.24 / 1.26 Apache 2.4.58
启用 TLS listen 443 ssl; SSLEngine on
证书链文件 ssl_certificate SSLCertificateFile
私钥 ssl_certificate_key SSLCertificateKeyFile
域名匹配 server_name ServerName + ServerAlias
协议版本 ssl_protocols SSLProtocol

用 certbot 2.x 签发或扩容 SAN。据 Let’s Encrypt 文档,同一张证书的域名上限为 100 个;新增域名时用 --expand 让 certbot 重建同一 --cert-name 的证书,避免生成 example.com-0001 这类目录:

# 首次签发多域名证书
sudo certbot certonly --nginx -d example.com -d www.example.com -d api.example.com 
  --cert-name example.com

# 后续追加域名(必须显式列出全部旧域名 + 新域名)
sudo certbot certonly --nginx -d example.com -d www.example.com -d api.example.com 
  -d new.example.com --expand --cert-name example.com

通配符 SAN 的两个硬性约束。第一,必须走 DNS-01 挑战,因为 CA 无法对 *.example.com 做 HTTP 文件验证;第二,*.example.com 不覆盖裸域 example.com(见 RFC 6125 关于通配符仅匹配单层标签的规则),apex 必须单独列入 SAN。

# 通配符 + apex 一起签发,注意引号防止 shell 展开 *
sudo certbot certonly --manual --preferred-challenges dns 
  -d '*.example.com' -d example.com --cert-name wildcard-example

验证配置是否生效,别只看 nginx -t:curl -svI https://api.example.com --resolve api.example.com:443:127.0.0.1 能看到实际协商的协议版本与证书链,比单纯重启服务更能暴露 SAN 不匹配的问题。

SAN 多域名证书、通配符证书、单域名证书怎么选?参数对比表

选证书前先问自己三个问题:要覆盖几个主域?子域是否只在一级?是否必须提供组织信息?这三问决定了你应该选单域名、SAN 多域名、通配符还是组合方案。

方案 覆盖范围 验证方式 参考价格(DV,国内常见区间) 适用场景
单域名证书 1 个 FQDN HTTP-01 / DNS-01 0–100 元/年 单站、测试站
SAN 多域名证书 2–100 个 FQDN/IP 每个名称单独 DCV 100–800 元/年 多子域、多品牌、多域名
通配符证书 *.example.com,apex 需另加 必须 DNS-01 300–1500 元/年 大量同级子域
SAN + 通配符 多主域 + 多级子域混合 以 DNS-01 为主 500–3000 元/年 多业务线统一证书
OV/EV SAN 组织验证 + 多名称 人工审核 800–8000 元/年 企业合规、合同要求

价格随 CA、年限、SAN 数量与促销波动,以订单页为准。判断 SAN 多域名证书是什么、是否适合你,可用一条命令查看任意站点实际覆盖了哪些名称:

# 读取对端证书并打印 SAN 列表(OpenSSL 1.1.1+/3.x 通用)
openssl s_client -connect www.example.com:443 -servername www.example.com /dev/null 
  | openssl x509 -noout -subject -dates -ext subjectAltName
# 输出示例:
# subject=CN = example.com
# notBefore=...  notAfter=...
# X509v3 Subject Alternative Name:
#     DNS:example.com, DNS:www.example.com, DNS:api.example.com, IP Address:203.0.113.10

选型规则:不同主域且名称数不超过 5 个,优先 SAN 多域名证书;同一主域下大量一级子域(a.example.com、b.example.com…),优先通配符;跨主域又必须展示组织信息,选 OV SAN;名称超过 100 个或跨团队权限复杂时,拆成多张证书更易管理。

成本边界:商业 CA 通常对第 2 个及以后 SAN 收附加费,而 Let’s Encrypt 免费。据 Let’s Encrypt 文档,同一注册域名每周限发 50 张证书、每 3 小时限 300 个新订单(rate limit)。高频测试务必切到 staging 环境,否则会撞上 too many certificates already issued for: example.com。ACME 客户端切换示例:

# certbot 使用 staging 端点做联调(--dry-run 已默认走 staging)
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com 
  --dry-run            # 只演练不签发,验证 DCV 与配置是否正确
# 生产签发时去掉 --dry-run;国内 CA 走 DNS-01 时把 --webroot 换成 --manual --preferred-challenges dns

安全边界:SAN 多域名证书把多个域名的信任绑定在同一私钥上,私钥一旦泄露,全部 SAN 名称同时受影响。建议 chmod 600 privkey.pem && chown root:root privkey.pem,按团队/业务拆证书,不要把生产私钥复制到开发机。

兼容边界:公网 CA 签发的 SAN 多域名证书在主流浏览器及 Java 8u301+/11+ 信任库中可用;私有 CA 签发的证书必须先把根证书导入客户端 trust store,否则依旧报 unable to get local issuer certificate。这与证书里放了几个 SAN 无关,是信任链问题——后续章节会结合 openssl verify 与 Nginx ssl_trusted_certificate 展开。

先明确一个高频误解:SAN 多域名证书是什么决定了浏览器只认 Subject Alternative Name(SAN)扩展里的 DNS 条目,Common Name(CN)自 Chrome 58(2017 年)起不再作为回退依据——据 Chromium 安全团队公告与 RFC 6125 第 6.4.4 节,主机名验证必须以 SAN 为准。所以”CN 写对了、SAN 漏了”是最典型的翻车姿势。下面按报错原文逐条拆。

curl: (60) SSL: no alternative certificate subject name matches target host name

这条报错有两个独立成因:证书 SAN 里确实没有该域名,或 SNI 把请求路由到了默认站点(返回了另一张证书)。必须带 -servername 复现,否则你看到的可能只是默认 vhost 的证书:

# 模拟浏览器 SNI 握手,只提取 SAN 扩展(OpenSSL 1.1.1+ 支持 -ext)
openssl s_client -connect api.example.com:443 
  -servername api.example.com /dev/null 
  | openssl x509 -noout -ext subjectAltName

# 预期输出示例
# X509v3 Subject Alternative Name:
#     DNS:example.com, DNS:www.example.com, DNS:api.example.com

# 同时看服务端实际下发的证书链与主体
openssl s_client -connect api.example.com:443 -servername api.example.com 
  -showcerts /dev/null | openssl x509 -noout -subject -issuer -dates

若输出里没有目标域名,只能重签;若输出的是别的站点证书,说明 Nginx 里该 server_name 没有独立 server 块,落到了 default_server。用 openssl s_client -connect IP:443(不带 servername)对比一次,就能判定是不是 SNI 路由问题。

Chrome: NET::ERR_CERT_COMMON_NAME_INVALID

证书查看器 → “使用者可选名称” 为空或缺少目标域名,即为根因。此时改 CN 无效,必须重签 CSR 并确保 subjectAltName 覆盖全部域名。用一条命令批量验证一组主机名(含通配符规则),避免逐个手点浏览器:

# 逐域名验证,非 0 退出码即为不匹配
for h in example.com www.example.com api.example.com; do
  echo | openssl s_client -connect "$h:443" -servername "$h" 2>/dev/null 
    | openssl x509 -noout -checkhost "$h"
done
# 输出示例:Certificate hostname api.example.com does not match

Nginx: no ‘ssl_certificate’ is defined / SSL_CTX_use_PrivateKey_file() failed

前者是 443 的 server 块漏写证书指令(Nginx 1.11.0 起支持在 http 层复用证书,但 443 监听块仍需可见的 ssl_certificate);后者几乎都是证书与私钥不配对。用 modulus 指纹比对,两行输出必须完全一致:

# 证书与私钥的模数指纹比对(RSA 证书)
openssl x509 -noout -modulus -in /etc/letsencrypt/live/example.com/fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in /etc/letsencrypt/live/example.com/privkey.pem   | openssl md5
# ECDSA 证书改用:
# openssl pkey -noout -pubout -in privkey.pem | openssl md5

# 改完配置先语法检查再平滑重载
nginx -t && nginx -s reload

注意 fullchain.pem 必须包含中间证书,否则部分 Android 与旧版 Java 客户端会报链不完整,而非域名不匹配——两者容易混淆。

certbot 三类报错怎么定位

报错原文 根因 处置
The server could not connect to the client to verify the domain HTTP-01 校验需 80 端口可达;被防火墙、CDN 回源或 301 跳 HTTPS 阻断 临时放行 80,或改用 --preferred-challenges dns
DNS problem: NXDOMAIN looking up A for … A/AAAA 记录缺失或未生效 补记录并等 TTL 过期后重试
CAA record for example.com prevents issuance 存在 CAA 但未授权 letsencrypt.org 追加 0 issue "letsencrypt.org"

据 Let’s Encrypt 官方速率限制文档,同一注册域名每周 50 张、失败校验每小时 5 次,撞限后盲目重试只会延长封禁。上线前务必演练:

# 用 staging 环境验证整条签发链路,不消耗生产配额
certbot certonly --webroot -w /var/www/html 
  -d example.com -d www.example.com -d api.example.com 
  --server https://acme-staging-v02.api.letsencrypt.org/directory 
  --dry-run

# 排查是否对同一组 SAN 重复申请
certbot certificates

通配符为什么仍然 hostname mismatch

RFC 6125 与 CA/Browser Forum 基线要求均规定:*.example.com 只匹配恰好一级子域,不匹配 example.com 本身,也不匹配 a.b.example.com;公共 CA 普遍拒签 *.*.example.com。正确做法是把 apex 与常见二级子域显式写入 SAN:

# 通配符 + apex 组合:覆盖 example.com、www/api 等一级子域
certbot certonly --webroot -w /var/www/html 
  -d example.com -d '*.example.com'      # 注意通配符需加引号防 shell 展开
# 需要 a.b.example.com 时必须单独 -d a.b.example.com 或另签一张证书

最后一条通用纪律:任何”域名不匹配”先跑 openssl x509 -noout -ext subjectAltName 确认服务端实际下发的 SAN 列表,再判断是重签证书还是修 SNI 路由——顺序反了会浪费大量时间在错误的方向上。

如何验证 SAN 多域名证书生效?6 条命令与检查点

验证 SAN 多域名证书是否真的生效,核心是回答一个问题:对每个 SAN 名称发起连接时,服务器经 SNI 返回的那张证书里,是否都包含该名称?据 RFC 6125 第 6.4.4 节,客户端必须用 SNI 中的主机名去匹配证书的 subjectAltName;现代浏览器和 curl/OpenSSL 都已忽略 CN(Common Name),只认 SAN。所以只验证主域名是不够的,必须逐个 SAN 名称过一遍。以下 6 个检查点从本地文件一路查到线上握手与到期时间。

检查点 1:本地读取证书文件,确认 SAN 列表本身写对了

# 直接解析 certbot 产出的 fullchain.pem(第一张是站点证书)
sudo openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem 
  -noout -subject -issuer -dates -ext subjectAltName
# 期望输出片段:
# subject=CN = example.com
# issuer=C = US, O = Let's Encrypt, CN = R11
# notBefore=...  notAfter=...
# X509v3 Subject Alternative Name:
#     DNS:example.com, DNS:www.example.com, DNS:api.example.com

若 -ext subjectAltName 报 No extensions in certificate,说明你签的不是 SAN 证书或拿错了文件(例如误读 cert.pem 之外的旧文件)。-ext 选项需要 OpenSSL 1.1.1 及以上,更老的 1.0.2 请改用 openssl x509 -text -noout 后搜索 Alternative Name。

检查点 2:远程握手,验证 SNI 分流是否正确

# 把 example.com 依次换成每一个 SAN 名称执行
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | openssl x509 -noout -ext subjectAltName

注意 -servername 不能省:省略后 OpenSSL 不发送 SNI,共享 IP 的服务器可能返回默认站点证书,你会误判为”证书不匹配”。据 OpenSSL 文档,s_client 默认不启用 SNI,必须显式传参。所有 SAN 名称返回的指纹应一致(同一张证书),否则说明存在多张证书混用。

检查点 3:用 curl 模拟真实客户端,顺带验证解析与跳转

# --resolve 绕过 DNS,把域名钉到指定 IP,便于在切换前预验证
curl -vI https://api.example.com --resolve api.example.com:443:203.0.113.10
# 关注三行:
# * Server certificate:  ... subjectAltName: host "api.example.com" matched cert's "api.example.com"
# * SSL certificate verify ok.
# < HTTP/2 200   (200/301/403 都算通过,只要不是证书错误)

如果 SAN 缺失,你会看到 curl: (60) SSL: no alternative certificate subject name matches target host name 'api.example.com'——这是最典型的真实报错,比浏览器提示更容易定位。

检查点 4:certbot 清单与续期演练

sudo certbot certificates          # 看 Certificate Name / Domains / Expiry Date
sudo certbot renew --dry-run       # 不写盘地跑一遍续期,验证 webroot 与钩子
systemctl list-timers | grep certbot   # Debian/Ubuntu 的 certbot.timer 是否已启用

Domains: 一行必须列全所有 SAN;据 Let’s Encrypt 文档,单张证书最多 100 个名称,超出需拆分。若 timer 不存在,说明是 cron 安装方式,改用 systemctl list-timers 之外的 /etc/cron.d/certbot 核查。

检查点 5:第三方在线核验

  • Qualys SSL Labs 的 Certificate #1 区块会列出完整 SAN 与链顺序,还能发现中间证书缺失。
  • crt.sh 查询 CT 日志,可确认是否出现过你不认识的 SAN(证书误签或历史遗留)。
  • Mozilla SSL Configuration Generator 用来对照 TLS 1.2/1.3 的协议与套件默认值。

检查点 6:到期监控(30 天阈值)

# 返回 "Certificate will expire" 表示 2592000 秒(30 天)内到期;无输出即安全
openssl s_client -connect example.com:443 -servername example.com /dev/null 
  | openssl x509 -noout -checkend 2592000

接 Prometheus blackbox_exporter 时,用 probe_ssl_earliest_cert_expiry 指标并对每个 SAN 单独建探针,否则某一个域名漏签会长期静默。

检查点 关键命令 通过判据 典型失败信号
本地文件 openssl x509 -ext subjectAltName 列出全部 DNS 名称 No extensions in certificate
远程 SNI openssl s_client -servername 各 SAN 返回同一证书 返回默认站点证书
客户端实测 curl -vI --resolve verify ok + 名称匹配 curl (60) 名称不匹配
certbot certbot certificates / renew --dry-run Domains 含全部 SAN dry-run 报 challenge 失败
在线 SSL Labs / crt.sh Certificate #1 的 SAN 完整 链不完整、出现陌生 SAN
到期 openssl x509 -checkend 2592000 无输出 Certificate will expire

常见追问:为什么浏览器显示安全但某个子域报错?通常是该子域没被写进 SAN——SAN 多域名证书的本质是”一张证书、多个身份”,漏一个名称就等于没签。可回到 CSR 阶段核对 subjectAltName 扩展,或参考本站《从 CSR 到 Nginx 配置》一节的 -addext 写法。

SAN 多域名证书续期与运维清单:扩域名、拆证书、监控 CT

先回答一个高频问题:san多域名证书是什么?它就是在一张 X.509 证书的 subjectAltName 扩展里塞进多个 DNS 名称(RFC 5280 第 4.2.1.6 节),浏览器只认 SAN 列表、不再看 CN。明白了这一点,续期和扩容的本质就变成”如何安全地修改这张证书的 SAN 集合”。下面按操作顺序给出可复制的清单。

一、扩 SAN:一次带齐全部域名,锁死 –cert-name

certbot 2.x(当前 2.x/3.x 均适用)扩域名不要新建证书目录,否则旧目录会变成孤儿。正确做法是重新执行 certonly 并列出旧域名 + 新域名的全集,用 --cert-name 指定原证书名。据 certbot 官方文档,--expand 在 2.x 中仍可用但已是冗余参数,列出超集 -d 即会自动扩展,保留它只是兼容旧脚本。

# 1) 扩 SAN:-d 必须包含全部旧域名,否则会被"缩容"
certbot certonly --webroot -w /var/www/html 
  --cert-name example.com 
  -d example.com -d www.example.com -d api.example.com -d shop.example.com 
  --expand --non-interactive --agree-tos -m ops@example.com

# 2) 校验 SAN 是否真的写入(别只看文件名)
openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout -ext subjectAltName

# 3) 只替换文件不重载 = 没换证书
nginx -t && systemctl reload nginx

漏掉第 3 步是最常见的”续期成功但线上还是旧证书”故障,排查时用 curl -sv https://example.com 2>&1 | grep expire 对比文件里的 notAfter 即可定位。

二、拆证书的阈值:什么时候不该继续合并

Let’s Encrypt 对单张证书的 SAN 名称数硬上限为 100,超限时 ACME 服务端直接拒绝,certbot 报 Error creating new order :: too many names in order(malformed 类错误),此时除了拆证书别无他法。经验阈值如下:

SAN 名称数 建议 依据
1–20 合并一张 续期一次覆盖全部,运维成本最低
20–50 可按主域/部门分组 单次 HTTP-01 校验失败不影响其他组
50–100 建议拆分 任一域名校验失败会拖垮整次续期
>100 必须拆分 超出 Let’s Encrypt 上限,无法签发

跨部门、跨环境(生产/预发)、跨注册主域时优先拆,原因是私钥共享范围等于泄露爆炸半径:一张证书的 privkey 泄露,攻击者可冒充其中所有域名。SAN 多域名证书是什么并不神秘,它省的是管理成本,代价正是这种耦合。

三、权限、备份与恢复前提

# 期望输出 600 root:root;archive/ 下的 privkey 同理
stat -c '%a %U:%G' /etc/letsencrypt/live/example.com/privkey.pem

# 备份必须包含 renewal/(记录 --cert-name 与认证器参数)和 accounts/(ACME 账户密钥)
tar -czf /backup/le-$(date +%F).tgz 
  /etc/letsencrypt/live /etc/letsencrypt/archive 
  /etc/letsencrypt/renewal /etc/letsencrypt/accounts
# 产物应落入加密仓库(KMS/Vault/带 SSE-KMS 的 S3),禁止明文进 Git

只备份 fullchain.pem 和 privkey.pem 是不够的:丢掉 renewal/example.com.conf 后 certbot renew 会找不到证书,丢掉 account key 则需要重新注册 ACME 账户,续期链路整体重建。

四、CAA 与 CT 监控:发现未授权域名立即吊销

# 只授权 Let's Encrypt;有商业 CA 时追加 issue "digicert.com" 等
example.com. 300 IN CAA 0 issue     "letsencrypt.org"
example.com. 300 IN CAA 0 issuewild "letsencrypt.org"
example.com. 300 IN CAA 0 iodef     "mailto:security@example.com"

dig +short CAA example.com   # 验证生效;注意 RFC 8659 的父域向上继承规则

CAA 是事前限制,CT 日志是事后发现。用 crt.sh 的 JSON 接口(https://crt.sh/?q=example.com&output=json)或 Cert Spotter API 每日拉取一次,比对返回的 name_value 与你的域名白名单,出现陌生子域说明有人绕过流程签发了证书——按 CA/B Forum 基线要求走吊销(certbot 用 certbot revoke --cert-path ... --reason keycompromise)后重签。

五、变更窗口与回滚

# 变更前留存上一版,回滚时直接换回并 reload
cp -a /etc/letsencrypt/live/example.com /backup/live-example.com-$(date +%F)

# 先在一台节点验证,再滚动 reload
openssl s_client -connect 10.0.0.11:443 -servername www.example.com 
  </dev/null 2>/dev/null | openssl x509 -noout -dates -ext subjectAltName

certbot certificates   # 核对 Expiry Date 与 Domains 是否与预期一致

低峰期执行的理由是 OCSP/CRL 与部分客户端缓存会短暂不一致。收尾必须同时核对两处:证书文件时间戳(ls -l --time-style=full-iso /etc/letsencrypt/live/example.com/)和 certbot certificates 输出的 Expiry Date,只对一处容易在软链未更新时误判成功。Mozilla 服务器端 TLS 指南建议的 reload 而非 restart 方式,也正是为了让存量连接平滑过渡。

技术上是一回事:UCC 是商业 CA 对 SAN 多域名证书的营销叫法。判断标准看 subjectAltName 里是否包含多个 DNS 名称,以及验证类型是 DV、OV 还是 EV,不要只看商品名。

取决于 CA。据 Let's Encrypt 文档,单证书最多 100 个 identifier;商业 CA 常见 5、10、25、100 个档位,超出按附加 SAN 收费。名称越多,私钥影响面和 CT 暴露面越大。

可以,但必须把 example.com 和 www.example.com 都写进 SAN。只申请 *.example.com 不会覆盖根域名 example.com;只写 CN=example.com 也不够,浏览器按 SAN 校验。

同 CA、同验证类型下,单域名最便宜,SAN 多域名按名称加价,通配符通常高于普通 DV。Let's Encrypt 对三者都免费但有速率限制;商业 DV SAN 常见 100-800 元/年,通配符 DV 常见 300-1500 元/年。

先确认新域名是否在证书 SAN 列表中,再确认 Nginx/Apache 的 server_name 是否命中该证书,最后用 openssl s_client -servername 新域名 检查 SNI 返回。常见原因是只改了 server_name 没重签证书,或请求落到 default_server。

CAA 错误检查 _acme-challenge 和 issue 记录;HTTP-01 错误检查 80 端口、CDN 回源和 301 跳转。可先用 certbot renew –dry-run 或 staging 环境复现,再按 –expand 带全量 -d 重签。

不能只吊销单个 SAN 名称,吊销针对整张证书。应吊销整张证书、重签新证书并轮换私钥,同时检查 CT 日志和访问日志;如果多域名共享私钥风险高,后续按业务拆成多张证书。


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

内容审核

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