跳到主要内容
Nginx

GlobalSign SSL 证书 Nginx 部署实战:证书链、HTTP/2 与验证全流程

问题背景与根因:证书装上了,为什么客户端还是报错

GlobalSign(GMO GlobalSign)是欧洲老牌 CA,除 TLS/SSL 证书外还提供文档签名、S/MIME、代码签名等合规类产品,根证书预置于主流操作系统与浏览器信任库,在欧洲与日本市场占有率高,OV/EV 审核流程规范。但“签发成功”不等于“部署成功”,Nginx 上翻车的原因高度集中。

根因一:证书链缺失。Nginx 没有 Apache 的 SSLCertificateChainFile 指令,ssl_certificate 指向的文件必须自带中间证书,即“叶子证书 + 中间证书”按顺序拼接的 fullchain。只配叶子证书时,桌面 Chrome 可能因 AIA 抓取或缓存显示正常,但 curl、Java、微信小程序、部分 Android WebView 会直接失败——这就是“浏览器正常、程序报错”的绝大多数来源。

根因二:语法过时。nginx 1.25.1 起,listen 443 ssl http2; 中的 http2 参数被废弃,error_log 会打印 the listen ... http2 directive is deprecated, use the http2 directive instead,正确写法是 listen 443 ssl; 配合独立的 http2 on;。照抄老教程必踩。

根因三:有效期认知落后。公共 TLS 证书最长有效期自 2020 年 9 月起为 398 天,CA/B 论坛已通过分阶段缩短计划(2026 年起 200 天、2027 年 100 天、2029 年 47 天),“买三年一劳永逸”早已不成立,靠人工记到期日必然翻车。

先用一条命令判断你手上是不是“残链”:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'

正常返回 2(叶子 + 中间),返回 1 说明链断了,需要重新合并 fullchain。

准备证书文件:从 GlobalSign 控制台到可用的 PEM 链

在 GlobalSign 控制台或代理商后台下载证书包时,选择 Nginx / PEM 或 Other / PEM 格式。包里通常包含 example.com.crt(叶子证书)、intermediate.pem 或 ca.pem(中间证书);私钥若由你在本地生成 CSR,则始终只在你自己手里。Nginx 只认 PEM(Base64 编码 + BEGIN CERTIFICATE 头尾),DER、PFX、JKS 都不能直接喂给它。

第一步,合并证书链。顺序必须是“叶子在前、中间在后”,反过来会握手失败:

cd /etc/nginx/ssl
cat example.com.crt intermediate.pem > example.com_fullchain.pem
chmod 644 example.com_fullchain.pem
chmod 600 example.com.key
chown root:root example.com_fullchain.pem example.com.key

第二步,确认链的长度与顺序。标准 RSA 单域名证书应为 2 张;若 GlobalSign 下发了交叉签名链,可能是 3 张。超过 3 张通常说明把根证书也塞进去了,建议删掉——根证书已在客户端信任库中,多余只会增大握手包体积。

grep -c 'BEGIN CERTIFICATE' example.com_fullchain.pem
openssl crl2pkcs7 -nocrl -certfile example.com_fullchain.pem | openssl pkcs7 -print_certs -noout

第二条命令会依次打印每张证书的 subject 与 issuer,检查第 1 张的 issuer 是否等于第 2 张的 subject,链才闭合。再做一次离线校验:

openssl verify -untrusted intermediate.pem example.com.crt
# 期望输出:example.com.crt: OK

第三步,核对私钥配对与 SAN 覆盖范围:

openssl x509 -noout -pubkey -in example.com_fullchain.pem | openssl md5
openssl pkey -pubout -in example.com.key | openssl md5
openssl x509 -noout -subject -issuer -dates -ext subjectAltName -in example.com_fullchain.pem

两行 md5 必须完全一致,否则 reload 时 Nginx 直接拒绝启动。最后确认 notAfter 在 398 天上限内,subjectAltName 覆盖 example.com 与 www.example.com。私钥权限保持 600、属主 root、所在目录 755,否则 worker 进程读不到文件。

配置示例:443、HTTP/2 与 80 跳转

