跳到主要内容
宝塔面板

SSL.com 证书在宝塔面板部署全流程:fullchain 拼接、强制 HTTPS 与链不完整排查

一、问题背景:面板显示“已部署”,客户端却握手失败

宝塔面板的「SSL」页面只要读到证书的 notAfter 就会打上绿色勾,但这只证明文件能被解析,并不代表整条链路可用。生产环境里最常见的四类原因如下:

  • 只粘贴了叶子证书。SSL.com 交付的压缩包通常包含 example.com.crt(叶子证书)、intermediate.crt 或 ca-bundle.crt(中间证书)。浏览器有 AIA 自动补链能力,缺中间证书照样显示小锁;但 curl、Java、微信小程序、Android 7 以下的 WebView 不会补链,直接报 unable to get local issuer certificate。
  • 私钥与证书不匹配。重新签发后仍在用旧私钥,或者把 CSR 阶段的 key 与最终的 crt 混用,Nginx 启动时报 key values mismatch。
  • 强制 HTTPS 与 CDN 回源协议冲突。站点开了强制跳转,CDN 回源仍走 HTTP,源站把 CDN 的 HTTP 请求 301 到 HTTPS,CDN 再回源 HTTP……浏览器侧出现 ERR_TOO_MANY_REDIRECTS。
  • 对有效期的认识过时。自 2020 年 9 月起,CA/B 论坛规定公开信任的 TLS 证书最长有效期 398 天;Let’s Encrypt 免费证书为 90 天,只靠自动续期才能持续使用。CA/B 论坛 SC-081 已规划 2026 年起逐步缩短至 200 天、100 天、47 天,把“证书到期”当成必须定时处理的风险来管理是唯一稳妥做法。

动手之前先用一条命令看清手上的文件到底是什么:

openssl x509 -in fullchain.pem -noout -subject -issuer -dates
# 输出示例
subject=CN = example.com
issuer=C = US, O = SSL Corporation, CN = SSL.com TLS RSA Root CA 2022
notBefore=Mar  1 00:00:00 2025 GMT
notAfter=Apr  3 23:59:59 2026 GMT   # 398 天

注意 issuer 一栏:如果显示的是你自己的域名而不是 CA 名称,说明这个文件里放的是自签证书或者链拼错了,后面所有步骤都会失败。

二、准备证书文件:把叶子证书拼成 fullchain

登录 SSL.com 控制台(或邮件里的下载链接)拿到证书包,一般包含 example.com.crt(服务器证书/叶子)、intermediate.crt 或 ca-bundle.crt(中间证书)、example.com.key(私钥,签发时在本地生成,CA 从不保存)。宝塔只认两个文本框,所以要先自己合成 fullchain。

拼接顺序必须是“叶子在前、中间在后”,根证书不要放(客户端与系统自带):

cat example.com.crt intermediate.crt > fullchain.pem
grep -c "BEGIN CERTIFICATE" fullchain.pem    # 正常应 ≥ 2
openssl x509 -in fullchain.pem -noout -subject -issuer -dates

私钥匹配性校验(RSA / ECC 通用,比较公钥摘要):

openssl x509 -in fullchain.pem -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5
# 两行 md5 必须完全一致

旧教程里的 openssl rsa -noout -modulus 只适用于 RSA,遇到 ECC 证书(SSL.com 有 ECC 产品线)会报 Not an RSA key,建议统一用上面的 pkey 方案。设置文件权限,避免私钥被面板以外的进程读到:

chmod 600 example.com.key
chown root:root example.com.key fullchain.pem

