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

CDN HTTPS 证书配置怎么做:边缘证书、回源 SNI 与 TLS 策略核对清单

cdn https证书配置 — CDN HTTPS 证书配置怎么做:边缘证书、回源 SNI 与 TLS 策略核对清单
核心结论

CDN HTTPS 证书配置要同时处理边缘证书和回源证书:边缘证书覆盖用户访问域名,回源证书由 CDN 校验源站,二者缺一会出现 525/526 或回源握手失败。 边缘证书优先选 DV 泛域名,DNS 验证通常 5-30 分钟;付费 DV 约 100-500 元/年,OV 约 1000-3000 元/年,部署到 CDN 一般 1-10 分钟生效。 回源 HTTPS 要开启 SNI 并让回源 Host 与源站证书 SAN 一致;Nginx 1.24+ 可用 proxy_ssl_server_name on; proxy_ssl_name $host; proxy_ssl_verify on;。 验证用 openssl s_client -connect cdn.example.com:443 -servername cdn.example.com -showcerts 看 Verify return code: 0 (ok),再用 curl -I 检查 301/200 与 HSTS 头。 证书轮换在到期前 30 天做双证书灰度:先上传新证书到 CDN,再切 10% 流量观察 24 小时,最后替换源站证书并保留旧证书 7 天。

为什么 CDN HTTPS 证书配置经常出现“边缘正常、回源失败”?

CDN 链路上实际跑着两次彼此独立的 TLS 握手:一次是用户 → CDN 边缘,用边缘证书;另一次是CDN 边缘 → 源站,用回源证书(或对源站证书的校验)。据 Cloudflare 文档,这两段是分开配置、分开报错的——只上传了边缘证书、却把回源协议改成 HTTPS,CDN 就会以客户端身份校验证书,失败时返回 525 SSL handshake failed 或 526 Invalid SSL certificate。这也是 cdn https证书配置 最常见的坑:控制台里“证书已生效”只代表第一段通了。

对比项 边缘证书 回源证书(CDN→源站)
校验方 用户浏览器 CDN 节点
证书域名要求 必须覆盖用户访问的域名(含泛域名/SAN) 必须覆盖回源 Host,不是源站 IP
典型报错 NET::ERR_CERT_COMMON_NAME_INVALID 525 / 526
排错入口 浏览器开发者工具 → Security openssl s_client 直连源站

根因 1:回源 Host 与证书 SAN 不一致。据 RFC 6125,客户端只按“访问时使用的主机名”匹配 SAN,回源 Host 填 origin.example.com、证书却只签了 www.example.com,Nginx 会直接报 SSL: no alternative certificate subject name matches target host name 'origin.example.com'。修复方式二选一:把回源 Host 改成证书里的域名,或为源站补签包含该名字的证书。用下面这条命令模拟 CDN 的回源行为(-servername 就是 SNI):

# 以真实回源 Host 作为 SNI 探测源站证书,并打印 SAN
# 适用:OpenSSL 1.1.1 / 3.x(1.1.1 起默认支持 TLS 1.3)
openssl s_client -connect origin.example.com:443 
  -servername origin.example.com -showcerts /dev/null 
  | openssl x509 -noout -subject -ext subjectAltName

根因 2:证书链不完整。源站只下发 leaf 证书、漏了中间 CA,浏览器往往靠 AIA 自动补链而“看起来正常”,CDN 节点不做补链,于是回源报 unable to get local issuer certificate。判断方法是看校验退出码:

# exit=0 表示链完整;exit=2 通常意味着缺中间 CA
openssl s_client -connect origin.example.com:443 -servername origin.example.com 
  -verify_return_error /dev/null 2>&1; echo "exit=$?"

# 修复:leaf 在前、中间 CA 在后拼成 fullchain(顺序不能反)
cat example.com.crt intermediate.crt > fullchain.pem
# Nginx 1.11.0+ 推荐写法:ssl_certificate 指向 fullchain.pem
server {
    listen 443 ssl;
    server_name origin.example.com;
    ssl_certificate     /etc/nginx/ssl/fullchain.pem;   # 站点证书 + 中间 CA
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;
    ssl_protocols       TLSv1.2 TLSv1.3;                # 与 CDN 回源最低版本对齐
}

根因 3:边缘证书没覆盖多域名。用户访问 img.example.com,而证书 SAN 只有 example.com,Chrome 报 NET::ERR_CERT_COMMON_NAME_INVALID;图片、静态资源走独立子域名时尤其容易漏。申请时把 *.example.com 与裸域一起写进 SAN。

根因 4:TLS 版本/套件不匹配。CDN 回源默认最低 TLS 1.2,源站只开 1.0/1.1 就握手失败;据 RFC 8996(2021 年 3 月),TLS 1.0/1.1 已正式弃用,主流 CDN 与浏览器均已移除支持。用 openssl s_client -tls1_2 单独验证一次即可确认。

