多域名(SAN)SSL/TLS 证书申请与部署实战:Certbot + Nginx 全流程
问题背景与根因:多主域名为什么必须用 SAN 证书
同一业务持有 example.com、example.cn、example.net 等多个主域名时,如果每个域名单独签发证书,续期、部署和监控都会成倍增加。现代浏览器校验证书时主要读取 X.509v3 的 subjectAltName(SAN)扩展,而不是只看 Common Name;因此一张证书要把多个域名放进 SAN 列表,客户端才会对每个域名都判定匹配。SAN 证书不是把多个域名写进 CN,正确做法是签发时用多个 -d 参数,让 ACME 服务端把全部 DNS 名称写入 SAN。早期 UCC 证书本质上也是多域名 SAN 证书,今天直接称为 SAN 证书即可。根因还包括有效期规则:公开信任的 TLS 证书最长有效期目前为 398 天,Let’s Encrypt 证书有效期为 90 天,续期必须自动化。Let’s Encrypt 单张证书最多包含 100 个 SAN,域名很多时应拆分证书或使用通配符。另一个常见误区是:SAN 证书新增域名必须重新签发,不能只改 Nginx 的 server_name;旧证书不会因为配置文件变化自动扩展 SAN。理解这些限制后,再规划验证方式、证书命名和续期钩子,才能避免上线后出现证书名称不匹配、续期失败或触发速率限制。
申请前的域名、端口与速率限制检查
先确认所有域名解析到同一台入口或至少能被 ACME 验证访问。执行 dig +short A example.com、dig +short AAAA example.com,对 www 和 .cn 域名重复检查;若使用 HTTP-01,公网 80 端口必须可达,执行 curl -I http://example.com/.well-known/acme-challenge/test 应返回 404 而不是连接拒绝。检查监听:ss -lntp | grep -E ':80|:443'。确认 Certbot 版本:certbot --version;安装 Nginx 插件:apt install certbot python3-certbot-nginx。检查 CAA:dig CAA example.com +short,若存在 CAA 记录,必须允许 letsencrypt.org。正式签发前用 staging 演练:certbot --nginx --dry-run --cert-name multi-example -d example.com -d www.example.com。还要评估速率限制:同一注册域名每周签发数量、重复失败验证都会影响生产签发;域名多时先用少量域名测试,再一次性签发。若域名无法开放 80 端口,改用 DNS-01;若各域名 webroot 不一致,不要硬用同一个 -w 参数。此阶段把解析、端口、CAA、插件和 dry-run 全部跑通,后面正式签发基本一次成功。还要确认 CDN 或负载均衡回源到源站时,/.well-known/acme-challenge/ 路径没有被缓存或拦截。
完整实操:用 Certbot 签发多域名 SAN 证书
以 Nginx 插件为例,一条命令把六个域名写入同一张 SAN 证书,并用 –cert-name 固定证书目录,便于续期和 Nginx 引用:certbot --nginx --cert-name multi-example -d example.com -d www.example.com -d example.cn -d www.example.cn -d example.net -d www.example.net --agree-tos -m ops@example.com --no-eff-email。首次执行会改写 Nginx 配置并申请证书;若只想签发不自动改配置,使用 webroot:mkdir -p /var/www/html/.well-known/acme-challengecertbot certonly --webroot -w /var/www/html --cert-name multi-example -d example.com -d www.example.com -d example.cn -d www.example.cn --agree-tos -m ops@example.com --no-eff-email。注意 -w 必须对应每个域名实际可访问的站点根目录;多站点根目录不同时,可重复 -w 或改用 DNS-01。签发后证书在 /etc/letsencrypt/live/multi-example/,包含 fullchain.pem 和 privkey.pem。不要手工复制 PEM 到其他目录,否则续期后容易引用旧文件。检查 SAN:openssl x509 -in /etc/letsencrypt/live/multi-example/cert.pem -noout -ext subjectAltName。若域名超过 100 个,拆成多张证书;新增域名时不要直接重跑相同命令,见后文 –expand 用法。生产签发前可加 --dry-run 验证,但 dry-run 不产生可用证书,去掉后才会写入 live 目录。
Nginx 配置示例:一张证书承载多个域名
把 HTTP 统一 301 到 HTTPS,并在 443 server 中列出全部域名。证书路径使用 live 目录,Certbot 续期后会更新软链接指向新文件,Nginx reload 即可生效:server { listen 80; server_name example.com www.example.com example.cn www.example.cn example.net www.example.net; location /.well-known/acme-challenge/ { root /var/www/html; } location / { return 301 https://$host$request_uri; } }server { listen 443 ssl http2; server_name example.com www.example.com example.cn www.example.cn example.net www.example.net; ssl_certificate /etc/letsencrypt/live/multi-example/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/multi-example/privkey.pem; ssl_protocols TLSv1.2 TLSv1.3; ssl_session_cache shared:SSL:10m; ssl_session_timeout 1d; add_header Strict-Transport-Security max-age=31536000; includeSubDomains; location / { root /var/www/html; index index.html; } }。保存后执行 nginx -t,通过再 systemctl reload nginx。如果使用 Certbot –nginx 自动改写,仍需人工检查 server_name 是否覆盖全部 SAN;否则会出现证书包含某域名但 Nginx 没有对应 server 块,访问返回默认站点或 404。HSTS 首次上线建议先用较短 max-age 验证,确认所有子域都支持 HTTPS 后再加 includeSubDomains。配置中不要写死 cert.pem,应使用 fullchain.pem,否则部分客户端会报证书链不完整。若使用 CDN,请确认回源 SNI 与源站证书匹配。
SAN 证书续期、扩容与新增域名重签
Let’s Encrypt 证书有效期 90 天,建议保留自动续期并加部署钩子。检查定时器:systemctl list-timers | grep certbot;演练续期:certbot renew --dry-run;强制续期测试:certbot renew --force-renewal --deploy-hook 'systemctl reload nginx'。生产环境不要频繁 –force-renewal,以免触发速率限制。查看证书和到期时间:certbot certificates。新增域名时,必须把旧域名和新域名一起传入并加 –expand,让同一 cert-name 重新签发:certbot --nginx --cert-name multi-example --expand -d example.com -d www.example.com -d example.cn -d www.example.cn -d new.example.com --deploy-hook 'systemctl reload nginx'。如果只写新域名,Certbot 可能新建另一张证书,导致 Nginx 仍引用旧证书。扩容前先确认新域名解析和 80 端口验证通过;若新域名无法 HTTP 验证,改用 DNS-01。续期不会自动发现 Nginx 新增的 server_name,所以新增域名必须重签并更新 SAN。建议在监控中记录 certbot certificates 的输出,证书剩余天数低于 21 天时告警,避免 90 天周期内因 cron 失败而过期。若证书已拆分,–cert-name 必须逐张指定,不能误用同一个名字覆盖其他证书。
三种验证方式与证书方案对比表
选择方案时先看验证通道,再看域名数量和运维成本。HTTP-01 适合能开放 80 端口的 Web 站点;DNS-01 适合内网、泛域名或 80 被封锁场景;Nginx 插件适合单机 Nginx 且希望自动改配置。SAN、多张单域名、通配符的取舍如下:
| 方案 | 适用场景 | 优点 | 限制与成本 |
|---|---|---|---|
| Certbot –nginx 多 -d | 单机 Nginx,多主域名 | 自动改配置,部署快 | 依赖 Nginx 插件,配置可能被改写 |
| webroot + HTTP-01 | 多站点同根目录或可控根目录 | 不改 Nginx 配置,权限清晰 | 80 必须可达,-w 要准确 |
| DNS-01 | 泛域名、内网、80 被封 | 支持通配符,无需入站 80 | 需 DNS API 或手动 TXT,传播有延迟 |
| 单张 SAN 证书 | 多个主域名统一管理 | 一张证书、一个续期任务 | 单证书最多 100 个 SAN,新增需重签 |
| 多张单域名证书 | 域名归属不同团队 | 故障隔离,权限分离 | 续期和部署任务成倍增加 |
| 通配符证书 | 同一主域下大量子域 | 覆盖同层子域,减少 SAN 数量 | 只覆盖一级,跨主域仍需 SAN 或多张 |
。如果 example.com、example.cn、example.net 属于同一业务且证书由同一团队维护,优先一张 SAN 证书;如果域名超过 100 个或跨团队,按业务拆成多张证书更稳。通配符不能覆盖 example.cn 这类不同主域,必须另加 SAN 或单独签发。证书数量多时,建议用命名规范如 biz-sites-2025 区分 cert-name。
常见错误排查:真实报错与修复命令
报错一:Challenge failed for domain www.example.cn,通常是解析未生效或 80 被拦截。执行 dig +short www.example.cn、curl -I http://www.example.cn/.well-known/acme-challenge/test,并检查安全组和 ss -lntp。报错二:Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404,说明 webroot 路径不对或 Nginx 的 location 未放行;确认 -w /var/www/html 与 root /var/www/html 一致。报错三:too many certificates already issued for example.com,触发速率限制,停止重复重试,等待窗口恢复,先用 –dry-run 验证。报错四:urn:ietf:params:acme:error:caa,检查 dig CAA example.com +short,删除错误 CAA 或加入 letsencrypt.org。报错五:nginx: [emerg] cannot load certificate ... No such file or directory,说明 Nginx 引用了不存在的 live 路径,执行 certbot certificates 核对 cert-name,再改 ssl_certificate。报错六:Problem binding to port 80: Could not bind to IPv4 or IPv6,80 被占用,执行 ss -lntp | grep :80 找到进程,或改用 DNS-01。每次改完先 nginx -t 再 reload,避免配置错误扩大故障。若日志中出现 Detail: Fetching ... Timeout during connect,优先排查防火墙和回源链路。
效果验证与上线后监控
部署后分别验证每个 SAN 域名,不能只测主域名。命令:echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -dates -ext subjectAltName,把 example.com 换成 www.example.com、example.cn 重复执行,确认 SAN 列表包含全部域名且 notAfter 符合预期。检查证书链:openssl s_client -connect example.cn:443 -servername example.cn -showcerts,应看到 fullchain 的中间证书。用 curl -I https://example.net 检查状态码和 HSTS 头;用 certbot certificates 查看证书名称、域名和到期日。监控脚本可用 openssl x509 -checkend 2592000 -noout -in /etc/letsencrypt/live/multi-example/cert.pem,剩余不足 30 天返回非零时告警;再结合 certbot renew --dry-run 每周巡检。若使用多张证书,按 cert-name 分别监控。上线后抽查移动端和旧客户端,确认 TLS 1.2 可用;若只开 TLS 1.3,部分旧设备会握手失败。最后保留一次成功签发和续期的日志,排错时可用 /var/log/letsencrypt/letsencrypt.log 对照时间线。对外提供 API 的域名还应验证 SNI 与证书链在负载均衡层一致。
常见问题
SAN 证书把多个明确域名写进 subjectAltName,可跨 example.com、example.cn 等不同主域;通配符只覆盖同一主域下一级子域,如 *.example.com,不能覆盖 example.cn。跨主域仍需 SAN 或单独证书。
必须。已有证书的 SAN 列表是签发时固定的,修改 Nginx server_name 不会扩展证书。应使用 certbot –cert-name 旧证书名 –expand,把旧域名和新域名一起传入重新签发,再 reload Nginx。
Let’s Encrypt 证书有效期为 90 天,应自动续期;单张证书最多 100 个 SAN。公开信任 TLS 证书最长有效期目前为 398 天,不能把 Let’s Encrypt 配成更长有效期。
先查 DNS 是否全部指向正确入口,再查 80 端口和 webroot 的 acme-challenge 路径是否返回 200/404 而非拒绝连接;有 CAA 记录时确认允许 letsencrypt.org,最后看 /var/log/letsencrypt/letsencrypt.log。
可以。只要这些域名都能通过 ACME 验证,并且总数不超过 100 个 SAN,就能签发到同一张证书。若域名归属不同团队或超过上限,建议按业务拆成多张证书,降低续期和权限风险。