SSL.com SSL 证书 Nginx 部署实战:fullchain 拼接、TLS 1.3 配置与证书链验证排查
问题背景:为什么“浏览器能打开”不代表证书链部署正确
Nginx 的 ssl_certificate 指令只接受一个文件。很多运维把 SSL.com 下发的站点证书(叶子证书)单独填进去,中间证书没有拼接。桌面浏览器遇到缺链时,会通过证书里的 AIA 字段自动去 CA 下载中间证书补齐,所以地址栏照样显示小锁;但 curl、Java、Android、微信支付回调、Go 的 crypto/tls 默认不做 AIA 抓取,会直接判定链不完整并中断握手。
典型报错就是下面三类,看到它们基本可以断定是证书链不完整:
curl: (60) SSL certificate problem: unable to get local issuer certificate
javax.net.ssl.SSLHandshakeException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
ssl.SSLCertVerificationError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate
第二个根因是有效期与续期节奏。按 CA/B Forum 基线要求,2020 年 9 月 1 日起签发的公开 SSL/TLS 证书最长有效期被限制在 398 天,SSL.com 的 DV/OV/EV 产品同样受此约束;Let’s Encrypt 免费证书则是 90 天。这意味着一年至少换一次证书,而 Nginx 只在启动或 reload 时读取证书文件——只替换磁盘文件而不 reload,进程内存里仍是旧证书,这是“续期后仍显示旧到期日”的唯一原因。
第三个根因是版本兼容:nginx 1.25.1 起 listen 443 ssl http2; 里的 http2 参数被废弃,日志会刷 the "http2" directive is deprecated, use the "http2" directive instead,需要改成独立的 http2 on;。另外 TLS 1.0/1.1 已被主流浏览器判定为不安全,必须显式关闭。
证书文件准备:PEM、fullchain 与私钥的对应关系
SSL.com 控制台下载“Nginx / PEM”包后,通常得到 example.com.crt(叶子证书)、intermediate.crt(中间证书,有时叫 ca-bundle)、example.com.key(私钥)。Nginx 需要的是把前两者合并的 fullchain 文件,合并顺序必须是叶子在前、中间在后:
cd /root/ssl.com
cat example.com.crt intermediate.crt > example.com_fullchain.pem
# 确认文件里有 2 段证书(3 段说明把根证书也拼进来了,可以保留但不推荐)
grep -c "BEGIN CERTIFICATE" example.com_fullchain.pem
# 查看主体、签发者与到期日
openssl x509 -in example.com_fullchain.pem -noout -subject -issuer -dates
接着校验私钥本身是否完好,并确认私钥与证书是同一对。RSA 与 ECDSA 的校验命令不同,SSL.com 两种都签发,用错命令会得到 unable to load Private Key:
# RSA 私钥
openssl rsa -in example.com.key -check -noout
# ECDSA 私钥
openssl ec -in example.com.key -check -noout
# 模数比对(RSA),两条输出的 md5 必须完全一致
openssl x509 -noout -modulus -in example.com_fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
最后按最小权限落到目录。私钥绝不能是 644,否则同机其他用户可读取,Nginx 也可能给出告警:
install -d -m 700 /etc/nginx/ssl
install -m 644 example.com_fullchain.pem /etc/nginx/ssl/
install -m 600 example.com.key /etc/nginx/ssl/
chown -R root:root /etc/nginx/ssl
ls -l /etc/nginx/ssl
完整实操步骤:从上传到平滑 reload 的可执行流程
下面是可直接照着敲的顺序,核心原则是先备份、再上传、再语法校验、最后 reload,任何一步失败都能秒级回滚。
# 1) 备份现有证书,带日期后缀
cd /etc/nginx/ssl
cp -a example.com_fullchain.pem example.com_fullchain.pem.$(date +%F)
cp -a example.com.key example.com.key.$(date +%F)
# 2) 从本地或跳板机上传新文件
scp example.com_fullchain.pem example.com.key root@server:/etc/nginx/ssl/
# 3) 确认配置引用的路径就是刚替换的文件
nginx -T 2>/dev/null | grep -n "ssl_certificate"
# 4) 语法与文件可读性校验(不做链校验)
nginx -t
# 5) 平滑重载,不断开现有连接
systemctl reload nginx # 等价于 nginx -s reload
# 6) 确认 master 进程的启动时间已更新,说明配置被重新加载
ps -eo pid,lstart,cmd | grep "nginx: master" | grep -v grep
务必理解 nginx -t 的能力边界:它只检查配置语法、文件是否存在、私钥能否与证书配对,不检查证书链是否完整、是否过期、是否被吊销。所以 nginx -t 显示 syntax is ok / test is successful 之后,仍然必须做一次真实的握手验证。
回滚只需把备份文件改回原名再 reload 一次。建议在变更窗口内保留旧的 .$(date +%F) 文件至少 7 天,并写进变更单,避免出现“证书换了但业务挂了又找不到原件”的局面。
Nginx 配置示例:TLS 1.2/1.3、OCSP Stapling 与 HSTS
以下配置适用于 nginx 1.25.1 及以上版本(使用独立的 http2 on;)。若你的版本低于 1.25.1,把 listen 443 ssl; 与 http2 on; 两行合并为 listen 443 ssl http2;。
server {
listen 443 ssl;
http2 on;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/example.com_fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_trusted_certificate /etc/nginx/ssl/example.com_fullchain.pem;
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;
resolver 223.5.5.5 1.1.1.1 valid=300s;
resolver_timeout 5s;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
add_header X-Content-Type-Options nosniff always;
location / {
root /var/www/example;
index index.html;
}
}
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
几个容易踩坑的参数:ssl_ciphers 只对 TLS 1.2 生效,TLS 1.3 的套件由 OpenSSL 默认控制,想改必须用 ssl_conf_command Ciphersuites ...;ssl_prefer_server_ciphers off 让客户端决定套件,配合 TLS 1.3 可获得更好的握手性能;ssl_stapling 依赖 ssl_trusted_certificate 与可用的 resolver,缺一就会在 error_log 里留下告警。HSTS 首次上线建议先用 max-age=300 观察,确认全站 HTTPS 无混合内容后再拉到一年。
证书类型与部署参数对比
SSL.com 是美国 CA,支持企业采购流程与多种付款方式,产品线覆盖 DV/OV/EV 与文档签名证书。选型直接影响 Nginx 侧的文件数量与配置,参考下表:
| 证书类型 | 校验内容 | 签发时长 | 有效期上限 | Nginx 部署差异 |
|---|---|---|---|---|
| DV 域名验证 | DNS TXT / HTTP 文件 / 邮箱验证域名所有权 | 几分钟至 2 小时 | 398 天 | 仅需 fullchain.pem + key |
| OV 组织验证 | DV + 工商信息人工核验 | 1~3 个工作日 | 398 天 | 链中多一层中间证书,仍需完整拼接 |
| EV 扩展验证 | OV + 严格法律实体审查 | 3~7 个工作日 | 398 天 | 配置同上;现代浏览器已不再显示绿色地址栏 |
| 通配符 / 多域名 SAN | 同 DV 或 OV | 视基础类型 | 398 天 | server_name 需列全,多个 SAN 共用一份 fullchain |
文件与指令的对应关系同样要记牢,放错指令是最常见的“配置了但不生效”:
| 文件 | 内容 | 对应指令 | 建议权限 |
|---|---|---|---|
| example.com_fullchain.pem | 叶子证书 + 中间证书 | ssl_certificate | 644 root:root |
| example.com.key | 私钥(RSA 2048/4096 或 ECDSA P-256) | ssl_certificate_key | 600 root:root |
| intermediate.crt | 中间证书,已并入 fullchain 时仅供 OCSP 校验 | ssl_trusted_certificate | 644 root:root |
注意:ssl_trusted_certificate 不能填成只含叶子证书的文件,否则 OCSP Stapling 校验必然失败。它和 ssl_certificate 指向同一个 fullchain 文件是允许且推荐的做法。
常见错误排查:真实报错与修复动作
1. 文件不是 PEM 或内容为空(常见于用记事本复制导致换行损坏):
nginx: [emerg] cannot load certificate "/etc/nginx/ssl/example.com.crt": PEM_read_bio_X509_AUX() failed (SSL: error:0480006C:PEM routines::no start line)
修复:head -1 example.com_fullchain.pem 必须输出 -----BEGIN CERTIFICATE-----,且文件末尾有对应 END 行;用 file 检查是否混入 CRLF,必要时 sed -i 's/r$//'。
2. 证书与私钥不匹配:
nginx: [emerg] SSL_CTX_use_PrivateKey("/etc/nginx/ssl/example.com.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
修复:回到上一节用 -modulus | openssl md5 比对两个值,不一致就说明传错了 key,重新从 SSL.com 控制台下载对应私钥。
3. 链不完整导致客户端失败:报错 curl: (60) ... unable to get local issuer certificate 或 Java 的 PKIX path building failed。修复:确认 ssl_certificate 指向的是 fullchain 而不是叶子证书。
4. OCSP Stapling 告警:
nginx: [warn] "ssl_stapling" ignored, issuer certificate not found for certificate "/etc/nginx/ssl/example.com_fullchain.pem"
修复:补齐 ssl_trusted_certificate 并配置可用的 resolver。
5. 端口被占用:nginx: [emerg] bind() to 0.0.0.0:443 failed (98: Address already in use),用 ss -lntp | grep :443 找到占用进程,通常是 httpd 或旧 nginx 残留。
6. http2 指令废弃:the "http2" directive is deprecated,按上一节拆成 listen 443 ssl; + http2 on;。
续期、自动化 reload 与到期监控
398 天的上限意味着每年至少一次人工续期;若使用 Let’s Encrypt 类 90 天证书,则需全自动。无论哪种,“换了文件不 reload”都是最高频的翻车点,因为 Nginx master 进程只在启动与 reload 时重新读取证书。
先写一个到期检查脚本,放到 cron 每天跑,输出可直接接入告警:
#!/bin/bash
DOMAIN="example.com"
END=$(echo | openssl s_client -connect ${DOMAIN}:443 -servername ${DOMAIN} 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
END_TS=$(date -d "${END}" +%s)
NOW_TS=$(date +%s)
DAYS=$(( (END_TS - NOW_TS) / 86400 ))
echo "${DOMAIN} 剩余 ${DAYS} 天,到期时间 ${END}"
[ ${DAYS} -lt 30 ] && echo "WARN: 证书即将到期" && exit 1
exit 0
续期完成后执行的动作固定为:替换文件 → nginx -t → systemctl reload nginx。若是 certbot 管理,可用 deploy hook 自动化,避免手滑:
certbot renew --deploy-hook "systemctl reload nginx"
# 写入 /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh 可永久生效
reload 与 restart 的差别要分清:reload 平滑加载新配置,老 worker 处理完存量请求后退出,用户无感;restart 会直接断开所有连接。生产环境优先 reload。监控侧建议同时盯两个指标:证书剩余天数、以及 reload 后 master 进程启动时间是否更新(ps -eo pid,lstart,cmd | grep "nginx: master"),二者结合能覆盖 99% 的续期失效场景。
效果验证:openssl、curl 与 SSL Labs 三件套
验证要分三层做:链是否完整、握手是否成功、评级是否达标。
# 1) 看服务端下发的证书数量与层级,正常应为 2 段(叶子 + 中间)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -E "^ *[si]:"
# 2) 链验证结果,必须为 0 (ok)
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep "Verify return code"
# 3) 强制 TLS 1.2 握手,验证协议兼容性
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null | grep "Protocol"
# 4) 检查 OCSP Stapling 是否生效
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null | grep -A2 "OCSP Response Status"
# 5) 用 curl 复核,关注 subject / issuer / expire date
curl -vI https://example.com 2>&1 | grep -E "SSL certificate verify|subject:|issuer:|expire date"
第 2 条输出 Verify return code: 0 (ok) 且第 1 条能数到两张证书,说明链已正确。若第 2 条出现 21 (unable to verify the first certificate),直接回到 fullchain 拼接环节。
最后跑一次 SSL Labs(https://www.ssllabs.com/ssltest/analyze.html?d=example.com),目标是 A 或 A+。拿不到 A 的典型原因是:仍开放 TLS 1.0/1.1、未启用 HSTS、私钥为 1024 位、或缺 OCSP Stapling。评级页面同时会列出“证书链不完整”的明确警告,可用来交叉验证前面的配置。
常见问题
fullchain.pem 是叶子证书与中间证书拼成的单个文件,内含两段 BEGIN CERTIFICATE。只放叶子证书时浏览器会通过 AIA 自动补链所以看似正常,但 curl、Java、小程序等严格校验的客户端会报 unable to get local issuer certificate。
nginx -t 只校验配置语法、文件是否存在以及私钥与证书能否配对,不校验证书链完整性、有效期和吊销状态。必须再用 openssl s_client 检查 Verify return code 是否为 0 (ok),并用 -showcerts 确认返回两张证书。
优先 systemctl reload nginx,它平滑加载新证书、不断开存量连接;restart 会中断所有会话。注意只替换磁盘文件而不 reload,Nginx 进程内存里仍是旧证书,这就是续期后到期日没变的原因。
受 CA/B Forum 基线要求约束,2020 年 9 月 1 日起签发的公开 SSL/TLS 证书最长有效期为 398 天,SSL.com 的 DV、OV、EV 产品均适用;Let’s Encrypt 免费证书则为 90 天,需要自动化续期。
可以,用多域名 SAN 证书或通配符证书。Nginx 侧在同一个 server 块的 server_name 里列全所有域名即可,它们共用同一份 fullchain.pem 和私钥;跨主域名的场景建议拆成独立 server 块分别配置。
私钥设为 600 且属主 root:root,所在目录 /etc/nginx/ssl 设为 700。若私钥是 644,同机其他用户可直接读取并冒用证书,属于严重安全隐患,部分合规审计会直接判定不通过。