跳到主要内容
CDN / 云加速

ZeroSSL 证书部署到 CDN / 云加速完整教程:边缘证书、回源协议与链完整性校验

本教程面向把 ZeroSSL 签发的 SSL 证书部署到 CDN / 云加速的场景,覆盖文件准备、控制台配置、回源设置、配置示例、方案对比、真实报错排查与效果验证。ZeroSSL 提供 90 天免费 DV(ACME 或网页流程)与付费 OV/EV,网页端对新手友好、签发快;注意公开信任证书最长有效期受 CA/B Forum 限制为 398 天,ZeroSSL 免费 DV 与 Let’s Encrypt 均为 90 天,必须按季度续期。

一、问题背景与根因:CDN 场景下有两段 TLS,不是一段

接入 CDN 后,一个 HTTPS 请求实际上经历两段彼此独立的 TLS 握手:用户浏览器 ↔ CDN 边缘节点(由边缘证书负责),CDN 边缘节点 ↔ 源站(由回源证书与回源协议负责)。很多教程只讲“上传证书”,把两段混为一谈,这是后续绝大多数故障的根因。

边缘证书决定浏览器地址栏的锁标与证书主体,由 CDN 控制台上传的 PEM/PFX 决定;回源证书决定 CDN 节点是否信任你的源站,由回源协议、回源端口、回源 Host(SNI)与源站配置共同决定。两者可以是同一张证书,但更推荐分开:边缘用云厂商免费边缘证书或 ZeroSSL 通配符证书,回源用源站内部 CA 证书,减少私钥扩散面。

三个必须记住的硬事实:

  • 公开信任的 TLS 证书最长有效期 398 天(CA/B Forum 自 2020-09-01 起强制),ZeroSSL 免费 DV 为 90 天,需按季度续期。
  • 回源协议选 HTTP、而源站 80 端口又配置了 301 强制跳转时,CDN 拿到 301 后仍以 HTTP 重试,形成 ERR_TOO_MANY_REDIRECTS 死循环。
  • 回源 HTTPS 时 CDN 会校验证书链与 SNI,源站若使用自签证书、或只部署叶子证书未拼链,边缘会返回 502 或 526。

排查第一步永远是分清故障段,用两条命令对照:

# 只看边缘节点(走 CDN)
curl -Iv https://example.com

# 绕过 CDN 直连源站,验证回源段
curl -Iv https://origin.example.com --resolve origin.example.com:443:203.0.113.10

两条命令返回的 issuer 不同、结果不同,就能立刻判断问题出在边缘证书还是回源链路,避免在错误的地方反复重传证书。

二、准备证书文件:fullchain 拼接、模数比对与链验证

ZeroSSL 网页流程签发的免费 DV 证书通常给到三个文件:certificate.crt(叶子证书)、ca_bundle.crt(中间 CA 链)、private.key(私钥)。CDN 上传要求“证书 + 链”拼接成 fullchain,只传叶子证书是最高频错误。拼接并检查内容:

cat certificate.crt ca_bundle.crt > fullchain.crt
openssl crl2pkcs7 -nocrl -certfile fullchain.crt | openssl pkcs7 -print_certs -noout

输出应包含两段 subject/issuer:第一段是你的域名,第二段 issuer 为 ZeroSSL 的中间 CA(例如 ZeroSSL RSA Domain Secure Site CA)。若只有一段,说明链没拼上。

校验证书与私钥是否匹配(RSA 用模数比对):

openssl x509 -noout -modulus -in fullchain.crt | openssl md5
openssl rsa  -noout -modulus -in private.key  | openssl md5

两个 MD5 必须完全一致,不一致说明证书与私钥不是同一次生成的。ECC 证书改用公钥比对:

openssl x509 -noout -pubkey -in fullchain.crt | openssl md5
openssl pkey -pubout -in private.key | openssl md5

再验证链完整性与域名覆盖:

openssl verify -untrusted ca_bundle.crt certificate.crt
openssl x509 -noout -dates -subject -issuer -ext subjectAltName -in fullchain.crt

部分国内云厂商只接受 PFX,转换命令(PFX 必须包含完整链,否则同样报链不完整):

openssl pkcs12 -export -out example.pfx 
  -inkey private.key -in fullchain.crt -certfile ca_bundle.crt 
  -passout pass:YourPfxPassword

用 ACME 自动化签发时(ZeroSSL ACME 端点),acme.sh 产出的 fullchain.cer 已是“叶子 + 中间链”,可直接上传 CDN,无需再拼接:

export ZEROSSL_EMAIL=you@example.com
acme.sh --register-account -m "$ZEROSSL_EMAIL" --server zerossl
acme.sh --issue -d example.com -d www.example.com 
  --webroot /var/www/html --server zerossl --keylength ec-256

三、CDN / 云加速控制台完整配置步骤

以主流云厂商控制台为例,按以下顺序操作,顺序错了容易在回源阶段返工。

第 1 步:添加加速域名并完成归属验证。回源地址填源站 IP 或源站域名;若填域名,务必确认该域名解析不指向 CDN 自身,否则会形成解析回环。