把下面内容写入 /etc/nginx/conf.d/example.com.conf。其中 listen 443 ssl; 与独立 http2 on; 适用于 nginx ≥ 1.25.1;若你还在 1.24 及更早版本,改回 listen 443 ssl http2;,否则启动报 unknown directive 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_protocols       TLSv1.2 TLSv1.3;
    ssl_ciphers         ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384: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;
    resolver 223.5.5.5 1.1.1.1 valid=300s;
    resolver_timeout 5s;

    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;

    location / {
        root /var/www/example.com;
        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 TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256;。其二,OCSP stapling 依赖 ssl_trusted_certificate 指向含中间证书的链文件,并必须配 resolver,否则日志持续输出 ssl_stapling ignored, issuer certificate not found。其三,多家 CA 正在弱化 OCSP,stapling 长期失败不影响站点可用性,可整段注释。其四,HSTS 一旦下发即在浏览器锁定 max-age,先在测试域名用小值验证。

若同时持有 RSA 与 ECDSA 两张证书,可在同一 server 块内写两次 ssl_certificate / ssl_certificate_key,Nginx 会按客户端能力自动选择,这是提升握手性能的低成本手段。

部署执行:校验、reload 与回滚

# 1. 备份当前配置与证书
tar czf /root/nginx-ssl-$(date +%F).tar.gz /etc/nginx/conf.d /etc/nginx/ssl

# 2. 语法与证书加载校验(-t 会真正读取证书文件)
nginx -t
# 期望:nginx: configuration file /etc/nginx/nginx.conf test is successful

# 3. 平滑重载
nginx -s reload
# 或 systemctl reload nginx

# 4. 确认最终生效的证书路径
nginx -T | grep -A2 ssl_certificate

nginx -t 是唯一的守门员:它不只查语法,还会真正调用 OpenSSL 加载证书与私钥,私钥不匹配、文件不存在、权限不足都会在这一步暴露。只要 -t 失败就绝不 reload,线上仍是旧配置,天然具备回滚能力。

若 reload 后 443 直接不通,按序排查三件事:ss -lntp | grep 443 看进程是否仍在监听;tail -50 /var/log/nginx/error.log 看具体报错;再查防火墙与云安全组。CentOS/RHEL 还要看 SELinux:getenforce 返回 Enforcing 时,把证书放在非标准目录(如 /data/ssl)会被拒绝读取,日志呈现 Permission denied 而非证书错误。临时验证用 setenforce 0,正式修复用 semanage fcontext -a -t httpd_sys_content_t '/data/ssl(/.*)?' && restorecon -Rv /data/ssl。

上线前建议先做本机灰度,用 curl --resolve 把域名强行指向本机 IP,不影响 DNS 即可验证新证书:

curl -vI --resolve example.com:443:127.0.0.1 https://example.com
openssl s_client -connect 127.0.0.1:443 -servername example.com </dev/null 2>/dev/null | grep 'Verify return code'

回滚很简单:解开备份包,执行 nginx -t && nginx -s reload。真正麻烦的是“证书换对了但客户端复用旧连接”,HTTP/2、gRPC、连接池可能数小时不重连,验证时务必新开进程而非复用已有会话。

关键文件与有效期对比

大量部署失败源于“文件角色”混淆。下表把 GlobalSign 证书包中每个文件的职责对齐到 Nginx 指令:

文件 内容 Nginx 中的正确用途 典型误用后果
example.com.crt 仅叶子证书 不可单独用于 ssl_certificate 链不完整,Java/curl 报错
intermediate.pem 中间证书 与叶子拼接成 fullchain 单独配置导致握手失败
example.com_fullchain.pem 叶子 + 中间 ssl_certificate 的正确取值 —
root.crt 根证书 无需部署 塞入链中增大握手包
example.com.key 无口令 PEM 私钥 ssl_certificate_key 带 passphrase 导致启动需交互
.pfx / .jks PKCS#12 / JKS 不适用,需先转换 直接配置触发 PEM_read_bio 报错

有效期与协议现状同样需要更新认知,下表是 2024 年之后仍然成立的硬事实:

项目 当前值 说明
公共 TLS 证书最长有效期 398 天 2020-09 起生效,CA 无法签发更长期
Let’s Encrypt 90 天 必须用 certbot / acme.sh 自动续期
GlobalSign OV/EV 多年期 分次签发,单张仍 ≤398 天 所谓 2 年期是两张证书轮换
TLS 1.0 / 1.1 已废弃 主流浏览器 2020 年起停用
http2 配置方式 nginx ≥1.25.1 用 http2 on; 旧版用 listen … ssl http2;

注意“多年期证书”并不违反 398 天上限:CA 的多年合约本质是预先付费、到期自动重签,每张证书的 notAfter 仍受浏览器策略约束。若你的监控只记录订单到期日而不读证书本身,就会在两次重签之间出现盲区。

常见错误排查:真实报错与修复

报错原文 根因 修复
nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) 证书与私钥不配对(常因重签后忘换 key) 比对 openssl x509 -noout -pubkey 与 openssl pkey -pubout 的 md5
cannot load certificate ... PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line) 文件是 DER 二进制,或下载到的是 HTML 页面 openssl x509 -inform DER -in cert.cer -out cert.pem
curl: (60) SSL certificate problem: unable to get local issuer certificate 链不完整,缺中间证书 合并 fullchain 后 reload
verify error:num=21:unable to verify the first certificate 同上,openssl 视角的同一问题 同上
PKIX path building failed: unable to find valid certification path to requested target Java 信任库严格,链缺失时必报 补链,而非往 cacerts 里塞站点证书
nginx: [warn] ssl_stapling ignored, issuer certificate not found for certificate 未配 ssl_trusted_certificate 或未配 resolver 指向 fullchain 并配置 DNS resolver
nginx: [emerg] PEM_read_bio_PrivateKey() failed ... bad decrypt 私钥带 passphrase openssl pkey -in enc.key -out plain.key 去口令

