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 或负载均衡是否缓存旧证书、确认多台后端节点全部更新,最后清理本地浏览器缓存复测。