跳到主要内容
宝塔面板

CFCA SSL 证书宝塔面板安装部署实战:从证书链核对到 HTTPS 验证

问题背景与根因:为什么 CFCA 证书在宝塔上会部署失败

CFCA(中国金融认证中心)证书常见于银行、政务、国企及国密改造项目,支持国际 RSA/ECC 与国密 SM2 双算法。把 CFCA 证书部署到宝塔面板,本质上不是点一下保存那么简单,而是要让 Nginx/Apache 同时满足三件事:证书链完整、私钥与证书匹配、客户端访问的域名和协议一致。实际故障中,约八成来自 fullchain 只放了叶子证书,缺少 CFCA 中间 CA,浏览器能靠缓存或 AIA 补链,但 curl、Java、小程序、Android 旧版本会直接报 unable to get local issuer certificate 或 PKIX path building failed。第二类根因是私钥错配:复制时混入旧证书、换签后未替换 privkey,Nginx 会报 key values mismatch。第三类是 CDN 回源协议仍为 HTTP,而源站又开启强制 HTTPS,形成 301 循环。第四类是有效期与续期问题:公开可信 TLS 证书单张最长有效期 398 天,Let’s Encrypt 为 90 天,过期后浏览器报 ERR_CERT_DATE_INVALID。宝塔证书默认存放在 /www/server/panel/vhost/cert/域名/ 下,fullchain.pem 与 privkey.pem 必须成对更新,并在替换后执行 nginx -t 与 reload。国密 SM2 证书不能直接塞进普通 Nginx,需要国密 Tengine、网关或 CFCA 中间件支持,否则会报 no shared cipher 或握手失败。

准备证书文件:fullchain、私钥与算法核对

CFCA 交付文件通常包含证书 leaf.crt、中间 CA intermediate.crt、根 CA root.crt 与私钥 private.key。宝塔手动上传需要两个文本:fullchain.pem(叶子证书加中间 CA,按顺序拼接)和 private.key(私钥)。不要只上传 leaf.crt,也不要把根证书重复拼到链中间。建议在服务器先建目录并核对:

mkdir -p /root/cfca && cd /root/cfca
openssl x509 -in fullchain.pem -noout -subject -issuer -dates -serial
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
openssl x509 -in fullchain.pem -noout -pubkey | openssl pkey -pubin -outform der | openssl md5
openssl pkey -in private.key -pubout -outform der | openssl md5
openssl verify -CAfile fullchain.pem fullchain.pem

两条 pubkey md5 必须一致;不一致就是证书与私钥不匹配。openssl crl2pkcs7 应看到至少两张证书:第一张是域名证书,后面是 CFCA 中间 CA。若使用 ECC 证书,不要用 rsa -modulus,改用上面的公钥哈希。若交付的是 SM2 国密证书,标准 OpenSSL 可能无法完整识别,需要用国密版 GmSSL 或 CFCA 工具查看:openssl x509 -in sm2.pem -noout -text | grep -E ‘Public Key Algorithm|Signature Algorithm’,输出应含 SM2。有效期核对时注意:公开可信 TLS 证书单张最长 398 天,Let’s Encrypt 为 90 天;CFCA 具体到期时间以 notAfter 为准。最后把 fullchain.pem 和 private.key 权限设为 600,属主 root,避免宝塔读取失败:chmod 600 fullchain.pem private.key。

宝塔面板部署步骤:自动申请与手动上传 CFCA

宝塔提供两条路径。方式一适合测试站或非金融业务:登录宝塔 → 网站 → 站点设置 → SSL → Let’s Encrypt → 勾选域名 → 文件验证或 DNS 验证 → 申请。Let’s Encrypt 证书有效期 90 天,务必开启自动续签,并确认 80/443 未被 CDN、防火墙或 301 规则阻断。方式二适合 CFCA 付费证书:SSL → 其他证书 → 左侧粘贴 private.key 全文,右侧粘贴 fullchain.pem 全文 → 保存 → 开启强制 HTTPS。粘贴时不要带 BOM、不要混入命令行提示符,文件头应为 —–BEGIN CERTIFICATE—– 和 —–BEGIN PRIVATE KEY—–(RSA 也可能是 BEGIN RSA PRIVATE KEY)。保存后宝塔会写入 /www/server/panel/vhost/cert/example.com/fullchain.pem 与 privkey.pem,并在站点 Nginx 配置中引用。随后执行:

