跳到主要内容
HTTPS安装配置

HTTPS 多域名证书(SAN/UCC)配置实战:从 CSR 生成到 Nginx、Apache、Exchange 部署

HTTPS 多域名证书(SAN/UCC)配置实战:从 CSR 生成到 Nginx、Apache、Exchange 部署 — HTTPS 多域名证书(SAN/UCC)配置实战:从 CSR 生成到 Nginx、Apache、Exchange 部署

问题背景与根因:单域名证书为什么撑不住多站点架构

典型场景:一个业务同时对外提供 example.com(官网)、www.example.com(站点)、api.example.com(开放接口)、pay.example.com(支付回调)、m.example.com(H5)。早期为了省钱,每个域名单独申请一张 DV 单域名证书,运维半年后通常会出现三类问题:一是证书台账失控,5 个域名 5 张证书,到期时间各不相同,靠表格记录必然漏续;二是 Nginx 上要维护 5 个 server 块,证书路径、加密套件、HSTS 配置四处分叉,改一次要改五遍;三是 CDN、负载均衡、WAF 回源各存一份私钥,泄露面成倍放大。

根因在证书的身份校验机制。X.509 证书用 subject 里的 CN(Common Name)标识身份,但 CN 字段只能放一个名字。RFC 6125 与 CA/Browser Forum 基线要求早已明确:证书必须在 subjectAltName(SAN)扩展中列出所有主机名,主流浏览器(Chrome、Firefox、Safari)在 CN 与 SAN 并存时只看 SAN,只有 SAN 没有 CN 也完全合法。这意味着即便只保护一个域名,证书里也必须带 SAN 条目。

第二个根因是 SNI 匹配。TLS 握手时客户端在 ClientHello 里发送 server_name 扩展,服务端据此选择证书;客户端收到证书后,会用自己请求的主机名去比对证书的 SAN 列表,任何一个条目都匹配不上就判定失败。Chrome 报 NET::ERR_CERT_COMMON_NAME_INVALID,Firefox 报 SSL_ERROR_BAD_CERT_DOMAIN,命令行 curl 报 curl: (60) SSL: no alternative certificate subject name matches target host name,本质都是同一个原因。

第三个根因是对通配符的误解。*.example.com 只匹配一级子域,不匹配裸域 example.com,也不匹配 a.b.example.com。业务方临时上线一个二级子域,运维只能重新签发。因此多域名(SAN)证书不是可选项,而是多入口架构下的默认方案。

概念厘清:SAN、UCC 与通配符证书的真实边界

UCC 是 Unified Communications Certificate 的缩写,源自微软 Exchange 2007/2010 时代对统一通信(IIS、SMTP、Autodiscover、OWA)场景的证书要求。如今主流 CA 已统一改称 Multi-Domain SAN Certificate,UCC 只是历史叫法,二者在技术上完全等价:都是在一张证书的 SAN 扩展里放多个 dNSName。

关于数量上限,网上常见的「最多 250 个一级域名」说法需要修正。SAN 是 X.509 v3 的扩展字段,理论上受证书总长度限制可以放很多条目,但实际受 CA 商业政策约束:Sectigo、DigiCert 等通常按购买的主域名数量叠加,单证书常见上限 100~250 个名称;Let’s Encrypt 单张证书限制 100 个名称,且同一注册域名每周签发次数有限制。选购时应以 CA 当前政策为准,而不是按理论值规划。

类型 覆盖范围 是否覆盖裸域 新增子域 适用场景
单域名证书 1 个 FQDN 需单独写进 SAN 必须重新签发 单入口、测试环境
通配符 *.example.com 任意一级子域 不覆盖 无需重签 子域按租户动态扩展
SAN 多域名 多个不同 FQDN,可跨主域 覆盖 必须重新签发 多品牌、多业务线
通配符 + SAN 多个通配符 + 多个裸域 覆盖 部分无需重签 大型混合架构

选型建议:域名总数不超过 5 个且层级固定,直接上 SAN 多域名;子域按租户无限扩展(如 t001.example.com),用通配符;既有裸域又有二级子域,买「通配符 + SAN」组合,一张证书里同时写 DNS:example.com 和 DNS:*.example.com。

实操一:生成带 SAN 扩展的 CSR

先确认 OpenSSL 版本,1.1.1 及以上才支持 -addext 参数:openssl version。CentOS 7 默认 1.0.2,需要用配置文件方式。

