HTTPS 多域名证书实战:SAN/UCC 证书申请、Nginx 配置与排错指南
问题背景与根因
多域名 HTTPS 的核心不是买一张证书,而是让证书的 SAN 列表覆盖所有实际访问的 FQDN。浏览器从 Chrome 58 起不再以 CN 作为匹配依据,只认 subjectAltName;如果只写 example.com,访问 www.example.com 或 api.example.com 就会报 NET::ERR_CERT_COMMON_NAME_INVALID。UCC 是早期 CA 的营销叫法,技术上仍是 SAN 证书。常见根因有三类:CSR 中漏写 SAN、Nginx/Apache 只加载了叶子证书未带中间证书、SNI 或多域名 server_name 未覆盖。
先确认目标域名:
echo | openssl s_client -connect example.com:443 -servername www.example.com 2>/dev/null | openssl x509 -noout -ext subjectAltName
若输出只有 DNS:example.com,说明证书未覆盖 www。另一个过时点是有效期:公共 TLS 证书单次最长 398 天,Let’s Encrypt 为 90 天;原文所谓三分钟发布、最多 250 个一级域名并不适用于所有 CA,主流公共 CA 常见上限为 100 个 SAN,具体以 CA 文档为准。SAN 列表中的每个 FQDN 都要单独列出,根域和 www 是两个名字。
证书选型:SAN、UCC、有效期与算法
选型先看三件事:域名数量、验证级别、密钥算法。SAN 证书把多个 FQDN 放进同一张证书;通配符只覆盖一级子域,不覆盖根域和多级子域。公共 CA 的单张证书有效期最长 398 天,Let’s Encrypt 为 90 天,建议到期前 30 天续期。算法上禁用 SHA-1,使用 SHA-256;RSA 至少 2048 位,推荐 3072 位;ECDSA 推荐 P-256,现代浏览器兼容性已足够。
生成 ECC 私钥并检查:
openssl ecparam -name prime256v1 -genkey -noout -out example-ecc.key
openssl pkey -in example-ecc.key -text -noout
多域名证书的 SAN 数量不是越多越好,SAN 越多证书体积越大,移动端首包可能变慢;把核心域名放同一张,长尾域名拆分为多张。OV/EV 证书仍需组织验证,DV 只验证域名控制权;UCC 不是独立标准,采购时看 SAN 列表、有效期和算法,不要只看名称。私有 CA 可自定义有效期,但必须分发根证书,不能直接用于公网。
完整实操步骤:生成 CSR 并签发多域名证书
以下命令可直接执行。先生成 RSA 私钥和带 SAN 的 CSR;把 DNS.1 到 DNS.4 换成你的域名,根域和 www 必须分别写。
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out example.key
chmod 600 example.key
cat > san.cnf <<'EOF'
[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 Tech
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 = shop.example.com
EOF
openssl req -new -key example.key -out example.csr -config san.cnf
openssl req -in example.csr -noout -text | grep -A1 'Subject Alternative Name'
确认输出包含全部 DNS 后,把 CSR 提交给公共 CA。若用 Let’s Encrypt,可直接执行:
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com -d api.example.com --email ops@example.com --agree-tos --no-eff-email
内网测试可用私有 CA 签发 397 天证书,并合并中间证书:
openssl x509 -req -in example.csr -CA ca.crt -CAkey ca.key -CAcreateserial -out example.crt -days 397 -sha256 -extfile san.cnf -extensions v3_req
cat example.crt intermediate.crt > fullchain.pem
Nginx 与 Apache 配置示例
Nginx 必须加载 fullchain.pem,而不是只加载叶子证书。Nginx 1.25.1 起推荐 http2 on;,旧版本用 listen 443 ssl http2;。多域名写入 server_name,证书 SAN 与 server_name 要一致。
server {
listen 443 ssl;
http2 on;
server_name example.com www.example.com api.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-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384';
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; includeSubDomains' always;
}
Apache 配置如下,SSLCertificateChainFile 在旧版本可用;新版本可把中间证书拼进 SSLCertificateFile。修改后执行 nginx -t 或 apachectl configtest。
<VirtualHost *:443>
ServerName example.com
ServerAlias www.example.com api.example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.key
SSLCertificateChainFile /etc/httpd/ssl/intermediate.crt
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
证书链、OCSP 与自动化续期配置
证书链顺序必须是叶子证书在前、中间证书在后,不要放根证书。检查链:
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem
OCSP Stapling 需要 ssl_trusted_certificate 指向中间证书链,并确保服务器可访问 CA 的 OCSP 地址。手动检查:
openssl ocsp -issuer intermediate.crt -cert example.crt -url http://ocsp.example-ca.com -resp_text
Let’s Encrypt 90 天证书应自动化续期。检查定时器:
systemctl list-timers | grep certbot
certbot renew --dry-run
续期后先 nginx -t,再 systemctl reload nginx;不要用 restart 造成不必要的连接中断。商业 CA 398 天证书也建议在到期前 30 天完成替换,并保留旧证书用于回滚。若使用多张 SAN 证书,按域名分组部署,避免单张证书 SAN 过多导致维护困难。
SAN/UCC 与通配符、单域名证书对比表
UCC 与 SAN 在技术上是同一类证书:一张证书包含多个 subjectAltName。选型时不要被名称误导,重点看覆盖范围、有效期和验证级别。
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- Wildcard 通配符 SSL 证书安装部署续费申请
- SSL/HTTPS 证书配置 · 证书安装 · 证书申请
| 方案 | 覆盖范围 | 有效期 | 验证方式 | 适用场景 | 注意点 |
|---|---|---|---|---|---|
| 单域名 DV | 1 个 FQDN | 最长 398 天;Let’s Encrypt 90 天 | 域名控制权 | 单站点 | 不覆盖 www 和子域 |
| SAN/UCC DV | 多个 FQDN,主流公共 CA 常见上限 100 个 SAN | 最长 398 天;Let’s Encrypt 90 天 | 域名控制权 | 多业务域名、多一级域名 | 每个域名都要写入 SAN |
| 通配符 DV | *.example.com 一级子域 | 最长 398 天;Let’s Encrypt 90 天 | 域名控制权 | 子域数量多 | 不覆盖 example.com 和 a.b.example.com |
| OV 多域名 | 多个 FQDN + 组织信息 | 最长 398 天 | 组织 + 域名 | 企业门户、对外服务 | 审核时间长,组织变更需重签 |
| 私有 CA | 按内部策略 | 自定义 | 内部信任 | 内网、测试 | 需分发根证书,不能公网直接信任 |
算法对比:RSA 2048 位兼容性最好,RSA 3072 位更稳;ECDSA P-256 性能更好但老系统可能不支持。签名算法统一使用 SHA-256,禁止 SHA-1。原文所谓 3 个一级域名起售、最多 250 个域名已不是通用规则,实际以 CA 的 SAN 上限和订单规则为准。
常见错误排查(真实报错)
报错 1:curl: (60) SSL certificate problem: unable to get local issuer certificate。原因通常是服务器只发送叶子证书,缺少中间证书。修复:cat example.crt intermediate.crt > fullchain.pem,Nginx 的 ssl_certificate 指向 fullchain.pem。
报错 2:nginx: [emerg] SSL_CTX_use_PrivateKey_file(‘/etc/nginx/ssl/example.key’) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。这是私钥与证书不匹配。用以下命令比对:
openssl x509 -noout -modulus -in example.crt | openssl md5
openssl rsa -noout -modulus -in example.key | openssl md5
两个 MD5 必须一致;ECDSA 证书改用公钥比对:openssl x509 -noout -pubkey -in example.crt | openssl pkey -pubin -outform der | openssl md5,以及 openssl pkey -in example.key -pubout -outform der | openssl md5。
报错 3:浏览器出现 NET::ERR_CERT_COMMON_NAME_INVALID,或 Go 报 x509: certificate is valid for example.com, not www.example.com。说明 SAN 漏写目标域名。检查:openssl x509 -noout -ext subjectAltName -in example.crt。修复是重新签发 CSR,把根域、www、API 域名全部写入 SAN。
报错 4:unable to verify the first certificate 或 SSL_ERROR_BAD_CERT_DOMAIN。前者多为链不完整,后者多为域名不匹配或 SNI 配错。报错 5:certificate has expired or is not yet valid,检查系统时间和证书 dates,公共证书最长 398 天,Let’s Encrypt 90 天,过期只能重签。报错 6:sslv3 alert handshake failure,检查 ssl_protocols 是否只开 TLSv1.2/TLSv1.3,以及客户端是否支持所选 ECDSA 证书。
效果验证
部署后先看证书链和 SAN:
openssl s_client -connect example.com:443 -servername www.example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
再验证信任链和 HTTP 状态:
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem
curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}' https://www.example.com
curl -I --tlsv1.2 https://api.example.com
ssl_verify_result 为 0 表示证书验证通过;http_code 应为 200、301 或 302。继续检查 TLS 版本和加密套件:
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null
nmap --script ssl-enum-ciphers -p 443 example.com
浏览器侧看锁标志、证书有效期和 SAN 列表;移动端至少测试 iOS Safari 与 Android Chrome。生产环境建议用 testssl.sh 做一次扫描:testssl.sh –severity HIGH https://example.com。若发现 TLSv1.0/1.1 仍开启、证书链缺失或 SAN 不全,按上一节修复后重新加载配置。多域名站点要分别访问根域、www 和 API 域名,不能只测一个入口。
常见问题
SAN 和 UCC 有什么区别?
UCC 是早期 CA 对多域名证书的营销叫法,技术标准仍是 SAN。证书里看 subjectAltName 列表,不看产品名称。
一张多域名证书能放多少个域名?
主流公共 CA 常见上限是 100 个 SAN,部分 CA 或企业 CA 可更多;原文的 250 个不是通用规则。通配符条目也占一个 SAN,具体以 CA 文档为准。
多域名证书能同时覆盖根域和 www 吗?
可以,但必须分别写入 SAN:DNS.1=example.com,DNS.2=www.example.com。通配符 *.example.com 不覆盖根域 example.com。
证书有效期现在是多久?
公共 TLS 证书单次最长 398 天,Let’s Encrypt 为 90 天。建议到期前 30 天续期,并用 certbot renew –dry-run 验证自动化流程。
为什么浏览器仍提示证书名称不匹配?
优先检查 SAN 是否包含当前访问的完整域名,其次检查 SNI 和多域名 server_name 是否命中。CN 已不再是浏览器匹配的唯一依据。
一张证书能给多个一级域名使用吗?
可以,把多个一级域名及其子域全部写入 SAN 即可。但 OV/EV 证书要求组织信息一致,且 SAN 越多证书体积越大,建议按业务分组签发。