跳到主要内容
ssl证书按装

HTTPS 多域名证书(SAN/UCC)配置实战:CSR 生成、Nginx 部署与排错

HTTPS 多域名证书(SAN/UCC)配置实战:CSR 生成、Nginx 部署与排错 — HTTPS 多域名证书(SAN/UCC)配置实战:CSR 生成、Nginx 部署与排错

为什么单域名证书会拖垮运维:多域名 HTTPS 的根因分析

一个中型业务通常同时暴露 example.com、www.example.com、api.example.com、static.example.com、m.example.com 等 5~30 个域名。如果每个域名单独买一张证书,运维会立刻撞上四个硬约束:

  • Nginx/Apache 的 443 端口每个 server 块只能绑定一组 ssl_certificate,多域名必须靠 SNI 分流,每个块都要维护独立证书路径和独立续期任务;
  • 公有 CA 签发的证书有效期上限已被 CA/B Forum 压到 398 天(2020-09-01 起强制),Let’s Encrypt 更是只有 90 天,续期任务数量随域名数线性增长;
  • 各证书到期时间不一致,监控告警退化成噪声;
  • 每新增一个子域都要重走申请、验证、部署流程。

根因在于证书与域名的绑定粒度。X.509 证书通过 subjectAltName(SAN)扩展声明自己覆盖的全部 FQDN,该扩展定义在 RFC 5280 第 4.2.1.6 节。现代浏览器只认 SAN,完全忽略 CN(Common Name)——Chrome 58(2017 年)就已移除对 CN 的回退匹配。大量“证书装上了但浏览器仍报不安全”的事故,就是 CA 只把域名写进了 CN 而没有写进 SAN。

所谓 UCC(Unified Communications Certificate)是微软 Exchange 2010 时代的商业叫法,指“一张证书里放多个邮箱域名”,技术本质与 SAN 证书完全相同。今天正确的说法统一是“多域名 SAN 证书”。

先用一条命令确认你手里的证书到底覆盖了哪些域名:

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

如果输出里没有 X509v3 Subject Alternative Name 段落,或只列出了部分域名,那么无论 CN 写得多正确,浏览器都会对未列出的域名抛出 NET::ERR_CERT_COMMON_NAME_INVALID。

第一步:规划 SAN 列表、有效期与密钥算法

下单或提 CSR 之前,先把三件事定死,否则后期改证书等于推倒重来。

1)SAN 列表。协议层对 SAN 条目数量没有硬上限,但商业 CA 按域名数量计价,单张证书常见上限为 100~250 个域名(不同 CA 产品线不同),且每个条目必须是完整 FQDN。三条易踩的规则:泛域名 *.example.com 只覆盖一级子域,不覆盖 example.com 本身,也不覆盖 a.b.example.com;泛域名和普通域名可以混在同一张证书里;内网 IP、localhost 只能由私有 CA 签发,公有 CA 一律拒绝。

2)有效期。当前公有证书单张最长 398 天;Let’s Encrypt 免费证书 90 天。CA/B Forum 已通过分阶段缩短方案:2026-03-15 起 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。这意味着“买一张管三年”的做法已彻底失效,证书必须纳入自动化续期。

3)算法。签名算法必须是 SHA-256 及以上,SHA-1 证书自 2017 年起被主流浏览器全面拒绝。密钥类型二选一:RSA 2048/3072 位(兼容性最好,Exchange、老 Java 客户端都吃),或 ECDSA P-256/P-384(握手更快、证书更小,TLS 1.3 下优势明显)。ECC 证书在 Windows Server 2008 及更早系统、部分老旧嵌入式设备上可能不被信任,若客户端不可控,优先 RSA 或采用双证书(RSA + ECDSA)并行。

规划完成后,先用一条命令核对现有证书的剩余寿命,避免在 398 天窗口里“续了个寂寞”:

openssl x509 -in fullchain.pem -noout -enddate | cut -d= -f2
openssl x509 -in fullchain.pem -noout -checkend 2592000 && echo "剩余超过30天" || echo "30天内到期,立即续期"

-checkend 2592000 表示检查 30 天(单位秒),可直接写进监控脚本,退出码 0 为未到期。

第二步:用 OpenSSL 生成带 SAN 的 CSR(可直接复制)

CSR 里的 SAN 必须由申请方自己写进扩展,不能指望 CA 帮你补。下面这份 san.cnf 覆盖了主域名、子域名和泛域名:

