跳到主要内容
宝塔面板

CFCA SSL 证书宝塔面板部署全流程:证书链、强制 HTTPS 与排错实战

问题背景与根因:CFCA 证书装上了,为什么仍然握手失败

CFCA(中国金融认证中心)签发的 SSL 证书常见于银行、政务、国企和金融合规项目,支持国际 RSA/ECC 与国密 SM2 双算法。很多站点在宝塔面板粘贴证书后,浏览器能打开,但 curl、Java、微信小程序仍报证书错误,根因通常不是证书本身,而是部署链路不完整。第一,CFCA 交付包通常包含服务器证书、中间证书和私钥,宝塔右框必须粘贴 fullchain(服务器证书在前、中间证书在后),只贴叶子证书会导致客户端无法构建信任链。第二,宝塔标准版 Nginx 基于常规 OpenSSL,不能直接完成国密 SM2 握手;SM2 证书需要国密版 Nginx/Tengine 或前置国密网关,客户端也要支持国密。第三,公开信任 TLS 证书单张有效期最长 398 天(行业基线,2020 年 9 月起),Let’s Encrypt 为 90 天,CFCA 付费证书到期需重新签发,不能靠改系统时间绕过。第四,开启强制 HTTPS 后,如果 CDN 回源协议仍是 HTTP,CDN 回源会被源站 301 到 HTTPS,形成重定向循环。第五,Java 旧信任库、小程序 TLS 版本限制也会放大证书链问题。排查前先确认运行环境:执行 openssl version -a 和 /www/server/nginx/sbin/nginx -V,看是否带国密能力;再用 openssl s_client -connect example.com:443 -servername example.com 看 Verify return code 是否为 0。若返回 20 或 21,优先检查 fullchain 和中间证书,而不是反复重装面板。

部署前准备:从 CFCA 交付包中选出 fullchain 与私钥

CFCA 证书交付包一般有 server.crt(服务器证书)、chain.crt 或 ca.crt(中间证书)、privkey.key(私钥)。宝塔手动部署只需要两个文本:fullchain 和私钥。fullchain 的拼接顺序必须是服务器证书在前、中间证书在后,根证书一般不放;顺序反了同样会握手失败。可直接执行:cat server.crt chain.crt > fullchain.pem。然后核对主题、签发者、有效期和 SAN:openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName。有效期应不超过 398 天,SAN 必须包含实际访问域名。检查私钥是否可用:RSA 用 openssl rsa -in privkey.key -noout -check,ECC 用 openssl pkey -in privkey.key -noout -check。核对证书与私钥是否匹配:RSA 执行 openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in privkey.key | openssl md5,两个 MD5 必须一致;ECC 证书不能用 modulus,改用 openssl x509 -noout -pubkey -in fullchain.pem | openssl md5 与 openssl pkey -in privkey.key -pubout | openssl md5 比对。国密 SM2 证书需用支持国密的 OpenSSL 查看 Public Key Algorithm 是否为 sm2,并确认宝塔 Nginx 是否为国密版;标准版不要直接粘贴 SM2 证书,否则表现为 SSL_CTX_use_certificate 失败或握手无可用密码套件。私钥权限设为 600,属主与 Nginx 运行用户一致。

宝塔面板完整实操:手动粘贴与命令行落地

登录宝塔面板,进入“网站” → 目标站点“设置” → “SSL” → “其他证书”。左框粘贴私钥全文,右框粘贴 fullchain 全文,保存后开启“强制 HTTPS”。宝塔通常把文件写到 /www/server/panel/vhost/cert/example.com/fullchain.pem 和 privkey.pem。随后在 SSH 执行以下命令确认文件与权限:ls -l /www/server/panel/vhost/cert/example.com/;chmod 600 /www/server/panel/vhost/cert/example.com/privkey.pem;/www/server/nginx/sbin/nginx -t;/etc/init.d/nginx reload。若 nginx -t 报 SSL_CTX_use_PrivateKey_file ... key values mismatch,说明私钥与证书不匹配,按上一节 MD5 方法重配。检查站点配置是否指向新文件:grep -nE 'ssl_certificate|ssl_certificate_key|return 301|listen 443' /www/server/panel/vhost/nginx/example.com.conf。开了 CDN 的站点,必须在 CDN 控制台把回源协议改为 HTTPS,否则源站强制 HTTPS 会与 HTTP 回源形成 ERR_TOO_MANY_REDIRECTS。CFCA 付费证书不能像 Let’s Encrypt 那样自动续签,建议加到期监控:openssl x509 -checkend 2592000 -noout -in /www/server/panel/vhost/cert/example.com/fullchain.pem,返回非 0 表示 30 天内到期,应提前重新签发并替换 fullchain 与私钥。替换后先 nginx -t 再 reload,不要直接 restart 生产环境。