方式一(OpenSSL 1.1.1+,单行可直接执行):

openssl req -new -newkey rsa:2048 -nodes -keyout example.key -out example.csr -subj '/C=CN/ST=Beijing/L=Beijing/O=Example Technology Co., Ltd./CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com,DNS:pay.example.com,DNS:*.shop.example.com'

方式二(通用,写配置文件 example.cnf):

[req]
default_bits = 2048
prompt = no
default_md = sha256
distinguished_name = dn
req_extensions = v3_req

[dn]
C = CN
ST = Beijing
L = Beijing
O = Example Technology Co., Ltd.
OU = IT
CN = example.com

[v3_req]
basicConstraints = CA:FALSE
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth, clientAuth
subjectAltName = @alt_names

[alt_names]
DNS.1 = example.com
DNS.2 = www.example.com
DNS.3 = api.example.com
DNS.4 = pay.example.com
DNS.5 = *.shop.example.com

执行 openssl req -new -key example.key -out example.csr -config example.cnf。

若需要 ECDSA P-256 证书,把密钥生成换成 openssl ecparam -genkey -name prime256v1 -out example.key,再执行 openssl req -new -key example.key -out example.csr -config example.cnf,其余不变。

校验 CSR:openssl req -in example.csr -noout -text | grep -A3 'Subject Alternative Name',必须能看到全部域名。三个必查项:CN 必须同时出现在 SAN 列表中(部分 CA 会拒绝 CN 不在 SAN 的请求);私钥权限 chmod 400 example.key;CSR 只含公钥,可以安全传给 CA,私钥绝不能外发。

实操二:签发、证书链拼接与自动续期

CA 签发后一般返回两个文件:example.crt(服务器证书,含你的域名)和 ca-bundle.crt(中间证书)。Nginx 的 ssl_certificate 必须指向「服务器证书 + 中间证书」的合并文件,顺序是叶子在前、中间在后,根证书不要放(客户端本地已有)。

cat example.crt ca-bundle.crt > example.fullchain.pem
openssl verify -CAfile ca-bundle.crt example.crt
openssl x509 -in example.fullchain.pem -noout -subject -issuer -dates -ext subjectAltName

用 Let’s Encrypt 签发多域名证书(certbot 2.x):

certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com -d api.example.com -d pay.example.com --cert-name example-multi --agree-tos -m ops@example.com --no-eff-email

或使用 Nginx 插件:certbot --nginx -d example.com -d www.example.com -d api.example.com --cert-name example-multi。注意 --cert-name 固定证书目录,后续增减域名都复用同一个 lineage,避免生成 example-0001 之类的重复证书目录。

自动续期:先 certbot renew --dry-run 演练,再在 /etc/letsencrypt/renewal-hooks/deploy/reload.sh 里写 nginx -t && systemctl reload nginx 并 chmod +x。商业 CA 的证书有效期上限已被压缩到 398 天(2020-09-01 起 Apple 与 Chrome 强制),Let’s Encrypt 为 90 天,人工续期不可行,必须自动化。

配置示例:Nginx / Apache / Tomcat 与 Exchange

Nginx(1.25.1+ 写法):

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

    ssl_certificate     /etc/nginx/ssl/example.fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/example.key;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-RSA-AES256-GCM-SHA384;
    ssl_prefer_server_ciphers off;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;
    ssl_session_tickets off;
    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/example.chain.pem;

    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
    add_header X-Content-Type-Options nosniff always;
}

旧版本 Nginx 把 http2 on; 换成 listen 443 ssl http2;。若同时部署 ECDSA 与 RSA 双证书,重复写两行 ssl_certificate / ssl_certificate_key 即可,Nginx 1.11.0+ 会按客户端能力自动选择。

Apache:

<VirtualHost *:443>
    ServerName example.com
    ServerAlias www.example.com api.example.com pay.example.com
    SSLEngine on
    SSLCertificateFile      /etc/httpd/ssl/example.crt
    SSLCertificateKeyFile   /etc/httpd/ssl/example.key
    SSLCertificateChainFile /etc/httpd/ssl/ca-bundle.crt
    SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
    SSLHonorCipherOrder off
    Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>