cat > san.cnf <<'EOF'
[req]
default_bits       = 2048
prompt             = no
default_md         = sha256
distinguished_name = dn
req_extensions     = v3_req

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

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

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

生成 RSA 私钥与 CSR:

openssl genrsa -out example.key 2048
chmod 600 example.key
openssl req -new -key example.key -out example.csr -config san.cnf
openssl req -in example.csr -noout -text | grep -A1 "Subject Alternative Name"

若要用 ECC,把第一步换成:

openssl ecparam -genkey -name prime256v1 -out example.key
openssl req -new -key example.key -out example.csr -config san.cnf -sha256

关键细节:CN 字段最长 64 字符,域名多时只放主域名即可,真正的覆盖范围全看 SAN;req_extensions = v3_req 不能漏,漏了 CSR 里就没有 SAN,CA 签出来的证书只能覆盖 CN 那一个域名;keyUsage 必须含 keyEncipherment(RSA 密钥交换需要)或仅 digitalSignature(ECDHE 场景),extendedKeyUsage = serverAuth 是 Exchange 兼容的硬要求,缺了会报证书用途不符。

提交给商业 CA 后,DV 证书通常几分钟出证,OV/EV 需要 1~5 个工作日做组织核验。证书到手先做一次链路拼装,顺序必须是「服务器证书 → 中间证书」,顺序颠倒会让部分客户端握手失败:

cat server.crt intermediate.crt > fullchain.pem

第三步:ACME 自动签发与续期(Let’s Encrypt / acme.sh)

如果不需要 OV/EV,直接用 ACME 一次签发全部域名,省掉 CSR 与人工验证。certbot 一条命令即可把 4 个域名写进同一张证书:

certbot certonly --webroot -w /var/www/html 
  -d example.com -d www.example.com -d api.example.com -d static.example.com 
  --cert-name example.com 
  --key-type ecdsa --elliptic-curve secp256r1 
  --agree-tos -m ops@example.com --non-interactive

注意 --cert-name:不指定时 certbot 会用第一个域名作为证书目录名,后续增删域名时容易生成“第二张证书”,导致 Nginx 指向旧文件。

泛域名不能走 HTTP-01,必须用 DNS-01。以阿里云 DNS 为例(acme.sh):

export Ali_Key="LTAI5t******"
export Ali_Secret="******"
acme.sh --issue --dns dns_ali 
  -d example.com -d '*.example.com' -d www.example.com 
  --keylength ec-256

续期与部署钩子:

acme.sh --install-cert -d example.com --ecc 
  --key-file       /etc/nginx/ssl/example.key 
  --fullchain-file /etc/nginx/ssl/fullchain.pem 
  --reloadcmd      "nginx -t && systemctl reload nginx"

--reloadcmd 是最容易被忽略的一环:证书续了但 Nginx 没 reload,线上仍在用旧证书,直到过期才被发现。certbot 侧对应的钩子写在 /etc/letsencrypt/renewal-hooks/deploy/reload.sh,并确保 systemctl list-timers | grep certbot 能看到定时器。

验证续期链路(不会真的签发,但会走完全部验证流程):

certbot renew --dry-run
acme.sh --renew -d example.com --ecc --force

90 天的 Let’s Encrypt 证书建议在剩余 30 天时续期,官方客户端默认就是这个阈值;不要改成“到期前 3 天”,一次网络抖动就足够让站点下线。

配置示例:Nginx / Apache / Exchange 三套可用配置

Nginx:一张 SAN 证书可以挂在多个 server 块上,也可以一个块里写全 server_name。推荐后者,配置更少、SNI 分支更清晰:

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

    ssl_certificate     /etc/nginx/ssl/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;
    ssl_prefer_server_ciphers off;
    ssl_session_cache   shared:SSL:10m;
    ssl_session_timeout 1d;
    ssl_stapling        on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
    add_header Strict-Transport-Security "max-age=31536000" always;
}
server {
    listen 80;
    server_name example.com www.example.com api.example.com static.example.com;
    return 301 https://$host$request_uri;
}

TLS 1.0/1.1 已于 2021 年被 RFC 8996 正式废弃,只保留 1.2 和 1.3。ssl_certificate 必须指向 fullchain(含中间证书),指向单张服务器证书会触发链不完整错误。

Apache:

