Nginx 配置多个 SSL 证书:SNI 多域名、泛域名与 server 块实操(1.26)
① 在同一台 Nginx 上配置多个 SSL 证书,核心是让每个域名落到独立 server 块,由 TLS SNI 在握手阶段选择对应证书;Nginx 1.26 下用 listen 443 ssl 加 http2 on,再为每个 server_name 指定 ssl_certificate 即可。② 证书文件建议 cert 644、key 600 且属主 root:root;每次改完先 nginx -t,再 systemctl reload nginx,不要直接 restart。③ 一个 server 块写多条 ssl_certificate 只适合同一组域名的 RSA 与 ECDSA 双证书,不能把两个不同域名塞进一个 server 块来省配置。④ 验证时用 openssl s_client -connect 127.0.0.1:443 -servername 域名,再管道给 openssl x509 -noout -subject -issuer -dates -ext subjectAltName,确认返回的 SAN 与目标域名一致。⑤ Let's Encrypt 证书有效期 90 天,建议剩余 30 天续期;续期后用 certbot renew --deploy-hook 'systemctl reload nginx' 或 acme.sh --install-cert 的 reloadcmd 触发平滑重载。
为什么一台 Nginx 配多个 SSL 证书会串证书?SNI 与默认 server 的根因在哪?
问:为什么地址栏是 b.example.com,却收到 a.example.com 的证书? 因为 TLS 握手发生在 HTTP 请求之前。据 RFC 6066,客户端先在 ClientHello 的 server_name 扩展中发送 SNI;Nginx 1.26 在握手阶段就用 SNI 选择虚拟主机和证书,不会等 HTTP Host 头到达。SNI 未命中或 server_name 写错时,浏览器会先报证书域名不匹配(如 ERR_CERT_COMMON_NAME_INVALID),HTTP 层还没开始。这正是 nginx 配置多个 SSL 证书时最常见的串证书根因。
据 nginx.org 的 server names 文档,server_name 匹配顺序为:
| 优先级 | 写法 | 示例 | 说明 |
|---|---|---|---|
| 1 | 精确域名 | a.example.com |
完全相等优先 |
| 2 | * 开头的最长通配 |
*.example.com |
泛域名证书常配这里 |
| 3 | * 结尾的最长通配 |
www.example.* |
较少使用 |
| 4 | 正则 | ~^apid+.example.com$ |
按配置顺序首个命中 |
| 5 | default_server |
listen 443 ssl default_server; |
全部不命中时兜底 |
串证书常见于:从 a 的 server 块复制出 b,只改 server_name,ssl_certificate 仍指向 a 的 fullchain.pem;或 b 没有独立 server 块,SNI 未命中后回落到 443 默认块。每个 listen 地址:端口 只能有一个 default_server,重复会触发 nginx: [emerg] a duplicate default server for 0.0.0.0:443。排查 nginx 配置多个 SSL 证书时,先确认 443 只有一个兜底块:
# 适用 Nginx 1.26.x;默认值:未显式写 default_server 时,该 listen 上第一个 server 隐式兜底
sudo grep -R --include='*.conf' -n 'default_server' /etc/nginx
sudo nginx -t
# 重复声明时典型输出:
# nginx: [emerg] a duplicate default server for 0.0.0.0:443 in /etc/nginx/conf.d/b.conf:3
# 验证 b 域名握手时实际拿到的证书
openssl s_client -connect b.example.com:443 -servername b.example.com /dev/null
| openssl x509 -noout -subject -ext subjectAltName
可显式放一个兜底块,避免未知 SNI 落到主站证书:
# /etc/nginx/conf.d/00-default.conf;Nginx 1.26.x
server {
listen 443 ssl default_server; # 0.0.0.0:443 仅此一处
server_name _;
# 证书路径为 Certbot/Let's Encrypt 默认布局
ssl_certificate /etc/letsencrypt/live/fallback.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/fallback.example.com/privkey.pem;
return 444; # 未命中 SNI 时断开,不返回业务内容
}
不支持 SNI 的老客户端(Windows XP 旧浏览器、Java 6)不会发送 server_name,服务端只能返回默认证书;这类流量占比通常很低,不建议把主站证书做成大 SAN,必要时用独立公网 IPv4 做兼容。
多证书落地怎么做?从域名盘点、证书分组到 server 块拆分的 6 步
多证书落地不是”把证书路径写进 Nginx 就完事”,而是先盘点、再分组、最后拆块。下面 6 步按顺序执行,出错概率最低。
步骤 1:盘点域名与证书覆盖范围。先对每张证书做一次体检,据 OpenSSL 官方文档,-ext subjectAltName 需要 OpenSSL 1.1.1 及以上才支持:
# 逐张检查:主体、签发者、有效期、SAN 列表(注意 -ext 需 OpenSSL >= 1.1.1)
openssl x509 -in /etc/nginx/certs/a.fullchain.pem -noout
-subject -issuer -dates -ext subjectAltName
# 输出示例:
# subject=CN = example.com
# issuer=C = US, O = Let's Encrypt, CN = R11
# notBefore=Mar 1 00:00:00 2025 GMT
# notAfter=May 30 23:59:59 2025 GMT
# X509v3 Subject Alternative Name:
# DNS:example.com, DNS:www.example.com
把每张证书的 SAN、notAfter、issuer 记入 CSV(如 cert-inventory.csv)。关键陷阱:泛域名 *.example.com 不覆盖 example.com,据 Let’s Encrypt 文档,泛域名必须用 DNS-01 挑战签发,且 apex 域名需单独列入 SAN,否则 https://example.com 会直接报 NET::ERR_CERT_COMMON_NAME_INVALID。
步骤 2:决定分组方式。按”证书边界 = server 块边界”原则选型:
| 场景 | 推荐方案 | 理由 |
|---|---|---|
| 不同主域(shop.com / api.net) | 一证一 server 块 | 续期、吊销、密钥轮换互不影响 |
| 同一主域大量子域、入口一致 | 泛域名或 SAN 证书合并 | 减少证书数量与续期任务 |
| 多域名只是同一站点别名 | 共用 server 块 | ssl_certificate 的 SAN 必须覆盖全部 server_name |
| 到期日差异大(如商业证书 1 年 vs LE 90 天) | 拆开独立块 | 避免一次续期牵动全站 |
步骤 3:规范证书文件。Let’s Encrypt 的默认产物中,fullchain.pem 用于 ssl_certificate,privkey.pem 用于 ssl_certificate_key,chain.pem 用于 ssl_trusted_certificate(OCSP stapling 需要)。自签或商业证书务必保证 fullchain 叶子证书在前、中间证书在后,顺序颠倒会导致部分 Android 与 Java 客户端链验证失败(unable to get local issuer certificate)。
步骤 4:设置权限。据 Nginx 官方文档,master 进程以 root 启动时读取私钥,worker 以 nginx 用户运行且不需要直接读私钥,所以私钥 600 即可:
# 私钥仅 root 可读;证书链 644 可被 worker 读取
install -m 600 -o root -g root a.key /etc/nginx/certs/a.key
install -m 644 -o root -g root a.fullchain.pem /etc/nginx/certs/a.fullchain.pem
步骤 5:拆分 server 块。一个域名一个 conf 文件,公共 TLS 参数抽成片段复用(http2 on; 是 Nginx 1.25.1 起的新写法,1.26 已完全取代 listen 443 ssl http2):
# /etc/nginx/conf.d/shop.conf
server {
listen 443 ssl;
http2 on; # Nginx >= 1.25.1 写法
server_name shop.example.com;
ssl_certificate /etc/nginx/certs/shop.fullchain.pem;
ssl_certificate_key /etc/nginx/certs/shop.key;
include /etc/nginx/snippets/tls-common.conf;
}
# /etc/nginx/conf.d/api.conf —— 结构与上块相同,仅证书与 server_name 不同
绝对不要把不同域名的证书路径塞进同一个 server 块——SNI 只会匹配到第一个证书,其余域名必然告警。
步骤 6:先测试再重载。
nginx -t # 校验语法 + 证书文件是否可读、是否匹配
systemctl reload nginx # 平滑加载,不断开现有连接
reload 会启动新 worker 并让旧 worker 处理完存量连接后退出;若新配置加载失败,旧 worker 继续服务,因此比 restart 更适合生产多证书环境。可用 openssl s_client -connect shop.example.com:443 -servername shop.example.com 逐域名验证 SNI 返回的证书是否正确。
配置示例:三个域名、泛域名和默认 server 的 nginx.conf 怎么写?
能,一份 nginx.conf 里放四个 server 块即可。SNI 由 RFC 6066 定义,Nginx 会依据 ClientHello 里的 server_name 选择匹配的 server 块;只有匹配不到时,才会落到 default_server。nginx 配置多个ssl证书时,最容易踩的坑不是证书路径,而是 http2 写法、泛域名层级和默认 server 回落。
域名 A 同时服务 apex 与 www,证书 SAN 必须覆盖两者:
server {
listen 443 ssl;
http2 on; # Nginx 1.25.1+ 的新指令;1.26.2 可直接用
server_name shop.example.com www.shop.example.com;
ssl_certificate /etc/nginx/certs/shop.fullchain.pem;
ssl_certificate_key /etc/nginx/certs/shop.key;
ssl_trusted_certificate /etc/nginx/certs/shop.chain.pem;
include /etc/nginx/snippets/tls-common.conf;
# root / proxy_pass 等按业务补
}
若仍写 listen 443 ssl http2;,1.25.1 起会告警:nginx: [warn] the "listen ... http2" directive is deprecated, use the "http2" directive instead。功能暂未失效,但 1.26 环境应统一改成独立 http2 on;。
域名 B 即使与 A 共用一张 SAN 证书,也建议拆成独立 server 块:日志、limit_req、proxy_pass 到不同 upstream 才能分开配。证书可复用同一份 fullchain,server 块不要复用。
server {
listen 443 ssl;
http2 on;
server_name api.example.com;
ssl_certificate /etc/nginx/certs/api.fullchain.pem;
ssl_certificate_key /etc/nginx/certs/api.key;
ssl_trusted_certificate /etc/nginx/certs/api.chain.pem;
include /etc/nginx/snippets/tls-common.conf;
access_log /var/log/nginx/api.access.log;
# limit_req zone=api burst=20 nodelay;
}
泛域名块只写 *.example.com:它匹配 shop.example.com、api.example.com,但不匹配 example.com,也不匹配 a.b.example.com。需要 apex 就把 example.com 加进证书 SAN,或单独写 server 块。据 Let’s Encrypt 文档,泛域名证书必须用 DNS-01 挑战签发。
server {
listen 443 ssl;
http2 on;
server_name *.example.com;
ssl_certificate /etc/nginx/certs/wildcard.fullchain.pem;
ssl_certificate_key /etc/nginx/certs/wildcard.key;
ssl_trusted_certificate /etc/nginx/certs/wildcard.chain.pem; # OCSP stapling 校验链
include /etc/nginx/snippets/tls-common.conf;
}
默认 server 用来接住“SNI 未匹配”的握手。据 Nginx 文档,1.19.4 起支持 ssl_reject_handshake,默认 off;开启后不会回落到第一个证书,而是直接拒绝:
server {
listen 443 ssl default_server;
server_name _;
ssl_reject_handshake on; # 1.19.4+;默认 off
}
低于 1.19.4 只能用自签默认证书兜底,避免暴露业务证书。两者行为不同:
| 方案 | 适用版本 | 未匹配 SNI 时 | 注意 |
|---|---|---|---|
ssl_reject_handshake on; |
1.19.4+ | 握手阶段直接失败 | 无需默认证书;同一 listen 只能有一个 default_server |
自签证书 + return 444; |
全版本 | 先完成握手再断连 | 客户端会看到自签证书告警 |
公共片段把 TLS 参数收口,默认值别记错:ssl_session_cache 默认 none,ssl_session_timeout 默认 5m,改成 1d 必须配合 shared 缓存才生效;OCSP stapling 需要 resolver 才能刷新,且每个 server 要有 ssl_trusted_certificate。
# /etc/nginx/snippets/tls-common.conf
ssl_protocols TLSv1.2 TLSv1.3; # Mozilla 现行推荐;TLSv1/1.1 已淘汰
ssl_session_cache shared:SSL:10m; # 默认 none;10m 约可存 4 万会话
ssl_session_timeout 1d; # 默认 5m
ssl_session_tickets off; # 默认 on;关闭可减少前向保密风险
ssl_stapling on;
ssl_stapling_verify on;
resolver 223.5.5.5 1.1.1.1 valid=300s; # OCSP 刷新依赖
resolver_timeout 5s;
改完先 nginx -t,再用 OpenSSL 的 s_client -servername 按 SNI 验证返回证书;这一步能直接暴露 server_name 写错或默认 server 抢先匹配的问题。
nginx -t && systemctl reload nginx
for h in shop.example.com api.example.com foo.example.com; do
echo "== $h =="
openssl s_client -connect 127.0.0.1:443 -servername "$h" </dev/null 2>/dev/null
| openssl x509 -noout -subject -ext subjectAltName
done
如果 foo.example.com 也返回了 shop 的证书,说明默认 server 没生效或 ssl_reject_handshake 未开;如果 apex 返回泛域名证书,说明 *.example.com 不会覆盖 apex,需要补 SAN 或补 server 块。按这套结构做 nginx 配置多个ssl证书,后续加域名只需复制 server 块并换证书路径。
独立证书、SAN、泛域名、多 IP 怎么选?一张对比表看成本与风险
Q:手上十几个域名,是每个签一张 DV 证书配独立 server 块,还是买一张 SAN 多域名证书,或者直接上泛域名?答案取决于三件事:这些域名是否属于同一业务、新增域名有多频繁、以及你愿不愿意维护一张到期日台账。把成本、续期影响面和故障面放在一起看,选型其实很快:
| 方案 | 适用域名数 | 证书成本区间 | 续期影响面 | 主要风险 |
|---|---|---|---|---|
| 独立 DV 证书 + 独立 server 块 | 1–20 个 | 每张 0–300 元/年(Let’s Encrypt 为 0 元) | 单域名故障隔离,一张过期不影响其他站 | 证书数量多、到期日分散,必须建台账,否则漏续期只在单个站点爆雷 |
| 多域名 SAN 证书 + 独立或共用 server 块 | 5–50 个强相关域名 | 商业 DV 约 300–1500 元/年,OV 约 800–4000 元/年 | 一次续期影响整组域名 | 新增域名必须重签;SAN 漏配会让新域名拿到不含它的证书,浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID。适合同一业务的多入口 |
泛域名证书(*.example.com) |
同一主域下大量一级子域 | DV 泛域名约 300–1500 元/年,OV 泛域名约 1500–8000 元/年 | 一次续期覆盖所有一级子域 | 不覆盖 apex(example.com)和多级子域;据 Let’s Encrypt 文档,泛域名只能走 DNS-01 验证,需长期维护 DNS API 凭据 |
| 多公网 IPv4 + 每 IP 独立证书 | 必须兼容无 SNI 的老客户端 | 额外 IPv4 约 20–100 元/月/个,再加每 IP 证书费用 | 每 IP 单独续期 | 成本高、IPv4 地址紧张、配置易漂移;仅建议为少量遗留客户端保留 |
默认 server + ssl_reject_handshake |
所有多证书环境的兜底 | 0 元 | 不涉及证书续期 | 未匹配 SNI 的客户端直接握手失败;上线前必须验证兜底行为符合预期 |
三个容易踩的点值得单独说清。第一,SNI 由 RFC 6066 定义,客户端在 ClientHello 里带上目标主机名,Nginx 才能选到对应 server 块的证书;不带 SNI 的客户端只会命中 default_server,这也是最后一行兜底方案存在的理由。第二,泛域名要同时覆盖 apex,签发时应写 -d example.com -d '*.example.com',只签 *.example.com 会导致裸域访问报证书名不匹配。第三,多 IP 方案并非”更兼容”的银弹,它的真实代价是地址费加证书数翻倍,而现代客户端(含 OpenSSL 1.1.1 起的 s_client)默认都发 SNI。
ssl_reject_handshake 自 Nginx 1.19.4 引入,默认值 off,1.26 可直接使用。兜底块不要配 server_name,只声明监听与拒绝:
# /etc/nginx/conf.d/000-default.conf —— 必须被最先加载(文件名前缀 000)
server {
listen 443 ssl default_server; # 未匹配任何 server_name 的请求落到这里
listen [::]:443 ssl default_server;
ssl_reject_handshake on; # 1.19.4+,默认 off;开启后不返回任何证书
}
server {
listen 443 ssl;
server_name a.example.com;
ssl_certificate /etc/letsencrypt/live/a.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/a.example.com/privkey.pem;
# 其余 b/c.example.com 各自复制一个 server 块,证书路径互不影响
}
上线前用不带 SNI 的握手确认兜底生效(-noservername 需 OpenSSL 1.1.0+):
$ nginx -t && nginx -s reload
$ openssl s_client -connect 203.0.113.10:443 -noservername </dev/null
# 预期:no peer certificate available
# OpenSSL 3.x 末尾报错:error:0A00045C:SSL routines::tlsv1 unrecognized name
# OpenSSL 1.1.1 显示为:sslv3 alert handshake failure
$ openssl s_client -connect 203.0.113.10:443 -servername a.example.com </dev/null | openssl x509 -noout -subject -ext subjectAltName
# 预期:subject=CN = a.example.com,SAN 列表与该 server 块证书一致
若两条命令返回同一张证书,说明 default_server 被别的 server 块抢走了——Nginx 按配置文件加载顺序取第一个带 default_server 的监听,用 nginx -T | grep -n "listen 443" 定位即可。证书链与密码套件的取舍可参考 Mozilla SSL Configuration Generator 的 intermediate 配置档,它按客户端兼容面给出可复制的参数组合。
常见报错有哪些?nginx: [emerg] 与浏览器证书错误的排查顺序
问:nginx -t 失败和浏览器报证书错误,该按什么顺序排查?先分层再定位——配置层(nginx -t 通过与否)→ 协议层(openssl s_client 实际返回哪张证书)→ 应用层(浏览器/curl 的校验结果)。顺序颠倒最容易白忙:配置还没通过就去清浏览器缓存,或者协议层明明返回了正确证书却反复改 server 块。下面这张表可以先帮你把现象归位。
| 报错 / 现象 | 出现阶段 | 首个排查点 | 定位手段 |
|---|---|---|---|
BIO_new_file() failed |
nginx -t / reload | 证书文件路径与读取权限 | ls -l + SELinux 审计 |
key values mismatch |
nginx -t | 证书与私钥是否配对 | openssl x509 -modulus |
ERR_CERT_COMMON_NAME_INVALID |
浏览器 / curl | SNI 命中的 server 块与 SAN | openssl s_client -servername |
a duplicate default server |
nginx -t | default_server 是否重复 | grep -R default_server |
http2 directive is deprecated |
reload 告警 | listen 中的 http2 参数 | grep -R "ssl http2" |
no ssl_certificate is defined |
nginx -t | 该 server 块是否缺证书 | grep -n "listen.*443" |
报错一:nginx: [emerg] cannot load certificate "..." ... BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory) 这是 OpenSSL 打开文件失败,不是证书内容有问题。先确认路径拼写,再确认 Let’s Encrypt 的 live/ 是软链(指向 ../../archive/),容器里只挂载 live/ 而不挂 archive/ 必然断链;RHEL/CentOS 系还要排除 SELinux 拦截。
# 1) 路径是否存在、软链是否断链
ls -l /etc/nginx/certs/a.fullchain.pem
ls -l /etc/letsencrypt/live/example.com/ # 断链时这里会显示 No such file or directory
# 2) 容器场景:必须同时挂载 live/ 与 archive/,否则软链指向不存在的目标
# -v /etc/letsencrypt:/etc/letsencrypt:ro
# 3) SELinux(RHEL/CentOS/Rocky)拦截时,恢复安全上下文后重试
restorecon -Rv /etc/nginx/certs
nginx -t && systemctl reload nginx # -t 通过只代表语法正确,需 reload 才生效
报错二:nginx: [emerg] SSL_CTX_use_PrivateKey("/etc/nginx/certs/a.key") failed (SSL: error:05800074:x509 certificate routines::key values mismatch) 意思是私钥与证书公钥不匹配,最常见的原因是运维批量拷贝时把 A 域名的 key 配到了 B 域名的证书上。据 OpenSSL 文档,用模数比对即可验证:
# 两行输出的 MD5 必须完全一致
openssl x509 -noout -modulus -in /etc/nginx/certs/a.fullchain.pem | openssl md5
openssl rsa -noout -modulus -in /etc/nginx/certs/a.key | openssl md5
# ECDSA 或 OpenSSL 3.x 更通用的写法:比对公钥
openssl x509 -noout -pubkey -in a.fullchain.pem | openssl md5
openssl pkey -in a.key -pubout | openssl md5
报错三:浏览器 NET::ERR_CERT_COMMON_NAME_INVALID,或 curl 退出码 60 并提示 SSL: no alternative certificate subject name matches target host name。按 RFC 6066,SNI 让客户端在握手时声明目标主机名,Nginx 据此选择 server 块;命中错误的块就会返回别的域名证书。另一种可能是证书 SAN 确实不含当前域名——CA/Browser Forum Baseline Requirements 早已要求主机名写入 SAN,只看 CN 是不够的。用下面这条命令看服务端实际吐出的证书,绕开 DNS 与 CDN 干扰:
openssl s_client -connect 127.0.0.1:443 -servername www.example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -ext subjectAltName
# subject 是别的域名 → SNI 落到错误 server 块,检查 server_name 是否写全(含 www)
# subjectAltName 不含目标域名 → 换证书,而不是改配置
curl -sv https://www.example.com --resolve www.example.com:443:127.0.0.1 2>&1 | grep -iE "subject|alt|SSL"
报错四:nginx: [emerg] a duplicate default server for 0.0.0.0:443 同一「地址:端口」组合只允许一个 default_server(默认值即无,只有显式声明才算)。先全局搜出来,再决定保留哪个兜底块:
grep -RIn "default_server" /etc/nginx
# 兜底块只留一个;其余 443 块删掉 default_server 关键字
server {
listen 443 ssl default_server;
server_name _;
ssl_reject_handshake on; # 需 Nginx >= 1.19.4,默认 off
}
报错五:nginx: [warn] the "listen ... http2" directive is deprecated, use the "http2" directive instead。自 Nginx 1.25.1 起,listen 里的 http2 参数被独立指令取代,每次 reload 都会刷这条告警,未来版本将移除。改成两行即可,语义等价:
server {
listen 443 ssl; # 不再写 listen 443 ssl http2;
http2 on; # Nginx 1.25.1+ 的新写法
server_name www.example.com;
ssl_certificate /etc/nginx/certs/a.fullchain.pem;
ssl_certificate_key /etc/nginx/certs/a.key;
}
报错六:nginx: [emerg] no "ssl_certificate" is defined for the "listen ... ssl" directive。某个 server 块写了 listen 443 ssl 却没有证书,ssl_certificate 没有全局默认值可继承(它只能在 http/server 层显式声明)。两种修法:给该块补上证书,或用 ssl_reject_handshake on(Nginx 1.19.4 起支持,默认 off)把默认块做成「拒绝未知 SNI」的兜底,避免为兜底再维护一张自签证书——这也是当前配置多张 SSL 证书时比自签兜底更干净的做法。
怎么验证多个证书真的生效?nginx -T、openssl s_client 与 curl 三组命令
三组命令的分工别搞混:nginx -T 查的是”配置里写了什么”,openssl s_client 查的是”握手时实际发了哪张证书”,curl 查的是”客户端视角整条链能不能验通”。三者都过,才算 nginx 配置多个ssl证书真的生效。
第一步永远是语法校验,然后看合并后的完整配置。据 nginx 官方文档,-T 与 -t 等价于额外把配置 dump 到标准输出,因此 include 进来的文件也会按实际加载顺序展开——这正是排查”后面 include 的 ssl_certificate 覆盖了前面”的唯一可靠手段。
# 先语法检查,通过后再 dump 合并配置
nginx -t && nginx -T 2>/dev/null
| grep -nE 'server_name|ssl_certificate|ssl_reject_handshake|listen'
# 关键检查点:
# 1) 每个 server_name 后面紧跟的 ssl_certificate 是否是预期路径
# 2) 443 上只能有一个 default_server(listen 443 ssl default_server)
# 3) 兜底块的 ssl_reject_handshake on(Nginx 1.19.4+ 可用,默认 off)
第二步按 SNI 逐个验证。据 OpenSSL 文档,-servername 会写入 ClientHello 的 SNI 扩展(RFC 6066),Nginx 据此选证书;-showcerts 输出整条链,再管道给 x509 解析。</dev/null 让 s_client 立即关闭输入,避免卡住。
for h in shop.example.com api.example.com www.example.com; do
echo "===== $h"
openssl s_client -connect 127.0.0.1:443 -servername "$h" -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
done
# subject 的 CN 与 SAN 列表都必须覆盖当前 $h,否则就是 SNI 选错了 server 块
第三步用 curl 验证链和 HTTP 状态。不要加 -k:它会把域名不匹配、链不完整、过期全部吞掉,正好掩盖你要查的问题。
curl -sS -o /dev/null -w '%{http_code} verify=%{ssl_verify_result}n'
--resolve api.example.com:443:127.0.0.1
https://api.example.com/
# 期望输出:200 verify=0;--resolve 绕过 DNS,强制走本机 Nginx
ssl_verify_result |
OpenSSL 错误常量 | 典型原因 |
|---|---|---|
| 0 | X509_V_OK | 链验证通过,这才是目标值 |
| 10 | X509_V_ERR_CERT_HAS_EXPIRED | 证书过期,看 -dates 的 notAfter |
| 18 | X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT | 只配了 ssl_certificate 未拼中间证书 |
| 20 | X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY | 缺中间证书,fullchain 未使用 |
| 62 | X509_V_ERR_HOSTNAME_MISMATCH | SNI 打到了别的 server 块 |
第四步验证默认兜底。不带 SNI 时 Nginx 会落到 default_server 块:
openssl s_client -connect 127.0.0.1:443 -noservername </dev/null
# 兜底块若启用 ssl_reject_handshake on,典型报错:
# 40A7...:error:0A000410:SSL routines::sslv3 alert handshake failure
# 若仍打印出某张业务证书的 subject,说明该块被写成了 default_server,或压根没有兜底块
最后排除环境误判:
ss -ltnp '( sport = :443 )'
# 应同时看到 0.0.0.0:443 与 [::]:443;只有 [::]:443 时 IPv4 客户端可能连不上
nginx -V 2>&1 | grep -E 'nginx version|OpenSSL|http_ssl'
# 期望:nginx version: nginx/1.26.2
# built with OpenSSL 3.0.13 30 Jan 2024
# configure arguments: ... --with-http_ssl_module ...
没有 --with-http_ssl_module 时 nginx -t 会直接报 unknown directive "ssl_certificate",这属于编译问题而非证书问题。把上面四段命令串成一个脚本放进 CI,每次改 server 块后跑一遍,能挡住绝大多数”证书换了但没生效”的线上事故。
新增域名或续期后怎么维护?多证书环境的轮换与监控清单
证书只有 90 天,到底该提前多久续、靠什么触发?
据 Let’s Encrypt 文档,其签发的证书有效期为 90 天,官方建议在剩余 30 天(即用掉约 2/3 生命周期)时续期,而不是等到最后几天——这样即使续期失败,也还有多次重试窗口。certbot 2.x 在 Debian/Ubuntu 上通过 apt 安装后会自带 certbot.timer,每天触发两次并带随机延迟;acme.sh 3.x 安装时写入 crontab,默认每天跑一次 --cron。续期前务必先预演,确认 ACME 挑战路径或 DNS API 凭据仍然有效:
# certbot 2.x:--dry-run 走 staging 环境,不写任何证书文件,验证续期链路是否还通
certbot renew --dry-run
# 确认定时器真的在跑(Debian/Ubuntu 由 apt 安装时自带,别只装了 certbot 就以为万事大吉)
systemctl list-timers | grep certbot
# acme.sh 3.x:手动触发一次 cron 逻辑,等同于计划任务里的那条命令
"/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh"
为什么续期成功了,浏览器拿到的还是旧证书?
因为证书文件更新了,但 Nginx worker 进程还持有旧证书的内存副本。certbot 的 --deploy-hook 只在证书实际发生更新时触发(未到期的域名被跳过时不触发),因此不会造成每天两次的无意义 reload;--renew-hook 已被废弃,老教程里的写法不要照抄。acme.sh 则用 --install-cert 把证书复制到 Nginx 目录,并把重载命令固化进 ~/.acme.sh/<domain>/<domain>.conf。
# certbot:写进 /etc/letsencrypt/cli.ini 可持久生效,避免每次手敲
# 关键:先 nginx -t 再 reload,配置写坏时 reload 会失败但旧进程仍在跑,形成"证书已换、线上未生效"的静默故障
deploy-hook = nginx -t && systemctl reload nginx
# acme.sh:--reloadcmd 在 install-cert 时写入并立即执行一次
acme.sh --install-cert -d example.com -d www.example.com
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.fullchain.pem
--reloadcmd 'nginx -t && systemctl reload nginx'
| 维度 | certbot 2.x | acme.sh 3.x |
|---|---|---|
| 续期触发 | certbot.timer(每日两次,随机延迟) | crontab 每日一次,执行 –cron |
| 重载钩子 | –deploy-hook,仅证书更新时触发 | –reloadcmd,写入 domain.conf |
| 证书落地路径 | /etc/letsencrypt/live/<domain>/ | ~/.acme.sh/<domain>/,需 –install-cert 复制 |
| 预演方式 | certbot renew –dry-run | acme.sh –issue –test(staging) |
怎么在不依赖第三方服务的前提下监控每个 SNI 的到期时间?
不要只看磁盘上的文件——泛域名证书和多 server 块很容易出现”某个域名指向了错误的证书”。正确做法是按 SNI 探测本机 443 端口实际下发的证书,-checkend 2592000 表示判断 30 天(2592000 秒)内是否过期:
#!/usr/bin/env bash
# check_cert_expiry.sh:/etc/nginx/sni-domains.txt 每行一个域名
while read -r domain; do
if ! out=$(openssl s_client -connect 127.0.0.1:443 -servername "$domain" </dev/null 2>/dev/null
| openssl x509 -noout -checkend 2592000 -enddate 2>/dev/null); then
echo "WARN $domain 将在 30 天内过期"
else
echo "OK $domain $out" # 输出示例:OK shop.example.com notAfter=Jun 12 03:14:07 2025 GMT
fi
done < /etc/nginx/sni-domains.txt
把域名、证书路径、SAN 列表、到期日、负责人整理成 CSV,每周跑一次脚本并比对,续期后自动更新该表——这比事后翻日志可靠得多。
OCSP stapling 没生效怎么排查?
Nginx 1.26 中 ssl_stapling 与 ssl_stapling_verify 默认均为 off,需要显式开启。用 -status 直接看握手响应里有没有装订的 OCSP 结果:
openssl s_client -connect 127.0.0.1:443 -servername shop.example.com -status </dev/null 2>/dev/null
| grep -A2 'OCSP Response Status'
# 正常输出:OCSP Response Status: successful (0x0)
# 若无此行或为 tryLater,依次检查:
# 1) ssl_stapling on; ssl_stapling_verify on;
# 2) ssl_trusted_certificate 指向 fullchain.pem(含中间链),指向叶子证书会失败
# 3) resolver 指向可达 DNS(如 resolver 127.0.0.53 valid=300s;),Nginx 需能出网查询 OCSP 响应者
新增一个域名,怎么做到 1 分钟内可回滚?
核心原则:新增而不是覆盖。先签发新证书、校验 SAN,再单独放一个 server 块文件,最后 nginx -t 通过才 reload。reload 是平滑的,旧 worker 会处理完存量连接再退出。改动前用 git 或 cp 备份旧 conf,出问题直接还原并 reload 即可。若图省事把新证书覆盖到旧路径,一旦中间链缺失就会看到这样的真实报错:
nginx: [emerg] cannot load certificate "/etc/nginx/ssl/old.example.com.pem":
BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory)
# 1) 签发(webroot 方式,不触碰现有 443 监听)
certbot certonly --webroot -w /var/www/html -d new.example.com
# 2) 校验 SAN 是否包含全部需要的域名(泛域名写作 *.example.com)
openssl x509 -in /etc/letsencrypt/live/new.example.com/fullchain.pem -noout -text
| grep -A1 'Subject Alternative Name'
# 3) 备份旧配置,再新增独立的 server 块文件到 /etc/nginx/conf.d/
cp /etc/nginx/conf.d/shop.example.com.conf /root/backup/shop.example.com.conf.$(date +%F)
# 4) 语法检查通过才 reload
nginx -t && systemctl reload nginx
这套流程同样适用于调整已有 SNI 多域名的 server_name:多域名共用一张证书时,新增域名意味着证书 SAN 变化,必须重新签发而非仅改 Nginx 配置,否则浏览器会报 NET::ERR_CERT_COMMON_NAME_INVALID。这也是在 nginx 配置多个 SSL 证书时最容易忽略的一环——配置文件与证书内容必须同步演进。
不能靠多条 ssl_certificate 覆盖不同域名。Nginx 1.11.0 起同一 server 块可写多条 ssl_certificate,但那是给同一组域名配置 RSA 与 ECDSA 双证书;不同域名应拆成独立 server 块,或改用覆盖所有 server_name 的 SAN/泛域名证书。
先执行 openssl s_client -connect 127.0.0.1:443 -servername 新域名 -showcerts
不同主域、不同业务、需要故障隔离时,用独立证书加独立 server 块更清晰;同一主域下大量一级子域且入口一致时,泛域名证书更省续期操作。注意泛域名 *.example.com 不覆盖 example.com,Let's Encrypt 泛域名还必须走 DNS-01 验证。
需要。Nginx 在启动或 reload 时把证书加载进内存,磁盘文件更新后不 reload 仍会用旧证书;建议用 certbot renew –deploy-hook 'systemctl reload nginx' 或 acme.sh 的 reloadcmd,在续期成功后先 nginx -t 再平滑重载。
无 SNI 客户端只会收到默认证书,无法按域名切换。可为这类遗留流量保留独立公网 IPv4 和单独证书,或接受默认证书不匹配;现代浏览器、Java 8 及以上、主流移动端均支持 SNI,不必为极少数客户端牺牲主站配置。
说明某个 listen 443 ssl 的 server 块没有配置证书。补上 ssl_certificate 与 ssl_certificate_key,或把该块改为默认兜底并启用 ssl_reject_handshake on;改完执行 nginx -t,确认无误后再 systemctl reload nginx。
Nginx 靠 server_name 加 SNI 选择 server 块和证书,Apache 靠 VirtualHost 加 SSLCertificateFile/SSLCertificateKeyFile,宝塔面板本质是生成 Nginx 配置并调用 reload。迁移时重点核对证书路径、default_server、http2 on 写法以及面板是否会在保存时重写配置。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。