时间与成本参考:DNS 验证 5–30 分钟,CNAME 接入 CDN 10–30 分钟,证书部署 1–10 分钟;免费 DV 有效期 90 天需轮换(Let’s Encrypt 文档明确推荐用 ACME 自动续期),付费 DV 约 100–500 元/年。

CDN HTTPS 证书配置前先分清:边缘证书、回源证书、源站证书和 CA 链

问:边缘证书、回源证书、源站证书,是不是同一张?不是。做 CDN HTTPS 证书配置前先把四个对象拆开:边缘证书是 CDN 边缘节点出示给终端浏览器的证书,也就是你在控制台上传并绑定到加速域名的那一张,用户点开锁图标看到的就是它;源站证书是源站 Nginx/Apache 在 ssl_certificate 里配置、出示给 CDN 的那一张;回源证书是 CDN 作为 TLS 客户端去校验源站时使用的信任锚,本质是”CDN 眼中的源站证书”;CA 链是 leaf → intermediate → root 的签发路径,决定浏览器和 CDN 能否把证书追到本地信任库。

对象 谁出示 / 谁校验 常见来源 链要求
边缘证书 CDN 出示,浏览器校验 公网 DV(泛域名常见)、商业 OV/EV leaf + intermediate,不含根证书
源站证书 源站出示,CDN 校验 Let’s Encrypt、商业 CA、内部 CA Nginx 写 fullchain.pem
回源证书 CDN 侧信任配置 公共信任库,或手动上传的内部 CA 需覆盖实际回源 Host 的 SAN
CA 链 双方共同依赖 CA 签发时提供 顺序 leaf 在前、中间 CA 在后

问:边缘证书为什么必须传 fullchain 而不是 cert.pem?据 Let’s Encrypt 文档,cert.pem 只含 leaf,中间 CA 需由客户端自行补齐;Android 7 以下、部分 Java 与 IoT 客户端不会做 AIA 补链,会直接判定链不完整。上传时顺序必须是 leaf 在前、中间 CA 在后,且不要包含根证书——根证书在客户端本地信任库中,带上只会增大握手包。检查链内容与顺序:

# 适用 OpenSSL 1.1.1 / 3.x;列出 fullchain.pem 中的全部证书及顺序
openssl crl2pkcs7 -nocrl -certfile /etc/nginx/ssl/fullchain.pem 
  | openssl pkcs7 -print_certs -noout

# 期望输出(leaf 在前,中间 CA 在后,无根证书):
# subject=CN = example.com
# issuer=C = US, O = Let's Encrypt, CN = R10
#
# subject=C = US, O = Let's Encrypt, CN = R10
# issuer=C = US, O = Internet Security Research Group, CN = ISRG Root X1

问:回源 Host 和证书 SAN 对不上会怎样?回源 Host 分两种模式:选”加速域名回源”时 SNI/Host 为加速域名;选”源站域名回源”时 SNI/Host 为你填写的源站域名(如 origin.example.com)。后者的源站证书 SAN 必须包含该名字,否则 CDN 侧直接报证书校验失败。用 openssl 模拟一次 CDN 回源握手:

# -servername 模拟回源 SNI,-verify_hostname 校验 SAN 是否覆盖回源 Host
openssl s_client -connect origin.example.com:443 
  -servername origin.example.com 
  -verify_hostname origin.example.com 
  -CAfile /etc/ssl/certs/ca-certificates.crt &1 | grep -E "subject=|Verify return code"

# 成功:Verify return code: 0 (ok)
# SAN 不含该主机名:Verify return code: 62 (Hostname mismatch)
# 链不全:Verify return code: 21 (unable to verify the first certificate)

若源站用内部 CA 签发,正确做法是在 CDN 回源配置里上传该内部 CA 证书(自建信任锚),而不是关闭回源校验;关闭校验意味着 CDN 不验证对端身份,回源链路暴露给中间人,生产环境不应长期保持。边缘与回源用不同证书完全正常:边缘用公网泛域名 DV,回源用内部 CA 或公网 DV,两者互不影响。

问:源站 ssl_certificate 到底写哪个文件?写 fullchain.pem,私钥写 privkey.pem。写 cert.pem 是 CDN HTTPS 证书配置中最常见的回源 526/证书链错误来源。

# Nginx 1.20+ / OpenSSL 1.1.1+,参数默认值见行内注释
server {
    listen 443 ssl;
    server_name origin.example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.pem;   # 必须含 leaf + intermediate
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;     # 权限 600,属主 root

    ssl_protocols       TLSv1.2 TLSv1.3;                # 默认仅 TLSv1.2/1.3(1.23+)
    ssl_ciphers         ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256;
    ssl_prefer_server_ciphers off;                      # 1.11.0 起默认 off
    ssl_session_cache   shared:SSL:10m;                 # 默认 none
    ssl_session_timeout 1d;                             # 默认 5m
}

