跳到主要内容
Nginx

TrustAsia(亚洲诚信)SSL 证书 Nginx 部署实战:fullchain 配置、398 天有效期与报错排查

问题背景与根因:为什么 TrustAsia 证书在 Nginx 上“装了却不生效”

TrustAsia(亚洲诚信)证书通过 DigiCert 根证书构建信任链,典型路径为「站点证书 → TrustAsia/DigiCert 中间证书 → DigiCert Global Root CA(或 G2)」,信任链与国际品牌一致,中文控制台与人民币计价对国内企业采购友好。但部署到 Nginx 后,“浏览器能打开、程序却报错”是最常见的故障,根因集中在三处。

根因一:证书链不完整。Nginx 的 ssl_certificate 只加载一个文件。如果只放叶子证书,Chrome、Firefox 会通过证书里的 AIA 字段自动下载中间证书补链,所以“看起来正常”;而 curl(部分版本默认不补链)、Java 的 PKIX 校验、微信小程序、旧版 Android 不会补链,直接抛出 unable to get local issuer certificate。正确做法是把叶子证书与中间证书合并成 fullchain.pem。

根因二:有效期规则已变。自 2020 年 9 月 1 日起,所有公共信任 TLS 证书最长有效期被限制为 398 天,Let’s Encrypt 免费证书只有 90 天。一年一续的旧习惯必须改成自动续期加自动 reload,否则很容易在续期窗口内出现全站证书过期。

根因三:协议与语法过时。TLS 1.0/1.1 已被主流浏览器移除,PCI DSS 自 2018 年 6 月 30 日起禁止使用;Nginx 1.25.1 起,listen 443 ssl http2 里的 http2 参数被弃用,需改用独立的 http2 on; 指令,照抄旧教程会出现 [warn] the 「listen … http2」 directive is deprecated 警告。下面按“准备文件 → 配置 → 排错 → 验证”的顺序给出可直接执行的步骤。

准备证书文件:PEM 格式、fullchain 合并与自检命令

TrustAsia 控制台下载「Nginx / PEM」格式的证书包,解压后一般得到站点证书(.crt 或 .pem)、中间证书(chain/ca-bundle)和私钥(.key)。Nginx 只认 PEM(Base64 文本,以 —–BEGIN CERTIFICATE—– 开头),若拿到的是 .pfx/.p12,需先转换:

openssl pkcs12 -in example.com.pfx -clcerts -nokeys -out example.com.crt
openssl pkcs12 -in example.com.pfx -nocerts -nodes -out example.com.key

随后按下面的命令完成合并与自检,任何一步输出不符合预期都不要继续往下部署。

# 1) 合并证书链:叶子证书在前,中间证书在后,不要放根证书
cat example.com.crt chain.crt > example.com.fullchain.pem

# 2) 查看主体、颁发者与有效期
openssl x509 -in example.com.fullchain.pem -noout -subject -issuer -dates

# 3) 查看 SAN,确认主域名与所有子域名都被覆盖
openssl x509 -in example.com.fullchain.pem -noout -text | grep -A1 'Subject Alternative Name'

# 4) 校验私钥是否完好、是否带密码
openssl rsa -in example.com.key -check -noout

# 5) 证书与私钥模数比对,两行 md5 必须完全一致
openssl x509 -noout -modulus -in example.com.fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5

# 6) 校验证书链能否被系统根库验证通过
openssl verify -untrusted chain.crt example.com.crt
# 期望输出:example.com.crt: OK

文件放到 /etc/nginx/ssl/ 并收紧权限:私钥 chmod 600、属主 root:root,fullchain.pem 用 644。若服务器启用 SELinux(CentOS/RHEL 默认开启),还要执行 restorecon -Rv /etc/nginx/ssl,否则 Nginx 读不到文件会直接启动失败。注意 fullchain.pem 的顺序不能颠倒,叶子证书必须在最前面,否则部分客户端会握手失败。