<VirtualHost *:443>
    ServerName example.com
    ServerAlias www.example.com api.example.com static.example.com
    SSLEngine on
    SSLCertificateFile      /etc/httpd/ssl/fullchain.pem
    SSLCertificateKeyFile   /etc/httpd/ssl/example.key
    SSLCertificateChainFile /etc/httpd/ssl/chain.pem
    SSLProtocol             -all +TLSv1.2 +TLSv1.3
    SSLCipherSuite          ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
    SSLHonorCipherOrder     off
    Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>

Apache 2.4.8 之后 SSLCertificateChainFile 已废弃,把中间证书拼进 SSLCertificateFile 即可;保留该指令不会报错,但会在启动时产生 warning。

Exchange:UCC 场景的经典坑是 SMTP 服务的 FQDN 不在 SAN 里。导入后必须同时启用 IIS 与 SMTP 服务:

Import-ExchangeCertificate -FileData ([System.IO.File]::ReadAllBytes('C:certfullchain.pfx')) -Password (ConvertTo-SecureString -String 'PfxPwd' -AsPlainText -Force) -PrivateKeyExportable $true
Enable-ExchangeCertificate -Thumbprint <THUMBPRINT> -Services IIS,SMTP
Get-ExchangeCertificate | Format-List Subject,Thumbprint,Services,NotAfter

Exchange 要求证书的 Subject 或 SAN 包含所有客户端访问与 SMTP 使用的 FQDN,且必须带 serverAuth 用途,否则报 The certificate is not valid for the requested usage。

选型对比:单域名、多域名 SAN、通配符、多张证书

四种方案的差异不只在价格,更在续期复杂度与故障半径:

方案 覆盖范围 单证有效期上限 新增域名成本 适用场景 运维复杂度
单域名证书 1 个 FQDN 398 天 重新申请一张 独立后台、临时测试 低(单点)
多域名 SAN 证书 多个不同主域 + 子域,常见 100~250 个 398 天 重新签发(多数 CA 支持追加) 多品牌、多业务线、Exchange 中
通配符证书 *.example.com 全部一级子域 398 天 0(同域内自动覆盖) 子域动态扩张、SaaS 租户 低,但私钥泄露影响面极大
通配符 + SAN 混合 *.example.com + example.com + 其他主域 398 天 重新签发 主域与子域同时对外 中
多张单域名证书 每张 1 个 398 天 新增一张 强隔离要求(如金融多租户) 高(N 套续期与监控)

再看密钥算法:

密钥类型 握手性能 证书体积 兼容性 建议
RSA 2048 基准 约 1.2 KB 最广,含老旧设备与 Java 8 客户端不可控时首选
RSA 3072/4096 略慢 更大 广 合规要求,通常无必要
ECDSA P-256 快 30%~50% 约 0.6 KB TLS 1.2+ 现代客户端 新系统首选,可双证书并行

结论:域名数 ≥ 3 且同属一个组织时,SAN 证书的边际成本最低;子域数量不可预知时用通配符;两者可合并成一张证书,但要清楚泛域名不覆盖裸域。SHA-1 已不可选,任何仍在使用 SHA-1 签名的证书都应在下一个续期窗口内替换。

常见错误排查:从 SAN 不匹配到中间证书缺失

1)curl: (60) SSL: no alternative certificate subject name matches target host name 'api.example.com'。这是最典型的 SAN 缺失。确认证书内容:openssl x509 -in fullchain.pem -noout -ext subjectAltName。如果只列出了 example.com,说明签发时 SAN 列表没带上该域名,只能重新签发,改 Nginx 配置无效。

2)curl: (60) SSL certificate problem: unable to get local issuer certificate。链不完整——服务器只发了叶子证书,没发中间证书。用 openssl s_client -connect example.com:443 -showcerts </dev/null 数一数返回了几个 -----BEGIN CERTIFICATE-----,正常至少 2 个(叶子 + 中间)。修复:cat server.crt intermediate.crt > fullchain.pem,并让 ssl_certificate 指向 fullchain。

3)nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem": PEM_read_bio_X509_AUX() failed。文件里混进了私钥、CSR 或 Windows 换行/多余空行。用 grep -c "BEGIN CERTIFICATE" fullchain.pem 核对数量,用 openssl x509 -in fullchain.pem -noout 单独校验第一段是否能解析。

4)NET::ERR_CERT_COMMON_NAME_INVALID 但 openssl 看 SAN 是对的。多为访问了未被覆盖的形态,例如证书写的是 *.example.com,用户访问裸域 example.com;或证书写的是 www.example.com,用户访问 example.com。检查 server_name 与 DNS 解析是否指向同一台机器。

