TrustAsia(亚洲诚信)SSL 证书 Nginx 部署实战:fullchain 配置、证书链完整性与排错全流程
问题背景与根因:TrustAsia 证书「装上了」却不生效的三类原因
TrustAsia(亚洲诚信)证书通过 DigiCert 授权的根证书签发,信任链与国际品牌一致,因此「浏览器正常、程序报错」几乎都不是 CA 的问题,而是部署环节的问题。真实工单里最高频的三类根因是:
1)只部署了叶子证书。压缩包里的 example.com.pem 只是站点证书,没有把中间证书拼进 fullchain.pem。桌面浏览器会通过 AIA Fetching 自动补链,所以看起来一切正常;而 curl、Java、微信小程序、部分 Android 旧版本不会自动补链,于是直接报 PKIX 校验失败。
2)证书与私钥不配对。同一域名一年内多次签发时,私钥文件很容易被覆盖成上一张证书的 key,Nginx 启动阶段就会拒绝加载。
3)续期后配置仍指向旧文件,或 reload 的不是对外服务的那个 Nginx。容器、多实例、SLB 后面的场景尤其常见——你在跳板机上执行了 reload,实际接流量的是另一台机器。
还有两个容易被忽略的事实:其一,按 CA/B Forum 基线要求,当前公开信任的 TLS 证书单张最长有效期为 398 天,并将在 2026 年 3 月起逐步缩短至 200 天、2027 年 100 天、2029 年 47 天;Let’s Encrypt 仍固定 90 天。其二,Nginx 1.25.1 起 listen 443 ssl http2 中的 http2 参数已废弃,需改成 listen 443 ssl; 加独立的 http2 on;,否则 nginx -t 会给出告警。
排查思路应该固定为:先用 openssl 看服务端到底发出了几张证书、链是否闭合,再判断是文件问题还是配置问题,而不是反复重启服务。
准备证书文件:从 TrustAsia 控制台到 Nginx 可用的 PEM
在 TrustAsia 控制台下载时选择「Nginx / PEM」格式,压缩包通常包含三部分:example.com.pem(叶子证书)、example.com_ca.crt 或 ca_bundle.crt(中间证书)、example.com.key(私钥,仅首次签发或选择重新生成时提供)。
Nginx 只需要两个文件:fullchain.pem(叶子证书 + 中间证书)和 example.com.key。拼接顺序绝对不能颠倒,叶子证书必须在前:
cd /etc/nginx/ssl
cat example.com.pem ca_bundle.crt > example.com_fullchain.pem
cp ca_bundle.crt example.com_chain.pem # 仅中间证书,供 OCSP Stapling 使用
chmod 644 example.com_fullchain.pem example.com_chain.pem
chmod 600 example.com.key
chown root:root example.com_fullchain.pem example.com_chain.pem example.com.key
校验链里到底有几张证书:
openssl crl2pkcs7 -nocrl -certfile example.com_fullchain.pem | openssl pkcs7 -print_certs -noout
输出中应看到多组 subject= 与 issuer=,最后一张的 issuer 是 DigiCert 根(如 DigiCert Global Root G2)。如果只打印出一条 subject,说明中间证书漏拼了。
检查有效期与 SAN 覆盖范围:
openssl x509 -in example.com_fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
notAfter 应落在 398 天以内(未来会进一步缩短),SAN 必须包含所有实际访问域名,例如只签了 example.com 而用户访问 www.example.com 就会报证书名称不匹配。
核对私钥与证书是否配对(RSA):
openssl x509 -noout -modulus -in example.com_fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
两条 md5 必须完全一致。若为 ECC 证书,改用 openssl ec -noout -text -in example.com.key 与证书公钥的十六进制值比对。
完整实操步骤:8 条命令完成上线
假设 Nginx 已安装、站点为 example.com,按顺序执行:
第 1 步,备份现有配置,避免改坏后无法回滚:
cp -a /etc/nginx/conf.d/example.com.conf /root/example.com.conf.$(date +%F)
第 2 步,放置证书文件到 /etc/nginx/ssl/,权限按上一节设置。
第 3 步,写入 HTTPS server 块,内容见下一节配置示例。
第 4 步,语法校验:
nginx -t
必须看到 nginx: configuration file /etc/nginx/nginx.conf test is successful,出现 emerg 就不要继续。
第 5 步,平滑生效:
nginx -s reload
第 6 步,容器环境需进入容器执行,否则 reload 的是宿主机进程:
docker exec nginx nginx -t && docker exec nginx nginx -s reload
第 7 步,放行端口(firewalld 与云安全组都要开):
firewall-cmd --permanent --add-service=https && firewall-cmd --reload
第 8 步,立即验证,用 openssl 与 curl 双层确认,见「效果验证」一节。
补充:Nginx 自 1.9.5 起支持 reload 热加载证书,无需 restart;只有修改 listen 端口、监听地址或 ssl_session_cache 名称时才需要 restart。Kubernetes Ingress 场景要改 Secret 而不是改 Pod 内文件,Secret 更新后由控制器触发重载。
配置示例:生产可用的 Nginx HTTPS server 块
以下配置可直接落到 /etc/nginx/conf.d/example.com.conf:
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
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-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
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;
add_header Strict-Transport-Security "max-age=31536000" always;
location / {
root /var/www/example.com;
index index.html;
}
}
几个关键点:
ssl_trusted_certificate 与 ssl_certificate 不是一回事。前者只用于校验 OCSP 响应,应放中间证书(不含叶子);把 fullchain 直接指过去会触发 ssl_stapling ignored 告警。
TLS 1.3 的套件不受 ssl_ciphers 控制。它由 OpenSSL 默认套件决定,需要显式调整时使用 ssl_conf_command Ciphersuites TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256;(OpenSSL 1.1.1+)。
HSTS 要最后开。先确认全站 HTTPS 与跳转都跑通,初次上线把 max-age 设为 300 秒试运行,确认无混合内容后再拉到一年。
泛域名证书的坑。*.example.com 不覆盖裸域 example.com,需要单独签一张或购买含裸域的组合证书,并在 SAN 中确认。
对比表格:文件组合、指令写法与生效方式的选择
表 1:证书文件组合对客户端的影响
| 组合方式 | 文件内容 | 浏览器 | curl / Java / 小程序 | 结论 |
|---|---|---|---|---|
| 仅叶子证书 | 1 张 | 正常(AIA 补链) | PKIX path building failed | 禁止 |
| fullchain.pem | 叶子 + 中间 | 正常 | 正常 | 推荐 |
| 叶子 + 中间 + 根 | 3 张 | 正常 | 部分客户端报多余证书 | 不推荐 |
表 2:http2 指令的版本差异
| Nginx 版本 | 推荐写法 | nginx -t 结果 |
|---|---|---|
| < 1.25.1 | listen 443 ssl http2; | 通过 |
| >= 1.25.1 | listen 443 ssl; + http2 on; | 旧写法告警 deprecated |
表 3:reload 与 restart 的取舍
| 操作 | 是否中断连接 | 适用场景 |
|---|---|---|
| nginx -s reload | 否,旧 worker 处理完存量请求后退出 | 换证书、改 location、改 header |
| systemctl restart nginx | 是 | 改 listen 端口、加载新模块 |
表 4:证书类型与覆盖范围
| 类型 | 覆盖范围 | 适用场景 | 注意 |
|---|---|---|---|
| 单域名 | example.com | 单站点 | www 需另配或加 SAN |
| 多域名 SAN | 多个独立域名 | 主站 + 后台 + API | 新增域名需重签 |
| 泛域名 | *.example.com | 子域数量不定 | 不覆盖裸域 |
选型建议:只要站点会同时被浏览器和程序访问,一律使用 fullchain;泛域名优先用于子域多且频繁新增的业务,单站点没必要为泛域名多付成本。
常见错误排查:真实报错与修复命令
1)文件路径错误:nginx: [emerg] cannot load certificate "/etc/nginx/ssl/example.com_fullchain.pem": BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory)。宿主机路径正确不代表容器内正确,用 docker exec nginx ls -l /etc/nginx/ssl 确认挂载。
2)证书与私钥不匹配:nginx: [emerg] SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。执行上一节的 modulus 对比,重新下载私钥。
3)链不完整:curl: (60) SSL certificate problem: unable to get local issuer certificate。用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 数一数返回了几张证书,只有一张就是漏拼中间证书。
4)Java 客户端:PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target。原因同上,JDK 不会自动补链,也不会信任私有根。
5)微信小程序:request:fail ssl hand shake error。多为链不完整或 TLS 版本过低,小程序要求 TLS 1.2 及以上,检查 ssl_protocols 是否误删 TLSv1.2。
6)http2 写法过时:nginx: [warn] the "listen ... http2" directive is deprecated, use the "http2" directive instead。按表 2 改写即可。
7)OCSP 未生效:nginx: [warn] "ssl_stapling" ignored, issuer certificate not found for certificate。补齐 ssl_trusted_certificate 并指向仅含中间证书的文件。
8)时间不同步:浏览器报 NET::ERR_CERT_DATE_INVALID,服务器时间漂移导致证书「尚未生效」。执行 timedatectl set-ntp true && timedatectl status。
9)续期后不生效:先 openssl x509 -in /etc/nginx/ssl/example.com_fullchain.pem -noout -dates 看文件是否真的更新,再 ps -ef | grep nginx 确认 reload 的 master 进程 PID 与接流量的实例一致。
效果验证:三层校验与到期监控
第一层,本地配置。nginx -t 必须成功,无 emerg、无 ssl 相关 warn。
第二层,服务端证书链。
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -E 'depth=|Verify return'
# 期望:Verify return code: 0 (ok)
模拟 Java/curl 的严格校验(指定系统 CA 包):
openssl s_client -connect example.com:443 -servername example.com
-CAfile /etc/ssl/certs/ca-certificates.crt -verify_return_error </dev/null
第三层,应用层。
curl -vI https://example.com 2>&1 | grep -E 'SSL certificate verify|subject:|expire date'
# 期望:SSL certificate verify ok.
协议与跳转检查:
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>&1 | grep Protocol
openssl s_client -connect example.com:443 -servername example.com -tls1 </dev/null 2>&1 | grep -i 'handshake failure'
curl -sI http://example.com | grep -i location
curl -sI https://example.com | grep -i strict-transport-security
TLS 1.0/1.1 应握手失败,80 端口应返回 301 到 https,HSTS 头应存在。
外部评级:SSL Labs 目标 A 及以上,重点看 Certificate chain incomplete 与 Weak protocols 两项告警。
到期监控(证书最长 398 天且未来缩短到 47 天,人工续期不可靠):
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate
接入 Prometheus blackbox_exporter 的 probe_ssl_earliest_cert_expiry 指标,提前 30 天告警,并把续期脚本与 nginx -s reload 串成一条流水线。
常见问题
不建议。根证书已内置在客户端信任库,重复下发会让部分严格实现的客户端判定链异常,也会增大握手包体积。正确顺序是叶子证书在前、中间证书在后,根证书不放入。
当前公开信任的 TLS 证书单张最长 398 天,TrustAsia 按此上限签发。CA/B Forum 已确定自 2026 年 3 月起降至 200 天、2027 年 100 天、2029 年 47 天,必须配置自动续期与到期告警。
先确认 reload 作用于真正对外服务的 master 进程,容器与多实例环境最常见。再用 openssl s_client 看 notAfter 是否更新。若前面有 CDN 或 SLB,需要同步更新边缘节点证书。
文件权限设 600、属主 root,所在目录 700,且不能被 Web 根目录访问到。更稳妥的做法是只读挂载或使用 KMS/HSM 托管。私钥一旦泄露应立即吊销重签。
不能。*.example.com 只匹配一级子域,裸域 example.com 必须单独列入 SAN 或另购单域名证书。部署后用 openssl x509 -noout -ext subjectAltName 确认覆盖清单。