JoySSL 证书 CDN / 云加速部署实战:边缘证书、回源协议与证书链排查
一、问题背景与根因:为什么 CDN 上装证书总出问题
把 JoySSL 证书「装到 CDN 上」的失败率,明显高于直接装在源站 Nginx 上。原因不在证书本身,而在 CDN 场景下 TLS 是两段彼此独立的链路:
- 第一段:客户端 ↔ CDN 边缘节点,使用边缘证书,由 CDN 节点直接出示给浏览器;
- 第二段:CDN 边缘节点 ↔ 源站,由回源协议决定是否加密,由回源证书校验源站身份。
两段由不同配置项控制,任何一段配错,最终现象往往都是「网站打不开」。下面五类根因覆盖了绝大多数工单:
- 只配了边缘证书,回源却选了 HTTPS。 源站仍在用自签证书或证书已过期,CDN 回源握手失败,返回 502 / 521 / 525 一类错误,浏览器侧只看到一个 5xx。
- 回源协议选 HTTP,源站又开了强制跳转 HTTPS。 CDN 用 HTTP 回源 → 源站 301 到 https → CDN 跟随 → 又回到 HTTP 回源,形成
ERR_TOO_MANY_REDIRECTS死循环。 - 上传的是叶子证书而不是 fullchain。 浏览器具备 AIA 补链能力所以显示正常,但 curl、Java HttpClient、微信小程序、部分 Android WebView 会直接报
unable to get local issuer certificate。 - 续期后只换了一端。 新证书只部署到源站,CDN 边缘仍是旧证书;或文件已替换但 Nginx 没 reload,进程仍持有旧证书的内存副本。
- 域名覆盖不全。 证书 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 配置。下面按通用流程描述,参数名按你的云厂商微调。
- 进入 HTTPS 配置,证书来源选「自有证书 / 上传证书」;
- 证书内容粘贴
fullchain.pem全文(含-----BEGIN CERTIFICATE-----到-----END CERTIFICATE-----,中间证书一并粘贴),私钥粘贴example.com.key全文; - 若厂商只支持 PFX,上传
example.com.pfx并填写导出密码; - 保存后等待下发,一般 1–5 分钟,海外节点可能更久;
- 开启「强制 HTTPS 跳转」,由 CDN 层完成 301,源站不必重复配置;
- 如需 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 以减少握手延迟。