还要确认私钥没有被二次加工:-----BEGIN PRIVATE KEY-----(PKCS#8)和 -----BEGIN RSA PRIVATE KEY-----(PKCS#1)宝塔都能识别,但如果文件里出现字面量 n、多余空行,或被 Windows 记事本存成 CRLF+BOM,粘贴到面板后会提示“证书格式错误”,用 sed -i 's/r$//' fullchain.pem 清理一遍最保险。

三、实操:在宝塔面板手动部署付费证书

路径:网站 → 站点名 → 设置 → SSL → 其他证书。左侧「私钥(KEY)」粘贴 example.com.key 全文,右侧「证书(PEM 格式)」粘贴 fullchain.pem 全文,保存后点「强制 HTTPS」。保存成功后面板会显示证书品牌、颁发时间与剩余天数。

宝塔实际保存的位置是固定的,可用命令行复核:

ls -l /www/server/panel/vhost/cert/example.com/
# fullchain.pem  privkey.pem
openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -dates

如果不走面板,直接改 Nginx 配置也可以(宝塔站点配置在 /www/server/panel/vhost/nginx/example.com.conf):

server {
    listen 443 ssl;
    http2 on;
    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-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
    ssl_prefer_server_ciphers off;
    ssl_session_cache   shared:SSL:10m;
    ssl_session_timeout 10m;
}

改完先检查语法再重载,不要直接用 restart(会中断连接):

nginx -t && nginx -s reload

两个容易出错的地方:一是宝塔面板自身(8888 端口)的证书在「面板设置 → SSL」里单独配置,和站点证书无关,很多人改完站点却发现面板还是自签;二是开启「强制 HTTPS」后宝塔会在 80 端口 server 块写入 return 301 https://$host$request_uri;,如果前面挂了 CDN,务必去 CDN 控制台把回源协议改成 HTTPS,否则就是第一节说的重定向循环。

四、实操:Let’s Encrypt 自动签发与续期(90 天)

免费证书更适合个人站和测试环境:网站 → 设置 → SSL → Let’s Encrypt,勾选需要签发的域名(含 www),验证方式选「文件验证」(需 80 端口可访问)或「DNS 验证」(支持泛域名 *.example.com),点申请,签发成功后勾选「自动续签」。Let’s Encrypt 证书有效期固定 90 天,官方建议剩余 30 天时续期,宝塔的续签任务每天执行一次,命中条件才真正续。

习惯命令行的可以用 certbot,等价且更可控:

# 安装
yum install -y certbot python3-certbot-nginx   # Debian/Ubuntu 用 apt install certbot
# webroot 方式签发多域名
certbot certonly --webroot -w /www/wwwroot/example.com 
  -d example.com -d www.example.com 
  --deploy-hook "nginx -s reload"
# 试运行验证续期链路(不会真的签发)
certbot renew --dry-run

证书落在 /etc/letsencrypt/live/example.com/,其中 fullchain.pem 已含中间证书,privkey.pem 为私钥,直接指给 Nginx 即可。关键点:续期只换文件,不 reload 等于没续。certbot 用 --deploy-hook 解决;宝塔续签后会自动重载,但如果站点是 Docker/OpenResty 自建,需要自己写钩子:

# /etc/letsencrypt/renewal-hooks/deploy/reload.sh
#!/bin/bash
nginx -t && nginx -s reload
docker exec openresty nginx -s reload 2>/dev/null || true

另外注意速率限制:Let’s Encrypt 对同一注册域名有 每周 50 张重复证书上限,调试阶段请用 --staging 环境,否则很容易触发 too many certificates already issued 并被锁一周。

五、配置示例:强制跳转、CDN 回源与 HSTS

一个完整的宝塔站点 HTTPS 配置应同时处理三件事:80 端口跳转、443 端口证书与加密套件、以及反向代理/CDN 场景下的真实协议识别。

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    http2 on;
    server_name example.com www.example.com;
    root /www/wwwroot/example.com;
    index index.php index.html;

    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_session_cache   shared:SSL:10m;

    # 全站 HTTPS 后让浏览器记住一年
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    # 顺手修掉历史页面里的 http:// 静态资源
    add_header Content-Security-Policy "upgrade-insecure-requests" always;

    location / { try_files $uri $uri/ /index.php?$query_string; }
}

