跳到主要内容
Nginx

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。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。