跳到主要内容
CDN / 云加速

JoySSL 证书 CDN / 云加速部署实战:边缘证书、回源协议与证书链排查

一、问题背景与根因:为什么 CDN 上装证书总出问题

把 JoySSL 证书「装到 CDN 上」的失败率,明显高于直接装在源站 Nginx 上。原因不在证书本身,而在 CDN 场景下 TLS 是两段彼此独立的链路:

  • 第一段:客户端 ↔ CDN 边缘节点,使用边缘证书,由 CDN 节点直接出示给浏览器;
  • 第二段:CDN 边缘节点 ↔ 源站,由回源协议决定是否加密,由回源证书校验源站身份。

两段由不同配置项控制,任何一段配错,最终现象往往都是「网站打不开」。下面五类根因覆盖了绝大多数工单:

  1. 只配了边缘证书,回源却选了 HTTPS。 源站仍在用自签证书或证书已过期,CDN 回源握手失败,返回 502 / 521 / 525 一类错误,浏览器侧只看到一个 5xx。
  2. 回源协议选 HTTP,源站又开了强制跳转 HTTPS。 CDN 用 HTTP 回源 → 源站 301 到 https → CDN 跟随 → 又回到 HTTP 回源,形成 ERR_TOO_MANY_REDIRECTS 死循环。
  3. 上传的是叶子证书而不是 fullchain。 浏览器具备 AIA 补链能力所以显示正常,但 curl、Java HttpClient、微信小程序、部分 Android WebView 会直接报 unable to get local issuer certificate。
  4. 续期后只换了一端。 新证书只部署到源站,CDN 边缘仍是旧证书;或文件已替换但 Nginx 没 reload,进程仍持有旧证书的内存副本。
  5. 域名覆盖不全。 证书 SAN 只有 example.com,而 CDN 加速域名配了 www.example.com,边缘节点直接拒绝握手。

还要留意有效期规则的变化:公共信任证书单张最长有效期目前为 398 天,按 CA/Browser Forum 已通过的 SC-081 时间表,2026 年 3 月 15 日起缩短至 200 天,2027 年 3 月 15 日起 100 天,2029 年 3 月 15 日起 47 天;Let’s Encrypt 等免费证书固定为 90 天。JoySSL 的免费 DV 属于短期证书档位,意味着续期会成为高频操作,CDN 与源站两端的同步必须流程化,而不能靠人工记忆。

理解了「两段链路 + 两端证书」这个模型,后面的操作基本就是填空题。

二、准备证书文件:PEM、KEY、fullchain 与 PFX 的正确组合

JoySSL 控制台签发后一般给出 .crt(或 .pem)与 .key,部分场景提供 .pfx。各家 CDN 的上传接口对格式要求不同:多数云厂商接受「PEM 证书 + PEM 私钥」两段文本粘贴,少数只接受 PFX 或需要填写密码。先在本机把文件整理干净。

第一步,生成 CSR 并提交(尚未签发时):

openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'

第二步,拼接 fullchain。顺序必须是「站点证书在前、中间证书在后」,颠倒会导致部分客户端校验失败:

cat example.com.crt intermediate.crt > fullchain.pem
grep -c 'BEGIN CERTIFICATE' fullchain.pem   # 正常应为 2(叶证书 + 中间证书)

第三步,校验私钥与证书是否匹配。RSA 用 modulus 比对,ECC 证书改用公钥比对:

openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# ECC 证书改用:
openssl x509 -in fullchain.pem -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5

两组 md5 必须完全一致。第四步,验证链条完整性:

openssl verify -untrusted intermediate.crt example.com.crt
# 期望输出:example.com.crt: OK

第五步,需要 PFX 时再转换(上传完成后记得删除本地 pfx):

openssl pkcs12 -export -out example.com.pfx -inkey example.com.key -in fullchain.pem -passout pass:JoySSL2025
openssl pkcs12 -in example.com.pfx -nodes -out restored.pem

最后确认证书的域名与有效期,避免拿错域名或误用已过期的旧文件:

openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName

整理成三个文件即可:fullchain.pem(同时上传给 CDN 与源站)、example.com.key(私钥,权限设为 600)、intermediate.crt(备用,配 OCSP 装订时使用)。

三、实操:在 CDN / 云加速控制台部署边缘证书

各厂商菜单命名不同,路径基本一致:CDN 控制台 → 域名管理 → 选中加速域名 → HTTPS 配置。下面按通用流程描述,参数名按你的云厂商微调。

  1. 进入 HTTPS 配置,证书来源选「自有证书 / 上传证书」;
  2. 证书内容粘贴 fullchain.pem 全文(含 -----BEGIN CERTIFICATE----- 到 -----END CERTIFICATE-----,中间证书一并粘贴),私钥粘贴 example.com.key 全文;
  3. 若厂商只支持 PFX,上传 example.com.pfx 并填写导出密码;
  4. 保存后等待下发,一般 1–5 分钟,海外节点可能更久;
  5. 开启「强制 HTTPS 跳转」,由 CDN 层完成 301,源站不必重复配置;
  6. 如需 HSTS,在 CDN 侧添加响应头,首次上线建议 max-age=300 观察,稳定后再提升到 31536000 并考虑 preload。

