CFCA SSL 证书 Nginx 部署实战:证书链、RSA/ECC 双算法与国密 SM2 配置全流程
一、问题背景与根因:CFCA 证书在 Nginx 上为什么容易装错
CFCA(中国金融认证中心)是国内金融行业的主流 CA,签发的 SSL/TLS 证书同时支持国密 SM2 与国际 RSA/ECC 算法,银行、政务、国企以及有国密改造要求的项目经常使用。把这类证书部署到 Nginx 时,故障点几乎集中在三处。
第一,格式与证书链。Nginx 只接受 PEM 格式,且 ssl_certificate 指向的文件必须是「站点证书 + 中间证书」拼接后的 fullchain。CFCA 控制台下载的 Nginx 包通常已经拼好,但很多人从压缩包里只取第一个 CERTIFICATE 块,结果浏览器(具备 AIA 自动补链能力)显示正常,curl、Java、微信小程序却直接握手失败。
第二,多算法链路混用。同一张证书可能对应 RSA、ECC(P-256)、SM2 多条签发链,中间证书完全不同。把 ECC 的中间证书拼到 RSA 叶子证书后面,或者续期时只换叶子证书、没换中间证书,都会导致证书链断裂,openssl s_client 报 Verify return code: 21。
第三,国密不能用标准 Nginx。官方 Nginx 链接的 OpenSSL 不实现 GMTLS 握手与 SM2 套件,必须使用铜锁(Tongsuo)编译的 Nginx 或国密版 Tengine,并配置国际 + 国密双证书,才能同时兼容普通浏览器与国密浏览器。
还需要注意有效期规则的变化:CA/Browser Forum 基线要求下,公有可信 CA 签发的 TLS 证书单张有效期上限为 398 天;按已通过的缩短计划,2026 年 3 月 15 日起降为 200 天,2027 年 3 月 15 日起 100 天,2029 年 3 月 15 日起 47 天。Let’s Encrypt 免费证书仍为 90 天。这意味着「一年一换、人工操作」的流程必须改成自动化续期,否则很容易出现证书过期导致的线上故障。
二、准备 PEM 文件:fullchain、私钥与证书链拆分
先把目录与权限做对,再谈配置。私钥目录必须 700,私钥文件 600,否则 Nginx 以 nginx 用户启动时会报 Permission denied。
install -d -m 700 /etc/nginx/ssl
cd /etc/nginx/ssl
# 从 CFCA 控制台下载的 Nginx/PEM 包中取出两个文件
# example.com.fullchain.pem example.com.key
chmod 600 example.com.key
chmod 644 example.com.fullchain.pem
接着做三项体检,任何一项不通过都不要往下走:
# 1. 证书主体、签发者、有效期
openssl x509 -in example.com.fullchain.pem -noout -subject -issuer -dates
# 2. 链内证书数量,正常为 2(叶子+中间)或 3(叶子+两张中间)
grep -c 'BEGIN CERTIFICATE' example.com.fullchain.pem
# 3. SAN 是否覆盖所有域名
openssl x509 -in example.com.fullchain.pem -noout -text | grep -A1 'Subject Alternative Name'
如果拿到的只有一个叶子证书,需要手工拼链。把 CFCA 提供的中间证书(通常名为 cfca_chain.pem 或 intermediate.crt)追加到叶子证书后面,顺序是「叶子在前、中间在后、根证书不要放」:
cat example.com.crt cfca_intermediate.crt > example.com.fullchain.pem
# 单独保留一份中间+根,供 OCSP Stapling 使用
cat cfca_intermediate.crt cfca_root.crt > cfca_chain.pem
私钥常见坑:从 Windows 导出的 key 可能带密码,首行为 -----BEGIN ENCRYPTED PRIVATE KEY-----,Nginx 启动时会交互式索要密码而卡死。解密命令为 openssl pkey -in enc.key -out example.com.key。另外确认私钥类型:RSA 证书配 RSA 私钥,ECC 证书配 EC 私钥,两者不能互换,否则 nginx -t 直接报 key values mismatch。
三、Nginx 标准配置示例:TLS 1.2/1.3 + OCSP Stapling + 强制跳转
下面是一份可直接落地的 /etc/nginx/conf.d/example.com.conf,覆盖 80 跳转、TLS 1.2/1.3、会话复用、OCSP Stapling 与 HSTS。
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-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/cfca_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;
add_header X-Content-Type-Options nosniff always;
root /var/www/example.com;
index index.html;
location / { try_files $uri $uri/ =404; }
}
几个参数必须解释清楚:ssl_trusted_certificate 只用于校验 OCSP 响应,指向中间证书(可含根),不要放叶子证书;若 CFCA 中间证书未提供 OCSP 地址,日志会出现 [warn] ssl_stapling ignored, issuer certificate not found,此时直接关闭 stapling 更干净。ssl_session_tickets off 是出于前向安全考虑,金融场景建议保持关闭。
如果 CFCA 同时下发了 RSA 与 ECC 两张证书,可在同一个 server 块里配置双证书(Nginx 1.11.0+ 支持),Nginx 会按客户端能力自动选择:
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.ecc.fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com.ecc.key;
注意两张证书的 SAN 必须完全一致,否则部分客户端会拿到不匹配的证书。上线前用 openssl s_client -cipher ECDSA 与 -cipher RSA 分别验证两条链路都能握手成功。
四、国密 SM2 双算法配置:必须用铜锁或国密版 Nginx
标准 Nginx 无法协商 SM2,需要先编译支持 NTLS 的版本。以铜锁(Tongsuo)为例:
cd /usr/local/src/nginx-1.25.5
./configure --prefix=/usr/local/nginx
--with-http_ssl_module --with-http_v2_module
--with-openssl=/usr/local/tongsuo
--with-openssl-opt='enable-ntls'
--with-cc-opt='-I/usr/local/tongsuo/include'
--with-ld-opt='-L/usr/local/tongsuo/lib -Wl,-rpath,/usr/local/tongsuo/lib'
make -j$(nproc) && make install
/usr/local/nginx/sbin/nginx -V # 确认输出含 enable-ntls
国密站点配置(不同发行版补丁的指令名略有差异,以所用版本文档为准,铜锁 Nginx 通常为 ssl_ntls):
server {
listen 443 ssl;
server_name gm.example.com;
ssl_ntls on;
ssl_certificate /etc/nginx/ssl/example.com.sm2.fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com.sm2.key;
ssl_certificate /etc/nginx/ssl/example.com.rsa.fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com.rsa.key;
ssl_protocols GMTLSv1.1 TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-SM2-SM4-GCM-SM3:ECDHE-SM2-SM4-CBC-SM3:ECDHE-RSA-AES128-GCM-SHA256;
ssl_prefer_server_ciphers on;
}
要点:国密证书的签名算法是 SM2-with-SM3,签发链由国密 CA 构成,不能与国际链混拼;GMTLSv1.1 是国密协议版本标识,只有国密浏览器(360 国密版、奇安信可信浏览器等)才会走这条路径,普通 Chrome 会自动回落到 RSA 链路。验证时不能用系统自带的 openssl,必须用铜锁自带的客户端:
/usr/local/tongsuo/bin/openssl s_client -connect gm.example.com:443
-ntls -cipher ECDHE-SM2-SM4-GCM-SM3 -servername gm.example.com
# 输出中应出现 Protocol: GMTLSv1.1 与 SM2 证书链
如果没有国密改造要求,不要为了「看起来更安全」盲目上国密双栈:编译维护成本高,且部分老旧负载均衡、WAF 无法识别 GMTLS 流量。金融、政务项目一般要求「国际 + 国密双栈」,此时建议在负载均衡层做协议分流,Nginx 只处理其中一条链路,便于灰度与回滚。
五、nginx -t 校验与平滑 reload 的正确姿势
改完配置先校验语法与证书可用性,再重载。顺序错了会直接把线上打挂。
# 1. 语法 + 证书文件可读性校验
nginx -t
# 2. 打印全部生效配置,确认没有旧路径残留
nginx -T 2>/dev/null | grep -nE 'ssl_certificate|ssl_protocols|server_name'
# 3. 平滑重载
systemctl reload nginx # 等价于 nginx -s reload
# 4. 确认新 worker 已起来、老 worker 已退出
ps -o pid,lstart,cmd -C nginx
nginx -t 会真实加载证书与私钥,因此它同时验证了「文件存在、格式为 PEM、私钥可读、公私钥匹配」四件事。如果只看到 syntax is ok 而没有 test is successful,说明证书层有问题,不要 reload。
几个容易踩的坑:reload 只对新连接生效,已有长连接会继续用旧证书,直到 worker 优雅退出(worker_shutdown_timeout 默认 4 小时,金融场景可设 worker_shutdown_timeout 30s;)。容器环境要 docker exec -it nginx nginx -s reload,而不是重启宿主机上的 systemd。Kubernetes 中通过 Secret 挂载的证书,若使用 subPath 方式不会热更新,必须 kubectl rollout restart deploy/xxx 或改用 volume 整体挂载。多实例与 CDN:只 reload 了一台机器、或证书没同步到 CDN 边缘节点,会出现「部分用户还是旧证书」的现象,务必用批量下发工具统一推。
另外,如果 nginx -T 里出现两个 server 块都写了 server_name example.com,Nginx 只会用第一个,后改的配置看似生效实则被覆盖,这是「改了没反应」的高频原因。
六、三种部署方案与文件类型对比表
先看部署方案怎么选,再看每个文件到底装什么。
| 方案 | 证书文件 | 关键配置 | 客户端兼容性 | 适用场景 |
|---|---|---|---|---|
| 单 RSA | 1 套 fullchain + key | 一组 ssl_certificate | 全兼容,老 Android、旧 JDK 均可握手 | 通用官网、对接老旧系统 |
| RSA + ECC 双证书 | 2 套 fullchain + key | 同一 server 内两组 ssl_certificate | 新客户端走 ECDSA 更快,老客户端回落 RSA | 高并发、移动端为主 |
| 国密双栈(SM2 + RSA) | 国密链 + 国际链各一套 | 铜锁 Nginx + ssl_ntls + GMTLSv1.1 | 国密浏览器走 SM2,普通浏览器走 RSA | 金融、政务国密改造 |
| 文件 | 内容 | 在配置中的位置 | 校验命令 |
|---|---|---|---|
| fullchain.pem | 叶子证书 + 中间证书 | ssl_certificate | grep -c ‘BEGIN CERTIFICATE’ 应为 2 或 3 |
| leaf.crt | 仅站点证书,禁止单独使用 | 不直接配置 | openssl x509 -noout -issuer |
| chain.pem | 中间证书(+根) | ssl_trusted_certificate | openssl verify -CAfile chain.pem leaf.crt |
| example.com.key | 未加密私钥 | ssl_certificate_key | openssl pkey -in key -noout -check |
选型建议:纯对外官网用单 RSA 最省事;有移动端性能诉求用 RSA+ECC 双证书,握手可省一次 RTT 并降低 CPU;涉及国密合规才上双栈,且必须准备独立的国密测试环境。需要强调的是,算法选择不影响证书链完整性要求——无论 RSA 还是 SM2,ssl_certificate 指向的都必须是包含中间证书的 fullchain。
七、常见错误与真实报错排查
报错 1:私钥不匹配。nginx: [emerg] SSL_CTX_use_PrivateKey_file(/etc/nginx/ssl/example.com.key) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。RSA 用模数比对,ECC 用公钥比对:
# RSA
openssl x509 -noout -modulus -in example.com.fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# ECC
openssl x509 -noout -pubkey -in example.com.fullchain.pem | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5
报错 2:证书链不完整。curl: (60) SSL certificate problem: unable to get local issuer certificate,或 openssl s_client 输出 Verify return code: 21 (unable to verify the first certificate)。说明 ssl_certificate 指向的是叶子证书而非 fullchain,把中间证书拼回去即可。Java 侧对应报错是 sun.security.validator.ValidatorException: PKIX path building failed,小程序侧是 request:fail ssl hand shake error,根因相同。
报错 3:文件格式错误。nginx: [emerg] PEM_read_bio_X509_AUX(...) failed (SSL: error:0909006C:PEM routines:get_name:no start line:Expecting: TRUSTED CERTIFICATE)。多半是下载了 DER/CRT 二进制格式,或文件里混入了 BOM、Windows 换行。转换命令:openssl x509 -in cert.crt -inform DER -out cert.pem -outform PEM,再用 sed -i 's/r$//' cert.pem 去掉回车。
报错 4:OCSP Stapling 告警。nginx: [warn] ssl_stapling ignored, issuer certificate not found for certificate。原因是 ssl_trusted_certificate 缺失或填了叶子证书,补齐中间证书即可;若 CA 不提供 OCSP,直接删除 stapling 三行配置。
报错 5:国密握手失败。sslv3 alert handshake failure 且日志显示无共享套件,说明客户端不支持 GMTLS,或 ssl_ciphers 里没写 SM2 套件,也可能用了未开启 NTLS 的标准 Nginx。用 nginx -V 确认编译参数含 enable-ntls。
报错 6:续期后不生效。证书文件已替换但浏览器仍显示旧证书,依次检查:配置路径是否指向新文件(nginx -T)、是否执行 reload、是否有多个实例/CDN 未同步、是否被 server_name 相同的旧 server 块覆盖。
八、效果验证:openssl、curl 与国密检测
部署完成后必须做四层验证,缺一层都可能在上线后暴露问题。
# 1. 证书主体、签发者、有效期、SAN
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 2. 协议版本、套件、链验证结果(Verify return code 必须为 0 (ok))
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| grep -E 'Protocol|Cipher|Verify return code'
# 3. 链内证书数量,应为 2 或 3
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| grep -c 'BEGIN CERTIFICATE'
# 4. 用系统信任库模拟真实客户端(Java/curl/小程序同一套逻辑)
curl -vI https://example.com --tlsv1.2 --max-time 10 2>&1 | grep -E 'SSL certificate verify|subject:|issuer:'
再补三项针对性检查:强制协议版本,用 openssl s_client -tls1_2 与 -tls1_3 分别握手,确认旧协议(TLS 1.0/1.1)已被拒绝;双证书验证,用 -cipher ECDHE-ECDSA-AES128-GCM-SHA256 与 -cipher ECDHE-RSA-AES128-GCM-SHA256 各跑一次,两条链都应返回 0 (ok);国密验证,用铜锁客户端执行 /usr/local/tongsuo/bin/openssl s_client -connect gm.example.com:443 -ntls -cipher ECDHE-SM2-SM4-GCM-SM3,输出应含 Protocol: GMTLSv1.1。
最后用 SSL Labs 或 testssl.sh 做整体评级:./testssl.sh --fast https://example.com,关注证书链、协议支持、HSTS、前向保密四项。A/A+ 的前提是仅启用 TLS 1.2/1.3、无 RC4/3DES、启用 HSTS 且证书链完整。国密部分则用国密浏览器实际访问,或用密评工具核对 SM2 证书链与套件是否合规。验证通过后建议把上述命令固化成巡检脚本,配合证书到期监控(提前 30 天告警),在 398 天乃至后续 200 天、100 天有效期规则下才能真正避免过期事故。
常见问题
不能。官方 Nginx 链接的 OpenSSL 不支持 GMTLS 与 SM2 套件,必须使用铜锁(Tongsuo)或国密版 Tengine 编译,并在 configure 时加 enable-ntls,配置中启用 ssl_ntls 与 GMTLSv1.1 才能协商国密链路。
不行。只配叶子证书会缺失中间证书,浏览器因具备 AIA 补链能力可能显示正常,但 curl、Java、微信小程序会报 unable to get local issuer certificate 或 PKIX path building failed,必须指向包含中间证书的 fullchain.pem。
RSA 证书执行 openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 后各自 md5,两值相同即匹配;ECC 证书改用 openssl x509 -noout -pubkey 与 openssl pkey -pubout 比对 md5。也可直接跑 nginx -t,不匹配会报 key values mismatch。
受 CA/Browser Forum 基线约束,公有可信 CA 签发的 TLS 证书单张最长 398 天,并将在 2026 年 3 月 15 日缩至 200 天、2027 年缩至 100 天、2029 年缩至 47 天。建议提前 30 天完成续期并自动化,不要按自然年规划。
常见原因有四:配置路径仍指向旧文件;reload 只对新连接生效,长连接仍用旧证书;多实例或 CDN 节点未同步;存在 server_name 相同的旧 server 块覆盖了新配置。用 nginx -T 打印生效配置逐项核对。