跳到主要内容
安装配置教程

CDN SSL 证书配置全流程:上传证书、回源 TLS、排错与验证(2025 版)

cdn ssl证书配置 — 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 说明,服务端必须下发「叶子 + 中间」,根证书不要拼进去(客户端本地已有)。修复与验证:

# 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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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