JoySSL SSL 证书 CDN/云加速部署实战:边缘证书、回源 HTTPS 与证书链排查
问题背景与根因:为什么 CDN 场景不能只上传一张证书
CDN/云加速场景存在两段独立的 TLS 连接:第一段是用户浏览器到 CDN 边缘节点,第二段是 CDN 边缘节点回源到源站。很多旧教程只讲在 CDN 控制台上传证书,却忽略回源协议和源站证书,结果出现循环重定向、502/521、Java 和小程序握手失败。JoySSL 是国产 CA,提供免费 DV 与价格亲民的付费证书,中文审核流程和本地化支持对国内用户较友好。需要先明确三个事实:公有 TLS 证书最长有效期受行业限制为 398 天,Let’s Encrypt 证书有效期为 90 天,部署前必须检查到期时间;CDN 边缘证书与源站证书可以不同,但回源 HTTPS 时 CDN 必须能校验源站证书链和域名;强制 HTTPS 跳转应尽量由 CDN 层完成,源站重复跳转容易与回源协议叠加成循环。
常见根因包括:只上传叶子证书而非 fullchain,导致 Android、Java、curl 报链不完整;回源协议选 HTTP,但源站配置了 301 强制 HTTPS,CDN 回源拿到 301 后再回源,形成 ERR_TOO_MANY_REDIRECTS;源站证书 SAN 不覆盖回源 Host,例如证书只有 example.com 而回源 Host 是 www.example.com;续期后只替换了源站文件,没有更新 CDN 边缘证书,或 Nginx 未 reload;私钥与证书不匹配。先执行基础检查:
openssl x509 -in fullchain.pem -noout -subject -issuer -dates
openssl x509 -in fullchain.pem -noout -ext subjectAltName
openssl x509 -in fullchain.pem -noout -modulus | openssl md5
openssl rsa -in example.com.key -noout -modulus | openssl md5
两条 modulus 的 MD5 必须一致,否则证书与私钥不匹配。subjectAltName 必须包含实际访问域名和回源 Host。dates 中的 notAfter 要留足续期窗口,建议剩余 30 天前完成更新。
证书文件准备与格式校验:PEM、KEY、PFX 与 fullchain
从 JoySSL 控制台下载证书包后,通常包含域名证书、中间链和私钥。CDN 上传一般接受 PEM+KEY 或 PFX 两种形式。PEM 方式需要上传 fullchain.pem 和私钥;fullchain 应包含叶子证书与中间 CA,不能只传叶子证书。若使用 PFX,需要把 fullchain 和私钥打包,并设置导入密码。先检查文件头尾和链数量:
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
openssl rsa -in example.com.key -check
openssl pkcs12 -export -out example.com.pfx -inkey example.com.key -in fullchain.pem -certfile chain.pem
第一条命令应能看到叶子证书和至少一个中间 CA 的 subject/issuer。第二条命令输出 RSA key ok 才说明私钥可读。若私钥是 PKCS#8 格式,CDN 通常也支持,但部分老平台只认 PKCS#1,可用 openssl rsa -in key.pem -out key-pkcs1.pem 转换。若需要重新生成 CSR 向 JoySSL 申请证书,可使用:
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'
提交 CSR 后,JoySSL 中文审核流程会完成域名验证并签发。拿到新证书后不要覆盖旧文件前先备份,并用 openssl x509 -noout -serial -dates 记录序列号和有效期。CDN 上传前务必确认 fullchain 中证书顺序为叶子在前、中间 CA 在后;顺序错误时部分客户端仍会报 unable to get local issuer certificate。
CDN 边缘证书上传与回源协议配置
进入 CDN/云加速控制台,找到域名管理中的 HTTPS 配置。边缘证书有两种方式:上传 JoySSL 的 fullchain+私钥,或使用云厂商提供的一键免费边缘证书。若业务要求边缘与源站统一品牌和审计,上传 JoySSL 证书;若只是快速启用 HTTPS,可用厂商免费边缘证书,但源站仍建议部署 JoySSL 证书。上传时选择 PEM+KEY 或 PFX,粘贴 fullchain 和私钥,保存后等待 5-10 分钟下发,检查域名的 CNAME 是否已指向 CDN。
关键步骤在回源配置:回源协议必须选 HTTPS,回源端口 443,回源 Host 要与源站证书 SAN 一致。若源站使用自签证书,需要在 CDN 上传回源 CA 或临时选择忽略校验,但不推荐生产使用忽略校验。强制 HTTPS 跳转在 CDN 层开启后,源站不要再重复配置 301,否则回源协议为 HTTP 时会形成循环。边缘验证命令:
curl -Iv https://example.com
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
curl -Iv --resolve example.com:443:源站IP https://example.com
第一条命令看 issuer 是否为 CDN 边缘证书签发者,subject 是否为访问域名,证书链是否完整。第二条命令可导出边缘节点证书链,检查中间 CA 数量。第三条命令绕过 CDN 直连源站,验证源站 443 是否可用、证书是否覆盖回源 Host。若回源 HTTPS 后出现 502/521,优先检查源站防火墙是否放行 CDN 回源 IP、源站证书是否过期、SNI 是否返回正确证书。
源站同步部署与 Nginx/Apache 配置示例
源站需要部署同一张 JoySSL 证书或云厂商认可的回源证书。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.pem;
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers HIGH:!aNULL:!MD5;
ssl_session_cache shared:SSL:10m;
add_header Strict-Transport-Security 'max-age=300' always;
root /var/www/html;
}
执行 nginx -t 检查语法,然后 systemctl reload nginx。注意 ssl_certificate 必须指向 fullchain.pem,不是只含叶子证书的 cert.pem。HSTS 首次上线建议 max-age 先设为 300 秒,验证无误后再逐步提高。Apache 配置示例:
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
# Apache 2.4.8 之前才需要单独指定链文件
# SSLCertificateChainFile /etc/httpd/ssl/chain.crt
执行 apachectl -t 后 systemctl reload httpd。检查配置实际指向:nginx -T | grep ssl_certificate;apachectl -S。若 CDN 已开启强制 HTTPS,源站 80 跳转可保留也可关闭,但回源协议必须是 HTTPS,且源站 443 必须可访问。源站不要重复做 301 到 HTTPS 之外的其他跳转,避免与 CDN 跳转叠加。
边缘证书与回源证书方案对比表格
| 对比项 | 方案A:CDN 免费边缘证书 + JoySSL 源站证书 | 方案B:JoySSL 边缘证书 + JoySSL 源站证书 | 方案C:仅 HTTP 回源 |
|---|---|---|---|
| 证书来源 | 边缘由云厂商签发,源站由 JoySSL 签发 | 边缘和源站均使用 JoySSL | 边缘有证书,回源明文 |
| 上传格式 | 边缘一键申请,源站上传 fullchain+KEY | 两处均上传 fullchain+KEY 或 PFX | 仅配置边缘证书 |
| 链完整性 | 边缘由厂商维护,源站需自行保证 fullchain | 两处都需保证 fullchain | 不涉及回源链 |
| 回源校验 | CDN 校验 JoySSL 源站证书 | CDN 校验 JoySSL 源站证书 | 不校验,存在明文风险 |
| 续期操作 | 边缘自动,源站手动更新 | 边缘和源站都要更新 | 只更新边缘 |
| 适用场景 | 快速上线、边缘免维护 | 品牌统一、审计要求高 | 不推荐生产使用 |
选择建议:生产环境优先方案B或方案A,必须开启回源 HTTPS。方案C虽然配置简单,但 CDN 到源站链路明文传输,无法满足等保、支付和用户隐私要求。若源站证书由 JoySSL 签发,CDN 回源时通常能正常校验其公共信任链;若源站使用内部 CA,则需要在 CDN 侧上传回源 CA。边缘证书与源站证书可以不同,但都要满足域名匹配和链完整。证书有效期方面,JoySSL 证书以控制台显示为准,Let’s Encrypt 为 90 天,公有 TLS 证书最长不超过 398 天,续期策略应按较短周期设计。
常见错误排查与真实报错
1)curl: (60) SSL certificate problem: unable to get local issuer certificate。说明服务端没有发送中间 CA,常见于只上传叶子证书。解决:CDN 和源站都改用 fullchain.pem,并用 openssl s_client -showcerts 确认链中至少包含一个中间 CA。
2)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)。这是证书与私钥不匹配。执行 openssl x509 -noout -modulus | openssl md5 和 openssl rsa -noout -modulus | openssl md5 对比,不一致就重新下载匹配的私钥。
3)浏览器 ERR_TOO_MANY_REDIRECTS。根因是回源协议选 HTTP,而源站又强制 301 到 HTTPS。解决:回源协议改为 HTTPS,或去掉源站重复跳转,只保留 CDN 层强制 HTTPS。
4)Java 报 javax.net.ssl.SSLHandshakeException: PKIX path building failed。浏览器能自动补链,Java 不会。解决:上传 fullchain,检查中间 CA 是否缺失,并确认 TLS 版本不低于 1.2。
5)小程序报 request:fail ssl hand shake error。检查域名是否备案、证书 SAN 是否匹配、链是否完整、是否启用 TLS 1.2/1.3。6)CDN 502/521。检查源站 443 端口、防火墙、源站证书是否过期、回源 Host 与证书 SAN 是否一致。7)续期后不生效。CDN 控制台重新上传边缘证书,源站替换文件后执行 nginx -t && systemctl reload nginx 或 apachectl -t && systemctl reload httpd,并用 nginx -T | grep ssl_certificate 确认指向新文件。
部署效果验证与监控
完成配置后按清单验证:curl -Iv https://example.com 查看 issuer、subject、TLS 版本和证书链;openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | openssl x509 -noout -subject -issuer -dates -serial 查看边缘证书序列号和到期时间;使用 SSL Labs 测试边缘节点评级,目标 A 或 A+;用 dig 检查多地 CNAME 是否生效;用 curl -Iv –resolve example.com:443:源站IP https://example.com 验证回源证书;浏览器访问确认无循环重定向;用 Java 和小程序各发一次请求验证链完整性。
监控脚本可定期检查到期天数:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate
openssl s_client -connect example.com:443 -servername example.com /dev/null | openssl x509 -noout -serial -dates
建议剩余 30 天触发告警。注意公有 TLS 证书最长有效期 398 天,Let’s Encrypt 为 90 天,不能按旧教程的一年期规划。HSTS 先短 max-age 验证,再逐步提高;OCSP Stapling 和证书透明 CT 在 CDN 边缘通常由厂商处理,源站可保持默认。SSL Labs 只测边缘节点,回源链路要用 –resolve 单独测。多节点 CDN 可能命中不同边缘 IP,建议多地拨测。
续期与自动化更新
JoySSL 证书续期后,从控制台下载新的 fullchain 和私钥。先备份旧文件,再替换源站文件,执行 nginx -t && systemctl reload nginx 或 apachectl -t && systemctl reload httpd。reload 不中断连接,不要直接 restart。检查配置指向:nginx -T | grep ssl_certificate;apachectl -S。随后登录 CDN 控制台更新边缘证书,等待 5-10 分钟下发,用 openssl s_client 对比 serial 是否变化。若使用 Let’s Encrypt 90 天证书,可用 ACME 客户端自动化源站续期,但 CDN 边缘证书仍需通过云厂商 API 或控制台同步;公有 TLS 证书最长 398 天的限制仍然适用。建议建立到期监控和变更记录,避免只更新源站忘记 CDN,或只更新 CDN 忘记源站。
常见问题
可以。CDN 的 HTTPS 配置通常支持 PEM+KEY 或 PFX,上传时选择 fullchain.pem 和匹配私钥,不要只传叶子证书。上传后等待 5-10 分钟下发,用 curl -Iv 和 openssl s_client 检查 issuer、subject 与链是否完整。
先确认源站 443 端口和防火墙放行 CDN 回源 IP,再检查源站证书是否过期、SAN 是否覆盖回源 Host、链是否完整。若源站是自签证书,需在 CDN 上传回源 CA,不要长期关闭校验。
浏览器会自动补链,Java 默认严格校验。服务端必须发送 fullchain,包含叶子证书和中间 CA。用 openssl s_client -showcerts 检查链,并在 CDN 和源站都替换为 fullchain 后重试。
先确认 CDN 控制台已重新上传边缘证书,再检查源站是否替换文件并 reload。用 nginx -T | grep ssl_certificate 确认配置指向新文件,用 openssl s_client 对比 serial 和 dates,CDN 多节点下发通常需要 5-10 分钟。
DV 只验证域名,适合普通 HTTPS 加密;付费证书可能提供更高保障、更长有效期选项和本地化支持。无论哪种,CDN 场景都要保证 fullchain 完整、回源 HTTPS 开启,并注意公有 TLS 证书最长 398 天、Let’s Encrypt 90 天的续期节奏。