跳到主要内容
cPanel

ZeroSSL SSL 证书 cPanel 安装部署实战:证书链、AutoSSL 边界与排错验证

问题背景与根因:为什么 ZeroSSL 证书在 cPanel 上「浏览器绿锁、程序报错」

ZeroSSL 提供 90 天免费 DV 证书(支持 ACME 与网页流程)以及付费 OV/EV 证书;免费 DV 与 Let’s Encrypt 一样是 90 天有效期,付费证书通常按 1 年售卖,但受公有可信 TLS 证书单次有效期最长 398 天限制,实际以 notAfter 为准。cPanel 安装证书使用 PEM 三件套:叶子证书 CRT、私钥 KEY、中间证书包 CA Bundle。最常见根因不是「证书没签发」,而是只上传了叶子证书,没有把中间证书放入 CA Bundle,导致浏览器能靠缓存或 AIA 补链,而 curl、Java、小程序、支付回调等严格校验客户端报证书链不完整。第二个根因是证书与私钥不匹配,常见于重复申请后拿旧 KEY 配新 CRT。第三个根因是 SAN 不含 www 或子域,访问别名时主机名校验失败。还要注意:cPanel 的 Run AutoSSL 触发的是 cPanel 当前配置的 AutoSSL provider(常见为 cPanel/Sectigo 或 Let’s Encrypt),并不会自动安装你在 ZeroSSL 网页申请的证书;ZeroSSL 免费证书应走手动上传或 ACME 客户端签发后部署。排查时先分清「链」「匹配」「SAN」「有效期」「重定向」五类问题,再动手改配置。

准备 PEM 三件套与有效期核对

在 ZeroSSL 下载证书时选择「cPanel / Apache」格式,付费证书同样下载该格式包。解压后一般得到 certificate.crt、private.key、ca_bundle.crt,先统一命名为 example.com.crt、example.com.key、cabundle.crt。执行以下命令核对主题、SAN、有效期和模数:

unzip zerossl-example.com.zip -d zerossl
cd zerossl
ls -l
openssl x509 -in example.com.crt -noout -subject -issuer -dates -ext subjectAltName
openssl rsa -in example.com.key -noout -modulus | openssl md5
openssl x509 -in example.com.crt -noout -modulus | openssl md5
openssl verify -untrusted cabundle.crt example.com.crt
cat example.com.crt cabundle.crt > fullchain.crt

两个 modulus 的 MD5 必须完全一致,否则 cPanel 会报 Certificate and private key do not match。openssl verify 返回 OK 表示链文件可用;若报 unable to get local issuer certificate,说明 cabundle 不是正确的中间证书包。用 openssl x509 -dates 查看 notBefore/notAfter,确认未过期且不超过 398 天上限。SAN 必须覆盖 example.com 与 www.example.com,若小程序、API 域名也要访问,应重新签发时一并加入。fullchain.crt 用于 Nginx、现代 Apache 或部分面板的整链字段;cPanel 的 Manage SSL Sites 通常要求 CRT 与 CA Bundle 分开填写,不要混用。最后确认私钥权限为 600,避免 cPanel 读取失败:chmod 600 example.com.key。若从旧证书续期,保留旧文件备份,后续回滚和对比模数都要用。

完整实操:cPanel 手动安装 ZeroSSL 证书

登录 cPanel,进入 Security > SSL/TLS Status,先确认目标域名没有处于 AutoSSL 失败或未验证状态。安装付费证书或手动上传免费证书时,进入 SSL/TLS > Manage SSL Sites,在 Domain 下拉选择 example.com,点击 Browse Certificate 上传 example.com.crt;Private Key 粘贴 example.com.key 内容;Certificate Authority Bundle 粘贴 cabundle.crt 内容。三个字段必须对应同一张证书,点击 Install 后等待页面返回成功。若使用命令行批量安装,可用 cPanel UAPI SSL::install_ssl,将 cert、key、cabundle 作为 PEM 字符串传入;注意 shell 中必须正确引用多行 PEM,否则换行会被拆成多个参数。安装完成后回到 Domains 页面,把 Force HTTPS Redirect 打开,cPanel 会写入重定向规则;也可在 .htaccess 中自行配置。若站点使用 Cloudflare 或其他 CDN,cPanel 安装只影响源站,CDN 侧还要上传证书或开启 Full (strict)。安装后不要立即重启所有服务,先检查 SSL/TLS Status 是否绿色;若仍显示未安装,清理浏览器缓存并确认访问的是正确虚拟主机。多域名证书要在 Manage SSL Sites 中逐个绑定,或使用包含全部 SAN 的证书重新安装。

完整实操:ACME 自动化与 cPanel AutoSSL 的边界

ZeroSSL 支持 ACME,适合用 acme.sh 自动签发 90 天免费 DV 证书。先安装并切换默认 CA:

