ZeroSSL 证书部署到宝塔面板:申请、安装、排错与 HTTPS 验证完整教程
一、问题背景与根因:为什么证书装上了仍提示不安全
ZeroSSL 是常见 ACME 证书服务商,免费 DV 证书有效期 90 天;按 CA/Browser Forum 规则,当前公共 TLS 证书最长有效期 398 天,付费 OV/EV 也不能超过该上限。宝塔面板既可在站点 SSL 中申请 Let’s Encrypt(90 天,自动续签),也可手动粘贴 ZeroSSL 的 fullchain.pem 与 private.key。很多站长看到宝塔 SSL 页显示有效期就认为完成,但 curl、Java、小程序仍报证书错误,根因通常不是证书没签发,而是部署链路不完整。
常见根因有四类:一是只上传叶子证书 cert.pem,未上传包含中间证书的 fullchain.pem,浏览器能补链但 Java/curl 严格校验失败;二是证书与私钥不匹配,多因重复申请或复制错文件;三是 CDN 已开 HTTPS,但源站仍强制 HTTP 跳 HTTPS,回源协议配置错误形成 301/302 循环;四是续期后 Nginx 未 reload,配置仍加载旧证书。排查时先分清“证书有效”与“证书链可信”两件事:前者看日期,后者看 fullchain 与私钥匹配。建议在宝塔中统一使用 fullchain.pem + private.key,并保留原始文件备份。若站点有 CDN,回源协议必须与源站监听一致,开启强制 HTTPS 前先确认 CDN 回源为 HTTPS。下面从文件核验开始给出可执行步骤。
二、准备证书文件与命令行核验
ZeroSSL 网页签发后通常下载压缩包,包含 certificate.crt、ca_bundle.crt、private.key;部署到 Nginx/宝塔时要把站点证书与中间证书合并成 fullchain.pem,顺序为“站点证书在前、中间证书在后”,不要放根证书。可用以下命令合并并核验:
cat certificate.crt ca_bundle.crt > fullchain.pem
openssl x509 -in fullchain.pem -noout -subject -issuer -dates
openssl x509 -in fullchain.pem -noout -modulus | openssl md5
openssl rsa -in private.key -noout -modulus | openssl md5
openssl verify -CAfile ca_bundle.crt certificate.crt
两条 modulus 的 MD5 必须完全一致,否则私钥不匹配,任何面板保存都会失败或握手报错。openssl verify 返回 OK 说明站点证书能由中间证书链验证;若返回 unable to get local issuer certificate,通常是 CAfile 选错或缺少中间证书。检查文件权限:私钥建议 600,属主为 root;宝塔证书目录常见为 /www/server/panel/vhost/cert/example.com/。如果使用 acme.sh 签发 ZeroSSL,可执行 acme.sh –register-account -m admin@example.com –server zerossl 注册账号,再签发:acme.sh –issue -d example.com -d www.example.com –webroot /www/wwwroot/example.com –server zerossl。签发后安装到宝塔目录:acme.sh –install-cert -d example.com –key-file /www/server/panel/vhost/cert/example.com/private.key –fullchain-file /www/server/panel/vhost/cert/example.com/fullchain.pem –reloadcmd ‘nginx -s reload’。注意免费 DV 有效期 90 天,需配置自动续期;不要用已过时的“证书最长 2 年”说法,当前上限为 398 天。
三、完整实操:ZeroSSL 证书在宝塔面板安装
方式 A 为面板自动申请 Let’s Encrypt:登录宝塔 → 网站 → 站点设置 → SSL → Let’s Encrypt → 勾选域名 → 选择文件验证或 DNS 验证 → 申请 → 开启自动续签。该方式有效期 90 天,适合能开放 80/443 或可配 DNS API 的站点。方式 B 为手动部署 ZeroSSL:网站 → 设置 → SSL → 其他证书 → 左框粘贴 private.key 全文,右框粘贴 fullchain.pem 全文 → 保存 → 开启强制 HTTPS。粘贴时保留 BEGIN/END 行,不要混入 BOM 或多余空格。若面板提示证书与私钥不匹配,回到第二节做 modulus 比对。
有 CDN 的站点顺序很关键:先在 CDN 控制台把回源协议改为 HTTPS,再回宝塔开启强制 HTTPS;否则 CDN 以 HTTPS 回源、源站又 301 到 HTTPS 但监听异常,会出现 ERR_TOO_MANY_REDIRECTS。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/private.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers HIGH:!aNULL:!MD5;
add_header Strict-Transport-Security 'max-age=31536000' always;
}
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
保存后执行 nginx -t && nginx -s reload。若用 Apache,则检查 SSLCertificateFile 指向 fullchain、SSLCertificateKeyFile 指向私钥,并 apachectl configtest。HSTS 首次部署建议先用较短 max-age,确认全站 HTTPS 后再加长;不要在没有回退方案时提交 preload。宝塔“强制 HTTPS”本质是写 301 规则,CDN 层也可能有跳转,二者只保留一处或确保协议一致。
四、方案对比与选型表格
ZeroSSL 与宝塔 Let’s Encrypt 都适合个人站和小型业务,但续期方式、验证流程和排错成本不同。下表按当前规则整理,免费 DV 均为 90 天,公共 TLS 证书最长有效期 398 天。选择时不要只看价格,还要看是否能自动续期、是否能拿到 fullchain、是否有 CDN 回源要求。
| 方案 | 有效期 | 验证方式 | 续期 | 适用场景 | 主要风险 |
|---|---|---|---|---|---|
| 宝塔 Let’s Encrypt | 90 天 | HTTP 文件/DNS | 面板自动续签 | 宝塔单站、可开放 80/443 | 验证失败、续期后未 reload |
| ZeroSSL 网页 DV | 90 天 | HTTP/DNS/邮箱 | 手动或 ACME | 新手、临时项目 | 漏传中间证书、忘记续期 |
| ZeroSSL ACME | 90 天 | ACME 挑战 | acme.sh 定时任务 | 多域名、自动化运维 | EAB/账号配置错误 |
| 付费 OV/EV | 最长 398 天 | 组织验证 | 手动续费 | 企业官网、支付相关 | 资料审核、部署链复杂 |
如果站点已在宝塔且没有特殊合规要求,优先用面板 Let’s Encrypt,减少手工粘贴错误;如果必须用 ZeroSSL 品牌证书或已有 ZeroSSL 账号,建议用 acme.sh 接入并设置 reloadcmd,避免 90 天到期中断。多域名站点要确保证书 SAN 覆盖 www 与裸域,否则浏览器会报 NET::ERR_CERT_COMMON_NAME_INVALID。CDN 场景要额外确认边缘证书与源站证书都有效,不能只替换源站。付费证书虽然有效期可到 398 天,但到期前仍需更新,且 OV/EV 不改变证书链部署要求。
五、常见错误排查:真实报错与定位命令
报错 1:curl: (60) SSL certificate problem: unable to get local issuer certificate。说明服务端未发送完整中间证书,或客户端 CA 库不信任。执行 openssl s_client -connect example.com:443 -servername example.com -showcerts 查看返回链,若只有一张证书,把 fullchain.pem 配到 ssl_certificate。报错 2:Java 报 PKIX path building failed,小程序报 request:fail ssl handshake error,处理同上,并检查是否用了自签或过期证书。
报错 3:Nginx 启动失败 [emerg] SSL_CTX_use_PrivateKey … key values mismatch。执行 openssl x509 -in fullchain.pem -noout -modulus | openssl md5 与 openssl rsa -in private.key -noout -modulus | openssl md5,两个 MD5 不一致就重新下载匹配的私钥。报错 4:浏览器 ERR_TOO_MANY_REDIRECTS,检查宝塔强制 HTTPS、CDN 回源协议和 Nginx 80 跳转是否叠加;用 curl -I http://example.com 与 curl -I https://example.com 逐跳查看 Location。报错 5:续期成功但浏览器仍显示旧证书,执行 nginx -t && nginx -s reload,并确认 ssl_certificate 路径指向新 fullchain,而不是旧 cert.pem。
报错 6:NET::ERR_CERT_DATE_INVALID,用 openssl x509 -in fullchain.pem -noout -dates 核对 notBefore/notAfter,同时检查服务器时间:date -u。报错 7:证书域名不匹配,执行 openssl x509 -in fullchain.pem -noout -text | grep -A1 ‘Subject Alternative Name’,确认包含实际访问域名。排错顺序建议:先看链,再看私钥匹配,再看跳转,最后看缓存与 CDN。每次修改后执行 nginx -t,避免配置错误导致全站 502。
六、效果验证与自动化续期
部署完成后做三层验证。第一层浏览器:无痕模式访问 https://example.com,点击锁图标查看证书颁发者、有效期和 SAN;第二层命令行:curl -vI https://example.com 应返回 HTTP/2 200 或 301,且无 SSL certificate problem;第三层链验证:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null | openssl x509 -noout -subject -issuer -dates。还可执行 curl -I –tlsv1.2 https://example.com 与 curl -I –tlsv1.3 https://example.com,确认协议兼容。宝塔 SSL 页显示剩余天数只代表文件有效,不代表链完整,必须结合 s_client 判断。
自动化续期方面,宝塔 Let’s Encrypt 在 SSL 页开启自动续签即可;acme.sh 用 crontab -l | grep acme.sh 检查定时任务,默认每天检查,到期前 30 天续签。安装证书时务必带 –reloadcmd ‘nginx -s reload’,否则新文件写入但进程仍用旧证书。可加一条续期后验证:acme.sh –cron –home ~/.acme.sh 手动触发,再执行 openssl s_client 查看 notAfter 是否更新。监控建议在宝塔“监控”页观察 HTTPS 请求占比,并用外部拨测检查 443 端口。若使用 CDN,刷新边缘证书缓存后再验证,避免源站已更新而边缘仍旧。记录证书到期日,免费 DV 90 天,提前 15 天处理最稳妥。
常见问题
ZeroSSL 免费 DV 证书有效期为 90 天,到期前需续签;当前公共 TLS 证书最长有效期上限为 398 天,付费 OV/EV 也不能超过该限制。建议用 acme.sh 或宝塔计划任务自动续期,并在续期后 reload Nginx。
应粘贴 fullchain.pem,即站点证书加中间证书的完整链;只粘贴 cert.pem 时浏览器可能正常,但 curl、Java、小程序会因链不完整报 unable to get local issuer certificate。私钥对应粘贴 private.key。
分别执行 openssl x509 -in fullchain.pem -noout -modulus | openssl md5 和 openssl rsa -in private.key -noout -modulus | openssl md5,两个 MD5 完全一致才匹配;不一致就重新下载同一订单的私钥,不要混用多次申请的文件。
先检查 CDN 回源协议是否设为 HTTPS,再确认宝塔强制 HTTPS 与 Nginx 80 跳转没有叠加冲突。用 curl -I 分别访问 http 和 https,查看 Location 跳转链;只保留一层 301,并确保 443 正常监听。
执行 nginx -t 检查配置,再 nginx -s reload 让进程加载新文件;确认 ssl_certificate 指向新 fullchain.pem。若使用 CDN,刷新边缘证书缓存。最后用 openssl s_client 查看 notAfter 是否已更新。