问:有效期和密钥算法怎么定?Let’s Encrypt DV 固定 90 天,必须自动化续期并同步刷新 CDN 上的边缘证书;商业 CA 受 CA/Browser Forum 基线要求约束,当前公网证书最长 398 天,并已排期逐步缩短。密钥 RSA 2048 为下限(3072 更稳),或 ECDSA P-256;据 Mozilla 服务器端 TLS 指南与 RFC 8996,TLS 1.0/1.1 已废弃,回源与边缘都应只保留 TLS 1.2/1.3。

CDN HTTPS 证书配置的完整实操步骤(以泛域名 + 回源 HTTPS 为例)

先盘域名还是先传证书?先盘。CDN HTTPS 证书配置最常见的失败不是证书本身有问题,而是回源 Host 或 SNI 填错,导致边缘握手成功、回源却 502。下面按六步走,命令可直接复制。

步骤 1:盘点域名与回源方式。建一张表,逐行填:加速域名、源站地址(IP 或域名)、回源 Host、回源协议。用 dig 确认 CNAME 已生效,再确认源站自身能正常响应 HTTPS:

# 确认加速域名已 CNAME 到 CDN 厂商调度域名
dig +short cdn.example.com
# 期望输出形如:cdn.example.com.w.cdngslb.com.  或  xxx.kunluncdn.net.

# 确认源站 443 可达,并查看证书 CN/SAN 是否覆盖回源 Host
curl -sI https://origin.example.com | head -1
openssl s_client -connect origin.example.com:443 -servername origin.example.com /dev/null | openssl x509 -noout -subject -dates

边缘证书类型怎么选,直接看这张对比表(据 Let’s Encrypt 速率限制文档,同一注册域名下泛域名证书每周限 50 张):

类型 覆盖范围 适用场景 续期风险
单域名 DV 1 个 FQDN 测试、单一业务站 低,但域名一多就要维护多张
多域名 SAN 最多 100 个 SAN 域名数量固定、跨主域 中,新增域名需重签整张
泛域名(*.example.com) 任意一级子域 多子域、频繁上新 低,但只能 DNS-01 验证

步骤 2:申请边缘证书。泛域名只能走 DNS-01。acme.sh 3.0.x 的写法(certbot 5.x 对应 --preferred-challenges dns):

# 安装(3.0.x),DNS-01 验证,ECDSA P-256 密钥
curl https://get.acme.sh | sh -s email=ops@example.com
~/.acme.sh/acme.sh --issue --dns dns_ali 
  -d example.com -d '*.example.com' 
  --keylength ec-256 
  --server letsencrypt

# 安装到固定目录,reloadcmd 填 CDN 厂商的证书推送 API 或留空手动上传
~/.acme.sh/acme.sh --install-cert -d example.com --ecc 
  --key-file       /etc/ssl/example.com/privkey.pem 
  --fullchain-file /etc/ssl/example.com/fullchain.pem 
  --reloadcmd      "echo uploaded"

DNS 记录生效通常 5–30 分钟;商业 DV 在控制台申请约 10–30 分钟出证。

步骤 3:打包证书链。只拼「站点证书 + 中间证书」,不要拼根证书——部分源站与旧版客户端会因链中多余自签根而报 unable to get local issuer certificate:

cat cert.pem intermediate.pem > fullchain.pem
# 用系统 CA 库独立验证,必须输出 OK
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem
# fullchain.pem: OK

边缘侧上传 fullchain.pem 与 privkey.pem 两个文件,私钥不得带口令。

步骤 4:配置边缘 TLS。在 CDN 控制台「HTTPS 证书」中上传或托管证书并绑定加速域名,开启 HTTP→HTTPS 强制 301;TLS 最低版本选 1.2(RFC 8996 已将 TLS 1.0/1.1 列为废弃);HSTS 先设 max-age=300 观察 24 小时,确认无混合内容后再改 31536000,includeSubDomains 与 preload 最后加,因为 preload 一旦提交到浏览器列表,回退周期以月计。

步骤 5:配置回源 HTTPS。回源协议选 HTTPS、端口 443、回源 Host 选「源站域名」并填 origin.example.com,务必开启 SNI——源站若与其他站点共用 IP,缺 SNI 会返回默认站证书。源站用自签或内部 CA 时,把内部根 CA 上传到「回源证书校验」,而不是直接关校验;关闭校验仅用于排错,排错后立即恢复。

# 用 SNI 模拟 CDN 回源握手,验证源站返回的证书是否正确
openssl s_client -connect origin.example.com:443 
  -servername origin.example.com -verify_return_error </dev/null

步骤 6:灰度与回滚。先切一个子域或 10% 流量,观察 24 小时的 5xx 率与回源 TLS 握手失败数;旧证书保留 7 天。回滚有两条路径,均可在 5 分钟内完成:把回源协议切回 HTTP,或在边缘换回旧证书。完整的 cdn https 证书配置清单建议固化成发布前检查项,与 TLS 版本策略、OCSP Stapling 一并核对。

源站要同时扮演两个角色:对外(或被 CDN 回源)提供 HTTPS 服务,以及在反向代理场景下作为客户端去校验上游证书。这两件事的配置项完全不同,混在一起写是 cdn https证书配置 最常见的错误来源。下面按”服务端片段 → 回源客户端片段 → 验证命令”的顺序给出可直接复制的版本,适用 Nginx 1.24.x / 1.26.x(stable 线)。