Nginx 完整配置实操:可直接执行的 server 块

下面是单站点 HTTPS 的完整配置,覆盖 TLS 1.2/1.3、会话复用、OCSP Stapling 与 HSTS,替换域名后即可使用。先执行 nginx -v 确认版本:1.25.1 及以上用 http2 on;,更早版本删掉该行并改写成 listen 443 ssl http2;。

server {
    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-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.chain.pem;
    resolver 223.5.5.5 119.29.29.29 valid=300s;
    resolver_timeout 5s;

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

    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 内置管理(如 TLS_AES_128_GCM_SHA256),该指令既管不到也无需管;ssl_prefer_server_ciphers off 让客户端优先选择,配合 TLS 1.3 握手性能更好;ssl_session_tickets off 关闭会话票据,降低私钥泄露后的历史流量解密风险;OCSP Stapling 必须配合 ssl_trusted_certificate 指向中间证书链,否则 Nginx 会报 issuer certificate not found 并静默跳过。

改完先校验再热加载,不要直接 restart:

nginx -t
# nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
# nginx: configuration file /etc/nginx/nginx.conf test is successful
nginx -s reload   # 或 systemctl reload nginx

HSTS 头首次上线建议先用 max-age=300 观察一周,确认全站 HTTPS 且无混合内容后,再调成 31536000 并考虑 includeSubDomains 与 preload;一旦下发长周期 HSTS,回退成本极高。若页面仍有 HTTP 资源,先修混合内容(浏览器控制台会提示 Mixed Content),否则加 HSTS 反而导致资源加载失败。

多域名、泛域名与 SNI 配置示例

泛域名证书 *.example.com 只覆盖一级子域(a.example.com 可以,a.b.example.com 不行),且不覆盖裸域 example.com。签发时务必把裸域写进 SAN,或在 server_name 中同时列出两个名字并确认证书包含它们,否则访问裸域会触发证书名称不匹配。

多域名共用同一台 Nginx 时,SNI 会让 Nginx 按 ClientHello 中的 server_name 选择证书,但直接用 IP 访问或客户端不支持 SNI 时会落到 default_server。建议显式配置默认块返回 444,直接断开连接,避免暴露任意一张业务证书:

server {
    listen 443 ssl default_server;
    server_name _;
    ssl_certificate     /etc/nginx/ssl/default.fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/default.key;
    return 444;
}

Nginx 1.11.0 起支持在同一 server 块配置多张证书,实现 RSA 与 ECDSA 双算法共存,老客户端走 RSA、新客户端走 ECDSA,握手更快:

ssl_certificate     /etc/nginx/ssl/example.com.rsa.fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com.rsa.key;
ssl_certificate     /etc/nginx/ssl/example.com.ecdsa.fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com.ecdsa.key;

验证 SNI 是否按预期返回证书,指定 IP 与域名分别测试:

openssl s_client -connect 203.0.113.10:443 -servername example.com -showcerts </dev/null 2>&1 | grep 'subject='

另外,跳转规则不要写在 location 里用 if 判断 $host,直接在 80 端口的 server 块用 return 301 https://$host$request_uri,既高效又不会出现重定向循环。多张证书共存时注意 ssl_certificate 与 ssl_certificate_key 必须成对出现,顺序不能交叉。

对比表格:文件类型、有效期与验证手段

部署前先把容易混淆的概念对齐。下表列出 Nginx 目录里常见文件的用途与误用后果。

文件 内容 是否必需 误用后果
example.com.crt 仅站点叶子证书 需合并进 fullchain 链不完整,Java/curl 报 unable to get local issuer certificate
chain.crt TrustAsia/DigiCert 中间 CA 合并进 fullchain 同上,小程序与 Android 报错
example.com.fullchain.pem 叶子证书 + 中间证书 是,ssl_certificate 指向它 —
example.com.key RSA/ECC 私钥 是,权限 600 泄露即证书作废,需立即吊销重签
root.crt DigiCert Global Root 不需要 握手包变大,无任何收益

有效期是另一个高频误区:TrustAsia 商业证书按年售卖,但受行业基线约束,单张证书的实际 NotAfter 不会超过 398 天;Let’s Encrypt 为 90 天。下表给出续期策略参考。

证书类型 单张最长有效期 建议提前续期 续期方式
公共信任 DV/OV/EV(含 TrustAsia) 398 天 30 天 控制台重签 + reload
Let’s Encrypt 90 天 30 天 certbot / acme.sh 自动续期
内部自签 CA 自定义 按内部策略 私有流程签发

验证手段的能力边界差异很大,浏览器会“帮你补链”,因此不能作为链完整性的判据。

验证方式 命令/入口 能发现的问题 局限
浏览器地址栏 点击锁标查看证书 严重错误、名称不匹配 会 AIA 补链,掩盖链缺失
curl curl -vI https://example.com 链不完整、协议不支持 不显示套件细节
openssl s_client -connect 域名:443 -servername 域名 链、协议、套件、有效期 输出需人工判读
SSL Labs ssllabs.com/ssltest 综合评级、HSTS、Stapling 需公网可访问,结果有缓存

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

下面这些报错在 TrustAsia 证书部署中出现频率最高,按报错原文对照处理即可。

报错原文 根因 修复动作
curl: (60) SSL certificate problem: unable to get local issuer certificate 缺中间证书 ssl_certificate 改指 fullchain.pem
nginx: [emerg] cannot load certificate … BIO_new_file() failed (SSL: … Permission denied) 文件权限或 SELinux chmod 600 私钥、chown root:root、restorecon -Rv /etc/nginx/ssl
nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:…key values mismatch) 证书与私钥不配对 模数 md5 比对,换回匹配私钥
java.security.cert.CertPathBuilderException: unable to find valid certification path to requested target 链不完整或 JDK 缺根 补全 fullchain,必要时 keytool 导入根证书
curl: (35) error:0A00018A:SSL routines::dh key too small 使用 1024 位 DH 参数 删除 ssl_dhparam,改用 ECDHE 套件
nginx: [warn] ssl_stapling ignored, issuer certificate not found 缺 ssl_trusted_certificate 指向 chain.pem 并确认文件存在
net::ERR_CERT_AUTHORITY_INVALID(小程序/Android) 链不完整或使用自签证书 部署 fullchain,对外勿用自签

