跳到主要内容
宝塔面板

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 是否已更新。

内容审核

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