问:源站对外提供 HTTPS 的 server 块该怎么写?

# /etc/nginx/conf.d/site.conf —— Nginx 1.24/1.26
server {
    listen 443 ssl;
    http2 on;                                  # 1.25.1+ 语法,1.24 用 listen 443 ssl http2;
    server_name origin.example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.pem;   # 必须含中间 CA
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;     # 权限 600,属主 root
    ssl_protocols       TLSv1.2 TLSv1.3;        # 1.23.4 起即为默认值
    ssl_ciphers         ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256;
    # 注意:ssl_ciphers 只影响 TLS1.2 及以下;TLS1.3 套件由 OpenSSL 默认策略决定
    ssl_session_cache   shared:SSL:10m;         # 默认 none,1MB≈4000 会话
    ssl_session_timeout 1d;                     # 默认 5m
    ssl_session_tickets off;                    # 关闭 ticket 便于密钥轮换审计

    add_header Strict-Transport-Security "max-age=300" always;  # 先用 300s 灰度
    # 确认无误后再改 max-age=31536000; includeSubDomains
}

为什么 HSTS 建议先写 max-age=300?因为该头一旦下发,浏览器会在有效期内强制走 HTTPS,配置回滚也救不回来。Mozilla SSL Configuration Generator 的 intermediate 档同样建议分阶段提升 max-age。

问:Nginx 作为客户端回源时,如何强制校验上游证书与 SNI?

location / {
    proxy_pass https://origin.example.com;
    proxy_ssl_server_name on;                  # 默认 off,不开则不发 SNI,多证书源站会拿到错证书
    proxy_ssl_name        $host;               # 与上游证书 SAN 必须匹配
    proxy_ssl_verify      on;                  # 默认 off —— 这是最大的安全隐患
    proxy_ssl_trusted_certificate /etc/nginx/ssl/upstream_ca.pem;  # 根+中间 CA
    proxy_ssl_verify_depth 3;                  # 默认 1,链较长时需放宽
    proxy_ssl_session_reuse on;                # 默认 on,可复用回源会话降低握手开销
    resolver 100.100.2.136 valid=300s;         # 变量域名需显式 resolver
}
指令 默认值 建议值 影响
ssl_protocols TLSv1.2 TLSv1.3(1.23.4+) TLSv1.2 TLSv1.3 低版本客户端兼容性 vs PCI DSS 要求
ssl_session_cache none shared:SSL:10m 回源与首字节延迟
proxy_ssl_verify off on 是否校验上游证书
proxy_ssl_verify_depth 1 3 证书链层级
proxy_ssl_server_name off on 是否发送 SNI

问:怎么用 OpenSSL 3.0.x / 3.2 核对边缘证书?

openssl s_client -connect cdn.example.com:443 -servername cdn.example.com -showcerts 
  /dev/null 
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 期望:subject=CN = cdn.example.com;SAN 含 cdn.example.com;notAfter 在有效期内
openssl s_client -connect origin.example.com:443 -servername origin.example.com 
  -verify_return_error -CAfile /etc/nginx/ssl/upstream_ca.pem </dev/null
# 期望:Verify return code: 0 (ok)
# 若报 unable to get local issuer certificate → 缺中间 CA,需补 fullchain

据 OpenSSL 官方文档,-servername 即设置 SNI 扩展,缺失时服务端可能返回默认站点证书,这正是 CDN 多域名场景下”证书看起来对、实际不匹配”的根因。

问:证书链怎么打包与自检?

cat cert.pem intermediate.pem > fullchain.pem      # 顺序:叶证书 → 中间 CA
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem
# 输出 fullchain.pem: OK
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
# 逐行确认 subject/issuer 顺序,倒序会导致部分客户端握手失败

问:最后怎么用 curl 8.x 做端到端确认?

curl -I -sS https://cdn.example.com/ | egrep -i 'HTTP/|strict-transport-security|location'
# 强制 HTTPS 时首跳应 301 到 https://cdn.example.com/,HSTS max-age 与配置一致
curl -sS --tlsv1.2 --tls-max 1.2 -o /dev/null -w '%{http_code}n' https://cdn.example.com/
# 验证最低版本仍可握手;配合 --tlsv1.1 应失败

整套 cdn https证书配置 的核对逻辑是:边缘证书看 SAN 与有效期,回源看 SNI 是否发出、证书链是否可验证,策略层看 TLS 版本下限与 HSTS 头是否真实下发——三者缺一,都会表现为”控制台显示已启用 HTTPS,但用户侧仍报证书错误”。

CDN HTTPS 证书配置方案怎么选:免费 DV、付费 DV、OV 与自签回源对比