链不完整是最高频问题,判断方法是用 openssl s_client -showcerts 看返回的证书条数,正常应至少两条(叶子 + 中间),只有一条即缺链。key values mismatch 一定是对错了私钥,用第 2 节的模数比对命令确认,CSR 阶段生成过两套密钥时极易混淆。

Permission denied 类报错先看权限,再看 SELinux:getenforce 返回 Enforcing 时,临时 setenforce 0 验证,若问题消失就用 restorecon 或 semanage fcontext 永久放行,不要长期关闭 SELinux。Java 的 PKIX path building failed 除链不完整外,还可能是 JDK 自带 cacerts 未包含对应根证书,可用 keytool -list -cacerts 检查。

续期后仍显示旧证书,按顺序排查:文件是否真的被替换(直接读文件看 Not After)、Nginx 是否 reload、前面是否有 CDN/SLB/Ingress 缓存了旧证书、多台后端是否全部更新。

续期自动化与上线检查清单

由于 398 天上限与 90 天的 Let’s Encrypt 规则,续期必须自动化。TrustAsia 商业证书一般在控制台重签后下载新包,建议到期前 30 天完成替换;免费证书用 certbot 或 acme.sh 自动续期,并把 reload 挂在钩子上,避免“续了但没生效”。

# certbot
certbot certonly --webroot -w /var/www/example.com 
  -d example.com -d www.example.com 
  --deploy-hook 'systemctl reload nginx'