curl https://get.acme.sh | sh -s email=admin@example.com
~/.acme.sh/acme.sh --set-default-ca --server zerossl
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com --webroot /home/user/public_html
~/.acme.sh/acme.sh --install-cert -d example.com --cert-file /home/user/ssl/example.com.crt --key-file /home/user/ssl/example.com.key --ca-file /home/user/ssl/cabundle.crt --fullchain-file /home/user/ssl/fullchain.crt

签发后把三个文件按上一节手动安装到 cPanel。若使用 cPanel AutoSSL,要明确边界:AutoSSL 只会使用 WHM > SSL/TLS > Manage AutoSSL 中配置的 provider,常见是 cPanel 提供的 DV 或 Let’s Encrypt,不会去读取 ZeroSSL 网页账户里的证书。触发用户级检查可执行:

whmapi1 start_autossl_check user=example

AutoSSL 适合共享主机批量域名,ZeroSSL ACME 适合需要统一 CA、审计或跨面板部署的场景。续期方面,Let’s Encrypt 与 ZeroSSL 免费 DV 都是 90 天,建议在到期前 30 天续期;付费 OV/EV 按 398 天上限管理,不要等到最后一天。acme.sh 默认会写 cron,执行 crontab -l 确认任务存在。若 AutoSSL 与手动证书同时存在,cPanel 可能以 AutoSSL 结果覆盖手动安装,建议在 Manage AutoSSL 中排除该域名,或关闭该域名的 AutoSSL。最后用 openssl x509 -dates 检查新文件日期,再 reload Apache/LiteSpeed,避免只替换文件未重载。

配置示例:Apache 虚拟主机、.htaccess 与 cPanel UAPI

cPanel 生成的 Apache 配置通常位于 /etc/apache2/conf.d/userdata/ssl/2_4/user/example.com/ 或通过 Include 引入。手工核对时可参考以下片段,证书路径替换为实际文件:

<VirtualHost 203.0.113.10:443>
    ServerName example.com
    ServerAlias www.example.com
    DocumentRoot /home/user/public_html
    SSLEngine on
    SSLCertificateFile /home/user/ssl/example.com.crt
    SSLCertificateKeyFile /home/user/ssl/example.com.key
    SSLCertificateChainFile /home/user/ssl/cabundle.crt
    <Directory /home/user/public_html>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Apache 2.4.8 及以上版本已弃用 SSLCertificateChainFile,可改为把叶子证书与中间证书合并到 SSLCertificateFile:SSLCertificateFile /home/user/ssl/fullchain.crt,并删除 ChainFile 行。修改后执行 apachectl configtest 或 /scripts/restartsrv_httpd 检查语法并重载。强制 HTTPS 可用 cPanel Domains 页面的 Force HTTPS Redirect,也可在 .htaccess 写入:

RewriteEngine On
RewriteCond %{HTTPS} !=on
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

如果使用 LiteSpeed,配置由 cPanel 同步,不要直接改 httpd.conf。cPanel UAPI 的 SSL::install_ssl 可用于自动化,参数为 domain、cert、key、cabundle,其中 cert 传叶子证书、cabundle 传中间证书包;在 shell 中传递多行 PEM 时必须正确引用,否则换行会被拆成多个参数。生产环境更稳妥的做法是先用 openssl 校验三件套,再通过 Manage SSL Sites 安装,最后用 curl 和 openssl s_client 验证链。配置示例中的 IP、用户名、路径都要按实际环境替换,不要直接复制到生产。

对比表格:ZeroSSL 免费 DV、付费 OV/EV、Let’s Encrypt 与安装方式

选择方案时不要只看价格,还要看有效期、验证类型、cPanel 集成方式和客户端兼容性。下表按当前常见规则整理,实际 notAfter 以证书为准:

方案 有效期与验证 cPanel 集成 适用场景 注意点
ZeroSSL 免费 DV 90 天,域名验证,支持 ACME/网页 手动上传 CRT/KEY/CA Bundle,或 acme.sh 签发后部署 个人站、测试、预算有限 不是 cPanel AutoSSL 默认 provider;续期要自动化
ZeroSSL 付费 OV/EV 通常按 1 年售卖,受 398 天上限约束,组织验证 下载 cPanel/Apache 包后 Manage SSL Sites 安装 企业站、支付、需要组织信息 验证材料周期长;EV 不再普遍显示绿色公司名
Let’s Encrypt DV 90 天,域名验证,ACME cPanel AutoSSL 可选 provider,或 acme.sh 批量域名、自动化优先 有速率限制;AutoSSL 会覆盖手动证书
cPanel AutoSSL 默认 DV 由 provider 决定,通常 90 天左右 WHM 统一配置,用户点 Run AutoSSL 共享主机、多域名托管 不会安装 ZeroSSL 网页证书;注意排除手动域名

