跳到主要内容
HTTPS小程序证书

HTTPS 多域名证书(SAN/UCC)实战:一张证书覆盖多域名与子域的签发、Nginx/Apache 配置与排错

HTTPS 多域名证书(SAN/UCC)实战:一张证书覆盖多域名与子域的签发、Nginx/Apache 配置与排错 — HTTPS 多域名证书(SAN/UCC)实战:一张证书覆盖多域名与子域的签发、Nginx/Apache 配置与排错

一、问题背景与根因:为什么单域名证书在多业务场景下必然失效

典型场景:一家公司同时运营 example.com、example.net、shop-example.com 三个一级域名,每个域名下还有 www、api、m、static 等子域,另有一台 Exchange 服务器需要 autodiscover、owa、smtp 三个名字。若按“一个域名一张证书”采购,就是十几张证书、十几套私钥、十几条续期流水线,任何一张漏续期都会在凌晨触发告警。

根因有三条:

1. 浏览器早已不看 CN。自 Chrome 58、Firefox 48 起,证书主体(Subject CN)不再参与域名匹配,只认 X.509 v3 的 subjectAltName(SAN)扩展。只写 CN=example.com 的证书访问 https://example.com 同样报 NET::ERR_CERT_COMMON_NAME_INVALID,这是大量“证书明明签下来了却报错”的真实原因。

2. 通配符证书只能覆盖一级。*.example.com 能覆盖 api.example.com,但不覆盖 example.com 本身,也不覆盖 a.b.example.com,更不能跨到 example.net。多一级域名场景下通配符无能为力。

3. 有效期被压缩。自 2020-09-01 起,Apple 平台要求公有 CA 签发的 TLS 证书有效期不超过 398 天;Let’s Encrypt 免费证书固定 90 天。手工续期不可行,必须脚本化。

SAN(Subject Alternative Name)多域名证书正是为此设计:一张证书、一个私钥、一条续期任务覆盖全部名字。UCC(Unified Communications Certificate)是商业 CA 的历史叫法,本质就是带多个 SAN 的多域名证书,早期主要面向 Microsoft Exchange / Lync 统一通信场景,因此强调 Exchange 兼容性。理解这一点,选型和排错就不会走偏。

二、概念澄清:SAN、UCC、通配符、多域名证书的边界

先厘清四个高频混淆的概念,再决定买什么。

类型 覆盖示例 不覆盖 典型上限
单域名 DV example.com www.example.com(除非另加 SAN) 1 个名称
通配符 *.example.com(api、www、m) example.com 裸域、a.b.example.com、其他一级域名 1 个通配符 + 少量 SAN
多域名 SAN example.com、www.example.com、api.example.com、shop-example.com 未显式列出的任何名字 Let’s Encrypt 单证书 100 个名称;商业 CA 常见 100~250 个 SAN 条目
UCC mail.example.com、autodiscover.example.com、owa.example.com、smtp.example.com 同 SAN,本质是多域名证书的营销名 同上,强调 Exchange/Skype 兼容

关键点:裸域必须显式写进 SAN。很多 CSR 只写了 CN=example.com、SAN 里只有 www.example.com,结果裸域访问直接报错。可以用一条命令查看任意在线站点的 SAN 列表,判断对方是怎么配的:

echo | openssl s_client -connect www.example.com:443 -servername www.example.com 2>/dev/null | openssl x509 -noout -text | grep -A1 'Subject Alternative Name'

输出形如 DNS:example.com, DNS:www.example.com, DNS:api.example.com,这就是该证书实际能覆盖的全部名字。另外注意:商业 CA 通常以订单页面填写的域名列表为准来签发 SAN,CSR 里的 SAN 只作参考;自建 CA 或私有 PKI 才会严格按 CSR 的扩展签发。ECC(P-256)证书体积小、握手快,现代客户端全部支持,Exchange 2013 及以上也没问题,但若还有老旧设备(如某些打印机、老式负载均衡),优先选 RSA 2048。