先给结论:边缘证书(浏览器看到的那张)在 90% 的场景下用免费 DV 就够,真正容易出事故的是回源那一段——回源 SNI、回源 Host 与证书 SAN 三者不一致时,CDN 会报 SSL handshake failed,而你在浏览器里看边缘证书一切正常。所以完整的 cdn https证书配置 要拆成”边缘 + 回源”两个独立决策,下面这张表把五种常见组合的边界说清楚。

方案 典型适用 价格 签发耗时 有效期/轮换 关键限制
免费 DV(Let’s Encrypt / ZeroSSL) 个人站、测试环境、泛域名 0 元 DNS-01 约 5–30 分钟 90 天,需自动续期 仅验证域名控制权,无组织信息,必须接自动化
付费 DV(商业 CA) 中小业务、需要发票或多年多域名 约 100–500 元/年 10–30 分钟 受 CA/B 规则上限约束(见下) 泛域名价格明显更高,仍需到期轮换
OV 证书 企业官网、需展示组织名称 约 1000–3000 元/年 1–3 个工作日审核 同上限 需营业执照或电话核验;边缘上传仍按 fullchain 格式
自签 / 内部 CA 回源 源站只服务 CDN、内网回源 0 元 + 运维成本 10–30 分钟 自定义 必须在 CDN 上传 CA 证书,否则只能关闭回源校验;公网用户不可见
边缘 DV + 回源公网 DV 对回源安全有硬要求的生产环境 0–500 元/年 30–60 分钟完成双证书 两份独立轮换 回源 Host 必须落在证书 SAN 内,漏签 SAN 是最高频故障

为什么有效期一栏不写死”398 天”?因为 CA/Browser Forum 已通过 Ballot SC-081 缩短公开信任证书的最长有效期:2026-03-15 起降为 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。历史上 398 天是 2020 年 9 月起的主流上限,现在买的付费 DV 大多仍标 398 天,但到期后不能指望一直续成同样的时长——这也是”能自动化就别手工”的根本原因。据 Let’s Encrypt 官方文档,其 90 天有效期本身就是为鼓励自动化轮换而设计的。

免费 DV 泛域名怎么签?泛域名只能走 DNS-01,HTTP-01 无法验证 *.example.com。注意 acme.sh 自 v3.0.0 起默认 CA 已改为 ZeroSSL,要显式指定才走 Let’s Encrypt:

# acme.sh v3.0+;泛域名必须 DNS-01
export CF_Token="你的Cloudflare API Token"   # 也可用阿里云 dns_ali / 腾讯云 dns_dp
acme.sh --issue --dns dns_cf 
  -d example.com -d '*.example.com' 
  --server letsencrypt         # 关键:默认是 zerossl,此行切到 LE
  --keylength ec-256

# 导出成 CDN 需要的 fullchain(证书链)+ 私钥两件套
acme.sh --install-cert -d example.com --ecc 
  --fullchain-file /etc/cdn/example.com.fullchain.pem 
  --key-file       /etc/cdn/example.com.key 
  --reloadcmd      "systemctl reload nginx"   # 或调用 CDN API 上传

自签回源怎么生成并在 CDN 侧验证?核心是 SAN 必须写成 CDN 实际使用的回源 Host,而不是源站 IP:

# 1) 建内部 CA
openssl req -x509 -newkey rsa:2048 -nodes -days 3650 
  -keyout origin-ca.key -out origin-ca.crt -subj "/CN=Internal Origin CA"
# 2) 签发回源证书,SAN 写回源 Host(写 IP 会导致后续校验失败)
openssl req -newkey rsa:2048 -nodes -keyout origin.key -out origin.csr 
  -subj "/CN=origin.example.com"
openssl x509 -req -in origin.csr -CA origin-ca.crt -CAkey origin-ca.key 
  -CAcreateserial -days 397 -out origin.crt 
  -extfile <(printf "subjectAltName=DNS:origin.example.comnbasicConstraints=CA:FALSE")
# 3) 模拟 CDN 回源,显式带 SNI 并强制校验
openssl s_client -connect origin.example.com:443 
  -servername origin.example.com -CAfile origin-ca.crt -verify_return_error </dev/null
# 期望:Verify return code: 0 (ok)

如果第 3 步输出 verify error:num=62:hostname mismatch,或 Nginx 日志里出现 upstream SSL certificate verify error: (62:hostname mismatch),就是 SAN 与回源 Host 不匹配;curl 侧对应报错为 curl: (51) SSL: certificate subject name '...' does not match target host name '...'。想进一步确认 CDN 边缘发出的证书链是否完整,可用 openssl s_client -connect cdn.example.com:443 -servername www.example.com -showcerts,链上应能打印出”叶证书 + 中间证书”,缺中间证书在部分安卓与旧版 Java 客户端上会直接握手失败——这也是 CDN 上传时必须用 fullchain 而非单张 .crt 的原因。

选型上的取舍可以落到一句话:边缘证书追求”被公共信任库认可”,回源证书追求”只有我和 CDN 认”。前者越便宜越好、越自动越好;后者用内部 CA 能省掉公网证书私钥外发的合规顾虑,但前提是你把 CA 证书传到了 CDN 的回源校验配置里,否则只能关校验,等于把回源链路降级为”加密但不认证”。

