多域名(SAN)证书申请与部署全流程:Certbot + Nginx 实战(2025 版)
一、问题背景与根因:为什么多主域名必须用 SAN 证书
同一业务持有 example.com、example.cn、example.net 三个主域名,早期常见做法是「一个域名一张证书」。这种做法的真实代价不在签发,而在运维:续期任务分散在 3~6 个 lineage 里,任何一条 cron 或 hook 失效,就会出现某个域名静默过期;Nginx 里要维护多份 ssl_certificate,配置漂移几乎不可避免。
根因在于 TLS 握手的机制:客户端通过 SNI 告知目标主机名,服务器只能返回一条证书链,浏览器随后校验该主机名是否出现在证书的 SAN(subjectAltName)扩展中。现代浏览器(Chrome 58+、Firefox 48+、Safari)已完全忽略 CN 字段,只看 SAN。因此「一张证书覆盖多个域名」不是取巧,而是标准做法。
关键约束有三个,直接决定了后续流程:
- SAN 列表在签发瞬间固化,事后无法追加。给已有证书加域名,只能整张重签(reissue),这也是原文「新增域名需重签」的技术原因。
- 有效期上限:自 2020 年 9 月起,公开信任的 TLS 证书最长有效期被限制为 398 天;Let’s Encrypt 签发的证书有效期为 90 天,且官方支持提前 30 天续期。自动化续期是必需项,不是可选项。
- 数量与频率配额:Let’s Encrypt 单张证书最多包含 100 个 SAN 标识符;同一组域名(exact set of domains)每周最多签发 5 张重复证书,每个注册域名每周上限 50 张,每个账户每 3 小时上限 300 个 new order。频繁重签会直接撞配额。
所以正确策略是:按业务边界把域名分组,每组用一张 SAN 证书,组内域名数量控制在合理范围(建议 ≤20,远低于 100 上限),并让续期与 reload 完全自动化。
二、前置条件与域名规划(决定成败的一步)
签发前先把「可达性」和「分组」两件事做掉,能避免 80% 的失败。
1)DNS 与网络可达性检查。HTTP-01 验证要求每个待签域名都能从公网解析到本机,并且 80 端口可访问。逐条确认:
dig +short A example.com
dig +short AAAA example.com
dig +short A example.cn
# 若返回了 AAAA 但服务器未监听 IPv6,务必删掉 AAAA 记录,否则验证会走 IPv6 而失败
curl -I http://example.cn/.well-known/acme-challenge/probe-test
# 期望 404(文件不存在但路径可达),而不是 301 到 https 或 502
2)放行端口与反向代理。若前面有 CDN / WAF,需确认 /.well-known/acme-challenge/ 路径回源不被拦截;否则改用 DNS-01 验证(见第五节对比表)。
3)安装并确认 Certbot 版本。Certbot 2.x 默认使用 ECDSA 密钥,行为与 1.x 有差异:
apt update && apt install -y certbot python3-certbot-nginx
certbot --version # 建议 >= 2.6.0
nginx -v
4)域名分组规划。示例:组 A = example.com + www.example.com + example.cn + www.example.cn(品牌主站);组 B = api.example.com + api.example.cn(接口服务)。不要把所有域名塞进一张证书——一旦某个冷门域名验证失败,整张重签都会被阻塞,影响面被放大。
三、完整实操:一条命令签发多域名 SAN 证书
以 Nginx 插件为例,交互式签发:
certbot --nginx
-d example.com -d www.example.com
-d example.cn -d www.example.cn
--cert-name example.com
--key-type ecdsa --elliptic-curve secp256r1
--must-staple
参数说明:--cert-name 指定 lineage 名称,避免 Certbot 用第一个域名自动命名导致后续找不到目录;--key-type ecdsa 生成 P-256 密钥,握手更快、体积更小;若需兼容极老客户端,改用 --key-type rsa --rsa-key-size 2048;--must-staple 会写入 OCSP Must-Staple 扩展,配合第四节的 stapling 配置使用。
非交互(适合脚本化 / CI):
certbot --nginx -n --agree-tos -m ops@example.com
--cert-name example.com
-d example.com -d www.example.com -d example.cn -d www.example.cn
--redirect
若不想让 Certbot 改 Nginx 配置,用 webroot 模式自行接管:
certbot certonly --webroot -w /var/www/html
--cert-name example.com
-d example.com -d www.example.com -d example.cn -d www.example.cn
成功后产物在 /etc/letsencrypt/live/example.com/:fullchain.pem(叶子证书 + 中间证书)、privkey.pem、chain.pem、cert.pem。Nginx 必须引用 fullchain.pem,只引用 cert.pem 会缺少中间证书,导致部分安卓和 Java 客户端报「unable to get local issuer certificate」。
四、配置示例:Nginx 多域名共用一张证书
核心是把所有 SAN 域名写进同一个 server_name,并让 80 端口只做跳转与 ACME 挑战放行。
server {
listen 80;
listen [::]:80;
server_name example.com www.example.com example.cn www.example.cn;
location /.well-known/acme-challenge/ {
root /var/www/html;
try_files $uri =404;
}
location / { return 301 https://$host$request_uri; }
}
server {
listen 443 ssl;
listen [::]:443 ssl;
http2 on;
server_name example.com www.example.com example.cn www.example.cn;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-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;
resolver 223.5.5.5 1.1.1.1 valid=300s;
resolver_timeout 5s;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
root /var/www/html;
index index.html;
}
生效前必做语法检查,再平滑重载(不要 restart,会断连接):
nginx -t && systemctl reload nginx
注意:includeSubDomains 的 HSTS 一旦下发,所有子域必须长期支持 HTTPS,若你有未上 HTTPS 的子域,先去掉该参数。多域名站点若内容不同,可用 map $host $site_root 做分发,但证书仍共用同一份。
五、方案对比:SAN、通配符与独立证书怎么选
下表按「覆盖范围 / 验证方式 / 新增域名成本 / 续期影响面」四个维度对比:
| 方案 | 覆盖范围 | 验证方式 | 新增域名成本 | 续期影响面 | 适用场景 |
|---|---|---|---|---|---|
| 每域名一张单域名证书 | 1 个 FQDN | HTTP-01 | 新签一张 | 分散,易漏续 | 域名归属不同团队 |
| 一张 SAN 多域名证书 | ≤100 个 FQDN | HTTP-01 / DNS-01 | 必须整张重签 | 集中,一次续期全生效 | 同一业务多主域名(本文场景) |
| 通配符 *.example.com | 该域下所有一级子域 | 仅 DNS-01 | 无需重签 | 集中 | 子域多且不可枚举 |
| 通配符 + SAN 混合 | *.example.com + example.cn | DNS-01 | 部分需重签 | 集中 | 多主域 + 大量子域 |
验证方式的选择同样影响架构:
| Challenge | 依赖端口 | 是否支持通配符 | 典型限制 |
|---|---|---|---|
| HTTP-01 | 80/tcp | 否 | 必须公网可达,CDN/WAF 易拦截 |
| DNS-01 | 53(TXT 记录) | 是 | 需要 DNS 服务商 API 凭据 |
| TLS-ALPN-01 | 443/tcp | 否 | 需独占 443,Certbot 支持有限 |
结论:主域名数量少(≤5)且都要独立品牌展示,用 SAN 证书最省心;子域名超过 10 个且经常增删,改用通配符 + DNS-01。
六、常见错误排查(附真实报错)
1)挑战文件 404
Detail: Invalid response from http://example.cn/.well-known/acme-challenge/AbCdEf...: "<html>...404 Not Found..."
原因通常是 80 端口被 301 到 https,或 webroot 路径与实际 root 不一致。修复:确认 location /.well-known/acme-challenge/ 在跳转规则之前,且 root 指向真实目录;用 echo test > /var/www/html/.well-known/acme-challenge/probe 后 curl 验证。
2)80 端口被占用
Problem binding to port 80: Could not bind to IPv4 or IPv6.
Nginx 正在运行导致 standalone 模式抢不到端口。改用 --nginx 或 --webroot,或先 systemctl stop nginx 再签发后启动。
3)撞配额
too many certificates (5) already issued for this exact set of domains in the last 168 hours
同一组域名一周内已签 5 张。等待窗口过去,或先用 --dry-run 在 staging 环境调试:certbot --nginx --staging -d ...。
4)证书与私钥不匹配
nginx: [emerg] SSL_CTX_use_PrivateKey("/etc/letsencrypt/live/example.com/privkey.pem") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
说明 ssl_certificate 与 ssl_certificate_key 来自不同 lineage。核对路径是否都指向 live/example.com/,不要混用 live/example.cn/。
5)新增域名后浏览器仍报错:证书里没有新域名。Certbot 检测到已有 lineage 时会提示是否 expand,非交互场景必须显式加 --expand,否则命令直接退出。
6)证书链不完整:curl: (60) SSL certificate problem: unable to get local issuer certificate。原因是只部署了 cert.pem,改为 fullchain.pem 即可。
七、自动续期与新增域名的正确姿势
Certbot 安装时通常已注册 systemd timer,先确认并演练:
systemctl list-timers | grep certbot
certbot renew --dry-run
systemctl cat certbot.timer | grep -i oncalendar
关键是加 deploy hook,让续期后自动重载 Nginx(否则新证书不生效,这是最常见的「续期成功但仍过期」原因):
certbot renew --deploy-hook "systemctl reload nginx"
持久化写法:在 /etc/letsencrypt/renewal/example.com.conf 中确认 renew_hook = systemctl reload nginx,或在 /etc/systemd/system/certbot.service.d/hook.conf 里追加 ExecStartPost=/bin/systemctl reload nginx。
新增域名时不要删目录重来,用 --expand 在原 lineage 上重签,保留原有配置与 hook:
certbot --nginx --cert-name example.com --expand
-d example.com -d www.example.com -d example.cn -d www.example.cn -d example.net -d www.example.net
重签后原证书立即被替换,无需等待续期周期。若域名数量持续增长,建议在达到 20 个左右时按业务线拆分证书,把失败影响面控制在一组之内。
八、效果验证:三条命令确认全部生效
1)检查本地证书 SAN 列表与有效期
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -dates -subject
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -text | grep -A2 "Subject Alternative Name"
期望看到 4 个 DNS 条目,notAfter 约为签发日 +90 天。
2)逐域名做真实握手验证(推荐脚本化)
for d in example.com www.example.com example.cn www.example.cn; do
echo "== $d"
echo | openssl s_client -connect $d:443 -servername $d 2>/dev/null
| openssl x509 -noout -subject -dates -ext subjectAltName
done
3)检查证书链完整性与 HTTP 层
curl -vI https://example.cn 2>&1 | grep -E "SSL certificate verify|subject:|expire date"
# 期望:SSL certificate verify ok.
补充检查项:openssl s_client -connect example.com:443 -status 应返回 OCSP Response Status: successful,证明 stapling 生效;再用 SSL Labs 或 testssl.sh example.cn 做一次全量扫描,确认没有 chain issues、没有 TLS 1.0/1.1 残留。最后把验证脚本挂进监控,每天跑一次,比人工巡检可靠得多。
常见问题
必须。SAN 列表在签发瞬间写入证书并由 CA 签名,事后无法追加。给已有证书加域名只能整张重签,用 certbot --cert-name 名称 --expand -d 旧域名 -d 新域名 在原 lineage 上覆盖,原证书立即失效并被替换。
单张证书最多 100 个 SAN 标识符(含主域名与 www)。此外同一组域名每周限签 5 张重复证书,每注册域名每周 50 张。生产环境建议每组控制在 20 个以内,便于隔离验证失败的影响面。
主域名少(≤5)且都是独立品牌域名,选 SAN 证书,可用 HTTP-01 验证,部署简单;子域名多且经常增删,选通配符证书,新增子域无需重签,但只能走 DNS-01,需要 DNS 服务商 API 凭据。
公开信任的 TLS 证书最长有效期为 398 天(2020 年 9 月起生效)。Let’s Encrypt 签发的是 90 天,支持提前 30 天续期。因此必须配置自动续期与 deploy hook,否则 90 天后必然过期。
因为 Nginx 没有重载,仍在内存中持有旧证书。需加 certbot renew --deploy-hook "systemctl reload nginx",或在 renewal 配置里写 renew_hook。用 openssl s_client -connect 域名:443 -servername 域名 核对实际下发的 notAfter。