还有一类“不报错但不生效”的情况:证书文件已更新,但 nginx -T 输出的 ssl_certificate 路径指向另一份旧文件,多站点配置里常见 include 覆盖。续期后务必执行 nginx -T | grep ssl_certificate 逐一核对,再配合 openssl s_client 看实际下发的 notAfter。若站点前面还有 CDN 或负载均衡,别忘了那一层也要换证书,否则源站更新后用户看到的仍是边缘节点的旧证书。

效果验证:命令行、评级与到期监控

先验证链与有效期,两条命令即可:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep 'Verify return code'
# 期望:Verify return code: 0 (ok)

再用 curl 一次性拿到状态码、证书校验结果与 HTTP 版本,ssl_verify_result 为 0 表示本地信任库校验通过:

curl -sSvo /dev/null -w '%{http_code} %{ssl_verify_result} %{http_version}n' https://example.com
curl -sI https://example.com | grep -i strict-transport-security

第三方评级用 SSL Labs 的公开 API,无需打开浏览器:

curl -s 'https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done&publish=off' | jq -r '.endpoints[0].grade'
# 目标:A 或 A+

内网或不便外发的域名可用 testssl.sh 本地跑:./testssl.sh --severity HIGH example.com,重点看 certificate chain、OCSP stapling、protocols 三段。

最后是到期监控,别依赖人工日历。用 cron 每天读一次实际证书的 notAfter:

#!/bin/bash
END=$(echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate | cut -d= -f2)
DAYS=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
[ $DAYS -lt 30 ] && echo "example.com 证书仅剩 $DAYS 天" | mail -s 'SSL 到期告警' ops@example.com

注意脚本要读线上实际下发的证书,而不是磁盘文件——两者不一致恰恰是最隐蔽的故障。若使用 GlobalSign 的多年期方案,把重签日历与监控告警都设在到期前 30 天,留出审核与变更窗口。

常见问题

几乎都是证书链不完整。桌面浏览器会通过证书里的 AIA 地址自动补抓中间证书,而 curl、Java、小程序等严格校验方不会。把叶子证书与 intermediate.pem 合并成 fullchain 再 reload 即可,用 openssl s_client -showcerts 数证书块应≥2。

技术上不会导致握手失败,但不建议。根证书已预置在客户端信任库,多放一张只会增大握手包、增加解析开销,个别老客户端还会因链过长报错。正确做法是只放叶子证书加中间证书,用 openssl crl2pkcs7 打印确认链闭合即可。

不必重启,reload 就够。nginx -s reload 会启动新 worker 加载新证书、旧 worker 处理完存量连接后退出,用户无感知;restart 会中断所有连接。但 reload 前必须先 nginx -t 通过,否则新配置不会生效、线上仍是旧证书。

证书与私钥不是同一对。常见于重签后只替换了证书文件、私钥仍是旧的,或多站点配置指向了错误目录。用 openssl x509 -noout -pubkey 与 openssl pkey -pubout 分别取公钥算 md5,两者一致才配对。

公共 TLS 证书单张最长 398 天,且 2026 年起将缩短至 200 天、2029 年至 47 天。GlobalSign 的多年期方案是分次重签,不是单张长期有效。建议用脚本每日读取线上证书 notAfter,剩余 30 天触发告警并进入换证流程。

先执行 nginx -T | grep ssl_certificate 确认最终生效路径,多站点场景常见 include 覆盖或复制了另一份配置。若路径正确,检查站点前方是否有 CDN、SLB、Ingress 等代理层,边缘节点未换证书时用户看到的仍是旧证书。

内容审核

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