很多人把 cdn https证书配置 当成”上传一张证书”就完事,结果一上线就撞上 525、526 或浏览器红锁。根因在于 CDN 上其实有两段完全独立的 TLS:边缘(用户 ↔ CDN,决定浏览器是否报 NET::ERR_CERT_*)和回源(CDN ↔ 源站,决定 525/526)。排查第一步永远是先分清报错出现在哪一段。

报错 出错环节 含义 首查命令
525 SSL handshake failed 回源 CDN 与源站 TCP/TLS 握手未完成 ss -lntp | grep ':443'
526 Invalid SSL certificate 回源 握手成功但证书校验不通过 openssl s_client -showcerts
NET::ERR_CERT_COMMON_NAME_INVALID 边缘 边缘证书 SAN 不含访问域名 浏览器开发者工具 → Security
unable to get local issuer certificate 回源 源站未下发中间证书 openssl s_client -verify 5

525 怎么快速定位?先确认源站 443 真的在监听且安全组放行 CDN 回源段 IP:

# 1) 源站本机看监听(Nginx 默认 0.0.0.0:443,只绑 127.0.0.1 会导致回源失败)
ss -lntp | grep ':443'

# 2) 从源站外部机器模拟回源握手,-servername 必须写回源 Host
timeout 5 openssl s_client -connect origin.example.com:443 
  -servername origin.example.com &1 | head -n 20

# 3) 源站若只开 TLS 1.0/1.1,而 CDN 最低 TLS 1.2,必然 525
openssl s_client -connect origin.example.com:443 -servername origin.example.com -tls1_2 </dev/null

526 为什么握手成功还报错?因为 CDN 对源站证书做了校验。一条命令同时看自签、过期、链和 SAN:

openssl s_client -connect origin.example.com:443 -servername origin.example.com -showcerts /dev/null 
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName

若返回 SSL: no alternative certificate subject name matches target host name 'origin.example.com',说明回源 Host 与证书 SAN 不一致——要么把回源 Host 改成证书里的名字,要么给源站证书补 origin.example.com 的 SAN。这里不要迷信 CN:据 RFC 9525(已取代 RFC 6125)与 CA/Browser Forum Baseline Requirements,CN 字段不再参与主机名校验,只有 SAN 有效,所以 NET::ERR_CERT_COMMON_NAME_INVALID 的正解是重签多域名/泛域名证书并在 CDN 绑定正确证书,而不是改 CN。

unable to get local issuer certificate 表示源站只发了 leaf 证书。Nginx 必须指向 fullchain.pem;Apache 2.4.8+ 把 SSLCertificateFile 直接指向合并链文件,2.4.8 之前才用 SSLCertificateChainFile(该指令自 2.4.8 起弃用)。

# Nginx:Nginx 1.23.4 起 ssl_protocols 默认 "TLSv1.2 TLSv1.3",旧版本默认含 TLSv1/1.1,建议显式声明
ssl_certificate     /etc/letsencrypt/live/origin.example.com/fullchain.pem;  # 含中间证书,勿用 cert.pem
ssl_certificate_key /etc/letsencrypt/live/origin.example.com/privkey.pem;
ssl_protocols       TLSv1.2 TLSv1.3;

# 验证链完整性:返回 "Verify return code: 0 (ok)" 才算通过
openssl s_client -connect origin.example.com:443 -servername origin.example.com 
  -verify 5 -CAfile /etc/ssl/certs/ca-certificates.crt &1 | grep -E 'Verify return code|verify error'

certificate has expired 属于续期链路断了。据 Let’s Encrypt 文档,其证书有效期 90 天,官方建议在剩余约 1/3 生命周期(约 30 天)时续期;acme.sh 默认每 60 天检查一次。核对到期时间并挂上自动重载:

openssl x509 -noout -dates -in /etc/letsencrypt/live/origin.example.com/fullchain.pem

# acme.sh:续期后必须 reload,否则 Nginx 仍加载内存中的旧证书
acme.sh --install-cert -d origin.example.com 
  --key-file       /etc/letsencrypt/live/origin.example.com/privkey.pem 
  --fullchain-file /etc/letsencrypt/live/origin.example.com/fullchain.pem 
  --reloadcmd      'nginx -s reload'

做 cdn https证书配置 时把这几条当成固定动作:边缘看 SAN、回源看链与 SNI、两边都锁 TLS 1.2+(可参考 Mozilla SSL Configuration Generator 的 intermediate 档位)。改完任何一项,都用上面的 openssl s_client 复测一遍,而不是只看控制台是否显示”已部署”。

CDN HTTPS 证书配置后怎么验证生效:从 DNS 到 TLS 握手的 6 个检查

证书在 CDN 控制台显示“已部署”不等于全网生效。下面 6 个检查按数据流方向排列,从 DNS 解析一路走到 TLS 握手和回源,每一步都给出可复制的命令与期望输出。这也是 cdn https证书配置 后最容易被跳过、却最容易出问题的一段。

  1. DNS 解析是否真的指向 CDN