三、实操第一步:用 OpenSSL 生成带 SAN 的 CSR 并本地验证

OpenSSL 默认交互式命令不会写入 SAN,必须用配置文件。下面这份 san.cnf 可直接改用:

cat > san.cnf <<'EOF'
[req]
default_bits = 2048
prompt = no
default_md = sha256
distinguished_name = dn
req_extensions = req_ext
[dn]
CN = example.com
O = Example Inc.
C = CN
[req_ext]
subjectAltName = @alt_names
[alt_names]
DNS.1 = example.com
DNS.2 = www.example.com
DNS.3 = api.example.com
DNS.4 = shop-example.com
DNS.5 = mail.example.com
DNS.6 = autodiscover.example.com
EOF
openssl req -new -newkey rsa:2048 -nodes -keyout example.key -out example.csr -config san.cnf

生成后必须自检,确认 SAN 已写入,否则提交给 CA 也会白跑一趟:

openssl req -in example.csr -noout -text | grep -A1 'Subject Alternative Name'
openssl req -in example.csr -noout -verify

若要在上线前做本地联调,可用同一份配置签一张 397 天的自签证书(务必小于 398 天,否则 iOS/macOS 直接拒绝):

openssl x509 -req -in example.csr -signkey example.key -days 397 -sha256 -extfile san.cnf -extensions req_ext -out example.crt
openssl x509 -in example.crt -noout -dates -subject -ext subjectAltName
openssl x509 -in example.crt -noout -checkhost api.example.com

最后一条应输出 api.example.com does match certificate,若输出 does NOT match 说明 SAN 漏项。私钥权限务必收敛:chmod 600 example.key,属主设为运行 Web 服务的账号(如 www-data)。CSR 与私钥一一对应,私钥丢失只能重签,因此建议生成时即纳入密钥管理系统,不要留在开发同学的家目录里。

四、实操第二步:acme.sh 申请 Let’s Encrypt 多域名证书并自动续期

免费方案首选 Let’s Encrypt,用 acme.sh 一条命令覆盖全部域名。先安装并配置自动续期定时任务:

curl https://get.acme.sh | sh -s email=ops@example.com
source ~/.bashrc
acme.sh --set-default-ca --server letsencrypt

HTTP-01 验证(域名已解析到本机、80 端口可访问):

acme.sh --issue -d example.com -d www.example.com -d api.example.com -d shop-example.com --webroot /var/www/html --keylength ec-256

DNS-01 验证(适合内网服务器、无法开放 80 端口,或需要签发通配符):

export Ali_Key=your_access_key
export Ali_Secret=your_access_secret
acme.sh --issue --dns dns_ali -d example.com -d '*.example.com' -d www.example.com -d api.example.com

签发成功后安装到 Nginx 路径,并绑定 reload 钩子,续期后自动生效:

acme.sh --install-cert -d example.com --ecc --key-file /etc/nginx/ssl/example.key --fullchain-file /etc/nginx/ssl/example.fullchain.pem --reloadcmd 'systemctl reload nginx'
acme.sh --list
crontab -l | grep acme

必须知道的配额:Let’s Encrypt 单张证书最多 100 个名称;同一注册域名每周最多 50 张证书;域名集合完全相同的“重复证书”每周最多 5 张;新订单 300 次/3 小时。acme.sh 默认在证书剩余约 60 天时续期,可用 –days 调整。调试阶段建议加 –staging 走测试环境,否则反复失败很容易撞上 5 张/周的重复证书限制,一卡就是七天。

五、配置示例:Nginx 与 Apache 同时挂载多域名证书

Nginx 侧把全部域名写进同一个 server_name,注意 ssl_certificate 必须用 fullchain(叶子证书 + 中间证书),否则 Android 与 Java 客户端会报 PKIX 失败:

server {
    listen 443 ssl;
    http2 on;
    server_name example.com www.example.com api.example.com shop-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;
    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' always;
}

Nginx 1.25.1 之前写 listen 443 ssl http2;,之后改为独立的 http2 on;,混用会报 unknown directive。Apache 侧等价配置:

