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

CDN SSL证书安装全流程:证书链打包、控制台上传、回源配置与生效验证

cdn ssl证书安装 — CDN SSL证书安装全流程:证书链打包、控制台上传、回源配置与生效验证
核心结论

CDN SSL 证书安装的本质,是把「域名证书 + 中间证书链 + 未加密私钥」上传到 CDN 证书管理并在域名处绑定,由边缘节点完成 TLS 终结;绝大多数失败源于证书链不全、私钥不匹配或域名未被 SAN 覆盖。 上传前用 openssl x509 -noout -modulus -in fullchain.pem | openssl sha256 与 openssl pkey -noout -modulus -in example.com.key | openssl sha256 比对,两条输出一致才允许上传。 控制台显示部署完成后,边缘节点通常 1–10 分钟生效、全球多节点 5–30 分钟;用 openssl s_client -connect 域名:443 -servername 域名 看到 Verify return code: 0 (ok) 才算真正生效。 成本参考:Let's Encrypt DV 免费但仅 90 天,必须自动化续期;商业 DV 约 100–800 元/年,OV 单域 300–1500 元/年,OV 通配符 3000–8000 元/年。 平台限制要先查:AWS CloudFront 只接受 us-east-1 区域的 ACM 证书,Cloudflare 上传自定义证书需 Business 套餐(约 200 美元/月起)或 Cloudflare for SaaS。

为什么 CDN 上装 SSL 证书总出问题?先看五个根本原因

很多人把 CDN 的 cdn ssl证书安装 理解成“把证书文件传到服务器上”,这是第一个认知偏差。实际流程是:把域名证书、中间证书链、未加密私钥上传到 CDN 的证书管理模块,由边缘节点完成 TLS 终结——TLS 1.3 握手(RFC 8446)发生在离用户最近的边缘,而不是你的源站。而“CDN 到源站”这一段是否加密,由控制台里独立的「回源协议」开关控制(HTTP / HTTPS / 协议跟随),与边缘证书互不影响。两者混为一谈,就会撞上“证书明明传上去了,回源却还是明文 HTTP”或“回源开了 HTTPS,边缘却报证书错误”的错配。下面五个根因覆盖了绝大多数上传失败与握手失败。

根因一:证书链不完整。只上传叶子证书、漏掉中间证书时,Chrome 会依据 AIA 扩展(RFC 5280 §4.2.2.1)自动抓取补链,看起来一切正常;但 curl、Java 8 早期版本、部分 Android 系统证书库与 Python requests 不做 AIA 抓取,会直接报 curl: (60) SSL certificate problem: unable to get local issuer certificate。这就是“浏览器能开、接口调不通”的经典现象。

# 上传后自查:返回的证书数量应 ≥ 2(叶子证书 + 中间证书),只有 1 说明链不完整
openssl s_client -connect cdn.example.com:443 -servername cdn.example.com 
  -showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE"

# 上传前打包完整链:叶子证书在前,中间证书在后,顺序不可颠倒
cat example.com.crt intermediate.crt > fullchain.crt