# 期望输出类似 cdn.example.com.w.cdngslb.com.,即 CDN 分配的 CNAME
dig +short cdn.example.com

# 只查 CNAME 记录;返回空说明还没切过来或仍是 A 记录直连源站
dig +short cdn.example.com CNAME

# 看完整应答与 TTL(主流 CDN 默认 600 秒)
dig cdn.example.com +noall +answer

TTL 600 秒意味着权威记录变更后约 10 分钟收敛,运营商递归缓存可能再拖 10–30 分钟。若 dig 已返回 CNAME 但 curl -I 仍打到源站,用 dig @8.8.8.8 cdn.example.com 对比公共递归与本地递归的答案。

  1. 边缘证书的 SAN 与有效期
# -servername 必须显式传,否则 CDN 可能回默认证书,导致误判为"证书不匹配"
openssl s_client -connect cdn.example.com:443 
  -servername cdn.example.com -showcerts /dev/null 
  | openssl x509 -noout -subject -dates -ext subjectAltName

期望 X509v3 Subject Alternative Name 中包含该加速域名,notAfter 与 CDN 控制台显示的有效期一致。据 Let’s Encrypt 文档,其证书有效期 90 天、到期前 30 天开始续期;若 CDN 托管的是 LE 证书,控制台应显示自动续期状态为“已开启”,否则第 91 天必然报 certificate has expired。

  1. 证书链是否完整
# Linux 用系统 CA 包校验;macOS 换成 /etc/ssl/cert.pem
openssl s_client -connect cdn.example.com:443 -servername cdn.example.com 
  -CAfile /etc/ssl/certs/ca-certificates.crt /dev/null 
  | grep 'Verify return code'

期望 Verify return code: 0 (ok)。返回 20 (unable to get local issuer certificate) 是典型的漏发中间 CA:上传时只传了叶子证书,浏览器能靠 AIA 补链,但 Java、Android 老版本和部分 IoT 客户端会直接握手失败。返回 10 (certificate has expired) 则查 notAfter。

  1. 强制 HTTPS 与 HSTS
# 期望 301 或 308,且 Location: https://cdn.example.com/
curl -sSI http://cdn.example.com/ | head -5

# 期望 200 或业务状态码,并检查 Strict-Transport-Security 的 max-age
curl -sSI https://cdn.example.com/ | head -8

301/308 优于 302,可被浏览器缓存、减少重复跳转。HSTS 的 max-age 要与控制台配置一致:上线先设 300 秒观察,确认无 HTTP 子资源后再拉到 31536000(1 年);据 Mozilla 服务器 TLS 指南,加 includeSubDomains 前必须确认所有子域都能提供 HTTPS,否则会把子域一起锁死。

  1. 回源请求的 SNI 与 Host
# 源站 nginx 需在 log_format 中加 $ssl_protocol $ssl_server_name,否则看不到 SNI
# log_format cdn '$remote_addr $host $ssl_protocol $ssl_server_name $request';
tail -f /var/log/nginx/access.log | grep -i cdn

确认请求源 IP 落在 CDN 官方回源网段内、$host 为 origin.example.com、$ssl_protocol 为 TLSv1.2 或 TLSv1.3。源站 443 端口多域名复用时,回源 SNI 配错会命中默认站点的证书,表现为回源 421 或证书域名不符。

  1. 浏览器与混合内容
# 快速扫出页面里硬编码的 http:// 资源
curl -sS https://cdn.example.com/ | grep -oiE '(src|href)="http://[^"]+' | head

Chrome DevTools 的 Security 面板应显示 “This page is secure (valid HTTPS)”,Console 不应出现 Mixed Content 报错。按 W3C Mixed Content 规范,脚本、样式表、iframe 等主动内容会被直接拦截,图片等被动内容则降级为警告但仍破坏锁标志。

检查项 关键命令 期望结果 常见失败
DNS/CNAME dig +short cdn.example.com CNAME 返回 CDN 分配的 CNAME 仍为 A 记录直连源站
边缘证书 openssl x509 -ext subjectAltName SAN 含加速域名 证书绑定错域名
证书链 grep 'Verify return code' 0 (ok) 缺中间 CA,返回 20
强制跳转 curl -sSI http://… 301/308 + Location 302 或不跳转
回源 tail -f access.log SNI=源站域名、TLSv1.2+ 命中默认站点
混合内容 grep -i 'http://' 无输出 硬编码 http 资源

完成这套核对,一次 cdn https证书配置 才算真正闭环。日常巡检可把 2–4 步写成 cron 脚本,对 notAfter 剩余天数和 Verify return code 做告警——证书过期和链路缺失是 CDN HTTPS 最高频的两类线上故障。

CDN HTTPS 证书轮换与灰度:到期前 30 天怎么切不中断