<VirtualHost *:443>
  ServerName example.com
  ServerAlias www.example.com api.example.com shop-example.com
  SSLEngine on
  SSLCertificateFile /etc/httpd/ssl/example.fullchain.pem
  SSLCertificateKeyFile /etc/httpd/ssl/example.key
  SSLProtocol -all +TLSv1.2 +TLSv1.3
  SSLOpenSSLConfCmd Curves X25519:secp256r1
</VirtualHost>

Exchange 场景额外提醒:UCC 证书必须把 autodiscover、owa、mail、smtp 全部列进 SAN,且内部与外部 URL 使用同一命名空间;否则 Outlook 客户端会持续弹凭据框或报证书名称不匹配。配置改完先 nginx -t / httpd -t 校验,再 systemctl reload nginx 平滑生效。

六、对比表格:证书类型与 CA 方案怎么选

下表覆盖采购决策最常见的两个维度,先看覆盖能力,再看验证等级与成本。

方案 覆盖能力 有效期 验证等级 适用场景
单域名 DV 1 个名称 ≤398 天 DV 个人站、测试环境
通配符 DV 1 个通配符 + 裸域 ≤398 天 DV 同一一级域名下大量子域
多域名 SAN(商业) 100~250 个 SAN ≤398 天 DV/OV/EV 多品牌、多一级域名、需要企业身份展示
UCC 多 SAN,含 Exchange 名称 ≤398 天 OV 为主 Exchange、Skype for Business 统一通信
Let’s Encrypt 单证书 100 个名称 90 天(自动续期) DV Web 服务、API 网关、容器集群
维度 Let’s Encrypt 商业 CA 多域名
费用 0 按域名数量阶梯计价
签发时长 域名验证通过后数分钟 DV 数分钟;OV/EV 1~3 个工作日
身份信息 无企业信息 OV/EV 含企业名称,EV 部分场景显示绿色标识
有效期上限 90 天 398 天
运维成本 必须自动化续期 仍需自动化,但周期长
吊销/保险 无资金保障 通常附保修条款

结论很直接:纯 Web/API 业务,Let’s Encrypt 多域名 + acme.sh 自动续期是性价比最高的组合;需要企业身份展示、合同要求或 Exchange 兼容性验证的,选商业 UCC/OV 多域名证书。注意 398 天是公有 CA 的硬上限,任何声称“买三年一次部署”的方案都已不可行,续期自动化是必选项而非可选项。

七、常见错误排查:真实报错与处理路径

以下报错都来自多域名证书部署现场,按出现频率排序。

报错信息 根因 处理
curl: (60) SSL: no alternative certificate subject name matches target host name ‘api.example.com’ SAN 缺该域名 重签并补入 SAN,或用 openssl x509 -checkhost 定位缺失项
NET::ERR_CERT_COMMON_NAME_INVALID 证书只填 CN 无 SAN,或 SAN 不含访问域名 检查 SAN 扩展,确认裸域与子域均已列出
SSL_ERROR_BAD_CERT_DOMAIN(Firefox) 同上 同上
nginx: [emerg] cannot load certificate … BIO_new_file() failed 路径错误或 www-data 无读权限 核对路径,chmod 644 证书、600 私钥
nginx: [emerg] SSL_CTX_use_PrivateKey_file() failed (X509_check_private_key:key values mismatch) 证书与私钥不配对 用 modulus 比对,重新安装匹配的 key
javax.net.ssl.SSLHandshakeException: PKIX path building failed 未下发中间证书 改用 fullchain.pem,或配置 ssl_trusted_certificate
Problem binding to port 80: Could not bind to IPv4 or IPv6 80 端口被 Nginx 占用,standalone 模式冲突 改用 –webroot,或加 –pre-hook 停服务
too many certificates already issued for exact set of domains 触发重复证书限制(5 张/周) 等待一周,或先用 –staging 调试

两组高频排查命令:私钥与证书是否配对,比对 modulus 哈希即可,两者一致才匹配:

