ZeroSSL 证书部署到 CDN/云加速:边缘证书、回源 HTTPS 与排错全流程
问题背景与根因:CDN 场景下 SSL/TLS 为什么容易失败
把 ZeroSSL 签发的 SSL 证书部署到 CDN/云加速,失败点通常不在“证书能不能签发”,而在“边缘证书”和“回源协议”被混为一谈。CDN 场景存在两段 TLS:用户到 CDN 边缘节点、CDN 节点到源站。边缘证书决定浏览器看到的证书,回源证书决定 CDN 能否验证源站。ZeroSSL 提供 90 天免费 DV(ACME 或网页流程)以及付费 OV/EV;公开信任 TLS 证书受 CA/B Forum 规则限制,最长有效期 398 天,Let’s Encrypt 默认 90 天,ZeroSSL 免费 DV 也是 90 天,因此必须把自动续期和 CDN 证书更新纳入流程。
常见根因有四类:一是只上传了边缘证书,回源仍走 HTTP,源站 80 端口又 301 到 HTTPS,CDN 反复回源形成重定向循环;二是上传的是叶子证书而非 fullchain,浏览器可能正常,但 curl、Java、Android、小程序会报链不完整;三是回源 Host 与源站证书 SAN 不匹配,CDN 校验源站证书失败;四是续期后只更新了源站文件,没有在 CDN 控制台重新上传并启用新证书。
- 边缘证书:用户访问
https://example.com时看到的证书,通常上传 PEM 证书链加私钥,或使用云厂商一键免费边缘证书。 - 回源证书:CDN 回源到
origin.example.com:443时校验的证书,需与回源 Host 匹配。 - 源站证书:Nginx/Apache/对象存储上的证书,建议与边缘证书同源管理,但不要误以为上传 CDN 后源站就无需配置。
排查时先用 curl -Iv https://example.com 看边缘证书的 subject、issuer 和链;再用 openssl s_client -connect ORIGIN_IP:443 -servername origin.example.com 看源站证书。两段分别验证,才能快速定位是边缘证书、回源证书还是源站配置问题。
完整实操步骤(一):准备 ZeroSSL 证书文件与私钥
网页流程适合新手:在 ZeroSSL 控制台新建 90 天 DV 证书,填写域名并完成 HTTP 文件、DNS CNAME 或 DNS TXT 验证。下载后通常得到 certificate.crt、ca_bundle.crt 和私钥文件。CDN 上传必须使用完整链,先拼接:
cat certificate.crt ca_bundle.crt > fullchain.crt
openssl x509 -in fullchain.crt -noout -subject -issuer -dates
openssl x509 -in fullchain.crt -noout -text | grep -A1 'Subject Alternative Name'
如果使用 ACME,可走 ZeroSSL ACME 端点,需要 EAB KID 与 HMAC Key。示例命令中的占位符需替换为控制台生成值:
export ZEROSSL_EAB_KID='YOUR_EAB_KID'
export ZEROSSL_EAB_HMAC_KEY='YOUR_EAB_HMAC_KEY'
acme.sh --register-account --server zerossl --eab-kid YOUR_EAB_KID --eab-hmac-key YOUR_EAB_HMAC_KEY
acme.sh --issue -d example.com -d www.example.com --server zerossl --keylength 2048
上传前核对私钥与证书是否匹配,两个 modulus 的 MD5 必须一致:
openssl x509 -in fullchain.crt -noout -modulus | openssl md5
openssl rsa -in example.com.key -noout -modulus | openssl md5
chmod 600 example.com.key
若 CDN 只接受 PFX/P12,可转换后再上传:
openssl pkcs12 -export -out example.pfx -inkey example.com.key -in fullchain.crt -certfile ca_bundle.crt
注意:ZeroSSL 免费 DV 为 90 天,Let’s Encrypt 也是 90 天;公开信任 TLS 证书最长有效期 398 天。不要把“付费证书”误解为可以长期不续期,CDN 上传型证书尤其要设置到期提醒。
完整实操步骤(二):CDN/云加速边缘证书与回源 HTTPS
第一步接入域名:在 CDN 控制台添加域名,按提示将 DNS 的 CNAME 指向 CDN 提供的目标。用 dig +short example.com 确认解析已生效。第二步配置边缘证书:进入“域名管理 → HTTPS 配置 → 上传证书”,证书名称填 example.com-zerossl,证书内容粘贴 fullchain.crt 全文,私钥粘贴 example.com.key;若云厂商支持一键免费边缘证书,也可直接申请,但需确认其覆盖 example.com 与 www.example.com。
第三步配置回源:进入“回源配置”,回源协议选择 HTTPS,回源端口 443,回源 Host 建议填源站证书实际覆盖的域名,例如 origin.example.com。关键点:回源协议不要选 HTTP。若 CDN 回源 HTTP,而源站 80 端口又 return 301 https://$host$request_uri,CDN 会不断回源形成循环,浏览器报 ERR_TOO_MANY_REDIRECTS。源站应同步部署同一张 ZeroSSL fullchain,或使用云厂商提供的回源证书。
第四步开启强制 HTTPS 跳转:在 CDN 的 HTTPS 配置中开启“强制 HTTPS”,由边缘节点把 http://example.com 301 到 HTTPS。源站 80 端口只保留到 443 的跳转即可,不要在 CDN 已回源 HTTPS 的情况下再叠加多层跳转。第五步验证:
dig +short example.com
curl -Iv https://example.com --resolve example.com:443:CDN_IP
curl -Iv https://origin.example.com --resolve origin.example.com:443:ORIGIN_IP
openssl s_client -connect CDN_IP:443 -servername example.com
如果源站使用自签证书,CDN 的“回源证书校验”应上传对应 CA,或仅在可信内网临时关闭严格校验;公网源站不建议关闭校验。最后在 CDN 控制台确认边缘证书状态为“已启用”,回源协议显示 HTTPS,且没有残留的 HTTP 回源规则。
配置示例:Nginx 源站、CDN 回源参数与 PFX 上传
源站 Nginx 建议把 80 与 443 分开配置,证书路径指向 fullchain 与私钥。以下配置可直接改域名后执行 nginx -t && systemctl reload nginx:
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.crt;
ssl_certificate_key /etc/nginx/ssl/example.com.key;
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;
add_header Strict-Transport-Security 'max-age=31536000' always;
location / {
root /var/www/html;
index index.html;
}
}
CDN 侧建议参数如下:边缘证书使用 fullchain + 私钥;最低 TLS 版本 1.2,优先开启 TLS 1.3;回源协议 HTTPS;回源端口 443;回源 Host 与源站证书 SAN 一致;强制 HTTPS 开启;HSTS 先设较短 max-age 观察,再逐步加长。若 CDN 只支持 PFX,用前文 openssl pkcs12 -export 生成 example.pfx 上传,密码单独保管。
| 配置项 | 推荐值 | 说明 |
|---|---|---|
| 边缘证书格式 | PEM fullchain + KEY | 部分云厂商支持 PFX/P12 |
| 回源协议 | HTTPS | 选 HTTP 易触发源站 301 循环 |
| 回源端口 | 443 | 与源站 listen 443 一致 |
| 回源 Host | origin.example.com | 必须被源站证书 SAN 覆盖 |
| 强制 HTTPS | 开启 | 由 CDN 边缘统一跳转 |
修改后执行 nginx -t,出现 syntax is ok 与 test is successful 再 reload。若使用对象存储源站,需在存储桶域名绑定证书,并确认 CDN 回源 Host 与绑定域名一致,否则会返回证书域名不匹配。
对比表格:边缘证书、回源证书与 ZeroSSL 证书类型
CDN 部署最容易混淆的是“证书放在哪一层”。下表按部署位置区分职责,避免把边缘证书当成回源证书使用:
| 项目 | 边缘证书 | 回源证书 | 源站证书 |
|---|---|---|---|
| 作用 | 用户到 CDN 节点 | CDN 到源站 | 源站直接提供 TLS |
| 常见格式 | PEM+KEY 或 PFX | PEM+KEY 或云托管 | PEM fullchain+KEY |
| 域名要求 | 用户访问域名 | 回源 Host/源站域名 | 源站域名 |
| 续期责任 | 上传型需手动更新,免费边缘证书可自动 | 随源站证书同步 | ACME 自动或手动 |
| 验证命令 | openssl s_client -connect CDN_IP:443 -servername example.com |
openssl s_client -connect ORIGIN_IP:443 -servername origin.example.com |
同左,按源站 IP 验证 |
ZeroSSL 证书类型也要区分:免费 DV 只验证域名控制权,有效期 90 天,适合 CDN 边缘和测试环境;付费 OV/EV 增加组织验证,适合金融、政企展示,但同样受公开信任证书最长 398 天限制。Let’s Encrypt 默认 90 天,与 ZeroSSL 免费 DV 一样应优先用 ACME 自动续期。格式上,PEM 是文本证书链,PFX/P12 是带私钥的二进制包;CDN 上传时优先 fullchain,PFX 仅在控制台明确要求时使用。
选择方案时,如果 CDN 提供免费边缘证书且支持自动续期,可让边缘证书由 CDN 托管,源站继续用 ZeroSSL/ACME 证书;如果合规要求统一证书来源,则边缘与源站都上传同一张 ZeroSSL fullchain,并建立到期前 30 天更新清单。
常见错误排查:真实报错与修复命令
报错 1:curl: (60) SSL certificate problem: unable to get local issuer certificate。说明链不完整,常见于只上传叶子证书。修复:把站点证书与中间证书拼接成 fullchain 后重新上传,并用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 查看返回链数量。
报错 2:SSL_ERROR_BAD_CERT_DOMAIN 或 Hostname mismatch。证书 SAN 不包含当前域名,或 CDN 回源 Host 填错。检查:openssl x509 -in fullchain.crt -noout -text | grep -A1 'Subject Alternative Name';把回源 Host 改为证书实际覆盖的 origin.example.com。
报错 3:ERR_TOO_MANY_REDIRECTS。典型原因是 CDN 回源 HTTP,源站 80 又 301 到 HTTPS。修复:CDN 回源协议改 HTTPS、端口 443;源站只保留 80→443 跳转,不要在 CDN 已回源 HTTPS 时再叠加跳转。
报错 4:Cloudflare 等 CDN 返回 526 Invalid SSL certificate。表示 CDN 无法验证源站证书,常见于源站证书过期、自签或域名不匹配。修复:源站安装有效 fullchain;严格模式需证书链完整;临时可切换 Full 模式,但不建议长期关闭严格校验。
报错 5:nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。证书与私钥不匹配。执行:openssl x509 -in fullchain.crt -noout -modulus | openssl md5 与 openssl rsa -in example.com.key -noout -modulus | openssl md5,两个值必须一致。
报错 6:certificate has expired 或 Java 报 PKIX path building failed。前者是续期后未 reload/未更新 CDN;后者多为中间证书缺失或根证书不受信。修复:源站 systemctl reload nginx,CDN 重新上传新 fullchain,Java 客户端更新 truststore,并检查 openssl x509 -enddate -noout -in fullchain.crt。
效果验证:curl、openssl、SSL Labs 与业务侧检查
先从边缘验证。执行 curl -Iv https://example.com,确认输出包含 SSL certificate verify ok、正确的 subject/issuer、TLS 1.2 或 TLS 1.3,并且没有证书链警告。若 DNS 尚未切换,可用 curl -Iv https://example.com --resolve example.com:443:CDN_IP 指定 CDN 节点。再用 openssl 查看边缘证书有效期与 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
openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null | grep 'Verify return code'
回源单独验证:curl -Iv https://origin.example.com --resolve origin.example.com:443:ORIGIN_IP,以及 openssl s_client -connect ORIGIN_IP:443 -servername origin.example.com。如果边缘正常、回源失败,优先检查回源 Host、源站证书 SAN 与 CDN 回源证书校验开关。
检查跳转:curl -I http://example.com 应返回 301 到 HTTPS;curl -IL https://example.com 不应出现多次 301;curl -s -o /dev/null -w '%{http_code} %{num_redirects}' https://example.com 应输出 200 和较少跳转次数。最后用 SSL Labs 测试边缘节点,目标评级 A/A+,证书链完整,TLS 1.0/1.1 关闭。业务侧用 Java、Android、小程序各跑一次 HTTPS 请求,避免只测浏览器。
建议加入到期监控:openssl x509 -checkend 2592000 -noout -in fullchain.crt,30 天内到期返回非零即告警;CDN 上传型证书在到期前 30 天更新,ACME 证书确认 cron 任务和 reload 命令生效。
常见问题
免费 DV 为 90 天,Let’s Encrypt 也是 90 天;公开信任 TLS 证书最长 398 天。建议用 ACME 自动续期,续期后在 CDN 控制台重新上传 fullchain 和私钥并启用,源站执行 nginx -t 与 systemctl reload nginx,再用 openssl s_client 检查 notAfter。
传 fullchain,即站点证书加中间证书,再加私钥;PEM 或 PFX 均可。只传叶子证书时浏览器有时正常,但 curl、Java、Android、小程序常报 unable to get local issuer certificate 或 PKIX path building failed。可用 openssl s_client -showcerts 检查链是否完整。
CDN 回源 HTTP 时,如果源站 80 端口又 301 到 HTTPS,CDN 会反复回源形成 ERR_TOO_MANY_REDIRECTS;同时回源明文也不满足端到端 TLS。应在 CDN 回源配置选 HTTPS、端口 443,并让回源 Host 与源站证书 SAN 匹配。
先确认 CDN 边缘证书已上传新 fullchain 并启用,源站已 reload;再清 CDN 缓存和本地 DNS 缓存。用 openssl s_client -connect 域名:443 -servername 域名 查看 notAfter,若仍是旧日期,说明更新的是源站而非 CDN 边缘证书。
分别计算模数 MD5:openssl x509 -in fullchain.crt -noout -modulus | openssl md5 与 openssl rsa -in example.com.key -noout -modulus | openssl md5,两者一致才匹配。Nginx 报 key values mismatch 时,多半是上传了旧私钥或 CSR 与证书不对应。