nginx -t
systemctl reload nginx
ls -l /www/server/panel/vhost/cert/example.com/
openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -dates -subject

如果站点开了 CDN,必须把 CDN 回源协议改为 HTTPS、回源端口 443,否则源站强制 HTTPS 会把 CDN 的 HTTP 回源再次 301,浏览器出现 ERR_TOO_MANY_REDIRECTS。证书替换后不要只点保存,必须 reload;宝塔面板显示的有效期来自证书文件,不 reload 时旧进程仍可能使用旧证书。CFCA 证书若为 398 天有效期,建议在到期前 30 天完成续签并重复上述替换流程。

Nginx 配置示例:TLS 1.2/1.3、OCSP 与强制跳转

宝塔站点配置一般位于 /www/server/panel/vhost/nginx/example.com.conf。可在 SSL 配置段核对或改成下面示例;修改前先备份,修改后必须 nginx -t。注意 listen 443 ssl http2; 在 Nginx 1.25.1 后建议改为 listen 443 ssl; 加 http2 on;,老版本保持原写法即可。

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl http2;
    server_name example.com www.example.com;
    ssl_certificate /www/server/panel/vhost/cert/example.com/fullchain.pem;
    ssl_certificate_key /www/server/panel/vhost/cert/example.com/privkey.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';
    ssl_prefer_server_ciphers off;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;
    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /www/server/panel/vhost/cert/example.com/fullchain.pem;
    add_header Strict-Transport-Security 'max-age=31536000' always;
    root /www/wwwroot/example.com;
    index index.html index.php;
    location / { try_files $uri $uri/ /index.php?$query_string; }
}

关键点:ssl_certificate 必须指向 fullchain,不是 leaf.crt;ssl_certificate_key 指向私钥;ssl_trusted_certificate 用于 OCSP stapling,可指向 fullchain。若使用 CDN,源站 80 跳转规则可能被 CDN 回源触发,建议只保留 443 源站,或在 CDN 侧配置回源 HTTPS。HSTS 首次上线建议先用 300 秒测试,确认全站 HTTPS 后再改 31536000。国密 SM2 双证书不能套用以上标准 Nginx 配置,需要 ssl_certificate 国密证书与 ssl_certificate_key 国密私钥配合国密引擎,或交由国密网关卸载。

方案对比:Let’s Encrypt、CFCA RSA 与 CFCA SM2

选型时不要只看价格,要把有效期、验证类型、算法兼容和合规要求放在一起比较。Let’s Encrypt 是 DV 证书,90 天自动续期,适合测试、博客和中小站点;CFCA RSA/ECC 证书面向金融、政务、国企,可按 OV/EV 产品提供更严格的身份审核;CFCA SM2 国密证书用于国密改造、密评和专网场景,但普通浏览器和标准 Nginx 不能直接完成双证书握手。公开可信 TLS 证书受 CA/B Forum 约束,单张最长有效期 398 天,任何声称超过该期限的公开证书都应核对签发规则。

项目 Let’s Encrypt CFCA RSA/ECC CFCA SM2 国密
有效期 90 天,自动续期 公开可信 TLS 单张最长 398 天,以签发为准 以签发为准,通常配套国密改造
验证类型 DV OV/EV(按产品) 金融合规/国密场景
算法 RSA/ECDSA RSA/ECC SM2
浏览器兼容 主流浏览器 主流浏览器 需国密浏览器或国密网关
合规适用 通用 银行、政务、国企 国密改造、等保、密评
续期方式 宝塔自动续签 手动替换 fullchain/privkey 国密工具或网关更新
典型场景 测试、中小站点 对外金融业务 内网、国密专网

部署到宝塔时,Let’s Encrypt 可直接在面板申请;CFCA RSA/ECC 走其他证书粘贴;CFCA SM2 则要先确认 Nginx 是否支持国密双证书,否则应在前置国密网关卸载 TLS,再由网关以普通 HTTPS 回源。对比表中 398 天与 90 天是两个必须记住的硬指标:前者是公开可信证书的单张上限,后者是 Let’s Encrypt 的固定周期。

常见错误排查:真实报错与修复命令