openssl x509 -noout -modulus -in example.fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.key | openssl md5
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted example.chain.pem example.crt

排查顺序建议固定为:先看 SAN 是否包含目标域名,再看链路是否完整,再看私钥是否匹配,最后看服务端是否 reload 生效。systemctl reload nginx 未执行是新证书“不生效”的最常见原因,改完配置务必确认进程已重载,并清理浏览器或 CDN 的会话缓存。

八、效果验证:从命令行到外部评分

部署完成后必须逐域名验证,不能只测主域名。批量检查脚本如下,逐条输出是否匹配:

for h in example.com www.example.com api.example.com shop-example.com mail.example.com; do
  printf '%s ' $h
  echo | openssl s_client -connect $h:443 -servername $h 2>/dev/null | openssl x509 -noout -checkhost $h
done

再确认有效期、签发者与 SAN 列表,并与 398 天上限比对:

echo | openssl s_client -connect api.example.com:443 -servername api.example.com 2>/dev/null | openssl x509 -noout -dates -issuer -ext subjectAltName
curl -sSI https://shop-example.com | head -1
curl -svI https://api.example.com 2>&1 | grep -Ei 'subject|issuer|expire'

协议与套件层面,确认只协商 TLSv1.2/1.3,且未出现 TLSv1.0 回退:

openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
nmap --script ssl-enum-ciphers -p 443 example.com

第一条应直接握手失败,说明旧协议已禁用。最后用 SSL Labs 或 testssl.sh 做外部评分,目标是 A 及以上、无证书链警告、无 SAN 不匹配提示。若业务面向移动端,额外用真机验证 Android 7 与 iOS 15+ 各一台,这两类客户端对中间证书与有效期最敏感。把上述命令封装成每日巡检脚本,发现剩余有效期小于 20 天即告警,即可彻底告别证书过期事故。

常见问题

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

取决于 CA。Let’s Encrypt 单张证书最多 100 个名称;商业 CA 的多域名/UCC 证书常见上限为 100~250 个 SAN 条目,具体以厂商订单页为准。域名数量越多,续期时一次验证失败的影响面越大,建议按业务线拆分,单证书控制在 20 个名称以内更易运维。

有了多域名证书,还需要通配符证书吗?

两者互补。SAN 只覆盖显式列出的名字,新增子域必须重签;通配符 *.example.com 可覆盖任意新增一级子域,但不覆盖裸域和二级子域。常见做法是主证书用“通配符 + 裸域 + 关键 API 域名”的组合,既控制证书数量又保留扩展性。

证书有效期到底是多久?398 天怎么来的?

398 天是 Apple 自 2020-09-01 起对公有 CA 签发的 TLS 证书实施的硬性上限,被全行业跟随,因此目前没有超过 398 天的公有证书。Let’s Encrypt 固定 90 天。两者都要求自动化续期,任何“一次购买多年免维护”的说法都已不成立。

多域名证书能直接用于 Exchange 邮件服务器吗?

可以,这正是 UCC 的起源场景。要求是把 autodiscover、owa、mail、smtp、mx 等所有客户端可能访问的名字全部写入 SAN,且内外网使用统一命名空间。若只写了 mail.example.com 而漏掉 autodiscover.example.com,Outlook 会反复弹出凭据框。

证书换掉后老客户端仍报错怎么办?

先确认是否只部署了叶子证书而缺中间证书,Java 与旧版 Android 会直接报 PKIX 失败;其次确认服务已 reload、CDN 已刷新证书。若客户端为 Android 4.x 或 Windows XP,还可能不支持 SNI,此时必须让该域名独占 IP,或升级客户端。

证书上的域名列表能随时增删吗?

不能修改,只能重签。增删域名意味着生成新的 CSR 并重新走验证流程,新证书与原证书并存直到替换完成。用 acme.sh 时直接修改 –issue 命令中的 -d 列表并重新签发即可,安装路径不变,reload 钩子会自动生效。

内容审核

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