三个细节:

  • HSTS 的承诺几乎不可撤销。一旦下发 max-age=31536000,一年内浏览器只会用 HTTPS 访问该域名,配置出错时连回滚都很困难。首次上线建议先写 max-age=300 观察一天,确认无混合内容告警后再调大,并视情况提交 preload。
  • 反向代理要传 X-Forwarded-Proto。站点后面还有一层代理时,PHP 判断 $_SERVER['HTTPS'] 会失效,导致页面内生成 http 链接、后台登录死循环。加 proxy_set_header X-Forwarded-Proto $scheme; 并在应用侧信任该请求头。
  • CDN 回源协议必须与源站跳转一致。CDN 控制台把“回源协议”从 HTTP 改为 HTTPS(或“协议跟随”),否则源站 301 → CDN 再回源 HTTP → 再 301,浏览器报 ERR_TOO_MANY_REDIRECTS。

Apache 环境(宝塔可切换)对应写法:SSLCertificateFile /path/fullchain.pem、SSLCertificateKeyFile /path/privkey.pem、SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1,改完执行 httpd -t && systemctl reload httpd。

六、对比:证书类型与三种部署方式怎么选

先看证书本身。SSL.com 的产品线覆盖 DV、OV、EV 以及文档签名证书,公开信任证书的最长有效期统一受 CA/B 论坛约束,目前为 398 天:

类型 验证内容 签发时长 单张最长有效期 浏览器展示 适用场景
DV(域名验证) DNS/文件/邮箱验证域名控制权 几分钟 398 天 小锁 个人站、博客、测试环境
OV(组织验证) DV + 企业工商信息人工核验 1–3 个工作日 398 天 小锁,证书详情可见企业名 企业官网、SaaS 后台
EV(扩展验证) OV + 更严格的实体与授权审查 3–7 个工作日 398 天 小锁(主流浏览器已取消绿色地址栏) 金融、支付、招投标资质
Let’s Encrypt ACME 自动验证 秒级 90 天(需自动续期) 小锁 自动化程度高的站点、泛域名

再看部署方式,宝塔上三条路各有取舍:

方式 操作位置 续期 适合谁
面板 Let’s Encrypt SSL → Let’s Encrypt 自动,90 天一轮 不想碰命令行的站长
手动粘贴付费证书 SSL → 其他证书 手动,到期前重签再粘贴 需要 OV/EV、有合规要求的站点
命令行 certbot SSH cron + deploy-hook 自动 多站点、容器化、需精细控制

选型建议:如果只是消除“不安全”提示,DV 或 Let’s Encrypt 足够;如果证书要出现在合同、支付通道报备或应用商店审核里,直接上 OV/EV,并把续期时间写进运维日历——398 天听起来很久,实际一年只有一次机会,忘一次就是全站告警。

七、常见错误排查:从真实报错定位根因

下面这些报错几乎覆盖了宝塔部署 SSL.com 证书 90% 的故障:

报错信息 根因 处理
curl: (60) SSL certificate problem: unable to get local issuer certificate 缺中间证书,只装了叶子 改用 fullchain.pem,确认文件内 ≥2 张证书
PKIX path building failed: unable to find valid certification path to requested target Java 信任库不补链 同上;企业内网还需把 CA 根导入 cacerts
nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) 私钥与证书不匹配 用第二节的 pubkey md5 对比,换回正确 key
ERR_TOO_MANY_REDIRECTS 强制 HTTPS + CDN 回源 HTTP CDN 回源协议改 HTTPS 或“协议跟随”
NET::ERR_CERT_DATE_INVALID 续期后未重载,进程仍加载旧文件 nginx -s reload,核对配置指向的路径
525 SSL handshake failed(Cloudflare) 源站 443 不通,或只监听 127.0.0.1 ss -lntp | grep 443,改 listen 0.0.0.0 并放行安全组
微信小程序 request:fail ssl handshake error 缺中间证书或协议过旧 补全链,禁用 TLSv1.0/1.1