# acme.sh
acme.sh --issue -d example.com -d www.example.com -w /var/www/example.com 
  --reloadcmd 'systemctl reload nginx'

监控侧建议每天跑一次到期检查,剩余天数小于 15 天即告警:

echo | openssl s_client -servername example.com -connect example.com:443 2>/dev/null 
  | openssl x509 -noout -enddate

上线前对照检查清单逐项打勾:

检查项 方法 通过标准
证书链完整 openssl s_client -showcerts 至少 2 张证书,Verify return code: 0 (ok)
证书与私钥匹配 模数 md5 比对 两行结果一致
有效期 openssl x509 -noout -enddate 剩余 > 30 天
HTTP 跳转 curl -I http://example.com 301 且 Location 为 https 地址
HTTP/2 curl –http2 -I https://example.com 返回 HTTP/2 200
配置语法 nginx -t syntax is ok / test is successful

效果验证:命令输出与 SSL Labs 评级

部署完成后不要只看浏览器锁标,用下面的命令做一次完整验证,输出与注释一致才算通过。

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>&1 | grep -E 'Verify return code|subject=|issuer='
# Verify return code: 0 (ok)

curl -sSI https://example.com | head -n 3
# HTTP/2 200

curl -sSI http://example.com | grep -i location
# location: https://example.com/

openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | grep 'Protocol'
# Protocol  : TLSv1.2

openssl s_client -connect example.com:443 -servername example.com -tls1 </dev/null | grep -i 'alert|error'
# 应出现 protocol version / handshake failure,说明 TLS 1.0 已禁用

SSL Labs 评级达到 A 或 A+ 的常见条件:只启用 TLS 1.2/1.3、禁用 RC4/3DES/EXPORT 套件、证书链完整并包含中间证书、密钥长度 RSA 不少于 2048 位或 ECC 不少于 256 位、启用 HSTS(A+ 要求)、支持 OCSP Stapling。若评级只有 B,多半是仍支持 TLS 1.0/1.1 或使用了 1024 位 DH 参数。

最后做一次真实业务回归:用 curl 模拟小程序/Java 客户端的严格校验(curl 默认校验证书且不 AIA 补链),再用 -verify_return_error 强制校验失败即退出,两条都通过才能说明链、协议与证书名称全部正确。

curl -sS --tlsv1.2 https://example.com/health -o /dev/null -w '%{http_code}n'
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null >/dev/null 2>&1; echo $?
# 输出 0 表示校验通过

常见问题

必须。浏览器会通过 AIA 自动补链,但 curl、Java、微信小程序和旧版 Android 不会,只配叶子证书会报 unable to get local issuer certificate。把叶子证书与中间证书合并成 fullchain.pem,并让 ssl_certificate 指向它即可。

说明证书与私钥不配对。用 openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in example.com.key | openssl md5 比对,两行必须一致;不一致就用错了私钥,换回签发时对应的 key 再 reload。

受行业基线约束,公共信任 TLS 证书单张最长 398 天,Let’s Encrypt 为 90 天。TrustAsia 商业证书按年售卖,但证书上的 NotAfter 同样不超过 398 天,建议到期前 30 天完成重签与替换。

可以。Nginx 1.11.0 起支持多组 ssl_certificate 与 ssl_certificate_key,会按客户端 ClientHello 中的签名算法自动选择,RSA 与 ECDSA 证书需成对书写,顺序不能交叉。

不需要。TLS 1.3 套件由 OpenSSL 内置管理,ssl_ciphers 只影响 TLS 1.2。确保 OpenSSL 不低于 1.1.1、在 ssl_protocols 中写入 TLSv1.3,并用 openssl s_client -tls1_3 验证握手成功即可。

依次排查:用 openssl x509 -noout -dates 直接读文件确认已替换、执行 systemctl reload nginx、检查 CDN 或负载均衡是否缓存旧证书、确认多台后端节点全部更新,最后清理本地浏览器缓存复测。

内容审核

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