Nginx 配置示例:TLS 1.2/1.3、HSTS 与证书链路径

宝塔站点配置位于 /www/server/panel/vhost/nginx/example.com.conf,可参考以下片段,修改域名和证书路径后执行 /www/server/nginx/sbin/nginx -t 验证:

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 on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
    add_header Strict-Transport-Security max-age=31536000 always;
    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /www/server/panel/vhost/cert/example.com/chain.pem;
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

注意:Nginx 1.25.1 及以上版本推荐写 listen 443 ssl; 加 http2 on;,旧写法 listen 443 ssl http2; 仍可用但会有弃用提示。ssl_trusted_certificate 用于 OCSP stapling,指向中间证书 chain.pem;没有该文件可先注释,不影响基本 HTTPS。HSTS 头一旦下发,浏览器会在 max-age 内强制 HTTPS,首次上线建议先用较小 max-age 验证。若站点有多个 server 块或旧配置残留,必须确认每个 443 块都指向新 fullchain,否则会出现“面板显示新证书、浏览器仍旧证书”的假象。配置中不要使用 SHA-1 证书链,TLS 1.0/1.1 应关闭。修改后执行 /www/server/nginx/sbin/nginx -t,输出 syntax is ok 和 test is successful 后再 /etc/init.d/nginx reload。

CFCA 与 Let’s Encrypt 方案对比:算法、有效期与续期方式

选择方案时不要只看价格,要看算法合规、客户端兼容和续期成本。下表按宝塔面板实际部署场景对比:

对比项 CFCA 国际 RSA/ECC CFCA 国密 SM2 Let’s Encrypt
证书类型 OV/EV 等企业级,适合金融合规 国密合规场景 DV,仅验证域名
单张有效期 不超过 398 天 按 CFCA 国密证书有效期,通常不超过 398 天 90 天
浏览器兼容 主流浏览器直接信任 需国密浏览器或国密网关转换 主流浏览器直接信任
宝塔标准 Nginx 可直接部署 通常不支持,需国密版 Nginx/Tengine 或前置网关 可直接部署
验证方式 企业资料审核,周期较长 企业资料加国密合规审核 HTTP-01/DNS-01 自动验证
续期方式 到期重新签发,人工替换 到期重新签发,人工替换 90 天自动续签
适用场景 银行、政务、国企对外站点 国密改造、金融内网、合规专网 个人站、测试环境、普通企业站

从部署角度看,CFCA 国际 RSA/ECC 证书与 Let’s Encrypt 在宝塔上的操作几乎一致,区别在有效期和审核流程:CFCA 付费证书有效期最长 398 天,需要建立到期台账;Let’s Encrypt 90 天但可自动续签,适合不想人工维护的站点。国密 SM2 不是简单换文件,必须确认 Nginx 编译了国密支持、客户端支持 SM2,否则不要在生产环境直接切换。若站点同时服务普通浏览器和国密浏览器,常见做法是国际算法走 443、国密算法走另一端口或由国密网关按客户端能力分流。表格中的 398 天是公开信任 TLS 证书的行业上限,不是 CFCA 独家参数;任何声称“一次签发多年”的公开信任证书都不应直接用于生产。

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