如果业务需要 Java、小程序、支付回调,优先选择链完整、SAN 覆盖全的证书,并在部署后用 openssl s_client 验证。免费 DV 与付费 OV/EV 在加密强度上没有区别,区别在身份验证和保障;不要把 OV/EV 当作解决链错误的工具。证书最长有效期 398 天是行业上限,ZeroSSL 免费 DV 与 Let’s Encrypt 的 90 天是产品策略,二者不矛盾。续期策略上,90 天证书建议 30 天前续,398 天证书建议 30-45 天前续,并保留旧证书用于回滚。若使用 CDN,源站与 CDN 边缘证书要分别管理,避免只更新一端。

常见错误排查:真实报错与修复命令

先看报错属于链、主机名、私钥、时间还是协议。以下为常见真实信息与处理:

1. curl: (60) SSL certificate problem: unable to get local issuer certificate。说明服务端未发送中间证书。把 cabundle.crt 正确填入 CA Bundle,或 Apache 使用 fullchain.crt;Nginx 用 ssl_certificate fullchain.crt。验证:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null。若输出只有一张证书,就是缺链。

2. curl: (60) SSL: no alternative certificate subject name matches target host name。SAN 不含访问域名。重新签发时加入 -d www.example.com,cPanel 中确认绑定域名与证书 SAN 一致。用 openssl x509 -in example.com.crt -noout -ext subjectAltName 检查。

3. Certificate and private key do not match。cPanel 安装时报错,执行 openssl rsa -in example.com.key -noout -modulus | openssl md5 与 openssl x509 -in example.com.crt -noout -modulus | openssl md5,两个 MD5 必须相同;不同则换回匹配的 KEY。

4. javax.net.ssl.SSLHandshakeException: PKIX path building failed。Java 客户端严格校验链,服务端缺中间证书或 Java truststore 过旧。先补全链,再更新 JDK 的 cacerts;不要通过关闭校验绕过。

5. 小程序 request:fail ssl hand shake error。常见于链不完整、TLS 版本过低或证书域名不匹配。用 openssl s_client -connect example.com:443 -servername example.com -tls1_2 检查,并确保 fullchain 正确。

6. NET::ERR_CERT_DATE_INVALID。服务器时间错误或证书过期。执行 date -u 与 openssl x509 -dates 对比,校正 NTP 后重载服务。若续期后仍旧,确认配置指向新文件并 reload,而不是只覆盖文件。

效果验证:从 cPanel 状态到 SSL Labs 与 curl/Java

部署完成不要只看浏览器绿锁。第一步看 cPanel Security > SSL/TLS Status,目标域名应显示绿色对勾,且到期时间正确;若显示红色,点开详情看是 DCV 失败、链错误还是私钥不匹配。第二步用 curl 验证证书链和主机名:

curl -I https://example.com
curl -vI https://example.com 2>&1 | grep -E 'SSL certificate verify|subject:|issuer:|expire date'
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null

最后一条命令应返回 Verify return code: 0 (ok)。若返回 20 (unable to get local issuer certificate),继续补链。第三步检查 SAN 与有效期:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName

第四步用 SSL Labs 或 testssl.sh 检查协议与套件,确保未启用 TLS 1.0/1.1,TLS 1.2/1.3 正常。第五步在浏览器开发者工具 Network 中确认无混合内容,所有 http:// 资源改为 https://。若站点有 Java 客户端,用 keytool -list -cacerts 检查信任库,并用测试程序发起 HTTPS 请求;小程序和支付回调要单独验证。最后用 curl -I http://example.com 确认 301 跳转到 https://,且跳转后证书校验通过。把验证命令写入上线检查清单,续期后重复执行,避免「文件换了但服务没重载」。

常见问题

不能直接安装。Run AutoSSL 使用 WHM 中配置的 provider,常见为 cPanel/Sectigo 或 Let’s Encrypt,不会读取 ZeroSSL 网页账户。ZeroSSL 免费 DV 需手动上传三件套,或用 acme.sh 走 ZeroSSL ACME 签发后再部署到 cPanel。

浏览器可能通过缓存或 AIA 自动补链,而 curl 严格校验服务端发送的证书链。把中间证书填入 CA Bundle,或让 Apache/Nginx 使用 fullchain 文件,再用 openssl s_client 确认服务端返回两张以上证书。

分别对私钥和证书执行 modulus 计算并比较 MD5:openssl rsa -in example.com.key -noout -modulus | openssl md5 与 openssl x509 -in example.com.crt -noout -modulus | openssl md5。两个值不同就是配错 KEY,换回匹配文件即可。

ZeroSSL 免费 DV 为 90 天;付费 OV/EV 通常按 1 年售卖,但受公有可信 TLS 证书最长 398 天限制,实际以证书 notAfter 为准。Let’s Encrypt 也是 90 天,续期建议提前 30 天。

先确认 cPanel 指向的是新 CRT、KEY、CA Bundle,再重载 Apache/LiteSpeed;若使用 CDN,同步更新边缘证书并清缓存。最后用 openssl s_client 查看 notAfter,确认服务端返回的是新证书而不是旧文件。

内容审核

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