证书轮换最容易出事的不是签发,而是“切换的那几分钟”。把过程拆成一张可执行的时间表,比任何一次临时救火都值钱。据 Let’s Encrypt 文档,其证书有效期 90 天,官方建议在剩余约 30 天时续期,因此每 60 天自动跑一次是安全余量。

距到期 动作 验证方式
30 天 申请新证书(新私钥,不复用旧 key) openssl x509 -noout -dates -in new/fullchain.pem
14 天 上传到 CDN 控制台,但不替换当前生效证书 控制台证书列表同时可见新旧两张
7 天 灰度 10% 流量(按域名、按节点或按权重) 抽查 openssl s_client -connect cdn.example.com:443 -servername example.com 的返回链
1 天 全量切换 对比灰度期错误率无抬升

双证书并存是回滚的前提。CDN 侧先上传新证书、保持旧证书为默认,再用证书灰度或多证书按域名切换;源站 Nginx 同时保留两套文件,切换时只改路径两行:

# /etc/nginx/conf.d/example.conf  适用 nginx 1.20+,指令自 0.7.14 起可用
ssl_certificate     /etc/nginx/ssl/new/fullchain.pem;   # 回滚只需把 new 改回 old
ssl_certificate_key /etc/nginx/ssl/new/privkey.pem;
# 旧证书留在 /etc/nginx/ssl/old/ 至少 7 天,含私钥,权限 600

自动化续期用 acme.sh(3.0.x 默认 CA 已是 ZeroSSL,要走 Let’s Encrypt 需显式指定 --server letsencrypt):

acme.sh --install-cert -d example.com --server letsencrypt 
  --key-file       /etc/nginx/ssl/privkey.pem 
  --fullchain-file /etc/nginx/ssl/fullchain.pem 
  --reloadcmd      'nginx -s reload'    # 续期成功后自动平滑重载

certbot 则用 deploy hook,注意 --deploy-hook 自 2.x 起仅在“真正续期成功”时触发,未到期不会重载 Nginx:

certbot renew --deploy-hook 'systemctl reload nginx'   # 建议写入 cron 或 systemd timer,每日两次随机延迟

监控分两层。主机侧一条命令即可判断 30 天窗口,退出码 0 表示尚未进入临界区:

openssl x509 -checkend 2592000 -noout -in /etc/nginx/ssl/fullchain.pem 
  || echo "证书将在 30 天内过期"
# 2592000 = 30 天秒数;返回非 0 即需告警

外部视角用 blackbox_exporter 0.25+ 的 probe_ssl_earliest_cert_expiry(Unix 秒时间戳),配合 (probe_ssl_earliest_cert_expiry - time()) / 86400 < 21 告警,能同时覆盖 CDN 边缘证书与回源证书——这正是 CDN HTTPS 证书配置里最容易被漏掉的一环:只盯源站,忘了边缘。

真出问题时症状很具体:浏览器报 NET::ERR_CERT_DATE_INVALID,curl 报 SSL certificate problem: certificate has expired,openssl s_client 报 verify error:num=10:certificate has expired。若新证书链缺中间证书,则会看到 unable to get local issuer certificate,此时应回滚而非现场补链。

回滚流程固定三步:CDN 控制台切回旧证书 → 源站改回 old/ 路径并 nginx -s reload → 保留旧证书与旧私钥 7 天后再删。整个过程应在 5 分钟内完成,并把变更单连同 openssl s_client 与 curl -vI 的输出一起归档,下次核对 TLS 策略(协议版本、密码套件、HSTS)时可直接比对。

不必。边缘证书给用户浏览器校验,回源证书给 CDN 校验源站,可以不同。若回源用自签或内部 CA,需在 CDN 上传 CA 或关闭回源校验,生产环境不建议长期关闭。

若回源协议是 HTTPS,CDN 作为客户端要校验源站证书;只配边缘证书会出现 525/526。回源走 HTTP 可不需要源站证书,但 CDN 到源站明文,生产环境不建议。

用 openssl s_client -connect origin.example.com:443 -servername origin.example.com -showcerts 检查源站证书是否过期、自签、链不完整或 SAN 不含回源 Host。补 fullchain、改回源 Host 或上传 CA。

可以,Let's Encrypt/ZeroSSL DV 支持单域名和泛域名,DNS-01 验证 5-30 分钟,90 天轮换。商业 DV 约 100-500 元/年,OV 约 1000-3000 元/年,按是否需要发票或组织信息选择。

源站共享 IP 托管多证书时必须开;否则 CDN 可能返回默认站点证书,报域名不匹配。Nginx 回源代理用 proxy_ssl_server_name on; proxy_ssl_name $host;。

用 openssl s_client 看 Verify return code: 0 (ok) 和 SAN,用 curl -I 看 301/200 与 HSTS 头,再查源站日志确认回源 Host/SNI;DNS CNAME 生效通常 10-30 分钟。

直接装源站只覆盖源站入口;CDN 配置要同时管边缘证书、回源证书、回源 Host/SNI 和 CDN 节点同步。边缘证书部署 1-10 分钟,源站证书需 reload Nginx 才生效。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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