跳到主要内容
宝塔面板

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 统一管理。

内容审核

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