Apache 2.4.8 之后更推荐用 SSLCACertificateFile 代替已废弃的 SSLCertificateChainFile。ServerAlias 必须把所有 SAN 域名都列上,否则请求会落到默认虚拟主机。

Tomcat:先转 PKCS12 再改 Connector。

openssl pkcs12 -export -in example.fullchain.pem -inkey example.key -name example -out example.p12 -passout pass:changeit
<Connector port='443' protocol='org.apache.coyote.http11.Http11NioProtocol' SSLEnabled='true' scheme='https' secure='true'>
  <SSLHostConfig>
    <Certificate certificateKeystoreFile='/opt/tomcat/conf/example.p12' certificateKeystorePassword='changeit' certificateKeystoreType='PKCS12' type='RSA' />
  </SSLHostConfig>
</Connector>

Exchange 2013 及以上版本原生支持 SAN 证书:在 EAC → 服务器 → 证书 → 新建,或执行 New-ExchangeCertificate -DomainName mail.example.com,autodiscover.example.com,owa.example.com -Services IIS,SMTP -PrivateKeyExportable $true,再在证书属性里勾选 IIS、SMTP、IMAP、POP 服务。Autodiscover 必须作为 SAN 之一,否则 Outlook 客户端会反复弹出凭据框。

关键参数对比:有效期、算法与兼容性

算法 握手性能 证书体积 兼容性 建议
RSA 2048 基准 约 1.2 KB 全覆盖 兜底必选
RSA 3072/4096 慢 30%~70% 约 2 KB 全覆盖 无合规要求不必上
ECDSA P-256 快 2~3 倍 约 0.8 KB TLS 1.2+ 主流客户端 首选,与 RSA 双证并存
ECDSA P-384 略慢于 P-256 约 1 KB 同上 高安全等级场景
校验等级 审核内容 签发周期 浏览器表现 适用
DV 仅验证域名控制权 分钟级 普通锁标识 绝大多数业务
OV 验证企业主体资质 1~3 个工作日 普通锁标识 金融、政企合规
EV 严格主体审核 3~7 个工作日 Chrome 77 起不再显示绿色公司名 仅作合规背书

SHA-1 已于 2017 年被所有主流浏览器彻底拒绝,任何新证书都必须是 SHA-256 及以上,因此「支持 SHA2」早已是唯一选项而非卖点。有效期方面,CA/B Forum 基线要求自 2020-09-01 起服务器证书最长 398 天,Apple 与 Chrome 会直接拒绝超期证书;Let’s Encrypt 固定 90 天。任何宣称「买三年」的产品,实际是三年期合同加每 398 天强制换发一次,必须配套自动化。

常见错误排查:真实报错逐条定位

1. 浏览器 NET::ERR_CERT_COMMON_NAME_INVALID,curl 报 curl: (60) SSL: no alternative certificate subject name matches target host name:SAN 里没有该域名。定位命令 openssl s_client -connect api.example.com:443 -servername api.example.com </dev/null 2>/dev/null | openssl x509 -noout -ext subjectAltName,核对返回列表是否包含正在访问的主机名。

2. unable to verify the first certificate 或 SSL certificate problem: unable to get local issuer certificate:服务端没有下发中间证书。用 -showcerts 数返回的证书数量,正常至少 2 张;把 ssl_certificate 指向 fullchain 合并文件即可。

3. SSL_CTX_use_PrivateKey: key values mismatch:私钥与证书不配对。RSA 比对 openssl x509 -noout -modulus -in example.crt | openssl md5 与 openssl rsa -noout -modulus -in example.key | openssl md5,两值必须一致;ECC 用 openssl x509 -noout -pubkey 与 openssl pkey -pubout 对比。

4. nginx: [emerg] PEM_read_bio_X509_AUX() failed:证书文件格式异常,常见于从 Windows 复制带入 CRLF 换行或混入了多余文本。执行 dos2unix example.fullchain.pem 并确认文件以 -----BEGIN CERTIFICATE----- 开头。

5. Java 客户端 javax.net.ssl.SSLHandshakeException: java.security.cert.CertificateException: No subject alternative names present:客户端不支持 SNI,或证书缺 SAN。旧 JDK(8u51 之前)默认不发 SNI,多域名站点会拿到默认证书;升级 JDK 或为该客户端单独配置默认 server 块。