习惯用 API 批量操作的话,多数云厂商提供「上传证书 + 绑定域名」两个接口,用 curl 走一遍即可纳入 CI:

# 示例:先上传证书拿到 CertId,再绑定到加速域名(参数名以厂商文档为准)
jq -n --arg n example.com-2025 --arg c "$(cat fullchain.pem)" --arg k "$(cat example.com.key)" '{name:$n,cert:$c,key:$k}' > payload.json
curl -s -X POST 'https://cdn.example-cloud.com/api/v1/certificates' -H 'Authorization: Bearer '$TOKEN -H 'Content-Type: application/json' -d @payload.json
curl -s -X POST 'https://cdn.example-cloud.com/api/v1/domains/example.com/https' -H 'Authorization: Bearer '$TOKEN -H 'Content-Type: application/json' -d '{"cert_id":"CERT-ID","force_https":true,"origin_protocol":"https"}'

三个容易忽略的细节:其一,私钥不要带密码(加密私钥多数 CDN 不接受),上传前用 openssl rsa -in enc.key -out plain.key 解密;其二,同一张证书可绑定多个加速域名,但每个域名都要单独触发一次下发;其三,泛域名证书 *.example.com 只覆盖一级子域,a.b.example.com 不在覆盖范围内,需要单独写入 SAN。

下发完成后不要急着宣布上线,先按第七节做一遍验证,再切流量。

四、回源协议与源站 Nginx 配置示例

边缘证书配好只解决了第一段链路。第二段链路的关键开关是「回源协议」,通常三选一:

  • HTTP 回源:CDN 到源站明文传输,配置最省事,但公网链路上可被嗅探,且与源站强制跳转 HTTPS 天然冲突;
  • HTTPS 回源:推荐。源站必须持有 CDN 信任的证书(公有证书,或把自签 CA 上传到 CDN 的「回源证书」中);
  • 协议跟随:用户用 HTTPS 访问就 HTTPS 回源,用 HTTP 就 HTTP 回源,适合灰度期,但行为不易预测,不建议长期使用。

源站 Nginx 最小可用配置:

server {
    listen 443 ssl;
    http2 on;
    server_name example.com www.example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.pem;
    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-RSA-AES256-GCM-SHA384;
    ssl_prefer_server_ciphers off;
    ssl_session_cache   shared:SSL:10m;
    ssl_session_timeout 1d;
    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/intermediate.crt;

    # 只允许 CDN 回源网段访问,防止绕过 CDN 直连源站
    allow 1.2.3.0/24;
    deny  all;

    # 还原真实客户端 IP
    set_real_ip_from 1.2.3.0/24;
    real_ip_header   X-Forwarded-For;
    real_ip_recursive on;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $http_x_forwarded_proto;
    }
}
server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;   # 仅当回源协议为 HTTPS 时保留
}

两个坑:一是如果回源协议选了 HTTP,源站这段 80 → 443 的 301 必须删掉,否则就是重定向循环;二是 ssl_stapling 要配合 ssl_trusted_certificate 指向中间证书,否则 OCSP 装订会静默失败。改完执行 nginx -t && nginx -s reload,reload 不会中断现有连接。

五、三类证书与三种回源方式对比

先明确一点:「边缘证书 / 回源证书 / 源站证书」不是同一张证书的三个别名,而是三个位置上的角色。

角色 出示给谁 是否需公有信任 格式要求 更新影响
边缘证书 浏览器 / 客户端 必须,JoySSL DV 即可 PEM + KEY 或 PFX 上传后 1–5 分钟全球下发
回源证书 CDN 节点(校验源站) 公有证书,或上传自签 CA 一般只需公钥部分 需在 CDN 侧单独配置
源站证书 CDN 节点 同上 fullchain.pem + key reload Nginx 后生效

再对比回源方式:

回源方式 链路加密 对源站的要求 性能 适用场景
HTTP 回源 否 关闭强制跳转 HTTPS 握手开销最低 内网 / 专线回源
HTTPS 回源 是 持有 CDN 信任的证书 多一次握手,可长连接复用 默认推荐
协议跟随 视客户端 两种都要支持 行为不确定 灰度期临时使用

最后是证书选型:

类型 验证方式 签发时长 有效期上限 适用场景
JoySSL 免费 DV DNS TXT / 文件验证 数分钟 短期档位(90 天量级) 个人站、测试环境
JoySSL 付费 DV 同上 数分钟至数小时 398 天(2026-03-15 起 200 天) 生产站点,覆盖多域名 / 泛域名
JoySSL OV 域名 + 企业实名核验 1–3 个工作日 同上 对外商业业务,证书内含企业信息

选型结论:CDN 边缘必须用公共信任证书,源站可以复用同一张,省掉一次续期同步;预算紧张时边缘用免费 DV、源站用自签 + 回源 CA 也可行,但要接受两端证书生命周期不同步带来的运维成本。

六、常见错误排查:真实报错与对应命令

