CFCA SSL 证书 Nginx 部署实战:fullchain 拼接、国密双算法与 398 天续期
一、浏览器正常但程序报错的根因:证书链不完整与有效期新规
把 CFCA 签发的证书装到 Nginx 上,最典型的现象是:Chrome/Edge 打开站点锁标正常,但 curl、Java 后端、微信小程序、Android 7 以下设备、部分 IoT 终端访问同一域名时 TLS 握手失败。根因通常不是私钥写错,而是 ssl_certificate 只指向了叶子证书(server certificate),没有把中间证书(intermediate CA)拼进去。
浏览器具备 AIA(Authority Information Access)自动补链能力,发现服务端没发中间证书会自己去下载;而 curl、Java 默认信任管理器、小程序运行时基本不做这件事,于是直接判定链路不可信,抛出真实报错:
# curl
curl: (60) SSL certificate problem: unable to get local issuer certificate
# OpenSSL
verify error:num=20:unable to get local issuer certificate
verify error:num=21:unable to verify the first certificate
# Java
javax.net.ssl.SSLHandshakeException: PKIX path building failed:
sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
第二个坑是有效期规则。自 2020-09-01 起,CA/Browser Forum 规定面向公开信任体系的 SSL/TLS 证书最长有效期不得超过 398 天(约 13 个月),Let’s Encrypt 固定为 90 天。CFCA 的 RSA/ECC 公网信任证书同样受此约束,任何“买两年省事”的部署思路都不成立,必须把续期做成常规运维动作。第三是算法选型:CFCA 同时支持国密 SM2 与国际 RSA/ECC,但 SM2 证书只在支持国密 TLS 的客户端(国密浏览器、国密网关、部分政务终端)中被识别,普通 Chrome 访问 SM2 站点会直接报 ERR_CERT_INVALID,因此金融、政务项目通常做 RSA + SM2 双证书分流,而不是二选一。
二、准备证书文件:PEM 格式、fullchain 拼接与私钥匹配
在 CFCA 控制台下载时选择「Nginx / PEM」格式,压缩包通常包含以下文件,注意哪个能直接配进 Nginx:
| 文件名 | 内容 | 是否直接用于 Nginx |
|---|---|---|
| example.com.crt | 站点叶子证书 | 否,单独使用会缺链 |
| intermediate.crt / ca.crt | 中间证书 | 否,需拼接 |
| example.com_fullchain.pem | 叶子 + 中间证书 | 是,配 ssl_certificate |
| example.com.key | 私钥(PEM) | 是,配 ssl_certificate_key |
Nginx 只认 PEM(Base64 文本),不认 DER/PFX。核心动作是把「叶子证书 + 中间证书」按顺序拼接,顺序不能反——先站点证书,后中间证书:
cd /tmp/cfca
cat example.com.crt intermediate.crt > example.com_fullchain.pem
grep -c 'BEGIN CERTIFICATE' example.com_fullchain.pem # 期望 2,含交叉证书时可能为 3
拼完必须做三项校验,任何一项不过都不要上传服务器:
# 1) 链路校验,必须输出 OK
openssl verify -untrusted intermediate.crt example.com_fullchain.pem
# 2) 域名与有效期校验,确认 SAN 覆盖全部业务域名
openssl x509 -in example.com_fullchain.pem -noout -subject -issuer -dates
openssl x509 -in example.com_fullchain.pem -noout -ext subjectAltName
# 3) 证书与私钥匹配(RSA 比对模数)
openssl x509 -in example.com_fullchain.pem -noout -modulus | openssl md5
openssl rsa -in example.com.key -noout -modulus | openssl md5
# ECC/SM2 无 modulus,改用公钥比对
openssl x509 -in example.com_fullchain.pem -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5
两次 md5 必须完全一致,否则说明证书和私钥不是同一次申请产出的。另外私钥权限要收紧:目录 700、私钥 600、属主 root,避免被非 Nginx 进程读取;若服务器启用了 SELinux,还要给证书目录打对标签,否则 Nginx 启动时只报一句 13: Permission denied,很难定位。
三、Nginx 完整配置示例:TLS 1.2/1.3 + OCSP Stapling + HSTS
以下配置可直接落地,含 80 跳转、TLS 版本收敛、会话复用、OCSP 装订与安全响应头:
# /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_trusted_certificate /etc/nginx/ssl/example.com_chain.pem;
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_conf_command Ciphersuites TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
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;
add_header X-Frame-Options SAMEORIGIN always;
location / {
root /var/www/html;
index index.html;
}
}
几个参数值得说明:ssl_trusted_certificate 指向中间证书(不含叶子),用于 OCSP 装订与链校验,缺失会触发警告;ssl_session_tickets off 牺牲少量性能换取前向安全;http2 on; 在 1.25.1 之前不识别,旧版必须写成 listen 443 ssl http2;,混写会报 unknown directive。
国密场景需额外注意:标准 Nginx 不支持 SM2 套件,需使用国密分支(如铜锁 Tongsuo 编译的 Nginx)。同一端口同时下发 SM2 与 RSA 证书的写法如下:
server {
listen 443 ssl;
server_name gm.example.com;
ssl_certificate /etc/nginx/ssl/sm2/sm2_fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/sm2/sm2.key;
ssl_certificate /etc/nginx/ssl/rsa/rsa_fullchain.pem; # 双证书回退
ssl_certificate_key /etc/nginx/ssl/rsa/rsa.key;
}
若没有国密分支,退而求其次的做法是 SM2 站点走独立端口或独立国密网关,普通公网 443 继续用 RSA/ECC 证书,避免普通用户访问时报证书不受信任。
四、可执行的分步实操:上传、权限、校验、平滑重载
从本地到生效的完整命令序列,可直接复制执行:
# 1) 建目录并收紧权限
sudo mkdir -p /etc/nginx/ssl
sudo chmod 700 /etc/nginx/ssl
# 2) 上传文件(在本地终端执行)
scp example.com_fullchain.pem example.com_chain.pem example.com.key root@1.2.3.4:/etc/nginx/ssl/
# 3) 属主与权限
sudo chown root:root /etc/nginx/ssl/*
sudo chmod 600 /etc/nginx/ssl/example.com.key
sudo chmod 644 /etc/nginx/ssl/example.com_fullchain.pem
# 4) SELinux(未启用可跳过)
sudo semanage fcontext -a -t httpd_sys_content_t '/etc/nginx/ssl(/.*)?'
sudo restorecon -Rv /etc/nginx/ssl
# 5) 语法校验
sudo nginx -t
# nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
# nginx: configuration file /etc/nginx/nginx.conf test is successful
# 6) 平滑重载,不中断现有连接
sudo systemctl reload nginx # 等价于 nginx -s reload
# 7) 确认端口监听与进程状态
sudo ss -lntp | grep ':443'
systemctl status nginx --no-pager | head -5
三个容易忽略的细节:一是 reload 不中断连接,restart 会,生产环境优先 reload;二是如果前面有 SLB、WAF 或 CDN,用户实际握手的是负载均衡上的证书,Nginx 只是回源,必须在云控制台同步上传新证书,否则改了 Nginx 前端依旧显示旧证书;三是 nginx -t 通过不等于 reload 成功,务必看 systemctl status 与 /var/log/nginx/error.log。另外要确认安全组与防火墙放行 443:firewall-cmd --add-service=https --permanent && firewall-cmd --reload。
五、RSA / ECC / SM2 与部署方式对比
选算法前先明确客户端分布。下表是 CFCA 三类证书在 Nginx 场景下的实际差异:
| 算法 | 典型密钥长度 | 证书体积 | 客户端兼容性 | 适用场景 |
|---|---|---|---|---|
| RSA 2048 | 2048 bit | 约 1.5 KB | 全平台通用 | 公网站点、老客户端兜底 |
| ECC P-256 | 256 bit | 约 0.8 KB | 现代浏览器与 JDK 8u261+ 良好 | 移动端、高并发、握手性能敏感 |
| SM2 | 256 bit | 约 1 KB | 仅国密浏览器/国密网关 | 金融、政务国密改造、内网合规 |
部署方式同样需要权衡:
| 部署方式 | 证书安装位置 | 优点 | 风险点 |
|---|---|---|---|
| Nginx 直接部署 | 源站 /etc/nginx/ssl | 可控、可国密、可自定义套件 | 每台机器都要换证,易漏 |
| SLB 卸载 | 云负载均衡证书管理 | 后端解密压力小、统一换证 | 回源段需另配证书,易被忽略 |
| CDN 边缘 | CDN 证书中心 | 边缘握手快、支持批量域名 | 回源证书过期仍会导致 502/526 |
实践建议:公网主域名用 ECC 证书并保留 RSA 证书做 SNI 兜底;国密改造项目用 SM2 + RSA 双证书;证书到期前 30 天启动续期,别指望一张证书用两年——398 天是硬上限,Let’s Encrypt 的 90 天更短。
六、常见错误与真实报错排查
| 报错原文 | 环节 | 原因与处理 |
|---|---|---|
| nginx: [emerg] PEM_read_bio_X509_AUX(“/etc/nginx/ssl/x.pem”) failed (SSL: error:0909006C:PEM routines:get_name:no start line) | nginx -t | 文件不是 PEM,多为 DER/PFX。执行 openssl x509 -inform DER -in x.cer -out x.pem 转换 |
| nginx: [emerg] SSL_CTX_use_PrivateKey_file(“…key”) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) | nginx -t | 证书与私钥不匹配,按第二节命令比对公钥 md5 |
| nginx: [warn] “ssl_stapling” ignored, issuer certificate not found for certificate | 启动日志 | 缺 ssl_trusted_certificate 或链不完整,补中间证书 |
| curl: (60) SSL certificate problem: unable to get local issuer certificate | 客户端 | 服务端只发了叶子证书,改配 fullchain.pem |
| curl: (60) SSL certificate problem: certificate has expired | 客户端 | 证书过期或服务器时间偏差,检查 date 与 openssl x509 -dates |
| PKIX path building failed: unable to find valid certification path | Java | 同上缺链,或 JDK 信任库不含该根证书 |
| NET::ERR_CERT_COMMON_NAME_INVALID | 浏览器 | SAN 不含当前域名,重新签发含全部域名的证书 |
| nginx: [emerg] bind() to 0.0.0.0:443 failed (98: Address already in use) | 启动 | 端口被占用,ss -lntp | grep 443 定位进程 |
还有一类“无报错但不生效”:reload 后浏览器仍显示旧证书。排查顺序是——先确认配置里没有另一个 listen 443 default_server 抢走请求(用 nginx -T | grep -n ssl_certificate 查全部命中),再确认前端 SLB/CDN 是否已同步换证,最后确认本地 DNS 是否解析到了旧 IP。
七、效果验证:openssl、curl、Java 与 SSL Labs
部署完不要只看浏览器,用命令做客观验证:
# 1) 链路验证,必须看到 Verify return code: 0 (ok)
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep -E 'Verify return code|verify error'
# 2) 服务端实际下发的证书数量,应为 2 张以上
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
# 3) 有效期与颁发者
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates
# 4) 确认 TLS 1.0/1.1 已禁用(应握手失败)
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
# 5) 走真实 HTTP 请求验证
curl -sSI https://example.com --resolve example.com:443:1.2.3.4 | head -1
# 6) Java 侧验证
keytool -printcert -sslserver example.com:443
第 1 条输出 Verify return code: 0 (ok) 才算链路完整;第 2 条若只输出 1,说明还是只发了叶子证书。第 4 条若返回 no protocols available 或握手失败,说明 TLS 1.1 已正确关闭。
再补两项工程化验证:一是用 SSL Labs 跑一次完整评级,目标 A 及以上,出现 Certificate - Chain issues: Incomplete 直接判定链不完整;二是做到期监控,把下面命令挂进 Zabbix/Prometheus 探针:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -checkend 2592000 -noout && echo OK || echo EXPIRING_IN_30_DAYS
小程序场景还要在微信开发者工具「详情 → 域名信息」里复查,或用第三方证书检测工具模拟 Android 4.x 握手,避免只在 Chrome 上验证就上线。
八、续期与自动化:398 天与 90 天的运维方案
398 天是公开信任证书的硬上限,Let’s Encrypt 只有 90 天,靠人肉记日历必然出事。CFCA 商业证书续期后需重新签发、重新下载、替换文件并 reload,建议封装成脚本,失败自动回滚:
#!/usr/bin/env bash
set -euo pipefail
DIR=/etc/nginx/ssl
NEW=/tmp/cfca_new
# 1) 校验新证书链与私钥
openssl verify -untrusted $NEW/chain.pem $NEW/fullchain.pem
openssl x509 -in $NEW/fullchain.pem -noout -pubkey | openssl md5
openssl pkey -in $NEW/example.com.key -pubout | openssl md5
# 2) 备份旧证书
cp $DIR/example.com_fullchain.pem $DIR/example.com_fullchain.pem.bak.$(date +%F)
# 3) 替换并校验配置
install -m 644 $NEW/fullchain.pem $DIR/example.com_fullchain.pem
install -m 600 $NEW/example.com.key $DIR/example.com.key
if nginx -t; then
systemctl reload nginx
else
mv $DIR/example.com_fullchain.pem.bak.$(date +%F) $DIR/example.com_fullchain.pem
echo 'config test failed, rolled back' >&2; exit 1
fi
如果证书走 ACME 渠道签发,用 certbot 托管更省事,续期前先演练:
certbot renew --dry-run
systemctl list-timers | grep certbot # 确认 systemd timer 已启用
certbot certificates # 查看全部证书剩余天数
多机集群要注意:脚本必须分发到每台 Nginx 节点,或把证书放在共享存储/配置中心统一推送;使用 SLB、CDN 的,还要在云控制台调用证书更新接口,否则源站换了、边缘没换,用户看到的仍是旧证书。建议在到期前 30 天触发告警、前 15 天完成更换,给回滚留出窗口。
常见问题
面向公开信任体系的证书最长有效期为 398 天(约 13 个月),这是 CA/Browser Forum 的强制要求,CFCA 的 RSA/ECC 公网证书同样适用;Let’s Encrypt 固定为 90 天。国密 SM2 证书若只在自有信任体系内使用,期限可不同,但仍建议按 398 天规划续期。
.crt 通常只有站点叶子证书,单独配置会导致证书链不完整;fullchain.pem 是按“叶子证书在前、中间证书在后”拼接的完整链,Nginx 的 ssl_certificate 必须指向它,否则 curl、Java、小程序会报 unable to get local issuer certificate。
不需要。根证书应存在于客户端的信任库中,服务端下发根证书会增大握手包体积,部分客户端还会判定为冗余或异常链。正确做法是只下发叶子证书加中间证书,通常 2 张,含交叉证书时 3 张。
按顺序排查:用 nginx -T | grep ssl_certificate 确认没有其他 server 块或 default_server 抢占;确认 reload 真的成功(systemctl status nginx);确认前端 SLB、WAF、CDN 已同步换证;确认本地 DNS 没有解析到旧 IP 或旧节点。
不能。标准 Nginx 不支持 SM2 证书与国密套件,需要国密分支(如铜锁 Tongsuo 编译的 Nginx)或独立国密网关。常见做法是 SM2 与 RSA 双证书部署,普通公网 443 继续用 RSA/ECC 证书,避免 Chrome 访问时报证书不受信任。
RSA 证书用 openssl x509 -noout -modulus -in cert.pem | openssl md5 与 openssl rsa -noout -modulus -in key.pem | openssl md5 比对;ECC/SM2 无 modulus,改用 openssl x509 -noout -pubkey 与 openssl pkey -pubout 分别取 md5 比对。两次结果一致即匹配。