第 2 步:配置边缘证书。进入“域名管理 → HTTPS 配置 → 证书上传”,粘贴 fullchain 全文与私钥全文(或上传 PFX + 密码)。若云厂商提供“一键申请免费边缘证书”,优先使用,通常为 90 天自动续期,可彻底规避漏续期风险。上传后证书部署到边缘节点有 5–30 分钟推送延迟。

第 3 步:配置回源协议(关键)。“回源配置 → 回源协议”选择 HTTPS,回源端口填 443;回源 Host / SNI 必须填源站证书实际签发给的那个域名,而不是加速域名,否则回源握手报 SNI 不匹配。若源站用自签证书,需要在控制台开启“忽略回源证书校验”或上传源站 CA;生产环境不建议长期忽略。

第 4 步:源站同步部署同一张证书(或云厂商回源证书)。源站 443 端口的证书必须是有效、链完整、未过期的,CDN 回源才会成功。

第 5 步:跳转与安全策略。“强制 HTTPS 跳转”在 CDN 层开启即可,源站不必对 CDN 回源流量重复配置 80→443 跳转;HSTS 建议只在 CDN 边缘下发,源站不要下发,避免灰度期无法回退。同时开启 HTTP/2(ALPN)与 TLS 1.2/1.3,关闭 TLS 1.0/1.1。

第 6 步:泛域名与多域名注意点。多数 CDN 一个加速域名对应一个证书槽位,通配符 *.example.com 只覆盖一级子域,a.b.example.com 需额外配置;证书 SAN 必须包含加速域名本身,否则浏览器报名称不匹配。

四、配置示例:Nginx 源站 + 回源参数

源站 Nginx 配置(回源 HTTPS,链完整、开启 OCSP Stapling 与真实 IP 还原):

server {
    listen 443 ssl http2;
    server_name origin.example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.crt;
    ssl_certificate_key /etc/nginx/ssl/private.key;
    ssl_trusted_certificate /etc/nginx/ssl/ca_bundle.crt;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
    ssl_prefer_server_ciphers off;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;

    ssl_stapling on;
    ssl_stapling_verify on;
    resolver 223.5.5.5 valid=300s;

    # 还原客户端真实 IP(按 CDN 回源 IP 段填写)
    set_real_ip_from 203.0.113.0/24;
    real_ip_header X-Forwarded-For;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

# 源站 80 端口仅做本机/直连跳转,CDN 回源走 443 不会触发
server {
    listen 80;
    server_name origin.example.com;
    return 301 https://$host$request_uri;
}

CDN 回源参数(控制台字段的等价 YAML 表达,用于核对配置是否一致):

origin:
  address: 203.0.113.10
  protocol: https        # 必须是 https
  port: 443
  host: origin.example.com   # 回源 Host,影响 SNI
  sni: origin.example.com
  verify_cert: true
  follow_redirect: false

edge:
  certificate: fullchain.crt   # 含中间链
  private_key: private.key
  force_https: true            # 跳转在边缘完成
  hsts: max-age=31536000       # 只在边缘下发
  http2: true
  tls_versions: [TLSv1.2, TLSv1.3]

若源站是 Apache,对应关键两行为 SSLCertificateFile /etc/ssl/fullchain.crt 与 SSLCertificateKeyFile /etc/ssl/private.key,并确保 SSLCertificateChainFile 在 2.4.8+ 已并入 fullchain,不要重复指定。改完配置一律先 nginx -t 再 systemctl reload nginx,reload 而非 restart 可避免连接中断。

五、方案对比:四种边缘证书落地方式

方案 有效期 续期方式 适用场景 主要注意点
ZeroSSL 免费 DV(网页导出后上传) 90 天 手动重签 + 重传 CDN 域名少、需要固定证书链与品牌一致 易漏续期,必须设日历提醒;重传有 5–30 分钟推送延迟
ZeroSSL ACME(acme.sh 自动签发) 90 天 自动,可用 --reloadcmd 调 CDN API 域名多、可编程、CI 化运维 需处理云厂商证书上传 API 的限速与幂等
云厂商免费边缘证书 90 天 全自动续期与部署 已在该云内、追求零运维 只能用于该 CDN,无法导出到源站使用
商业 OV / EV 证书 单张最长 398 天 手动或厂商托管 金融、政企合规、需要组织身份展示 需组织验证,签发 1–3 个工作日;同样受 398 天上限约束

选择建议:边缘证书优先用云厂商免费证书(自动续期最省心);需要跨云一致或导出到源站时用 ZeroSSL + acme.sh;只有合规要求才上 OV/EV。回源证书建议独立一张,与边缘证书解耦,避免一次续期失败同时打断两段链路。

六、常见错误排查(含真实报错)

1)curl: (60) SSL certificate problem: unable to get local issuer certificate
浏览器正常但 curl / Java / 微信小程序报错,典型是证书链不完整:CDN 上传了叶子证书而非 fullchain。用第二节的 openssl crl2pkcs7 命令确认链段数,重传 fullchain。

