跳到主要内容
Nginx

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 比对。两次结果一致即匹配。

内容审核

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