下面这些报错在 CFCA 证书宝塔部署中很常见,按顺序排查能覆盖大部分问题。1)curl: (60) SSL certificate problem: unable to get local issuer certificate:客户端拿不到中间证书。修复:把服务器证书和中间证书按顺序拼成 fullchain,右框重新粘贴 fullchain,执行 nginx -t 后 reload。2)Java 报 javax.net.ssl.SSLHandshakeException: PKIX path building failed ... unable to find valid certification path to requested target:同样是证书链不完整,或 Java 8 旧信任库不认新根。先用 openssl s_client -connect example.com:443 -servername example.com -showcerts 确认服务端发送了中间证书,再考虑更新 JDK。3)Nginx 报 SSL_CTX_use_PrivateKey_file ... failed ... key values mismatch:证书与私钥不匹配,用上一节 MD5 命令核对。4)微信小程序报 request:fail ssl hand shake error:检查域名是否备案、证书链是否完整、是否仅支持 TLS 1.2 以上;用 openssl s_client -connect example.com:443 -servername example.com -tls1_2 测试。5)浏览器报 ERR_TOO_MANY_REDIRECTS:CDN 回源协议为 HTTP,而源站开了强制 HTTPS,改成 HTTPS 回源或对回源 IP 放行 HTTP。6)续期后仍显示旧证书:执行 openssl x509 -noout -dates -in /www/server/panel/vhost/cert/example.com/fullchain.pem 看文件日期,再检查是否有多个 server 块引用旧路径,最后 reload。不要用重启服务器代替 reload。

效果验证:用 openssl、curl 与面板监控确认部署成功

部署完成后不要只看浏览器小锁,按以下顺序验证。第一步,查看服务端实际下发的证书主题、签发者和有效期:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates。第二步,确认信任链:openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep 'Verify return code',期望输出 Verify return code: 0 (ok);若为 20 或 21,回到 fullchain 排查。第三步,用 curl 验证 HTTP 状态和跳转:curl -I https://example.com 应返回 200 或业务正常状态;curl -I http://example.com 应返回 301 到 HTTPS。第四步,分别测试 TLS 1.2 和 TLS 1.3:openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 与 -tls1_3,避免关闭旧协议后业务客户端断连。第五步,浏览器无痕模式访问,确认地址栏小锁和证书有效期;宝塔“监控”页可看 HTTPS 流量占比,但它是辅助指标,不能替代 openssl 验证。第六步,外网可用 SSL Labs 或 openssl verify 做交叉检查。若使用 CDN,还要在 CDN 控制台确认边缘证书和回源证书都已更新,否则源站验证通过、用户侧仍可能看到旧证书。

常见问题

公开信任 TLS 证书单张最长 398 天,CFCA 付费证书通常按此上限签发,不是自然年。到期必须重新签发并替换 fullchain 与私钥,不能靠修改服务器时间绕过。Let’s Encrypt 为 90 天,可自动续签。

通常不能。宝塔标准 Nginx 使用常规 OpenSSL,不支持 SM2 握手;需要国密版 Nginx/Tengine、国密网关或前置负载均衡,并且客户端要支持国密浏览器。国际 RSA/ECC 证书可直接在宝塔“其他证书”中粘贴部署。

最常见原因是证书链不完整。宝塔右框应粘贴 fullchain(服务器证书加中间证书),不是单张服务器证书。用 openssl s_client 查看 Verify return code 是否为 0,非 0 时优先补中间证书并 reload。

把 CDN 回源协议改为 HTTPS,或让源站仅对 CDN 回源 IP 放行 HTTP。否则 CDN 以 HTTP 回源会被源站 301 到 HTTPS,CDN 再回源又触发 301,形成 ERR_TOO_MANY_REDIRECTS。

先执行 openssl x509 -noout -dates 核对 fullchain 文件日期,再检查站点配置是否有多个 server 块引用旧路径。修改后执行 nginx -t 和 reload,不要只重启面板;CDN 站点还要同步更新边缘证书。

RSA 证书用 openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 分别取 MD5 比对;ECC 证书改用 openssl x509 -noout -pubkey 与 openssl pkey -pubout 的 MD5 比对。两个值一致才说明匹配,否则重新导出私钥。

内容审核

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