5)SSL_ERROR_BAD_CERT_DOMAIN(Firefox)。与第 4 条同源,但常见于 SNI 未生效:客户端不支持 SNI,或 Nginx 中该域名没有匹配的 server_name,请求落到了默认 server 块,返回了另一张证书。

6)certificate has expired or is not yet valid。先 date -u 看本机时间,再看 openssl x509 -noout -dates。容器或虚拟机时钟漂移是高频原因。

7)Exchange 报 The certificate is not valid for the requested usage。证书缺少 extendedKeyUsage = serverAuth,或 Enable-ExchangeCertificate 时没带 SMTP 服务。

排查顺序建议固定为:SAN 内容 → 链完整性 → 时间有效性 → SNI 匹配 → 服务端 reload。这五步能覆盖 95% 的多域名证书故障。

效果验证:单域名探测、批量巡检与 TLS 版本确认

部署完成后不要只看浏览器绿锁,要逐项验证。先验证单个域名的证书主体、签发者与 SAN:

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

批量核对一张证书声明的所有域名是否真的都能握手成功:

DOMAIN=example.com
for h in $(openssl s_client -connect $DOMAIN:443 -servername $DOMAIN </dev/null 2>/dev/null 
  | openssl x509 -noout -ext subjectAltName | tail -1 | tr ',' 'n' | sed 's/.*DNS://;s/ //g'); do
  case "$h" in **) echo "skip wildcard $h"; continue;; esac
  end=$(echo | openssl s_client -connect "$h:443" -servername "$h" 2>/dev/null 
    | openssl x509 -noout -enddate | cut -d= -f2)
  [ -z "$end" ] && echo "FAIL  $h" || echo "OK    $h  到期: $end"
done

确认协议版本已收敛(TLS 1.0/1.1 应当握手失败):

openssl s_client -connect example.com:443 -tls1_1 </dev/null 2>&1 | grep -E "Protocol|alert|handshake failure"
openssl s_client -connect example.com:443 -tls1_3 </dev/null 2>&1 | grep "Protocol"

用 curl 做端到端确认,-w 直接打印状态码、校验结果与耗时:

curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result} %{time_total}sn' https://api.example.com/
curl -sSvo /dev/null https://api.example.com/ 2>&1 | grep -E "SSL connection|subject:|issuer:"

生产环境还应加一道到期监控,退出码非 0 即告警:

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -checkend 1209600 || echo "ALERT: 证书 14 天内到期"

最后用 testssl.sh 或 SSL Labs 做一次全面体检,重点看证书链、SAN 列表、协议支持与 HSTS 是否正确下发。整套验证跑通,才算真正完成了多域名 HTTPS 的交付。

常见问题

是。UCC 是微软 Exchange 时代对多域名证书的商业叫法,技术本质就是 X.509 的 subjectAltName 扩展。如今所有 CA 与浏览器统一使用“多域名 SAN 证书”这一说法。购买时只需确认证书的 SAN 列表包含你的全部域名,名称叫法不影响任何兼容性。

协议层没有硬上限,实际取决于 CA 产品:常见单证书 100~250 个 FQDN,超出需拆分成多张证书。域名越多,私钥泄露的影响面越大,且任一域名验证失败都会拖慢整体签发,建议单张控制在 20 个以内。

不能。*.example.com 只匹配一级子域,example.com 必须单独写进 SAN。同理 a.b.example.com 也不被 *.example.com 覆盖。正确做法是把 example.com 与 *.example.com 一起放进同一张证书的 SAN 列表。

公有 CA 签发的证书单张最长 398 天,自 2020-09-01 起由主流浏览器强制。Let’s Encrypt 免费证书为 90 天。按 CA/B Forum 决议,2026-03-15 起缩短至 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天,自动化续期是唯一可行方案。

单张证书只能有一种密钥类型。若需同时支持,可申请两张证书(RSA + ECDSA),在 Nginx 中分别配置两组 ssl_certificate 与 ssl_certificate_key,由服务端按客户端能力自动选择。Exchange 等场景建议直接用 RSA 保证兼容。

证书文件已更新但服务未重载。Nginx/Apache 只在启动或 reload 时读取证书,需执行 nginx -t && systemctl reload nginx。ACME 客户端应在部署钩子里写 reloadcmd,并确认 systemd timer 或 cron 任务处于启用状态。

内容审核

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