CDN SSL 证书配置全流程:上传证书、回源 TLS、排错与验证(2025 版)
CDN SSL 证书配置的核心是两段链路:用户到边缘使用你上传的证书,边缘到源站由回源协议决定;边缘证书必须上传完整证书链(叶子证书 + 中间 CA),否则 Android 与 curl 会报 unable to get local issuer certificate。 最低 TLS 版本设为 1.2、开启 TLS 1.3 与 HTTP/2,Nginx 源站采用 Mozilla SSL Configuration Generator v5.7 的 intermediate 套件,ssl_session_cache shared:SSL:10m,可把 SSL Labs 评级从 B 提升到 A。 Let's Encrypt 证书有效期 90 天,其 OCSP 响应服务已于 2025-08-06 停止,不要再依赖其 stapling;用 acme.sh --cron 每天检查,剩余 30 天自动续期并调用 CDN API 重传。 Cloudflare 525 是回源握手失败,526 是源站证书无法验证;切换 Full (strict) 前先把 Cloudflare Origin CA 或公有 CA 证书装到源站。 证书部署后 1-10 分钟生效,用 openssl s_client -showcerts 确认证书张数为 2-3 张,curl -w '%{ssl_verify_result}' 返回 0 即校验通过。
为什么 CDN 上配好证书仍然报错?6 个高频根因
控制台显示”证书已部署”,浏览器却报 ERR_CERT_AUTHORITY_INVALID,先查什么?
先查证书链是否完整,这是 CDN SSL 证书配置最高频的失败点。据 Let’s Encrypt 文档,ACME 客户端产出的 fullchain.pem 必须整链上传,只传 cert.pem(叶子证书)会让边缘只下发一张证书。缺少中间 CA(Let’s Encrypt R10/R11、DigiCert Global G2、Sectigo RSA DV G1 等)时,桌面 Chrome 常因能”链式补全”而显示正常,但 Android 7 以下、Java 8u 早期版本、curl 会直接报 unable to get local issuer certificate。正常链长度为 2–3 张(叶子 + 中间 CA,可含交叉签名),用以下命令统计并验证(OpenSSL 1.1.1 / 3.x 通用,默认读取系统信任库):
# 1) 统计边缘下发的证书张数:正常为 2~3;返回 1 说明缺中间 CA
openssl s_client -connect www.example.com:443 -servername www.example.com
-showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE"
# 2) 严格校验链:链断裂时直接失败并打印 verify error
openssl s_client -connect www.example.com:443 -servername www.example.com
-verify_return_error </dev/null
# 典型报错:verify error:num=20:unable to get local issuer certificate
# verify error:num=21:unable to verify the first certificate
为什么”边缘正常”不等于”回源正常”?边缘证书与回源证书是两套完全独立的体系:用户 → CDN 边缘使用你在控制台上传的证书,CDN 边缘 → 源站则由回源协议决定。回源选 HTTPS 时,源站证书必须能被 CDN 节点校验(有效期、域名匹配、链完整),否则 Cloudflare 回源报 525 SSL Handshake Failed、阿里云 CDN 报 502,而用户侧看到的只是一个无信息的 5xx。
| 对比维度 | 边缘证书 | 回源证书 |
|---|---|---|
| 校验方 | 终端浏览器 / 移动 SDK | CDN 回源节点 |
| 配置位置 | CDN 控制台证书管理,手动上传或托管签发 | 源站 Web 服务器(Nginx/Apache)或对象存储 |
| 失败表现 | 浏览器证书错误页、curl 退出码 60 |
Cloudflare 525、阿里云 502、腾讯云 514 |
| 验证命令 | openssl s_client -connect 域名:443 -servername 域名 |
openssl s_client -connect 源站IP:443 -servername 加速域名 |
SNI 与泛域名边界:*.example.com 为什么不覆盖 a.b.example.com?同一 IP 靠 SNI 区分证书,Windows XP 与 Android 4.x 不发 SNI,只能拿到默认站点证书;同时通配符证书按 RFC 6125 只匹配一级标签,*.example.com 覆盖 a.example.com,不覆盖 a.b.example.com。若域名不在 SAN 列表内,Chrome 报 ERR_CERT_COMMON_NAME_INVALID、Firefox 报 SSL_ERROR_BAD_CERT_DOMAIN。可用 openssl s_client -noservername 模拟无 SNI 客户端,或用 openssl x509 -noout -ext subjectAltName 核对 SAN 条目。
协议与套件不匹配会报什么?RFC 8996(2021 年 3 月)已正式弃用 TLS 1.0/1.1,但部分 CDN 默认配置仍保留;反过来,源站只支持 TLS 1.0 而边缘最低要求 TLS 1.2 时,回源握手失败,浏览器侧表现为 ERR_SSL_VERSION_OR_CIPHER_MISMATCH。用 openssl s_client -tls1_1 探测最低版本,握手成功即说明未关闭旧协议。
证书没错、协议也对,为什么签发或访问仍被拦?三类前置条件:中国大陆 CDN 加速域名必须先完成 ICP 备案,否则域名无法添加或解析不生效;CAA 记录(RFC 8659)会限制可签发 CA,域名的 CAA 未放行 letsencrypt.org 时签发直接失败,可用 dig +short CAA example.com 查看;金融场景还涉及国密 SM2 双证书部署,需边缘同时支持 RSA 与 SM2 套件。最后一类是混合内容与 HSTS:HTTPS 页面引用 http:// 资源会被浏览器主动升级或拦截,而 HSTS 一旦下发 max-age=31536000 并进入 preload 列表,回退需将 max-age 改为 0 并等待浏览器更新,周期以月计。
CDN SSL 证书配置的 7 个实操步骤(从清点到灰度)
做 CDN SSL 证书配置时,最常被问到的三个问题是:到底该买泛域名还是多域名 SAN?证书上传后浏览器为什么还报证书链不完整?灰度怎么做才不至于让全站不可用?下面这 7 步是从清点到灰度的完整顺序,每一步都可以直接复制执行。先看选型,据 Let’s Encrypt 文档,单张证书最多包含 100 个域名,默认签发一般给 3–5 个 SAN 名额,超出需要额外付费。
| 证书形态 | 适用 host | 典型价格/周期 | 关键限制 |
|---|---|---|---|
| 单域名 DV | 仅 www 或仅 api | 免费,90 天 | 新增子域就要重签 |
| 多域名 SAN | www + api + static + m | 默认 3–5 个,可扩到 100 | 主域名变更需重新签发 |
| 泛域名 *.example.com | 子域数量不确定、动态扩容 | 只能 DNS-01 验证 | 不覆盖 example.com 本身,需额外加一条 -d |
| OV / 国密双证书 | 金融、政务、等保场景 | 1–3 个工作日,需企业实名 | CDN 边缘须支持 SM2 套件 |
步骤 1:清点域名。不要凭记忆列 host,先从 DNS 区域和日志里拉真实数据:
# 逐个子域确认解析是否存在,避免给不存在的 host 买 SAN 名额
for h in www api static m; do printf "%-8s " "$h"; dig +short "$h.example.com" | head -1; done
# 从访问日志反查实际被请求的 Host 头(需日志格式含 $host)
zcat -f /var/log/nginx/access.log* | awk '{print $2}' | sort | uniq -c | sort -rn | head -20
步骤 2:签发证书。CDN 域名通常不解析到源站,HTTP-01 走不通,优先 DNS-01。acme.sh 3.0.x 一行搞定:
# acme.sh 3.0.x + 阿里云 DNS,签发泛域名 + 裸域
export Ali_Key="LTAI5t****" Ali_Secret="****"
acme.sh --issue --dns dns_ali -d example.com -d '*.example.com'
--keylength ec-256 --server letsencrypt
# 安装时把私钥和全链分别落到固定路径,方便上传
acme.sh --install-cert -d example.com --ecc
--key-file /etc/ssl/privkey.pem
--fullchain-file /etc/ssl/fullchain.pem
--reloadcmd "echo reloaded"
# certbot 2.x 等价写法;2.0 起 --key-type 默认已是 ecdsa
certbot certonly --manual --preferred-challenges dns
-d example.com -d '*.example.com' --key-type ecdsa
商业证书交付的一定是 fullchain.pem(叶子证书在前、中间证书在后)与 privkey.pem,私钥为 RSA 2048 或 ECDSA P-256。
步骤 3:本地校验。上传前把证书链和密钥配对关系验证完,能省掉一轮线上排错:
# 1) 链完整性,期望输出 "fullchain.pem: OK"
openssl verify -CAfile chain.pem -untrusted fullchain.pem fullchain.pem
# 2) RSA 证书与私钥比对,两行 MD5 必须完全一致
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in privkey.pem | openssl md5
# 3) ECDSA 证书用公钥比对
openssl x509 -noout -pubkey -in fullchain.pem | openssl md5
openssl pkey -pubout -in privkey.pem | openssl md5
真实报错:
error 20 at 0 depth lookup: unable to get local issuer certificate意味着中间证书缺失或顺序颠倒,按 OpenSSL 文档,fullchain 必须把叶子证书放在最前。
步骤 4:上传绑定。阿里云 CDN 走「域名管理 → HTTPS 配置 → 证书上传」,腾讯云走「CDN → 域名配置 → HTTPS 配置」,AWS CloudFront 只能用 us-east-1 的 ACM 证书,传错区域会报 InvalidViewerCertificate: The specified SSL certificate ... must be in US East (N. Virginia)。上传前确认 PEM 为 Base64 编码、私钥无口令(不含 Proc-Type: 4,ENCRYPTED)。
步骤 5:设置边缘参数。最低 TLS 版本选 1.2(默认常兼容 1.0/1.1,需手动关闭),同时开启 TLS 1.3(RFC 8446)与 HTTP/2;有商业证书时开 OCSP stapling。HSTS 按 RFC 6797 先试运行:
# 第一阶段:max-age=300,观察 24 小时
Strict-Transport-Security: max-age=300
# 第二阶段:无异常后升到一年,再加 includeSubDomains
Strict-Transport-Security: max-age=31536000; includeSubDomains
注意 preload 与 includeSubDomains 一旦下发,回退成本极高,务必放在最后一步。
步骤 6:配置回源。回源协议选 HTTPS、端口 443,回源 SNI 必须显式填源站域名,否则多证书源站会返回默认站点证书。源站是自签证书时,把源站 CA 证书上传到 CDN 的「回源证书信任列表」;不想改源站,就临时改 HTTP 回源,并把 CDN 官方回源 IP 段加进源站白名单。
步骤 7:灰度与回滚。先只对 1 个子域或 1% 流量开启,10 分钟内盯两个指标:CDN 侧 5xx 比例与 TLS 握手失败数。正常后再全量。旧证书保留 7 天,并记录指纹,方便回滚后比对:
# 记录 SHA-256 指纹,回滚时用它确认 CDN 边缘生效的是哪张证书
openssl x509 -noout -fingerprint -sha256 -in fullchain.pem
# 线上核对:实际下发的证书指纹是否已更新
echo | openssl s_client -connect www.example.com:443 -servername www.example.com 2>/dev/null
| openssl x509 -noout -fingerprint -sha256 -dates
这套顺序的核心是「本地能验证的绝不留到线上」:链完整性、密钥配对、指纹三项在步骤 3 和步骤 7 各做一次,CDN SSL 证书配置的绝大部分故障就消解在上传之前了。
配置与命令示例:Nginx 源站、云 CLI 与验证命令
源站的 Nginx 该怎么写,才能既通过 CDN 回源校验、又不给自己留下安全债?
把证书链与私钥放到固定路径,并套用 Mozilla SSL Configuration Generator v5.7 的 intermediate 模板,是目前最省心的组合。下面的片段在 Nginx 1.24.x 与 1.26.x stable 上均可用;注意 ssl_prefer_server_ciphers 的官方默认值就是 off,在 TLS 1.3 下该指令本就不起作用,保持 off 能让浏览器优先选 CHACHA20,对移动端更友好(据 Nginx 官方文档 ngx_http_ssl_module)。
# /etc/nginx/conf.d/static.conf
server {
listen 443 ssl;
# Nginx 1.25.1+ 用 http2 on; 1.24.x 请改写为 listen 443 ssl http2;
http2 on;
server_name static.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem; # 站点证书 + 中间证书,顺序不可颠倒
ssl_certificate_key /etc/nginx/ssl/privkey.pem; # chmod 600,属主 root
ssl_trusted_certificate /etc/nginx/ssl/chain.pem; # 仅用于校验 OCSP stapling 响应
ssl_protocols TLSv1.2 TLSv1.3;
# Mozilla SSL Configuration Generator v5.7, intermediate 套件
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m; # 1m ≈ 4000 个会话,10m 为常用值
ssl_session_timeout 1d;
ssl_session_tickets off; # 关闭 ticket,避免削弱前向保密
ssl_stapling on;
ssl_stapling_verify on;
resolver 223.5.5.5 119.29.29.29 valid=300s; # stapling 需自行解析 OCSP 地址
resolver_timeout 5s;
}
关于 stapling 有个 2025 年的新变化必须知道:据 Let’s Encrypt 官方公告,其 OCSP 服务已于 2025-08-06 停止,新签发证书不再带 OCSP URL,Nginx 会记录 ssl_stapling "ignored, no OCSP responder URL in the certificate"。因此 Let’s Encrypt 证书上这三行 stapling 配置可直接注释掉,只有商业 CA 证书才需要保留——这也是做 cdn ssl证书配置 时最容易被照抄旧教程坑到的一点。
用云 CLI 上传证书,各家的参数差在哪?
# 阿里云 CLI >= 3.0.200:证书内容直接传文件正文
aliyun cdn SetDomainServerCertificate
--DomainName static.example.com
--ServerCertificateStatus on
--ServerCertificateName le-2025
--CertType upload
--ServerCertificate "$(cat /etc/nginx/ssl/fullchain.pem)"
--PrivateKey "$(cat /etc/nginx/ssl/privkey.pem)"
# 腾讯云 CLI:CertId 来自 ssl 模块上传接口的返回值
tccli cdn UpdateDomainConfig --Domain static.example.com --region ap-guangzhou
--Https '{"Switch":"on","CertId":"AbCd1234","Http2":"on","TlsVersion":["TLSv1.2","TLSv1.3"]}'
# AWS:CloudFront 只认 us-east-1 的 ACM 证书
aws acm request-certificate --domain-name '*.example.com'
--validation-method DNS --region us-east-1 --query CertificateArn --output text
| 云厂商 | CLI 版本要求 | 证书标识字段 | TLS 版本参数 |
|---|---|---|---|
| 阿里云 CDN | aliyun-cli ≥ 3.0.200 | ServerCertificateName(自定义) |
域名 HTTPS 配置项 |
| 腾讯云 CDN | tccli 最新版 | CertId(上传接口返回) |
TlsVersion 数组 |
| AWS CloudFront | aws-cli v2 | AcmCertificateArn |
MinimumProtocolVersion: TLSv1.2_2021 |
配完怎么证明真的生效?两条命令足够,注意 ssl_verify_result 为 0 才代表链完整可信:
openssl s_client -connect static.example.com:443 -servername static.example.com
-showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
# 期望:subject=CN = static.example.com issuer=... Let's Encrypt ... 且 notAfter 未过期
curl -sI https://static.example.com -o /dev/null -w '%{http_code} %{ssl_verify_result}n'
# 期望输出:200 0
若 Nginx reload 时报 SSL_CTX_use_PrivateKey_file() failed ... key values mismatch,说明 fullchain.pem 与 privkey.pem 不配对,用 openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与私钥同法比对即可定位——这正是回源 TLS 握手 502 的高频成因。
证书类型、托管方式与 TLS 参数怎么选?对比表
Q:DV、OV、EV 三种证书,价格相差十倍,到底该怎么选?先看签发链路和浏览器实际表现,再决定是否为“组织身份”付溢价。据 CA/Browser Forum 基线要求(Baseline Requirements),三类证书的加密强度完全一致,差别只在于身份验证深度和证书里写不写组织名。
| 类型 | 验证内容 | 签发耗时 | 参考价格(2025 年) | 浏览器表现 |
|---|---|---|---|---|
| DV | 仅域名控制权(HTTP-01 / DNS-01 / TLS-ALPN-01) | 1–10 分钟 | ¥0–300/年 | 仅显示锁标,无组织信息 |
| OV | 工商实名 + 电话回拨核验 | 1–3 个工作日 | ¥800–3000/年 | 与 DV 视觉无差别,O 字段需在证书详情中查看 |
| EV | OV 基础上加严人工尽调 | 3–7 个工作日 | ¥3000–8000/年 | Chrome 77(2019)起取消绿色组织名展示 |
Q:一张证书能覆盖多少域名?泛域名能跨级吗?单域名证书只含 1 个 FQDN;多域名(SAN)证书默认包含 3–5 个,可按需追加至 100 个(多数 CDN 平台对上传证书的 SAN 上限也是 100)。泛域名 *.example.com 只匹配一级子域,既不匹配裸域 example.com(部分 CA 会额外赠送该 SAN,需在下单时确认),也不匹配 a.b.example.com;价格约为单域名的 3–5 倍,所以“泛域名 + 裸域”组合是常见做法。
Q:证书交给 CDN 托管,还是上传自有证书?这是 CDN SSL 证书配置里最容易踩坑的一步——很多平台不提供“托管证书导出”能力,一旦要迁移或多 CDN 灰度,就得重新签发。
| 维度 | CDN 平台托管(免费证书) | 上传自有证书 |
|---|---|---|
| 续期 | 全自动,通常到期前 30 天重签 | 手动或 ACME 脚本 + 平台 API |
| 私钥归属 | 平台生成并保管 | 自己,私钥不出内网 |
| 可控性 | 低:不能指定 CA、密钥算法、有效期 | 高:可选 RSA 2048/4096 或 ECDSA P-256,可控制 OCSP/CRL |
| 适用场景 | 中小站点、快速上线 | 多 CDN 并存、等保/合规审计场景 |
| 限制 | 不能导出,部分平台不支持泛域名 | 受大小与格式限制:通常 PEM ≤ 64 KB,仅“叶子证书 + 中间证书”,不支持加密私钥 |
Q:最低 TLS 版本该定 1.2 还是 1.3?据 RFC 5246,TLS 1.2 配合 ECDHE + AES-GCM 的兼容性最好,可覆盖 99% 以上的现代客户端;TLS 1.3(RFC 8446)把握手压缩到 1-RTT,并支持 0-RTT 早期数据,但 RFC 8446 附录 E.5 明确提示其存在重放风险,建议只对幂等的静态 GET 请求开启。回源侧同理:源站 Nginx 1.23.4 起 ssl_protocols 默认值已是 TLSv1.2 TLSv1.3,而 ssl_early_data 默认 off。
# 判断证书类型:DV 无 O= 字段,策略 OID 为 2.23.140.1.2.1;OV 为 2.23.140.1.2.2;EV 为 2.23.140.1.1
openssl x509 -in cdn.crt -noout -subject -ext certificatePolicies
# 期望输出(OV):subject=CN = cdn.example.com, O = Example Co., Ltd., C = CN
# certificatePolicies: Policy: 2.23.140.1.2.2
# 确认 CDN 节点已禁用 TLS 1.0/1.1(应握手失败,返回 protocol version alert)
openssl s_client -connect cdn.example.com:443 -servername cdn.example.com -tls1_1 &1 | head -3
Q:免费证书够用吗?还要额外算请求费?据 Let’s Encrypt 官方文档,其证书有效期 90 天、无 SLA,且自 2025 年起逐步停止 OCSP 支持(吊销状态改由 CRL 承载),同年还推出了可选的 6 天短周期 profile。需要发票、赔付条款或对外承诺可用性的业务,应选商业 DV(有效期 1–2 年)。另外 CA/Browser Forum 的 SC-081 计划将证书最长有效期在 2026 年降至 200 天、2027 年 100 天、2029 年 47 天——这进一步抬高了“平台自动续期”的价值,做 CDN SSL 证书配置时优先选支持自动重签的方案。
成本别只算证书钱:阿里云、腾讯云 CDN 的 HTTPS 请求数约 ¥0.05/万次起,按日均 100 万次请求估算,月请求量 3000 万次,月增约 ¥150,需与证书费用一并计入预算。参数侧可直接参考 Mozilla SSL Configuration Generator 的 intermediate 档:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256 加 ssl_ecdh_curve X25519:prime256v1,在 TLS 1.2 客户端覆盖与性能之间取得平衡。
常见报错与排查:从 ERR_CERT_AUTHORITY_INVALID 到 525
把 cdn ssl 证书配置做完之后,真正耗时的是排错。先记住一个判断原则:报错出现在浏览器端,多半是边缘证书链问题;报错出现在 CDN 回源侧(52x 系列),问题在源站。下面按真实搜索问句逐条拆。
为什么浏览器报 NET::ERR_CERT_AUTHORITY_INVALID,curl 报 unable to get local issuer certificate?因为上传时只给了叶子证书,缺中间证书,客户端无法把链补到受信任根。按 Let’s Encrypt 的 Chain of Trust 说明,服务端必须下发「叶子 + 中间」,根证书不要拼进去(客户端本地已有)。修复与验证:
- APP/小程序 HTTPS · SSL网站加密证书 · CA证书配置
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
- SSL证书安装服务 · 腾讯云 HTTPS 部署 · 证书过期更新
# 1) 拼接:叶子在前,中间证书在后(顺序错也会失败)
cat leaf.crt intermediate.crt > fullchain.pem
# 2) 上传后在边缘侧验证,张数应为 2~3 张
openssl s_client -connect cdn.example.com:443 -servername cdn.example.com
-showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE"
# 3) 严格校验链是否可验证
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt
-untrusted intermediate.crt leaf.crt
ERR_SSL_VERSION_OR_CIPHER_MISMATCH 是证书坏了吗?不是。它表示客户端与边缘没有共同协议或套件,最常见原因是 CDN 最低 TLS 版本被设成 1.3,而客户端只支持 1.2(RFC 8446 定义 TLS 1.3,但老旧 Android/爬虫仍停留在 1.2)。把最低版本回调到 TLS 1.2(多数 CDN 默认值即 1.2,套件可参考 Mozilla SSL Configuration Generator 的 intermediate 配置)后复现验证:
# 指定 1.2 握手;若返回 alert handshake failure / no protocols available
# 说明边缘已禁用该版本
openssl s_client -connect cdn.example.com:443 -servername cdn.example.com
-tls1_2 </dev/null
Cloudflare 525 和 526 差在哪?525 是回源 443 握手失败,先查源站是否只监听 HTTP、安全组是否放行 CDN 回源段、源站是否要求 SNI;526 是源站证书无效(过期、自签、非公有 CA)。切到 Full (strict) 之前,按 Cloudflare 文档先安装 Cloudflare Origin CA 证书(最长 15 年有效期,仅被 Cloudflare 信任)。
| 报错 | 发生层 | 根因 | 首选验证 |
|---|---|---|---|
| ERR_CERT_AUTHORITY_INVALID / curl (60) | 边缘 → 浏览器 | 缺中间证书或链顺序错 | openssl s_client -showcerts |
| ERR_SSL_VERSION_OR_CIPHER_MISMATCH | 边缘 → 浏览器 | 最低 TLS 版本过高 / 套件不重叠 | -tls1_2 复现 |
| 525 SSL handshake failed | CDN → 源站 | 源站未开 443、防火墙、SNI 不匹配 | openssl s_client -connect 源站IP:443 -servername 域名 |
| 526 Invalid SSL certificate | CDN → 源站 | 源站证书过期或非公有 CA | 换 Origin CA 后重试 |
| ERR_TOO_MANY_REDIRECTS | 跳转规则 | Flexible 模式 + 源站强制 HTTPS 循环 | 改 Full (strict),源站只收 443 |
上传提示「证书与私钥不匹配」怎么办?RSA 比对 modulus,ECDSA 比对公钥指纹;私钥带口令时 CDN 通常无法读取,先去密再上传:
# RSA:两个 md5 必须一致
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in privkey.pem | openssl md5
# ECDSA / 通用:比对公钥
openssl x509 -noout -pubkey -in fullchain.pem | openssl md5
openssl pkey -in privkey.pem -pubout | openssl md5
# 去除私钥口令
openssl pkey -in key.pem -out key-nopass.pem
页面一半加载不出来,控制台报 Mixed Content 怎么批量修?先加响应头让浏览器自动升级请求,再清理 CDN 缓存里的硬编码 http 资源:
# Nginx:对所有响应下发,注意 always 保证错误页也生效
add_header Content-Security-Policy "upgrade-insecure-requests" always;
最后提醒:cdn ssl证书配置 完成后别只测首页,用 openssl s_client -showcerts 与 curl -sSI https://cdn.example.com/ 各跑一遍,确认链张数、协议版本与 strict-transport-security 响应头同时到位。
怎么确认 CDN 证书配置生效?6 种验证手段
证书传完、控制台显示“已部署”,并不等于全网生效。CDN 是分布式系统,配置下发到边缘节点有秒级到分钟级的延迟,而且不同节点可能处于灰度中。下面 6 种手段按“从单点到全网、从静态到持续”的顺序排列,建议每次更换证书后至少跑完前 4 项。
| 手段 | 验证目标 | 判定标准 | 耗时 |
|---|---|---|---|
| openssl s_client -showcerts | 证书链完整性 | BEGIN CERTIFICATE 计数为 2 或 3 | <1 s |
| 多 IP 逐一握手 | 边缘节点一致性 | serial 与 notAfter 全部相同 | 5–30 s |
| testssl.sh / nmap | 协议版本与加密套件 | 无 TLS 1.0/1.1、有 TLS 1.3、无 RC4/3DES | 30–120 s |
| curl -w | HTTP 层与握手时延 | http_version=2、ssl_verify_result=0 | <1 s |
| SSL Labs | 第三方综合评级 | A 或 A+ | 2–3 min |
| blackbox_exporter | 到期与可用性持续监控 | 剩余有效期 > 30 天 | 常驻 |
证书链到底传全了吗?先数证书张数
# OpenSSL 1.1.1 / 3.x 均适用;-servername 必须带,否则 SNI 未命中会拿到默认证书
openssl s_client -connect cdn.example.com:443 -servername cdn.example.com -showcerts </dev/null 2>/dev/null
| grep -c 'BEGIN CERTIFICATE'
# 期望输出 2 或 3:叶子证书 + 中间证书(+ 可选根证书)
# 输出 1 是最常见的配置事故:只上传了域名证书,漏了中间 CA
# 再做一次严格校验,让 openssl 以非零退出码暴露问题
openssl s_client -connect cdn.example.com:443 -servername cdn.example.com -verify_return_error </dev/null
# 通过时末尾为 "Verify return code: 0 (ok)"
# 失败典型报错:
# verify error:num=21:unable to verify the first certificate → 缺中间证书
# verify error:num=20:unable to get local issuer certificate → 同上,客户端找不到签发者
# verify error:num=10:certificate has expired → 边缘节点仍在用旧证书
据 OpenSSL 文档,-showcerts 会打印服务端发送的全部证书,因此计数直接反映链的完整度;浏览器有 AIA 补链能力,手机 App 和老版本 Java 客户端没有,这就是“浏览器正常但 App 报 SSLHandshakeException”的根因。
不同边缘节点拿到的是同一张证书吗?
for ip in $(dig +short cdn.example.com A | head -5); do
echo "== $ip"
openssl s_client -connect $ip:443 -servername cdn.example.com </dev/null 2>/dev/null
| openssl x509 -noout -serial -dates -fingerprint -sha256
done
# 各 IP 的 serial / notAfter 必须完全一致
# 出现不一致 = 部分节点还没拉到新证书,属于灰度未收敛,继续等或手动刷新缓存
跨地域可以配合 17CE、ITDOG 做 HTTPS 拨测,重点看“证书到期时间”这一列是否全表统一。注意 dig +short 遇到 CNAME 链时可能只返回 CNAME,必要时加 A 类型限定。
协议版本和加密套件达标了吗?
# testssl.sh 3.2(2024-05 发布)
./testssl.sh --severity HIGH cdn.example.com
# 逐项看:TLS 1.0/1.1 应为 "not offered";TLS 1.3 应为 offered
# 出现 RC4 / 3DES / EXPORT 会被标红,直接拖低 SSL Labs 评级
nmap --script ssl-enum-ciphers -p 443 cdn.example.com
# 末尾输出 "least strength: A";若显示 TLSv1.0: 则说明旧协议没关
HTTP 层是否真的走了 HTTP/2?
curl -sI https://cdn.example.com -o /dev/null
-w '%{http_version} %{ssl_verify_result} %{time_appconnect}n'
# 期望形如 "2 0 0.152"
# http_version=1.1 → 边缘未启 HTTP/2 或 ALPN 被中间设备剥离
# ssl_verify_result 非 0 → 证书链或域名不匹配(变量需 curl ≥ 7.52.0)
# time_appconnect 通常 100–300 ms,明显偏高说明回源或 OCSP 拖慢了握手
第三方评分掉到 B 是什么原因?
据 Qualys SSL Labs 评级文档,扫描约 2–3 分钟;A/A+ 的硬性条件是证书链完整、最低 TLS 1.2、启用 HSTS、无已知漏洞套件。实践中最常见的降级原因就是 TLS 1.0/1.1 未关闭——很多 CDN 的默认配置仍兼容旧协议,需要手动在控制台把最低版本改成 TLS 1.2。A+ 还要求 HSTS 的 max-age ≥ 6 个月并包含子域。
怎么在证书过期前 30 天收到告警?
# blackbox_exporter v0.25.0 + Prometheus
# prometheus.yml
- job_name: 'cdn-tls'
metrics_path: /probe
params: {module: [https_2xx]}
static_configs: [{targets: ['https://cdn.example.com']}]
relabel_configs:
- {source_labels: [__address__], target_label: __param_target}
- {source_labels: [__param_target], target_label: instance}
- {target_label: __address__, replacement: 'blackbox-exporter:9115'}
# 告警规则:probe_ssl_earliest_cert_expiry 为 Unix 时间戳(秒)
- alert: CDNCertExpiringSoon
expr: probe_ssl_earliest_cert_expiry - time() < 86400 * 30
for: 1h
Zabbix 可用内置 web.certificate.get 检查项或自定义脚本每日巡检,同时把证书的 SHA-256 指纹写入 CMDB——指纹变化即代表有人换了证书,能在故障复盘时快速定位变更来源。这套“指纹 + 到期时间”双指标,也是后续把 CDN 证书纳入统一证书生命周期管理(ACME 自动续签、回源 TLS 校验)的基础。
续期、多 CDN 一致性与国密:上线后的 5 件事
证书还没到期,为什么 CDN 上已经是旧证书了?因为 CDN 节点不会主动回源拉取证书——续期只解决“签出新证书”,把新证书推回每一家 CDN 才是 cdn ssl证书配置 里最容易漏的一步。下面这 5 件事按上线后的时间顺序排列。
1. 自动续期:Let’s Encrypt 90 天有效期,为什么建议提前 30 天?据 Let’s Encrypt 官方文档,证书有效期 90 天,官方建议在剩余 30 天左右续期,留出重试与人工介入窗口(2025 年 LE 另提供可选的 6 天 shortlived 证书,需显式指定 profile,默认仍为 90 天)。acme.sh 与 certbot 的默认阈值并不相同:
| 对比项 | acme.sh 3.x | certbot 2.x/3.x |
|---|---|---|
| 默认续期阈值 | 剩余 60 天(--days 可调) |
剩余 30 天(renew_before_expiry 可调) |
| 定时机制 | 安装时写入 crontab,每日 00:00 跑 --cron |
依赖 systemd timer 或自定义 cron 跑 renew |
| 部署钩子 | --reloadcmd / --deploy-hook |
--deploy-hook 或 renewal-hooks/deploy/ 目录 |
# acme.sh:安装定时任务(每日 00:00 执行一次 --cron 检查)
acme.sh --install-cronjob
# 手动触发一次,确认续期链路与 reloadcmd 都正常
acme.sh --cron --home ~/.acme.sh
# certbot:deploy-hook 负责把新证书重传给 CDN,失败重试 3 次并告警
# 保存为 /etc/letsencrypt/renewal-hooks/deploy/cdn-upload.sh 并 chmod +x
#!/usr/bin/env bash
set -euo pipefail
DOMAIN="cdn.example.com"
CERT="/etc/letsencrypt/live/${DOMAIN}/fullchain.pem"
KEY="/etc/letsencrypt/live/${DOMAIN}/privkey.pem"
for i in 1 2 3; do
cdn-cli cert upload --domain "$DOMAIN" --cert "$CERT" --key "$KEY" && exit 0
sleep 30
done
curl -s "https://alert.example.com/hook?msg=cert-upload-failed&d=${DOMAIN}" >/dev/null
exit 1
2. 同一域名 CNAME 到两家 CDN,为什么会出现“间歇性证书错误”?DNS 轮询或权重把用户分流到不同厂商,若只更新了其中一家,命中旧节点的那部分用户就会看到 NET::ERR_CERT_DATE_INVALID。证书绑定的是域名而非 CDN 厂商(见 CA/B Forum Baseline Requirements),因此每家都必须上传同一张 fullchain.pem(含中间证书)。灰度顺序:先给新 CDN 1% 权重 → 校验其证书指纹 → 再逐步切换。
3. 金融、政务要求的国密双证书怎么配?CDN 侧开启国密开关后,握手优先协商 ECC-SM2-SM4-CBC-SM3 等套件(依据 GM/T 0024《SSL VPN 技术规范》);Chrome、Firefox 均不支持 SM2 证书,会回落 RSA/ECDSA 证书,所以必须双证书并存,且两条链路分别验证:
# 国密链路(需 GmSSL 或支持 SM2 的客户端)
gmssl s_client -connect cdn.example.com:443 -servername cdn.example.com
-cipher ECC-SM2-SM4-CBC-SM3
# 国际链路回落验证
openssl s_client -connect cdn.example.com:443 -servername cdn.example.com </dev/null
| openssl x509 -noout -subject -dates
4. 怎么批量巡检所有子域名的到期时间?用下面这段脚本,直接输出剩余天数:
for h in a.example.com b.example.com; do
end=$(echo | openssl s_client -servername "$h" -connect "$h:443" 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
days=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
echo "$h 剩余 ${days} 天 ($end)"
done
# 输出示例:a.example.com 剩余 27 天 (Apr 12 03:14:07 2026 GMT)
5. 变更审计记录什么?指纹是唯一可靠标识——控制台里同名的证书条目可能有多张。上线前后各执行一次:
openssl x509 -noout -fingerprint -sha256 -in fullchain.pem
# SHA256 Fingerprint=3A:1F:...:9C
把 SHA-256 指纹、notBefore 生效时间、操作人、涉及的每家 CDN 写入变更单;回滚时按指纹比对线上实际证书,而不是看证书名称。据 OpenSSL 文档,-fingerprint 默认算法为 SHA-1,务必显式加 -sha256,否则记录的指纹与 CDN 控制台展示的 SHA-256 指纹不一致,比对会失效。
多数是证书链缺中间 CA。用 openssl s_client -showcerts 看是否只有 1 张证书;把中间证书拼进 fullchain.pem 重传,通常 2-10 分钟生效。
不必。边缘证书面向公网用户,源站证书只需被 CDN 回源校验信任;自签源站证书可把其 CA 上传到 CDN 信任列表,或使用 Cloudflare Origin CA 这类专用证书。
可以,CDN 不区分免费与商业证书。注意 90 天有效期要自动化续期,且 Let's Encrypt 的 OCSP 服务已于 2025-08-06 停止,不要依赖其 stapling。
525 是 CDN 到源站 TLS 握手失败,多为端口、防火墙或 SNI 问题;526 是源站证书无法验证,常见于自签、过期或域名不匹配。切 Full (strict) 前先在源站装好受信任证书。
不能。*.example.com 只匹配 a.example.com,不匹配 a.b.example.com;需要多级时申请 *.b.example.com 或使用多域名 SAN 证书。
能,但有延迟。把 max-age 改为 0 并去掉 includeSubDomains,浏览器在下次收到响应后更新;若已提交 preload 列表,移除需数月且要等浏览器版本更新。
控制台显示成功通常 1-10 分钟,全球节点全部生效一般不超过 30 分钟;若用 DNS-01 验证,还要看 DNS TTL(常见 600 秒)。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。