SSL.com 证书 Nginx 部署实战:fullchain 配置、398 天有效期与链完整性排错
问题背景与根因:证书已经安装,为什么仍然报错
Nginx 部署 SSL 证书时出现的“失败”,很少发生在证书签发环节;90% 的问题集中在三个根因:证书链不完整、证书与私钥不配对、续期后没有重载进程。典型现象是:用浏览器访问正常,因为 Chrome 会通过 AIA 自动补全缺失的中间证书;而 curl、Java 客户端、微信小程序、iOS 原生请求会直接握手失败,因为这些客户端的信任库只接受服务端下发的完整证书链。
第二个常见问题是有效期。自 2020-09-01 起,CA/B Forum 强制要求公有 CA 签发的单张 TLS 证书有效期不超过 398 天;Let’s Encrypt 更短,固定为 90 天。因此,“一年装一次、装完不再管”的做法必然导致证书过期。SSL.com 控制台售卖的 1 年期产品,实际签发证书的 notAfter - notBefore 同样受 398 天限制;到期前必须重新签发(reissue),而不是以为“续费即可继续使用旧证书”。
第三个根因是协议与加密套件配置过时。如果站点仍然只启用 TLSv1 TLSv1.1,2024 年后会被主流浏览器标记为不安全;反过来,如果只写 TLSv1.3,则会排除部分老旧 Android 与 Java 8 客户端。定位问题前,先运行一条命令确认当前状态:
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
如果 issuer 显示的是站点自己的域名,而不是中间 CA 的名称,说明你下发的是叶子证书而不是 fullchain,这就是根因。
前置准备:PEM 文件、CSR 与 398 天有效期
Nginx 只识别 PEM(Base64 文本)格式。SSL.com 控制台在订单详情页提供「Nginx / PEM」下载包,解压后通常得到三个文件:
| 文件 | 内容 | 用途 |
|---|---|---|
| example.com.crt | 站点叶子证书 | 需与中间链合并 |
| example.com.ca-bundle | 中间证书链 | 需与叶子证书合并 |
| example.com.key | 私钥 | 严格保密,权限 600 |
关键操作是把叶子证书和中间链按顺序合并成一个 fullchain 文件;顺序错了同样会导致握手失败:
cat example.com.crt example.com.ca-bundle > example.com_fullchain.pem
grep -c "BEGIN CERTIFICATE" example.com_fullchain.pem # 应为 2 或 3
如果手里还没有 CSR(证书签名请求),可以用下面一条命令生成 2048 位 RSA 私钥与 CSR,并把主域名和 www 一起写进 SAN:
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key -out example.com.csr
-subj "/C=CN/ST=Shanghai/L=Shanghai/O=Example Ltd/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
注意:现代浏览器早已不再检查 CN 字段,只认 SAN。如果 CSR 里的 SAN 漏了 www,签出来的证书在访问 www.example.com 时就会报 NET::ERR_CERT_COMMON_NAME_INVALID。另外,CSR 与私钥必须成对保存;重新生成 CSR 就等于更换密钥,旧证书也会随之作废。
实操步骤一:上传证书文件并限制权限
证书目录不要放在 /home 下,因为 SELinux 会拦截;统一放在 /etc/nginx/ssl,并把目录权限设为 700、私钥权限设为 600:
sudo mkdir -p /etc/nginx/ssl
sudo chmod 700 /etc/nginx/ssl
sudo install -m 600 -o root -g root example.com_fullchain.pem /etc/nginx/ssl/
sudo install -m 600 -o root -g root example.com.key /etc/nginx/ssl/
上传完成后,必须校验三件事:
# 1. 证书与私钥是否配对:两个 md5 必须完全一致
openssl x509 -noout -modulus -in /etc/nginx/ssl/example.com_fullchain.pem | openssl md5
openssl rsa -noout -modulus -in /etc/nginx/ssl/example.com.key | openssl md5
# 2. 有效期与 SAN
openssl x509 -noout -dates -ext subjectAltName -in /etc/nginx/ssl/example.com_fullchain.pem
# 3. 链顺序:输出的第一个 subject 必须是站点域名
openssl crl2pkcs7 -nocrl -certfile /etc/nginx/ssl/example.com_fullchain.pem
| openssl pkcs7 -print_certs -noout
第三条命令的输出中,第一个 subject= 必须等于你的域名,后面依次是中间 CA 和根 CA。根证书可以不下发,也不影响验证。权限方面:Nginx master 进程以 root 启动,随后降权给 worker 进程;600 权限对 worker 仍然可读。如果放在自定义路径下被 SELinux 拦截,可以执行 chcon -t httpd_sys_content_t 修正上下文。
实操步骤二:完整的 server 块配置示例
下面是一份可直接使用的配置,包含 HTTP 跳转、TLS 1.2/1.3、OCSP Stapling、会话复用与 HSTS:
# /etc/nginx/conf.d/example.com.conf
server {
listen 80;
listen [::]:80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
listen [::]:443 ssl;
http2 on; # nginx ≥ 1.25.1 写法;旧版用 listen 443 ssl http2;
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_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;
ssl_trusted_certificate /etc/nginx/ssl/example.com_fullchain.pem;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
root /var/www/example.com;
index index.html;
}
几个容易配错的点:ssl_prefer_server_ciphers off 是让客户端优先选择 ChaCha20;在移动端没有 AES 硬件加速时,ChaCha20 更快,这也是 Cloudflare 的推荐值。ssl_stapling 必须配合 ssl_trusted_certificate 指向包含中间证书的链文件,否则 Nginx 会输出 "ssl_stapling" ignored 警告。HSTS 一旦下发,浏览器会在 max-age 内拒绝 HTTP 访问;灰度阶段建议先用 max-age=300 观察。
实操步骤三:语法校验与平滑重载
sudo nginx -t # 语法 + 证书可加载性
sudo nginx -T | grep -E "ssl_certificate|server_name" # 打印最终生效配置
sudo systemctl reload nginx # 等价于 nginx -s reload
nginx -t 会真正 open 证书文件并做私钥匹配检查,因此下面两类错误在这一步就会暴露,不必等到线上才发现:
nginx: [emerg] cannot load certificate "/etc/nginx/ssl/example.com_fullchain.pem": PEM_read_bio_X509_AUX() failed (SSL: error:04800064:PEM routines::bad base64 decode)
nginx: [emerg] SSL_CTX_use_PrivateKey("/etc/nginx/ssl/example.com.key") failed (SSL: error:0A080006:SSL routines::EVP_PKEY_CTX_ctrl failed:key values mismatch)
第一条错误通常是文件被 CRLF 换行破坏,或者在复制时被截断;第二条错误说明私钥与证书不配对。reload 是平滑的:master 启动新 worker 加载新证书,旧 worker 处理完存量连接后退出,不会断流。容器环境要特别注意:K8s 里挂载的 Secret 更新后是软链接,Nginx 必须 reload 才会重新 open 文件;如果只挂载文件、没有 reload,进程内持有的仍然是旧证书。如果 reload 之后 nginx -t 仍报旧错误,先执行 systemctl status nginx 确认 reload 是否失败并退回了旧配置。
方案与配置对比表
先看下发内容对客户端的影响,这是排错时最直接的判据:
| 对比项 | 只下发叶子证书 | 下发 fullchain(推荐) |
|---|---|---|
| 浏览器访问 | 正常(AIA 自动补链) | 正常 |
| curl / wget | (60) unable to get local issuer certificate | 通过 |
| Java / Android 原生 | PKIX path building failed | 通过 |
| 微信小程序 | request:fail ssl hand shake error | 通过 |
| SSL Labs 评级 | 通常 B 或 A- | A / A+ |
再对比证书类型与有效期上限(SSL.com 与 Let’s Encrypt):
| 类型 | 验证内容 | 签发时长 | 典型用途 | 有效期上限 |
|---|---|---|---|---|
| DV | 仅域名控制权 | 分钟级 | 博客、API | ≤398 天 |
| OV | 企业工商信息 | 1–3 工作日 | 企业官网、B 端 | ≤398 天 |
| EV | 严格主体核验 | 3–7 工作日 | 金融、支付 | ≤398 天 |
| Let’s Encrypt | 域名控制权 | 分钟级 | 自动化场景 | 90 天 |
最后对比配置项写法的新旧差异:
| 配置项 | 过时写法 | 当前推荐 |
|---|---|---|
| ssl_protocols | TLSv1 TLSv1.1 | TLSv1.2 TLSv1.3 |
| HTTP/2 开关 | listen 443 ssl http2 | http2 on;(nginx ≥ 1.25.1) |
| 加密套件 | AES128-SHA(CBC 模式) | ECDHE-*-GCM / CHACHA20 |
| 证书更新生效方式 | restart | reload(平滑,不断流) |
常见错误排查(含真实报错)
1. curl: (60) SSL certificate problem: unable to get local issuer certificate
证书链不完整。用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE" 查看下发张数,只返回 1 张就是漏了中间证书,重新合并 fullchain。
2. verify error:num=21:unable to verify the first certificate
同上的另一种表现形式,常见于用 openssl s_client 直接测试时。补链后 Verify return code 应变为 0 (ok)。
3. Java 报 PKIX path building failed: unable to find valid certification path to requested target
先确认服务端下发了几张证书;若服务端完整,则是客户端 JDK 的 cacerts 缺根证书,用 keytool -importcert -alias myca -file root.crt -keystore $JAVA_HOME/lib/security/cacerts 导入。
4. nginx: [warn] "ssl_stapling" ignored, issuer certificate not found for certificate
缺少 ssl_trusted_certificate,或者它指向的文件不含中间证书。指向 fullchain 即可消除。
5. nginx: [emerg] no "ssl_certificate" is defined for the "listen ... ssl" directive
某个 listen 443 ssl 的 server 块漏配证书;用 nginx -T | grep -B5 "listen 443" 定位到具体文件。
6. 续期后浏览器仍显示旧证书
先用 echo | openssl s_client -connect 127.0.0.1:443 2>/dev/null | openssl x509 -noout -dates 对比文件的 notAfter,判断是本机未 reload 还是 CDN/负载均衡层没更新;多层架构下每一层都要换。
效果验证:从命令行到 SSL Labs 评级
部署完成后,按下面 6 条命令逐项验证,全部通过才算完成:
# 1. 协商到的协议与套件
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep -E "Protocol|Cipher"
# 2. 链验证结果,必须为 0 (ok)
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep "Verify return"
# 3. 下发证书条数,应 ≥2
echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null | grep -c "BEGIN CERTIFICATE"
# 4. HTTP 是否 301 到 HTTPS
curl -sI http://example.com | head -3
# 5. HSTS 响应头是否下发
curl -sI https://example.com | grep -i strict-transport-security
# 6. 剩余有效期是否超过 30 天
echo | openssl s_client -connect example.com:443 2>/dev/null | openssl x509 -noout -checkend 2592000 && echo "剩余超过30天"
最后跑一次 SSL Labs(https://www.ssllabs.com/ssltest/analyze.html?d=example.com)。要拿到 A/A+,需要同时满足:只启用 TLS 1.2 及以上、不支持 RC4/3DES、证书链完整、下发 HSTS、支持前向保密套件(ECDHE)。若评级卡在 B,多半是链不完整或仍在协商 TLS 1.1,回到上文第 1、2 条命令复查即可。
常见问题
不需要,也建议不放。根证书已内置在浏览器与操作系统的信任库中,服务端只需下发叶子证书和中间证书。多放根证书会让握手包变大,个别老旧客户端反而可能报错。合并后执行 grep -c “BEGIN CERTIFICATE” 确认是 2 张即可。
可以。SSL.com 支持在订单有效期内随时 reissue,新证书会覆盖旧证书的使用期限,但单张证书的 notBefore 到 notAfter 仍不超过 398 天。建议在剩余 30 天时执行 openssl x509 -checkend 2592000 触发告警并提前更换。
不必。使用 systemctl reload nginx(或 nginx -s reload)即可,master 会加载新证书并平滑替换 worker,不会中断现有连接。restart 会断开所有活跃连接。但 reload 前务必先执行 nginx -t,避免新配置有误导致 reload 失败、继续使用旧证书。
因为 Chrome 会通过 AIA 自动下载缺失的中间证书补全链,而小程序、Java、部分 Android 原生请求不会。它们只信任服务端实际下发的证书链。解决办法是把中间证书合并进 fullchain.pem 并在 ssl_certificate 中引用,再用 openssl s_client -showcerts 确认下发 2 张以上。
可以。为每个域名建立独立的 server 块,各自配置 ssl_certificate 与 ssl_certificate_key,靠 SNI 区分。注意同一 IP 上不要使用多个 listen 443 ssl default_server;旧版 Nginx 对多张证书的会话复用会有干扰,建议升级到 1.20 以上并关闭 ssl_session_tickets。