1)curl: (60) SSL certificate problem: unable to get local issuer certificate
证书链不完整,CDN 边缘只部署了叶子证书。确认命令:echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null | grep -c 'BEGIN CERTIFICATE',返回 1 即缺中间证书,重新上传 fullchain.pem。

2)curl: (60) SSL: no alternative certificate subject name matches target host name ‘www.example.com’
SAN 未覆盖该域名。用 openssl x509 -in fullchain.pem -noout -ext subjectAltName 核对,缺域名只能重新签发,无法通过配置绕过。

3)nginx: [emerg] SSL_CTX_use_PrivateKey_file(“/etc/nginx/ssl/example.com.key”) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
证书与私钥不配对。回到第二节做 modulus / pubkey 比对,通常是续期时只换了其中一个文件。

4)ERR_TOO_MANY_REDIRECTS 或 310 重定向次数过多
用 curl -I http://example.com 与 curl -I https://example.com 各看一次 Location 头。若 CDN 回源协议为 HTTP、源站 80 端口又 301 到 HTTPS,就是循环根因,二选一即可修复。

5)521 / 525 / 502 回源失败
521 多为源站拒绝连接(端口或安全组问题),525 是回源 SSL 握手失败(源站证书过期 / 自签未被信任)。在源站机器上执行 curl -Iv https://127.0.0.1 -H 'Host: example.com' --insecure 先确认本机 443 可用,再查回源端口是否为 443 或自定义的 8443。

6)ERR_SSL_VERSION_OR_CIPHER_MISMATCH
多为边缘证书尚未下发完成,或 TLS 版本策略过旧。用 openssl s_client -connect example.com:443 -servername example.com -tls1_2 验证,同时检查是否误关了 TLSv1.2。

7)页面样式丢失、控制台报 Mixed Content
用 curl -s https://example.com | grep -o 'http://[^"]*' | head 找出硬编码的 http 资源,改为协议相对或 https 绝对地址。

七、效果验证:五条命令确认部署成功

部署完成后,按顺序执行下面五条命令,全部符合预期才算完成:

# 1. 看边缘节点出示的证书主体与签发者
curl -Iv https://example.com 2>&1 | grep -E 'subject:|issuer:|SSL certificate verify'

# 2. 数证书链段数,返回 2 段说明含中间证书
echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null | grep -c 'BEGIN CERTIFICATE'

# 3. 看有效期与 SAN
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates -ext subjectAltName

# 4. 绕过 CDN 直连源站,单独验证回源链路
curl -Iv --resolve example.com:443:203.0.113.10 https://example.com

# 5. 检查 HSTS 与跳转头
curl -sI https://example.com | grep -iE 'strict-transport-security|location'

再补三项:用 SSL Labs 跑一次边缘节点评级,目标 A 及以上,注意它带缓存,换证书后需等 30 分钟再测;用 curl -s -o /dev/null -w '%{http_code} %{time_total}n' https://example.com 对比开启前后的总耗时,TLS 握手开销通常在 30–80 ms;最后用手机 4G 与微信开发者工具各访问一次,这两个环境对证书链最敏感,能通过基本就全通过了。

另外建议把验证脚本固化到续期流程里:证书更新后自动跑第 1、2、3 条命令,任一条不符合预期就告警,避免「续期成功但线上仍用旧证书」这类静默故障。

常见问题

不必相同,但两端都要被各自的校验方信任。边缘证书必须由公共信任 CA 签发(如 JoySSL DV),因为它要出示给浏览器;源站证书只要 CDN 信任即可,用 JoySSL 证书或把自签 CA 上传到 CDN 的回源证书里都行。复用同一张证书最省事,续期时两端一起换。


浏览器具备 AIA 补链能力,会自动下载缺失的中间证书;curl、Java、小程序不做这件事。说明 CDN 边缘上传的是叶子证书而非 fullchain。用 openssl s_client -showcerts 数一下证书段数,只有 1 段就是缺中间证书,重新上传 fullchain.pem 即可。


用 curl -I 分别请求 http 与 https 两个地址,各看一次 Location 响应头。若 CDN 回源协议为 HTTP、而源站 80 端口又 301 到 HTTPS,就是循环根因。二选一修复:把回源协议改成 HTTPS,或删除源站的强制跳转,统一由 CDN 层做跳转。


依次检查三处:CDN 边缘证书是否重新上传并下发完成、源站 fullchain.pem 是否替换且执行了 nginx -s reload、是否有节点缓存旧 TLS 会话。用 openssl s_client 查 notAfter 日期确认实际生效时间,SSL Labs 有缓存,需等约 30 分钟再测。


个人站、测试环境、内部系统够用。免费 DV 只验证域名控制权,不显示企业信息,且有效期短、续期频繁。对外商业站点建议用付费 DV 或 OV,有效期最长 398 天(2026 年 3 月 15 日起降至 200 天),能显著降低两端证书不同步的风险。


影响很小。CDN 节点与源站之间是长连接复用,TLS 握手只在建连时发生一次;开启 ssl_session_cache 后开销更低。真正影响性能的是回源 RTT 和是否开启 OCSP 装订,建议源站配置 ssl_stapling on 以减少握手延迟。

内容审核

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