一条命令看完整条链,是最快的定位手段:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | grep -E "^ [0-9] s:|^ [0-9] i:|Verify return code|Protocol"
# 期望输出
#  0 s:CN = example.com
#  0 i:C = US, O = SSL Corporation, CN = SSL.com TLS RSA Root CA 2022
#  1 s:C = US, O = SSL Corporation, CN = SSL.com TLS RSA Root CA 2022
#  1 i:C = US, O = SSL Corporation, CN = SSL.com TLS RSA Root CA 2019
#  Verify return code: 0 (ok)
#  Protocol  : TLSv1.3

如果只输出一条 0 s: 而没有 1 s:,说明链断了;Verify return code 不是 0,对照括号里的原因(unable to get local issuer certificate、certificate has expired)逐项排查即可。

八、效果验证:四条命令确认“真的部署好了”

部署完成不等于验证完成,建议按文件层 → 服务层 → 链路层 → 应用层依次确认:

# 1. 文件层:证书链完整、有效期正确
openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -subject -dates
grep -c "BEGIN CERTIFICATE" /www/server/panel/vhost/cert/example.com/fullchain.pem

# 2. 服务层:配置语法与端口监听
nginx -t && ss -lntp | grep ":443"

# 3. 链路层:握手协议与证书链
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep -E "Verify return code|Protocol"

# 4. 应用层:跳转与响应
curl -sI http://example.com | head -1        # 期望 HTTP/1.1 301
curl -sI https://example.com | head -3       # 期望 HTTP/2 200 + server 头

再补三项外部验证:

  • SSL Labs / MySSL 评级。目标 A 或 A+。拿不到 A 通常是因为仍启用 TLSv1.0/1.1、缺少 HSTS,或证书链里混入了根证书导致握手包过大。
  • 客户端实测。浏览器无痕模式访问看小锁与证书详情;再用 curl -v https://example.com 和一段 Java/小程序的真实请求各跑一次——这正是“浏览器正常但接口报错”的分水岭。
  • 面板监控。宝塔「监控」页可以看到 HTTPS 请求占比,开启强制跳转后应接近 100%;若仍有大量 80 端口 200 响应,说明有路径绕过了跳转(例如 CDN 缓存了旧的 HTTP 响应)。

最后把到期提醒配上:398 天的证书建议提前 30 天处理,Let’s Encrypt 的 90 天证书依赖自动续期,两者都应纳入监控。可以用一行脚本塞进 crontab 每天检查:

openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -checkend 2592000 || echo "证书 30 天内到期" | mail -s alert ops@example.com

常见问题

不代表。面板只解析了本地文件,未验证链路完整性。必须用 openssl s_client 确认 Verify return code 为 0 且输出两级以上证书,再用 curl 或业务客户端实测一次,才算部署完成。

典型是证书链不完整。浏览器会用 AIA 自动下载中间证书补齐,而 curl、Java、小程序不会。把 intermediate.crt 与叶子证书按“叶子在前”顺序拼成 fullchain.pem 再部署即可解决。

多半是文件带了 BOM、CRLF 换行或多余空行。执行 sed -i ‘s/r$//’ fullchain.pem 清理,确认首行是 —–BEGIN CERTIFICATE—–、末行是 —–END CERTIFICATE—–,且没有把 .key 内容粘进证书框。

续期只更新了磁盘文件,Nginx 进程仍加载旧证书。执行 nginx -t && nginx -s reload 即可;certbot 用户应配置 –deploy-hook 自动重载,CDN 站点还要在控制台刷新或重新上传边缘证书。

加密强度相同,差别在身份验证与有效期:OV 需人工核验企业工商信息,证书详情可见公司名,适合合同、支付报备、应用商店审核;Let’s Encrypt 仅验证域名控制权,有效期 90 天,需依赖自动续期。

先看是否挂了 CDN:源站强制跳转 HTTPS 而 CDN 回源仍走 HTTP,就会形成 301 死循环。把 CDN 回源协议改为 HTTPS 或“协议跟随”;未用 CDN 则检查 80 端口 server 块的 return 301 是否指向了错误域名。

内容审核

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