2)ERR_TOO_MANY_REDIRECTS 或 curl: (47) Maximum (50) redirects followed
回源协议选了 HTTP,而源站 80 端口强制 301 到 HTTPS;或回源 Host 填成了加速域名导致回源请求又打回 CDN。用 curl -sIL http://example.com | grep -Ei '^(HTTP/|location:)' 看跳转链,把回源协议改为 HTTPS、回源 Host 改为源站域名。

3)nginx: [emerg] SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
证书与私钥不匹配。用第二节的模数 MD5 比对确认,重新导出配对文件。

4)curl: (51) SSL: no alternative certificate subject name matches target host name 'api.example.com'
证书 SAN 不含该域名。通配符只覆盖一级子域,检查 -ext subjectAltName 输出,必要时重签含该 SAN 的证书。

5)CDN 返回 502 Bad Gateway / 526 Invalid SSL Certificate
回源 HTTPS 握手失败:源站证书过期、自签未放行、回源端口填错(填 80 但协议选 HTTPS)、SNI 与源站证书域名不符。先直连验证:curl -Iv https://origin.example.com --resolve origin.example.com:443:203.0.113.10。

6)acme.sh 报 urn:ietf:params:acme:error:unauthorized
HTTP-01 验证被 CDN 拦截、或验证路径被 301 到 HTTPS 后不可达。临时关闭强制跳转,或改用 DNS-01:acme.sh --issue -d example.com --dns dns_ali --server zerossl。

7)续期后仍显示旧证书
边缘证书未推送成功,或源站进程未重载。源站执行 nginx -t && systemctl reload nginx,CDN 侧重新提交证书并等待推送完成。

8)Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure resource
页面内硬编码 http:// 资源。批量排查:curl -s https://example.com | grep -o 'http://[^"'''> ]*' | sort -u,改为协议相对或 https 绝对地址。

七、效果验证:边缘、回源、评级三件事

第一步验证边缘证书主体与链:

curl -Iv https://example.com 2>&1 | grep -E 'subject|issuer|SSL certificate verify'
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | openssl x509 -noout -issuer -subject -dates

issuer 应为 CDN 厂商的 CA 或 ZeroSSL 中间 CA,且 SSL certificate verify ok。

第二步验证回源段与跳转链:

curl -Iv https://origin.example.com --resolve origin.example.com:443:203.0.113.10
curl -sIL http://example.com | grep -Ei '^(HTTP/|location:)'

期望:跳转链只有一次 301 指向 https://,之后是 200,无回跳。

第三步看评级与协议版本,期望 A 或 A+,且 TLS 1.0/1.1 已关闭:

curl -s 'https://api.ssllabs.com/api/v3/analyze?host=example.com&publish=on&all=done' 
  | jq -r '.endpoints[] | .grade'
openssl s_client -connect example.com:443 -tls1_1 </dev/null   # 应握手失败

最后把到期时间纳入监控,避免 90 天证书静默过期:

openssl x509 -noout -enddate -in fullchain.crt
# 建议 cron 每天检查剩余天数,<15 天告警
openssl x509 -checkend 1296000 -noout -in fullchain.crt || echo 'LESS THAN 15 DAYS'

三项都通过后,再用浏览器无痕模式与小程序真机各验证一次,确认无混合内容、无重定向循环、证书链完整。

常见问题

免费 DV 证书有效期为 90 天,且受 CA/B Forum 规定限制,任何公开信任证书单张最长不超过 398 天。到期前 15 天重新签发,导出 fullchain 后重新上传 CDN,并在源站 reload 进程;建议改用 ACME 自动化续期避免遗漏。

需要。只要回源协议选 HTTPS,CDN 节点就要与源站完成一次 TLS 握手,源站必须有有效且链完整的证书,否则边缘返回 502 或 526。源站可用内部 CA 或自签证书,但需在 CDN 侧放行校验。

典型是证书链不完整:浏览器会自行补链,而 curl、Java 信任库、小程序 SDK 要求服务端下发完整中间链。上传时必须用叶子证书拼接 ca_bundle 生成的 fullchain,而不是只传 certificate.crt。

技术上可以,但源站到 CDN 之间将明文传输,且源站若配置了 80 跳 443,会与 CDN 回源形成重定向死循环,出现 ERR_TOO_MANY_REDIRECTS。生产环境应选 HTTPS 回源,端口 443,并正确填写回源 Host 与 SNI。

可以,但通配符只覆盖一级子域:*.example.com 匹配 a.example.com,不匹配 a.b.example.com。上传前用 openssl x509 -ext subjectAltName 确认加速域名在 SAN 列表中,否则浏览器报名称不匹配。

先确认源站已 reload 且指向新文件:nginx -t 后 systemctl reload nginx;再检查 CDN 控制台证书是否已更新并推送完成,边缘证书推送通常有 5 到 30 分钟延迟。若仍不生效,删除旧证书重新上传并刷新缓存。

内容审核

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