先看三类高频报错。第一类,curl 报 curl: (60) SSL certificate problem: unable to get local issuer certificate,说明服务端链不完整。修复时把叶子证书和 CFCA 中间 CA 按顺序拼接:cat leaf.crt intermediate.crt > fullchain.pem,再执行 openssl verify -CAfile fullchain.pem fullchain.pem。第二类,Java 报 javax.net.ssl.SSLHandshakeException: PKIX path building failed,除了服务端补链,还要检查客户端 truststore 是否导入 CFCA 中间 CA:keytool -importcert -alias cfca -file intermediate.crt -keystore cacerts。第三类,Nginx 报 nginx: [emerg] SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch),这是证书与私钥不匹配,用公钥哈希核对:openssl x509 -in fullchain.pem -noout -pubkey | openssl pkey -pubin -outform der | openssl md5 与 openssl pkey -in private.key -pubout -outform der | openssl md5,两个值必须一致。

curl: (60) SSL certificate problem: unable to get local issuer certificate
javax.net.ssl.SSLHandshakeException: PKIX path building failed
nginx: [emerg] SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
浏览器:ERR_TOO_MANY_REDIRECTS / ERR_CERT_DATE_INVALID / SSL_ERROR_BAD_CERT_DOMAIN

ERR_TOO_MANY_REDIRECTS 多由 CDN 回源 HTTP 加源站强制 HTTPS 造成,处理方式是 CDN 回源协议改 HTTPS 443,或源站仅对 CDN 回源放行 HTTP。ERR_CERT_DATE_INVALID 用 openssl x509 -in fullchain.pem -noout -dates 查 notAfter,过期就续签并 reload。SSL_ERROR_BAD_CERT_DOMAIN 用 openssl x509 -in fullchain.pem -noout -text | grep DNS 检查 SAN 是否包含实际访问域名,缺 www 或子域要重新签发。改完配置统一执行 nginx -t && systemctl reload nginx,不要 restart 前跳过语法检查。

部署效果验证:命令行、浏览器与监控三路确认

部署完成后至少做三路验证。命令行先看证书链和有效期:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null,输出中应出现 ssl_certificate 对应的叶子证书和 CFCA 中间 CA;再用 openssl s_client -connect example.com:443 -servername example.com /dev/null | openssl x509 -noout -subject -issuer -dates 核对域名、签发者和到期时间。协议测试分别跑 TLS 1.2 与 TLS 1.3:echo | openssl s_client -connect example.com:443 -servername example.com -tls1_2 2>/dev/null | grep Protocol 和 -tls1_3 版本,确认没有被旧协议降级。curl 验证:curl -I https://example.com 应返回 HTTP/2 200 或 301,curl -v https://example.com 2>&1 | grep -E ‘SSL certificate verify|subject:|issuer:’ 应显示 verify ok。

nginx -t && systemctl reload nginx
ss -lntp | grep ':443'
openssl s_client -connect example.com:443 -servername example.com -showcerts &1 | grep -E 'SSL certificate verify|subject:|issuer:'

浏览器用无痕模式访问,确认地址栏小锁、证书颁发者为 CFCA、有效期正确;再点开证书路径,应看到叶子证书和中间 CA。宝塔监控页可观察 HTTPS 流量占比是否上升,站点 SSL 页显示的有效期应与 openssl 输出一致。对外站点建议再用 SSL Labs 或 CFCA 官方检测工具跑一次链完整性和协议评分。若 curl 正常但 Java 小程序仍报错,优先怀疑客户端 truststore 或服务端链顺序,而不是证书未签发。

常见问题

公开可信 TLS 证书单张最长 398 天,CFCA 实际到期时间以证书 notAfter 为准;Let’s Encrypt 固定 90 天。建议到期前 30 天续签并替换 fullchain 与私钥。


分别计算证书公钥和私钥公钥的 md5,两条命令输出必须一致。不一致说明私钥用错或复制混入旧文件,重新导出 fullchain 与 private.key 后再粘贴保存。


源站强制 HTTPS 而 CDN 回源仍走 HTTP 时会循环跳转。把 CDN 回源协议改为 HTTPS、回源端口 443,或让源站仅对 CDN 回源放行 HTTP。


检查 80/443 是否被 CDN、防火墙或 301 规则阻断,确认 DNS 解析和 CAA 记录正常,再查看宝塔计划任务与 acme 日志;可先手动续签一次并 reload Nginx。


不能直接配。标准 Nginx/OpenSSL 默认不支持 SM2 双证书握手,需要国密 Tengine、国密网关或 CFCA 中间件;普通浏览器也需支持国密算法才能访问。


多数不是没签发,而是服务端只发了叶子证书、缺少 CFCA 中间 CA。把 leaf.crt 与 intermediate.crt 按顺序拼成 fullchain.pem,再用 openssl verify 检查链是否完整。

内容审核

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