6. Exchange 报 The certificate is not valid for the requested usage 或事件 ID EXPRX1006:证书未勾选对应服务(IIS/SMTP/IMAP/POP),或 SAN 缺少 autodiscover 主机名。在 EAC 证书属性中勾选服务并执行 Enable-ExchangeCertificate -Thumbprint <hash> -Services IIS,SMTP。

7. certbot renew 报 Problem binding to port 80: Could not bind to IPv4 or IPv6:standalone 模式端口被 Nginx 占用。改用 --webroot,或先 systemctl stop nginx 再续期(不推荐)。

8. Too many certificates already issued for exact set of domains:命中 Let’s Encrypt 速率限制,同一组域名每周签发次数有限。调试一律加 --dry-run 或 --staging,不要在正式环境反复试。

效果验证与到期监控

部署完成后,从外部节点做三件事:查看证书内容、校验链、打分。

openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://pay.example.com/health

ssl_verify_result 返回 0 表示链校验通过;非 0 值(如 20、21)对应 OpenSSL 的 X509_V_ERR 错误码。

curl -s 'https://api.ssllabs.com/api/v3/analyze?host=example.com&publish=off&all=done' | jq -r '.endpoints[0].grade'

到期监控脚本(用 -checkend 判断剩余秒数,避免解析日期字符串):

#!/bin/bash
HOSTS='example.com www.example.com api.example.com pay.example.com'
for h in $HOSTS; do
  if ! echo | openssl s_client -servername $h -connect $h:443 2>/dev/null | openssl x509 -noout -checkend 1296000 >/dev/null; then
    echo WARN $h will expire within 15 days
  fi
done

再做一次「清单对齐」:把证书 SAN 列表导出,与 Nginx 的 server_name、DNS 解析记录做 diff,能提前发现漏配或配错的域名。

openssl x509 -in example.fullchain.pem -noout -ext subjectAltName | tr ',' 'n' | grep DNS

建议把上面这段 diff 与到期监控放进同一条巡检流水线,每天跑一次,告警直接推到值班群。证书问题 90% 不是签不出来,而是换证书时漏了某个入口、或某台机器上的旧文件没被覆盖。

常见问题

一张 SAN 证书最多能放多少个域名?

技术上受 X.509 证书长度限制,理论上可以放很多;实际受 CA 政策约束,主流商业 CA 单证书常见 100~250 个名称,Let’s Encrypt 单证书上限 100 个名称。原文的「250 个一级域名」是早期某家 CA 的产品上限,不是协议限制,采购前务必确认当前政策。

UCC 证书和 SAN 证书有什么区别?

没有技术区别。UCC 是微软 Exchange 生态的历史叫法,指能同时覆盖 IIS、SMTP、Autodiscover 多个名称的证书;现在 CA 统一叫 Multi-Domain SAN Certificate,判断标准就是证书的 SAN 扩展里包含多个 dNSName。

已经有通配符证书,还需要 SAN 证书吗?

看域名层级。*.example.com 覆盖 a.example.com,但不覆盖 example.com 本身,也不覆盖 a.b.example.com。常见做法是一张证书里同时放 DNS:example.com 和 DNS:*.example.com,或直接采购「通配符 + SAN」组合证书。

证书有效期到底是 398 天还是 1 年?

CA/B Forum 基线要求自 2020-09-01 起,服务器证书最长有效期 398 天,Apple 与 Chrome 会拒绝超期证书;Let’s Encrypt 固定 90 天。任何「买三年」的产品,实际是三年合同加每 398 天强制换发,必须配套自动续期和部署钩子。

为什么浏览器提示证书无效,但 openssl 命令看着正常?

最常见是中间证书缺失:openssl s_client 默认只展示服务端发来的链,若服务端没发中间证书,浏览器(尤其 Android、部分 Java 客户端)会因为无法补齐链路而报错。用 -showcerts 数一下返回的证书数量,正常应至少 2 张;再确认 ssl_certificate 指向的是 fullchain 文件而非单张叶子证书。

ECC 证书会不会导致老客户端无法访问?

ECDSA P-256 在 TLS 1.2+ 的主流浏览器、Android 5.0+、iOS 9+ 上均支持,但 Windows XP/Server 2003、部分老旧嵌入式设备、Java 6 不支持。稳妥做法是在 Nginx 上同时配置 ECDSA 与 RSA 两张证书,由服务端按客户端能力协商。

内容审核

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