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。
- Wildcard 通配符 SSL 证书安装部署续费申请
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
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 两张证书,由服务端按客户端能力协商。