根因二:私钥与证书不匹配,或私钥带口令。平台普遍只接受 PEM 格式、无口令的私钥,头部必须是 -----BEGIN PRIVATE KEY-----(PKCS#8)或 -----BEGIN RSA PRIVATE KEY-----(PKCS#1)。若文件头部出现 Proc-Type: 4,ENCRYPTED,会被直接拒绝。

# 比对证书与私钥的 modulus,两个 MD5 必须完全一致
openssl x509 -noout -modulus -in fullchain.crt | openssl md5
openssl rsa  -noout -modulus -in privkey.key   | openssl md5

# 私钥若带口令,先解密(OpenSSL 3.x 推荐用 pkey 子命令)
openssl pkey -in encrypted.key -out decrypted.key   # 交互式输入原口令

根因三:域名覆盖不足。通配符 *.example.com 只覆盖一级子域,不覆盖裸域 example.com,也不覆盖 a.b.example.com。用 openssl x509 -noout -text -in fullchain.crt 查看 Subject Alternative Name 字段;多域名场景必须靠 SAN 扩展,或依赖 CDN 的 SNI 多证书能力为每个域名单独绑定。

根因四:算法与格式限制。国内 CDN 对密钥算法有明确白名单,超出范围往往只给一句模糊的“证书格式不支持”。据 Let’s Encrypt 与 Mozilla 服务器端 TLS 配置建议,2048 位 RSA 与 P-256 ECC 是当前兼容性最优解。

检查项 主流 CDN 接受值 典型拒绝表现 自查命令
RSA 长度 2048 位(部分支持 3072/4096,个别平台 4096 上传失败) 上传报“证书格式不支持” openssl rsa -in k.key -noout -text
ECC 曲线 P-256 / prime256v1 握手失败或上传被拒 openssl ec -in k.key -noout -text
封装格式 PEM(Base64 文本) .pfx / .der 直接上传失败 openssl pkcs12 -in cert.pfx -nodes -out all.pem
自签名证书 不接受 上传成功但边缘握手失败 openssl verify -CAfile fullchain.crt fullchain.crt

根因五:CAA 记录阻断签发。若域名已存在 0 issue "letsencrypt.org" 的 CAA 记录(RFC 8659),改用其他 CA 申请证书会被对方 CA 依规拒绝。先查询再补录,然后重新提交申请:

# 查询现有 CAA,注意返回的 issue / issuewild 标签
dig CAA example.com +short

# 在 DNS 中追加目标 CA(示例:同时保留原 CA,避免影响已签发证书续期)
# example.com. 300 IN CAA 0 issue "letsencrypt.org"
# example.com. 300 IN CAA 0 issue "digicert.com"

第一步:签发与打包证书,先把证书链和私钥准备好

Q:证书是从 CA 下载下来的,直接上传到 CDN 控制台为什么还会报“证书链不完整”?

因为 CA 通常只发给你一张服务器证书,中间证书需要自己拼接。CDN 节点回源或对外握手时若只发叶子证书,Android 旧版本、Java 客户端、部分命令行工具会直接握手失败。所以 cdn ssl证书安装 的第一步不是“上传”,而是“打包”——把私钥、服务器证书、中间证书三者理清楚。

Q:私钥和 CSR 怎么生成?-nodes 是什么意思?

推荐 OpenSSL 1.1.1 及以上(-addext 参数自 1.1.1 引入,CentOS 7 自带的 1.0.2k 不支持,会报 req: Unknown option or ciphersuite addext):

# 适用 OpenSSL 1.1.1+ / 3.x;生成 2048 位 RSA 私钥与 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"

# -nodes(no DES):私钥不加密、不设口令
# CDN 控制台没有输入私钥口令的交互入口,加密私钥会直接导致"私钥格式错误"
chmod 600 example.com.key   # 私钥权限收紧,仅属主可读

据 OpenSSL 官方文档,-subj 只设置主题 DN,SAN 必须靠 -addext 或配置文件补充;现代浏览器早已忽略 CN,只看 SAN。若追求更小握手体积,可把 rsa:2048 换成 -newkey ec -pkeyopt ec_paramgen_curve:prime256v1,但需确认 CDN 厂商支持 ECDSA 证书。

Q:免费 Let’s Encrypt 和商业证书怎么选?

类型 典型价格 有效期 核验方式 适用场景
Let’s Encrypt DV 免费 90 天,需自动续期 DNS-01 / HTTP-01 个人站、API、测试环境
商业 DV 约 100–800 元/年 1 年(受基线缩短影响) 同上 需发票、SLA、更长有效期
OV 单域 300–1500 元/年 1 年 企业资料人工核验,1–3 个工作日 企业官网、政企投标
OV 通配符 3000–8000 元/年 1 年 同上 多子域统一管理

据 CA/Browser Forum 基线要求(SC-081),公有证书最长有效期将自 2026 年 3 月起缩短至 200 天、2027 年 3 月起 100 天,最终收敛到 47 天。这意味着“买三年省事”的老思路已失效,无论选哪家,自动化续期 + 自动推送 CDN 才是长期方案。

Q:域名验证选 DNS-01 还是 HTTP-01?域名已经接入 CDN 了怎么办?

  • DNS-01:在 _acme-challenge.example.com 添加 TXT 记录,TTL 建议 60–600 秒,便于快速验证与清理;通配符证书只能走这条路。
  • HTTP-01:要求 http://example.com/.well-known/acme-challenge/<token> 可公网直连。域名已接入 CDN 时,必须确认该路径不被回源改写、不被缓存、不被强制跳转 HTTPS,否则 Let’s Encrypt 校验会返回 404 或 301。
# acme.sh 走 DNS-01 签发(示例:阿里云 DNS API)
acme.sh --issue -d example.com -d www.example.com --dns dns_ali --keylength 2048
# 产物默认在 ~/.acme.sh/example.com/:example.com.key / example.com.cer / ca.cer / fullchain.cer

Q:证书链怎么合并?顺序错了会怎样?

# 顺序必须是「服务器证书 → 中间证书」,根证书不要放进去
cat example.com.crt intermediate.crt > fullchain.pem

# 核对链内顺序与证书数量
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout

根证书(如 ISRG Root X1、DigiCert Global Root G2)已内置于各客户端信任库,放进链里会让部分客户端把链判为“过长”或“自签名混入”而握手报错。

Q:上传前怎么自检?

# 用系统信任库验证完整链,期望输出:fullchain.pem: OK
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
  -untrusted intermediate.crt fullchain.pem
# 若报 error 20 at 0 depth lookup: unable to get local issuer certificate
# 说明缺中间证书,或 -untrusted 未正确指向中间证书

# 确认有效期与 SAN 列表
openssl x509 -in fullchain.pem -noout -dates -ext subjectAltName
# notBefore=... / notAfter=...
# X509v3 Subject Alternative Name: DNS:example.com, DNS:www.example.com

这两条命令是 cdn ssl证书安装 阶段最省时间的“前置闸门”:验证通过后再进控制台上传,能避免“上传成功但节点未生效”这类排查成本极高的假象。Mozilla Server Side TLS 指南同样建议服务器发送完整链(不含根),并把私钥与证书文件分离存放。

第二步:在 CDN 控制台上传证书并绑定域名(分步骤)

上传之前先在本机把材料准备干净,能省掉控制台里最烦的一类报错。据 OpenSSL 官方文档,证书链的顺序必须是「站点证书 → 中间证书 →(可选)根证书」,顺序颠倒时浏览器会报 unable to get local issuer certificate。用三条命令自检:

# 1) 拼接完整链:站点证书在前,中间证书在后(顺序不可颠倒)
cat example.com.crt intermediate.crt > fullchain.pem

# 2) 私钥与证书必须配对:两条命令输出的 MD5 应完全一致
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5

# 3) 检查文件大小与编码(含 BOM 会导致部分厂商解析失败)
wc -c fullchain.pem example.com.key          # 单文件建议 < 100 KB
file fullchain.pem                            # 期望 ASCII text,非 "UTF-8 Unicode (with BOM) text"

步骤 1:找到证书入口。各家的路径差异很大,先看这张对照表,避免在错误的页面里反复找「上传」按钮:

CDN 厂商 上传入口 关键限制
阿里云 CDN CDN 控制台 → 证书服务 → 证书管理 → 上传证书 仅 PEM,单文件 ≤ 100 KB
腾讯云 SSL 证书管理 → 上传证书,再回 CDN 域名管理绑定 证书与私钥需成对上传
Cloudflare SSL/TLS → Edge Certificates → Upload Custom SSL 需 Business 及以上套餐或 Cloudflare for SaaS
AWS CloudFront 只能选 us-east-1 区域的 ACM 证书或 IAM 证书 其他区域的 ACM 证书不会出现在下拉列表

步骤 2:填写内容。证书名称建议写成「域名-到期日」,例如 example-com-202506,续期时一眼能看出新旧。证书内容粘贴 fullchain.pem 全文,私钥粘贴 example.com.key 全文,务必保留 -----BEGIN CERTIFICATE----- / -----END CERTIFICATE----- 头尾。若控制台提示「证书与私钥不匹配」,几乎都是第 2 步的 MD5 校验没通过,或私钥被编辑器自动加了换行。

步骤 3:绑定域名并开启 HTTPS 跳转。在域名管理里把 HTTPS 证书指向刚上传的证书,并开启「强制 HTTPS」(301)。注意:如果源站也配置了 301 跳转,必须关掉其中一侧,否则会陷入 ERR_TOO_MANY_REDIRECTS——CDN 跳到源站的 HTTPS,源站又跳回,循环到浏览器放弃。

步骤 4:设置 TLS 参数。最低版本选 TLS 1.2,同时开启 TLS 1.3;等保或金融场景按规范禁用 TLS 1.0/1.1 以及 RC4、3DES 套件。开启 HSTS 前先确认全站 HTTPS 可用,max-age 建议从 300 秒起逐步加到 31536000 秒,否则一旦配错,浏览器会在有效期内拒绝回退到 HTTP。

步骤 5:处理回源。回源协议选 HTTPS 时,源站证书必须由公共 CA 签发且域名严格匹配,否则改用「协议跟随」或 HTTP 回源。Cloudflare 的 Full (strict) 模式同样要求源站证书有效,自签名证书场景应改用 Cloudflare Origin CA(据 Cloudflare 文档,其根证书有效期至 2030 年后)。

步骤 6:等待下发并确认解析。控制台显示「已部署」后,边缘节点通常 1–10 分钟生效,全球多节点 5–30 分钟。据 Let’s Encrypt 文档建议,任何 cdn ssl证书安装 完成后都应做一次外部验证,而不是只看控制台状态:

# 解析必须指向 CDN 的 CNAME,而不是源站 IP
dig +short www.example.com CNAME
# 期望:www.example.com.w.kunlunsl.com.(阿里云)等 CDN 域名

# 验证实际握手协议版本与证书链
curl -sI --tlsv1.2 --tls-max 1.2 https://www.example.com | head -n 5
openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts </dev/null 2>/dev/null | grep -E "^ *[si]:"

如果 dig 返回的是源站 IP,说明 CNAME 尚未生效,此时看到的证书很可能是源站证书而非 CDN 边缘证书——这也是很多 cdn ssl证书安装 案例中「明明传了证书却仍报旧证书」的真实原因。

关键配置与命令示例:Nginx 源站、证书校验与上传 API

源站的 Nginx 到底该怎么写?1.24 和 1.26 的默认值有区别吗?

有。Nginx 自 1.23.4 起把 ssl_protocols 的默认值从 TLSv1 TLSv1.1 TLSv1.2 改成了 TLSv1.2 TLSv1.3,1.24/1.26 都已是新默认;但 ssl_stapling 仍默认 off,需要显式打开,否则边缘节点回源时拿不到 OCSP 响应,只能自行外连 CA。据 Nginx 官方文档,ssl_stapling_verify 只有在 ssl_trusted_certificate 配置正确时才真正生效。

# /etc/nginx/conf.d/example.conf —— Nginx 1.24 / 1.26 通用
# http 级:会话复用,10m 共享内存约可缓存 4 万个会话
ssl_session_cache   shared:SSL:10m;   # 默认 none(每个 worker 独立缓存)
ssl_session_timeout 10m;              # 默认 5m

server {
    listen 443 ssl;                   # 1.24 需写成 listen 443 ssl http2;
    server_name 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;                # 1.23.4 起默认即此
    ssl_ciphers             ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
    ssl_prefer_server_ciphers off;      # 默认 off,让客户端选套件,减少握手往返

    ssl_stapling            on;         # 默认 off
    ssl_stapling_verify     on;         # 默认 off
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;  # 只放中间证书,不要放 fullchain
    resolver                223.5.5.5 119.29.29.29 valid=300s;
    resolver_timeout        5s;
}

为什么 ssl_trusted_certificate 不能直接指向 fullchain.pem?

因为 Nginx 会用这个文件里的全部证书去验证 OCSP 响应者的签名,而 fullchain.pem 的顶端是站点自己的叶子证书——它既不是签发者也不是信任锚,反而可能让 stapling 验证失败并在 error.log 中留下 ssl_stapling_verify: OCSP response verify error。正确做法是拆出纯中间证书链(chain.pem)单独喂给该指令。

指令 Nginx 默认值 推荐值 备注
ssl_protocols TLSv1.2 TLSv1.3(1.23.4+) TLSv1.2 TLSv1.3 旧版需手动禁 TLSv1/1.1
ssl_session_cache none shared:SSL:10m 多 worker 间共享
ssl_session_timeout 5m 10m 需与 CDN 回源连接复用配合
ssl_stapling off on 需 resolver
ssl_stapling_verify off on 依赖 trusted_certificate
ssl_prefer_server_ciphers off(1.11.0+) off Mozilla 配置生成器同建议

上传前怎么确认证书和私钥是配对的?

# RSA 证书:两条输出的 SHA256 必须完全一致
openssl x509 -noout -modulus -in fullchain.pem | openssl sha256
openssl pkey -noout -modulus -in example.com.key | openssl sha256

# ECC(ECDSA)证书没有 modulus,改用公钥比对
openssl x509 -noout -pubkey -in fullchain.pem | openssl sha256
openssl pkey -noout -pubout -in example.com.key | openssl sha256

控制台上传完,怎么验证 CDN 边缘真的下发对了?

直接对加速域名做一次握手,跳过本地信任库:

openssl s_client -connect www.example.com:443 -servername www.example.com 
  -tls1_2 -showcerts /dev/null | openssl x509 -noout -subject -issuer -dates
# 期望:Verify return code: 0 (ok)
openssl s_client -connect www.example.com:443 -servername www.example.com 
  -showcerts /dev/null | grep -c "BEGIN CERTIFICATE"
# 期望:≥2,说明中间证书已随握手下发(缺链时 Android/Java 客户端会报 PKIX path building failed)

能不能不点控制台,用 API 完成 cdn ssl证书安装?

可以,上传后拿到证书 ID,再在 CDN 域名配置里引用即可。

# 阿里云 CAS(aliyun CLI 3.x,需已配置 AK)
aliyun cas UploadUserCertificate --Name example-com-202506 
  --Cert "$(cat fullchain.pem)" --Key "$(cat example.com.key)"
# 返回 JSON 中的 CertId(整数),在 CDN SetDomainServerCertificate 中引用

# 腾讯云(tccli 3.x)
tccli ssl UploadCertificate --Certificate "$(cat fullchain.pem)" 
  --PrivateKey "$(cat example.com.key)" --Alias example-com-202506
# 返回 CertificateId,形如 "aBcD1234"

证书到期了还要手动重来一遍吗?

用 ACME 自动签发可免去手工搬运。据 Let’s Encrypt 文档,通配符证书必须走 DNS-01 校验:

pip install "certbot>=2.0" certbot-dns-aliyun
certbot certonly --dns-aliyun 
  --dns-aliyun-credentials /root/.secrets/aliyun.ini 
  -d example.com -d "*.example.com" 
  --server https://acme-v02.api.letsencrypt.org/directory
# 产物:/etc/letsencrypt/live/example.com/fullchain.pem 与 privkey.pem
# 建议加 --deploy-hook "nginx -t && systemctl reload nginx" 实现零停机换证

注意 certbot 生成的 fullchain.pem 是「叶子 + 中间」,而 chain.pem 才是纯中间链——正好分别对应 ssl_certificate 与 ssl_trusted_certificate,这也是把上述 Nginx 片段固化成模板后,cdn ssl证书安装能从数小时缩短到几分钟的原因。

证书类型与部署方式怎么选?一张对比表说清

先用一句话回答:按「域名数量 × 预算 × 核验要求」三步筛完,再用 CDN 平台限制做减法。

  1. 域名数量:只有 1–2 个独立域名,选单域 DV;≥3 个子域(如 api.、img.、static.)直接上通配符,别买多张单域证书。
  2. 预算:能接受 90 天一续且愿意做自动化,0 元够用;没人值守运维,就买 1 年期的商业 DV。
  3. 核验要求:只有当合同、招投标文件或行业合规明确写”OV/EV”时才付溢价。据 Chrome 官方博客,自 Chrome 77(2019 年 9 月)起 EV 证书不再显示绿色地址栏,仅剩证书详情里的组织名,性价比已大幅下降。
对比维度 DV(域名型) OV(组织型) EV(扩展验证)
域名覆盖 单域 / 多域 SAN / 通配符均支持 单域、SAN、通配符(OV 通配符) 多为单域或有限 SAN,通配符少且贵
价格区间 免费(Let’s Encrypt、ZeroSSL)0 元;商业 DV 约 100–800 元/年,通配符约 300–1500 元/年 单域约 300–1500 元/年,通配符约 3000–8000 元/年 通常 1500 元/年以上,通配符极少见
签发与核验时长 1–10 分钟,仅验证域名控制权(HTTP-01 / DNS-01) 1–3 个工作日,需营业执照、电话回拨 3–7 个工作日,核验最严
有效期 免费 90 天;商业 1 年(受 CA/B Forum 路线图约束逐步缩短) 1 年 1 年
CDN 平台兼容性 全部 CDN 支持,可上传也可用平台托管免费证书 需手动上传 PEM,Cloudflare 免费版不支持 同 OV,且多数 CDN 无特殊待遇

免费 DV 能不能上生产?能,前提是把续期写成自动化。据 Let’s Encrypt 文档,其证书有效期固定 90 天,官方建议在剩余 30 天时续期。下面以 acme.sh v3.0.7 为例(v3.0.0 起默认 CA 为 ZeroSSL,默认密钥为 2048 位 RSA),用 DNS-01 签发通配符并输出可直接上传 CDN 的完整证书链:

# 适用 acme.sh >= 3.0.0;Cloudflare API Token 需 Zone.DNS 编辑权限
export CF_Token="你的Cloudflare_API_Token"

acme.sh --issue --dns dns_cf 
  -d example.com -d '*.example.com'       # 通配符必须走 DNS-01
  --server letsencrypt                     # 切换到 Let's Encrypt,默认是 ZeroSSL
  --keylength ec-256                        # 默认 2048 位 RSA,ECC 体积更小

# fullchain.pem = 站点证书 + 中间 CA,缺一段就会在部分安卓/旧浏览器上报链不完整
acme.sh --install-cert -d example.com --ecc 
  --key-file       /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/fullchain.pem 
  --reloadcmd      "systemctl reload nginx"

三种部署方式怎么选?手动上传 PEM 最可控、能装 OV/EV,但过期前必须人工换证;CDN 托管免费证书(Cloudflare Universal SSL、阿里云免费 DV 证书)自动续期,代价是只覆盖 DV,且免费版通配符只匹配一级子域,a.b.example.com 不在覆盖范围内;ACME + 平台 API 自动上传最省人力,域名数超过 10 个时基本是唯一可持续的方案,也是后文 cdn ssl证书安装 自动化流程的基础。

哪些平台限制会让方案直接作废?必须先查,再买证书:Amazon CloudFront 只接受 us-east-1 区域 ACM 签发的证书,上传其他区域的 ARN 会报 The certificate must be in the us-east-1 region;Cloudflare 上传自定义证书需 Business 计划(约 200 美元/月起)或 Cloudflare for SaaS;国内 CDN(阿里云、腾讯云)要求域名已完成 ICP 备案,否则证书绑定成功后访问仍会被拦截。

常见报错与排查:这 6 条错误信息分别意味着什么

上一节验证通过不代表永远不出问题——CDN 侧 cdn ssl证书安装 最容易在换证书、换源站、改回源协议时集中爆发。下面 6 条是工单里出现频率最高的报错,每条给出根因、一条可直接复现的定位命令和修复方向。

报错信息 真实根因 一条定位命令 修复方向
curl: (60) unable to get local issuer certificate 服务端只下发叶子证书,链断了 s_client -showcerts | grep -c 'BEGIN CERTIFICATE' 上传 fullchain(2–3 张)
NET::ERR_CERT_COMMON_NAME_INVALID SAN 未覆盖当前域名 x509 -noout -ext subjectAltName 补签 SAN 或换证书
Cloudflare Error 526 源站证书过期/自签/域名不符 s_client 看 Verify return code 用 Origin CA 或降到 Full
Cloudflare Error 525 边缘到源站握手失败 s_client -connect 源站IP:443 -servername 域名 修监听/TLS 版本/SNI
「证书与私钥不匹配」 modulus 不同、BOM、带口令私钥 x509/rsa -noout -modulus | md5 重新导出 PEM
ERR_TOO_MANY_REDIRECTS CDN 强制 HTTPS 与源站 301 叠加 curl -I 逐跳看 Location 统一在 CDN 做跳转

Q:curl 报 (60) unable to get local issuer certificate,Go 程序报 x509: certificate signed by unknown authority,是同一个问题吗?

多数情况是。两者都表示客户端拿不到中间证书、无法把叶子证书连到受信任根。据 OpenSSL 官方文档,s_client 的 -showcerts 会打印服务端实际下发的整条链,数 -----BEGIN CERTIFICATE----- 的次数即可判定:公网证书通常应为 2–3 张(叶子 + 中间 + 可选根),只出现 1 张就是链缺失——这正是 cdn ssl证书安装 时最容易漏的一步。

# 1 = 链缺失;2–3 = 正常
openssl s_client -connect cdn.example.com:443 -servername cdn.example.com -showcerts </dev/null 2>/dev/null 
  | grep -c -- '-----BEGIN CERTIFICATE-----'

# Alpine / distroless 镜像里报 unknown authority,往往不是服务端问题,而是客户端没有根库
apk add --no-cache ca-certificates && update-ca-certificates

Q:浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID 或 Firefox 报 SSL_ERROR_BAD_CERT_DOMAIN?

CN 字段早已被主流浏览器忽略(RFC 6125 起以 SAN 为准),要看 subjectAltName。通配符只匹配一级:*.example.com 覆盖 a.example.com,不覆盖 a.b.example.com。

openssl x509 -in fullchain.pem -noout -ext subjectAltName
# 输出示例:DNS:example.com, DNS:*.example.com

Q:Cloudflare 526 与 525 怎么区分?

526 是「握手成功但证书验不过」,即 Full (strict) 模式下源站证书过期、自签名或域名不匹配;改用 Cloudflare Origin CA 证书(有效期最长 15 年,仅 Cloudflare 信任)或临时降到 Full。525 是「连证书都没拿到」,属于握手层失败。两者都可以绕过 CDN 直连源站复现:

# -servername 传 SNI,模拟边缘节点的握手
openssl s_client -connect 203.0.113.10:443 -servername cdn.example.com -tls1_2 </dev/null
# 526 常见 Verify return code: 10 (expired) / 18 (self signed)
# 525 常见 handshake failure 或 no peer certificate available —— 查 443 监听、是否只开 TLS 1.3、源站是否拒绝未知 SNI

Q:控制台上传提示「证书与私钥不匹配」或「证书格式错误」?

先确认 openssl x509 -in cert.pem -noout 能正常解析(解析失败多半是复制时丢了换行、混入 BOM 或上传了 .pfx),再做 modulus 比对:

openssl x509 -in cert.pem    -noout -modulus | openssl md5
openssl rsa  -in privkey.pem -noout -modulus | openssl md5
# 两行必须一致;报 unable to load Private Key 说明私钥带口令或不是 PEM

Q:浏览器报 ERR_TOO_MANY_REDIRECTS?

典型是 CDN 强制 HTTPS 跳转与源站 301 叠加,或回源协议设为 HTTP 而源站只监听 443。逐跳打印 Location 定位循环点:

curl -sI https://cdn.example.com/        | grep -iE '^(HTTP/|location)'
curl -sI http://origin.example.com/      | grep -iE '^(HTTP/|location)'

怎么确认 CDN 上的 SSL 证书真的生效了?六层验证法

证书上传成功、控制台显示”已部署”,和用户浏览器真正拿到一张可信证书,中间还隔着证书链、SNI 匹配、边缘节点下发、OCSP 装订等多个环节。以下六层验证按成本从低到高排列,任何一层失败都能定位到具体环节,不必靠猜。

第一层:响应正常就等于证书生效了吗?不等于,但它是 5 秒内能排除掉 80% 问题的起点。据 curl 官方文档,7.52 及以上版本默认以 OpenSSL 为 TLS 后端,握手失败会直接报错而非静默降级:

# 只看状态行,期望 HTTP/2 200 或 HTTP/1.1 200
curl -sSI https://www.example.com | head -1

# 看握手细节,必须出现 "SSL certificate verify ok."
curl -vI https://www.example.com 2>&1 | grep -E "SSL certificate verify|subject:|issuer:"

若输出 SSL certificate problem: unable to get local issuer certificate,几乎可以断定边缘只下发了叶子证书、中间证书没打包——这是 cdn ssl证书安装 中最常见的返工原因,Let’s Encrypt 文档也明确要求部署 fullchain 而非 cert.pem。

第二层:怎么确认边缘真的在跑 TLS 1.3 且证书链完整?用 openssl 直连,注意 -servername 必须显式传入,否则共享 IP 的 CDN 会回落到默认站点证书;</dev/null 用于防止交互挂起:

# OpenSSL 1.1.1+ 才支持 -tls1_3
openssl s_client -connect www.example.com:443 -servername www.example.com -tls1_3 </dev/null 
  | grep -E "Protocol|Verify return code|subject="
# 期望:Protocol : TLSv1.3
#       Verify return code: 0 (ok)

第三层:为什么本机正常、外地用户却报错?因为 CDN 是多节点部署,证书下发存在时间差。先用 dig +short 拿到 CNAME 与多个边缘 IP,再逐个用 --resolve 强制打到指定节点:

dig +short www.example.com
# 对每个节点 IP 逐一验证,ssl_verify_result 为 0 表示校验通过
curl --resolve www.example.com:443:203.0.113.10 https://www.example.com 
  -o /dev/null -w "%{http_code} %{ssl_verify_result}n"

第四层:外部工具看什么?把域名丢进 Qualys SSL Labs,目标 A 及以上;重点不是总分,而是三处细节:Certificate chain 是否显示完整链路(含中间证书)、OCSP stapling 是否为 Yes、TLS 1.3 是否 Supported。据 SSL Labs 评级规则,链不完整会直接压到 B 级以下,与密钥强度无关。

第五层:OCSP 装订有没有生效?装订由边缘节点代客户端查询吊销状态,可省掉一次额外的第三方请求(RFC 6960 定义的 OCSP 协议):

openssl s_client -connect www.example.com:443 -servername www.example.com -status </dev/null 
  | grep -A2 "OCSP Response Status"
# 期望:OCSP Response Status: successful (0x0)

第六层:怎么在证书过期前被叫醒?人工检查迟早会漏。用 Prometheus 的 blackbox_exporter(0.22+)采集 probe_ssl_earliest_cert_expiry(单位:秒级 Unix 时间戳),或用 cron 每日兜底:

# cron 每日 09:00 执行,输出 notAfter
0 9 * * * openssl s_client -connect www.example.com:443 -servername www.example.com </dev/null 
  | openssl x509 -noout -enddate
# Prometheus 告警规则:剩余不足 21 天触发
- alert: CDNCertExpiringSoon
  expr: probe_ssl_earliest_cert_expiry - time() < 21 * 86400
  for: 1h

把六层中常见的失败现象与根因对照起来,排查时可直接反查:

看到的报错/现象 根因 处理
unable to get local issuer certificate 未打包中间证书 按 叶子→中间 顺序拼 fullchain 重传
Verify return code: 21 同上,链断在中间 同上
Verify return code: 10 边缘仍是旧证书 刷新部署、等待节点下发
no alternative certificate subject name matches SNI 未命中或域名不在 SAN 内 核对证书 SAN 与控制台域名绑定
本机 ok、某节点 ssl_verify_result 非 0 单节点未同步 单节点重推或提工单

续期与自动化:别让证书在凌晨过期

Let’s Encrypt 证书有效期 90 天,官方明确建议在剩余 30 天时开始续期——不是到期前几天。据 Let’s Encrypt 文档(”Why ninety-day lifetimes for certificates?”),缩短有效期是为了限制密钥泄露与吊销的暴露窗口,代价就是把续期责任完全交给自动化。手工续期意味着每年至少 4 次操作窗口,任何一次遗漏都会让 CDN 边缘节点在凌晨返回握手失败。

certbot 2.x 通过发行版包安装后会自动注册 systemd timer,无需再手写 cron。先确认它真的在跑:

# 确认 certbot 定时器已启用(certbot 2.x,Debian/Ubuntu 包默认启用)
$ systemctl list-timers | grep certbot
Mon 2024-06-10 03:14:22 CST  7h left  Mon 2024-06-10 00:41:07 CST  16h ago  certbot.timer  certbot.service

# 查看下一次执行与随机延迟(timer 默认 Persistent=true,每天两次带随机延迟)
$ systemctl cat certbot.timer | grep -E "OnCalendar|RandomizedDelaySec"
OnCalendar=*-*-* 00/12:00:00
RandomizedDelaySec=12h

随机延迟的设计意图是避免大量主机在同一秒涌向 ACME 服务器触发速率限制(Let’s Encrypt 对同一注册域名有 50 张/周的签发上限)。只有续期成功后才会触发部署钩子,所以上传动作天然幂等:

# /etc/letsencrypt/renewal-hooks/deploy/upload_cert.sh
# 仅当证书确实被续期时执行;未续期则 certbot 不调用此钩子
certbot renew --deploy-hook "/usr/local/bin/upload_cert.sh"

阿里云场景下,脚本的核心是先用 CAS 上传拿到 CertId,再用 CDN 接口绑定——不要直接覆盖旧证书,保留 CertId 才能在出问题时回滚到上一代:

#!/bin/bash
set -euo pipefail
DOMAIN="example.com"
LIVE="/etc/letsencrypt/live/${DOMAIN}"

# 1) 上传到数字证书管理服务(CAS),名称带年月便于识别与回滚
CERT_ID=$(aliyun cas UploadUserCertificate 
  --Name "${DOMAIN}-$(date +%Y%m)" 
  --Cert "$(cat ${LIVE}/fullchain.pem)" 
  --Key  "$(cat ${LIVE}/privkey.pem)" 
  | grep -o '"CertId":[0-9]*' | cut -d: -f2)

# 2) 绑定到 CDN 域名,--ServerCertificateStatus on 才会真正启用
aliyun cdn SetDomainServerCertificate 
  --DomainName "${DOMAIN}" 
  --ServerCertificateStatus on 
  --CertName "${DOMAIN}-$(date +%Y%m)" 
  --ServerCertificate "$(cat ${LIVE}/fullchain.pem)" 
  --PrivateKey "$(cat ${LIVE}/privkey.pem)"

echo "$(date -Is) renewed CertId=${CERT_ID}" >> /var/log/cdn-cert.log

最容易踩的坑是只续了边缘、忘了源站。CDN 回源时用的是源站自己的证书,边缘证书再新也没用;源站过期时 Cloudflare 会直接返回 Error 526 Invalid SSL certificate,阿里云 CDN 则表现为回源 502 并在日志里出现 SSL handshake failed。把两侧到期时间放进同一张巡检表,统一在到期前 21 天处理:

位置 证书来源 续期方式 过期后的典型报错 巡检阈值
CDN 边缘节点 控制台上传的 fullchain.pem deploy-hook 调 API 自动上传 浏览器 NET::ERR_CERT_DATE_INVALID 剩余 ≤ 21 天
源站 Nginx/Apache 同一份 LE 证书或商业证书 certbot reload + systemctl reload nginx Cloudflare 526 / 回源 SSL handshake failed 剩余 ≤ 21 天

轮换与备份同样要写进流程:私钥至少保留最近两代,文件按「域名-到期日」命名(如 example.com-20240912.pem),便于比对与回滚。若怀疑私钥泄露,顺序是先在 CA 后台吊销、再重新签发、最后全量替换所有 CDN 节点——只换节点不吊销,旧证书仍在有效期内可被冒用。据 Mozilla Server Side TLS 指南,吊销后应同步更新 OCSP/CRL 配置,否则部分客户端仍会短暂信任旧证书。

是。CDN 边缘节点要完成 TLS 握手就必须持有私钥,因此上传时私钥会离开你的服务器。若不愿交出私钥,可考虑由厂商托管签发的证书方案,或使用支持自有密钥托管的边缘平台,但要先通过相应的合规评估。

浏览器会通过证书里的 AIA 字段自动下载中间证书补链,而多数 HTTP 客户端不会。把 fullchain.pem(叶子证书 + 中间证书)完整上传到 CDN,再用 openssl verify -untrusted 验证,即可消除这类差异。

不能。免费版与 Pro 版使用 Cloudflare 签发的 Universal SSL,只覆盖一级子域;上传自定义证书需要 Business 套餐(约 200 美元/月起)或 Cloudflare for SaaS。若只是想让源站用自有证书,可改用 Full (strict) 并部署 Cloudflare Origin CA。

不必。边缘证书面向访客,源站证书只在回源链路上校验,可以是不同 CA、不同有效期的两张证书。但 Full (strict) 模式要求源站证书由公共 CA 或 Cloudflare Origin CA 签发且域名匹配,否则会报 526。

先确认是 PEM 而非 .pfx/.p12:用 openssl pkcs12 -in cert.pfx -nodes -out all.pem 转换后拆出证书与私钥;再检查文件是否带 UTF-8 BOM、是否缺 —–END CERTIFICATE—– 结尾、私钥是否带口令。用 openssl x509 -in cert.pem -noout -subject 能正常解析后再重试。

只覆盖一层。*.example.com 匹配 www.example.com、api.example.com,但不匹配 example.com 裸域,也不匹配 a.b.example.com。需要裸域时把 example.com 写进 SAN,需要多级子域则单独签发或改用多域证书。

先在 CDN 证书管理里保留上一版证书并记录 CertId,续期上传后若 5–30 分钟仍未生效,直接把域名绑定切回旧 CertId。同时用 openssl s_client -servername 对比新旧证书的 serial 与 notAfter,判断问题出在上传环节还是节点下发环节。


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

内容审核

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