ZeroSSL SSL 证书宝塔面板安装部署实战:fullchain、强制 HTTPS 与续期排查
问题背景与根因:ZeroSSL 证书在宝塔上为何仍报证书链错误
ZeroSSL 提供 90 天免费 DV 证书,也可签发付费 OV/EV;Let’s Encrypt 同样为 90 天。需要先修正一个常见误区:公共信任 TLS 证书单张最长有效期为 398 天,并不是所有证书都能签一年以上。宝塔面板支持两种部署方式:面板内申请 Let’s Encrypt 并自动续期,或把 ZeroSSL 的 fullchain.pem 与私钥手动粘贴到“其他证书”。实际故障多集中在四类:只上传叶子证书导致中间证书缺失;私钥与证书不匹配;CDN 回源仍为 HTTP 造成强制 HTTPS 循环;续期后未 reload 服务。
先用命令定位:
openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | openssl x509 -noout -issuer -dates
curl -vI https://example.com
若 s_client 输出只有一张证书,或 curl 报 unable to get local issuer certificate,基本是证书链不完整。宝塔“SSL”页显示有效期只代表面板已保存,不代表链完整。浏览器可能缓存中间证书而正常,但 Java、微信小程序、curl 会严格校验。根因表:叶子证书 vs fullchain;私钥不匹配;CDN 回源协议;续期未 reload;证书过期。修复顺序:先补 fullchain,再比对模数,最后检查 Nginx 配置与 CDN。不要直接重启服务器,先 nginx -t 验证配置。
准备证书文件:从 ZeroSSL 导出 fullchain.pem 与私钥
ZeroSSL 网页端签发后下载 ZIP,通常包含 certificate.crt、ca_bundle.crt、private.key。宝塔手动上传需要两个文本:私钥 .key 与 fullchain .pem。fullchain 的拼接顺序必须是“站点证书在前、中间证书在后”,不能反过来。命令:
cat certificate.crt ca_bundle.crt > fullchain.pem
openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
openssl verify -CAfile ca_bundle.crt certificate.crt
openssl rsa -in private.key -noout -modulus | openssl md5
openssl x509 -in certificate.crt -noout -modulus | openssl md5
两个 modulus 的 MD5 必须一致,否则就是证书与私钥不匹配,粘贴多少次都不会成功。检查 fullchain 是否至少包含两张证书:grep -c ‘BEGIN CERTIFICATE’ fullchain.pem,结果应为 2 或更多。ZeroSSL 免费 DV 有效期为 90 天,私钥在网页端只展示一次,下载后立即备份。私钥权限设为 600:chmod 600 private.key。若使用 ACME 方式,acme.sh 生成的 fullchain.cer 可直接作为 fullchain.pem 使用,但安装路径要与宝塔站点配置一致。不要用 certificate.crt 单独部署,否则 Android 旧版本、Java 客户端和小程序容易报证书链错误。准备完成后,把 fullchain.pem 与 private.key 内容分别复制到宝塔两个输入框,左 key 右 fullchain。
宝塔面板完整部署步骤:ACME 自动申请与手动上传两条路径
路径一适合 Let’s Encrypt 或已接入 ACME 的 ZeroSSL:宝塔 → 网站 → 站点设置 → SSL → Let’s Encrypt → 勾选域名 → 选择文件验证或 DNS 验证 → 申请 → 开启自动续签。文件验证要求 80 端口可访问,CDN 站点建议用 DNS 验证。路径二适合 ZeroSSL 网页签发的证书:SSL → 其他证书 → 左框粘贴 private.key,右框粘贴 fullchain.pem → 保存 → 开启强制 HTTPS。保存后执行 nginx -t,再 nginx -s reload。宝塔证书目录通常为 /www/server/panel/vhost/cert/example.com/,检查:
ls -l /www/server/panel/vhost/cert/example.com/
nginx -T | grep -E 'ssl_certificate|ssl_certificate_key'
若用 acme.sh 对接 ZeroSSL,可执行:
curl https://get.acme.sh | sh -s email=admin@example.com
~/.acme.sh/acme.sh --set-default-ca --server zerossl
~/.acme.sh/acme.sh --register-account -m admin@example.com
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com --webroot /www/wwwroot/example.com
~/.acme.sh/acme.sh --install-cert -d example.com --key-file /www/server/panel/vhost/cert/example.com/privkey.pem --fullchain-file /www/server/panel/vhost/cert/example.com/fullchain.pem --reloadcmd 'nginx -s reload'
若提示 EAB,需在 ZeroSSL 控制台生成 EAB KID 与 HMAC,追加 –eab-kid 与 –eab-hmac-key。开了 CDN 的站点,必须在 CDN 把回源协议改为 HTTPS,否则宝塔强制 HTTPS 会与回源 HTTP 形成 301 循环。部署完成后不要只信面板绿标,继续做链验证。
Nginx/Apache 配置示例:TLS 参数、HSTS 与 CDN 回源
宝塔开启强制 HTTPS 后会自动写入跳转,但手动证书常缺 TLS 加固。Nginx 站点配置可参考:
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_session_cache shared:SSL:10m;
ssl_session_timeout 10m;
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; includeSubDomains' always;
}
Apache 对应配置:SSLCertificateFile 指向 fullchain.pem,SSLCertificateKeyFile 指向 private.key,SSLCertificateChainFile 在 Apache 2.4.8 后可不单独写,但 fullchain 必须完整。强制跳转用 RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]。HSTS 首次建议 max-age=300,确认全站 HTTPS 后再改 31536000。CDN 回源协议选 HTTPS,并传递 X-Forwarded-Proto。若源站 Nginx 已判断 $scheme,CDN 回源 HTTP 会误判,需改为判断 X-Forwarded-Proto 或直接固定跳转。修改后必须 nginx -t 与 systemctl reload nginx。
ZeroSSL、Let’s Encrypt 与商业证书对比:有效期、验证与续期
选择证书不要只看价格。ZeroSSL 免费 DV 与 Let’s Encrypt 都是 90 天,适合个人站和自动化程度高的业务;商业 DV/OV 单张最长 398 天,仍需在到期前续期。对比表:
| 项目 | ZeroSSL 免费 DV | Let’s Encrypt | 商业 DV | 商业 OV/EV |
|---|---|---|---|---|
| 有效期 | 90 天 | 90 天 | 最长 398 天 | 最长 398 天 |
| 验证方式 | HTTP/DNS | HTTP/DNS | 域名验证 | 企业资料审核 |
| 自动续期 | ACME/面板 | ACME/面板 | API/手动 | API/手动 |
| 价格 | 免费 | 免费 | 付费 | 付费较高 |
| 证书链 | 必须 fullchain | 必须 fullchain | 必须 fullchain | 必须 fullchain |
| 适用 | 新手网页申请 | 生态成熟 | 企业展示 | 金融/政企 |
注意:398 天是公共信任 TLS 证书的单张上限,不是“永久有效”。ZeroSSL 免费账户有证书数量限制,适合少量站点;站点多时优先 ACME 自动续期。Let’s Encrypt 的客户端兼容性更广,ZeroSSL 网页流程对新手更直观。OV/EV 并不会让浏览器地址栏显示公司名,EV 的视觉差异已弱化,核心价值在审核与合规。无论选哪种,部署时都要上传 fullchain,而不是只上传叶子证书。证书链完整性与有效期是两件事:面板显示 90 天有效,不代表 Java 客户端信任。
常见错误排查:真实报错、证书链与私钥不匹配修复
报错一:curl: (60) SSL certificate problem: unable to get local issuer certificate。原因是没有发送中间证书,解决方法是使用 fullchain.pem。验证:openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | grep ‘BEGIN CERTIFICATE’ -c,结果应大于等于 2。报错二:Java 报 PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target。这是 Java truststore 不信任链,先补 fullchain,再把根证书导入 cacerts。报错三:nginx: [emerg] SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。执行 modulus 比对:
openssl x509 -in fullchain.pem -noout -modulus | openssl md5
openssl rsa -in private.key -noout -modulus | openssl md5
两个 MD5 不一致就重新导出私钥。报错四:微信小程序 request:fail ssl handshake error 或浏览器 ERR_CERT_AUTHORITY_INVALID,通常是中间证书缺失或证书过期。报错五:续期后 openssl 仍显示旧日期,执行 nginx -s reload,并确认配置路径没有指向旧文件。报错六:CDN 站点无限 301,把回源协议改为 HTTPS,检查 X-Forwarded-Proto。排查时先 nginx -t,再 reload,不要直接 restart 全服务器。
续期与自动化:90 天证书如何避免过期
ZeroSSL 免费 DV 与 Let’s Encrypt 都是 90 天,手工续期极易遗漏。宝塔面板申请 Let’s Encrypt 时勾选自动续签,计划任务会定期执行。用 acme.sh 时确认 cron 存在:crontab -l | grep acme.sh;查看证书列表:~/.acme.sh/acme.sh –list;强制续期测试:~/.acme.sh/acme.sh –renew -d example.com –force。安装证书时一定要带 –reloadcmd ‘nginx -s reload’,否则文件更新但进程仍用旧证书。certbot 用户可用 certbot renew –dry-run 测试,–deploy-hook ‘nginx -s reload’ 在续期成功后重载。检查剩余天数:
openssl x509 -checkend 2592000 -noout -in fullchain.pem && echo 30天内到期 || echo 仍充足
openssl x509 -in fullchain.pem -noout -enddate
公共信任证书最长 398 天,但免费 DV 只有 90 天,不要按一年规划。CDN 站点续期后还要在 CDN 控制台更新证书或开启回源证书自动同步。多域名站点建议用 SAN 证书统一管理,减少漏续。监控层面可在宝塔“监控”看 HTTPS 流量占比,也可用外部拨测检查 443。若续期失败,先看 80/443 端口验证是否被 CDN 或防火墙拦截,再检查 ACME 账户邮箱与 EAB 凭据。
效果验证与安全加固:从 curl 到 SSL Labs
部署后不要只看浏览器小锁。执行:
curl -vI https://example.com
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | openssl x509 -noout -issuer -dates -subject
nginx -T | grep -E 'ssl_certificate|ssl_protocols|Strict-Transport-Security'
curl 应返回 HTTP/2 或 HTTP/1.1 200,证书链验证通过;s_client 不应出现 verify error。再用 SSL Labs 或 Qualys 测试,目标 A 级以上。安全加固:只启用 TLSv1.2/TLSv1.3,关闭 TLSv1.0/1.1;私钥 chmod 600;HSTS 先短时间再延长;开启 OCSP stapling;备份 /www/server/panel/vhost/cert/example.com/。宝塔“SSL”页显示有效期、浏览器无痕模式小锁、监控 HTTPS 占比三项都满足只能算基础通过。最后检查 80 端口是否仍能访问敏感路径,强制 HTTPS 应 301 到 https。若用 CDN,验证回源证书与边缘证书都未过期。
常见问题
ZeroSSL 免费 DV 证书有效期为 90 天,到期前需续期;公共信任 TLS 证书单张最长 398 天,但免费 DV 通常为 90 天。宝塔面板或 acme.sh 可自动续期,续期后务必 reload Nginx。
左框粘贴 private.key,右框粘贴 fullchain.pem。fullchain 必须是站点证书加中间证书,不能只粘 certificate.crt;否则 curl、Java、小程序会报证书链不完整。
优先检查证书链是否完整,用 openssl s_client -showcerts 确认至少两张证书;把 fullchain 部署到宝塔,并让 Java 客户端信任对应根证书或中间证书。
执行 nginx -t 后 nginx -s reload,确认配置指向新 fullchain 与私钥;CDN 站点还要更新边缘证书或开启回源证书同步。
把 CDN 回源协议改为 HTTPS,并检查源站是否根据 X-Forwarded-Proto 判断协议;不要同时让 CDN 回源 HTTP 和源站强制跳转 HTTPS。
两者都提供 90 天免费 DV,Let’s Encrypt 生态和客户端兼容性更广,ZeroSSL 网页申请对新手更友好且支持 ACME。站点多、追求自动化时优先 ACME 统一管理。