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

腾讯云 CDN HTTPS 配置全流程:证书上传、TLS 版本、强制跳转与生效验证

腾讯云cdn https配置 — 腾讯云 CDN HTTPS 配置全流程:证书上传、TLS 版本、强制跳转与生效验证
核心结论

腾讯云 CDN 配置 HTTPS 的核心动作是:把含中间 CA 的完整 PEM 证书链与私钥上传到「域名管理 → HTTPS 配置」,开启强制跳转 301,并勾选 TLS 1.2/1.3 与回源 SNI,提交后约 5-10 分钟全网生效。 证书链不完整是最常见故障:用 openssl s_client -connect 域名:443 -servername 域名 -showcerts 统计 BEGIN CERTIFICATE 数量,少于 2 段即说明缺少中间证书,浏览器会报 ERR_CERT_AUTHORITY_INVALID。 推荐参数基线:TLS 版本选 TLSv1.2 + TLSv1.3、开启 HTTP/2 与 OCSP Stapling、HSTS max-age 先设 300 试运行再升到 31536000、回源端口 443 且必须勾选回源 SNI。 腾讯云免费 DV 证书有效期为 90 天、每账号每年约 20 张额度;付费 DV 单域名约 200-600 元/年,泛域名 DV 约 1000-2000 元/年,OV 约 1500-4000 元/年,需按子域数量与合规要求选型。 验证是否生效只需三条命令:curl -sI http://域名 看 301、curl -sI --http2 https://域名 看 HTTP/2 200、openssl s_client 看证书链与到期时间。

为什么腾讯云 CDN 开了 HTTPS,浏览器还是提示证书不可信?

先说结论:控制台里 HTTPS 状态显示「已开启」,只说明腾讯云 CDN 已经拿到了你的证书,不等于证书链完整、不等于流量真的走了 CDN、也不等于证书覆盖了你访问的那个主机名。这三种情况在浏览器里报的错各不相同,按报错信息对号入座,比反复重传证书快得多。

根因 典型报错 一条命令定性 修复方向
CNAME 未生效,流量没进 CDN 证书是源站那张,改 CDN 配置毫无变化 dig +short 你的域名 改 DNS 解析,等 TTL 过期
只传了叶子证书,缺中间 CA ERR_CERT_AUTHORITY_INVALID / curl (60) openssl s_client -showcerts 上传「叶子+中间」合并的全链 PEM
SAN 不匹配 ERR_CERT_COMMON_NAME_INVALID openssl x509 -ext subjectAltName 补签 SAN 或多域名/泛域名证书
TLS 版本策略过严 ERR_SSL_VERSION_OR_CIPHER_MISMATCH openssl s_client -tls1_1 按客户端画像决定是否保留 TLS 1.0/1.1
回源 HTTPS 未开 SNI CDN 侧 502 源站 access.log 看命中的 server 块 控制台开启「回源 SNI」
加速区域境内但未备案 控制台直接提示开启失败 看控制台报错文案 先完成 ICP 备案

第一步永远是确认 CNAME,而不是证书。很多人在腾讯云 CDN 的 HTTPS 配置里反复折腾,其实解析根本没生效:

# 确认流量是否真的被调度到 CDN 节点
dig +short www.example.com
# 正常:返回 *.cdntip.com / *.dnsv1.com 之类的调度域名(CNAME 链)
# 异常:返回源站 A 记录 —— 说明浏览器验证的是源站证书,此时改 CDN 配置没有任何意义

dig +trace www.example.com | grep -E "CNAME|ANSWER SECTION"   # 看整条 CNAME 链在哪一跳断掉

第二步查证书链。据 CA/Browser Forum 的 TLS 基线要求(Baseline Requirements §7.1.2),服务器必须下发「叶子证书 + 全部中间 CA」,根证书可省略(客户端本地已有)。腾讯云 CDN 的控制台只接受 PEM,如果你只贴了域名证书那一段,链就断了——Firefox 与 curl 会立刻报错,而 Windows 上的 Chrome 因为会走 AIA 抓取中间证书,可能反而”看起来正常”,这正是问题难以复现的原因。

# 验证链是否完整:关注 depth / verify 两行
openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts &1 | grep -E "^(depth|verify)"
# verify return:1                                    → 链完整
# verify error:num=20 unable to get local issuer certificate → 缺中间 CA
# 合并全链的顺序必须是「叶子在前、中间在后」,反了同样失败:
cat www.example.com.crt intermediate.crt > fullchain.pem

第三步核对 SAN 与协议版本,这两个问题在腾讯云 CDN 上常被混淆。SAN 方面,证书只签了 example.com 却用 www.example.com 访问会报 ERR_CERT_COMMON_NAME_INVALID;泛域名 *.example.com 只覆盖一级子域,a.b.example.com 不在覆盖范围内,必须单独签发。协议方面,腾讯云 CDN 默认同时开放 TLSv1.0/1.1/1.2(TLS 1.3 需手动勾选,协议定义见 RFC 8446),若你在控制台只勾选 TLS 1.2/1.3,仍停留在 JDK 6、Android 4.4 上的旧客户端会直接握手失败。

# 看实际下发的 SAN 列表
openssl s_client -connect www.example.com:443 -servername www.example.com /dev/null 
  | openssl x509 -noout -subject -dates -ext subjectAltName

# 探测旧协议是否被服务端拒绝(预期报 handshake failure 才说明已收紧)
openssl s_client -connect www.example.com:443 -servername www.example.com -tls1_1 &1 | head -5

第四步看回源。回源协议选了 HTTPS 但没开「回源 SNI」(腾讯云 CDN 该开关默认关闭),源站 Nginx 会命中第一个 server 块的默认证书,CDN 校验失败后给客户端返回 502,浏览器端看到的不是证书错误而是网关错误,很容易误判成源站宕机。源站多域名共用一个 IP 时,回源 SNI 是必开项。

最后别忘合规前置条件:加速区域为「中国境内」的域名必须先完成 ICP 备案,未备案域名在控制台开启 HTTPS 会直接提示失败,与证书本身无关。做腾讯云 CDN HTTPS 配置时,先排除备案与 CNAME 这两层”非证书因素”,再谈证书链和 TLS 版本,能省掉大半的返工。

腾讯云 CDN HTTPS 配置的完整操作步骤(6 步)

腾讯云 CDN 的 HTTPS 配置能一次点完吗?不能。控制台里那几个开关只是最后一步,前面的备案、CNAME、证书链格式、源站回源能力,任何一环缺失都会让提交后的状态卡在「部署中」或直接报错。完整走完下面 6 步大约 15–20 分钟。

  1. 前置校验(约 10 分钟,最容易被跳过)。四项同时满足才动手:域名已完成 ICP 备案;CNAME 已指向 CDN 调度域名;控制台域名状态为「已启动」;源站 443 端口对公网可达。任一项不满足,后面的腾讯云 CDN HTTPS 配置必然失败。命令如下:
# 1) CNAME 是否生效:应返回腾讯云 CDN 调度域名(形如 xxx.cdntip.com)
dig +short www.example.com CNAME

# 2) 源站 443 是否可从公网访问(nc 来自 netcat,CentOS 需 yum install -y nmap-ncat)
nc -zv 203.0.113.10 443        # 期望输出:succeeded / open

# 3) 证书链是否完整:fullchain 中应有 2–3 段 BEGIN CERTIFICATE(叶子 + 中间 CA)
grep -c "BEGIN CERTIFICATE" fullchain.crt

# 4) 私钥是否带口令保护:出现 "ENCRYPTED" 即不可直接上传,需先解密
openssl rsa -in private.key -check -noout

# 5) 证书与私钥是否配对:两条命令输出的 MD5 必须一致
openssl x509 -noout -modulus -in fullchain.crt | openssl md5
openssl rsa  -noout -modulus -in private.key  | openssl md5

第 4 步若报 unable to load Private Key ... bad decrypt,说明私钥被口令加密;第 5 步两条 MD5 不一致,控制台会直接提示「证书与私钥不匹配」。这两种情况是上传失败最常见的原因。

  1. 准备证书。在 SSL 证书控制台申请免费 DV 证书(单域名、有效期 90 天,据腾讯云文档每个账号每年约 20 张额度),或上传自有证书。必须是 PEM 文本格式,fullchain.crt 内含 2–3 段 -----BEGIN CERTIFICATE-----,私钥单独存为 .key 且不能带口令。
  2. 上传到 CDN。CDN 控制台 → 域名管理 → 目标域名「管理」→ HTTPS 配置;证书来源选「自有证书」粘贴 fullchain 与 key,或选「腾讯云托管证书」直接下拉选择已签发证书。提交后状态变为「部署中」。
  3. 开启 HTTPS 与强制跳转。打开 HTTPS 开关,「强制跳转」选 HTTP → HTTPS 并优先用 301,避免 302 造成权重传递损耗。站点若仍有必须保留的 HTTP 接口(第三方回调、老 App 轮询),先用「协议跟随」灰度,确认无依赖再切 301。
跳转方式 状态码 权重传递 适用场景 风险
强制 HTTPS 301 完整 已确认无 HTTP 依赖的正式站点 浏览器永久缓存,回滚需清缓存
强制 HTTPS 302 不传递 灰度验证阶段 长期使用不利于 SEO
协议跟随 不跳转 — 仍有 HTTP 接口或第三方回调 源站需同时监听 80 与 443
  1. 协议与安全加固。TLS 版本勾选 TLSv1.2 + TLSv1.3,确认无老旧客户端后可关闭 TLSv1.0/1.1(PCI DSS 已不接受 1.0);开启 HTTP/2(依赖 HTTPS 已开启)与 OCSP Stapling。HSTS 先设 max-age=300 试运行 24 小时,确认没有 HTTP 子域依赖后再改为 31536000;includeSubDomains 与 preload 慎用,一旦提交到浏览器预置列表几乎不可撤销(HSTS 机制定义见 RFC 6797)。
  2. 回源配置。回源协议按源站能力选 HTTPS 或「协议跟随」,回源端口填 443,务必勾选「回源 SNI」——多域名共用 IP 的源站不填 SNI 会返回错误证书导致 502。保存后等待 5–10 分钟全网下发(腾讯云文档给出约 5 分钟、跨区域最迟约 30 分钟),期间不要反复改配置。验证命令:
# 协议与 ALPN 协商结果:应看到 TLSv1.3 与 ALPN protocol: h2
openssl s_client -connect www.example.com:443 -servername www.example.com -alpn h2 /dev/null 
  | grep -E "Protocol|Cipher|ALPN"

# 强制跳转是否生效:应返回 301 且 Location 指向 https
curl -sSI http://www.example.com | head -5

# HSTS 头是否下发
curl -sSI https://www.example.com | grep -i strict-transport-security

若 openssl s_client 仍显示 TLSv1.2 而控制台已勾选 1.3,多半是配置尚未下发完成,等满 5 分钟再测;若 curl -I 返回 200 而非 301,检查是否同时开了「协议跟随」与「强制跳转」,两者互斥。

证书链拼接与验证的具体命令、控制台参数示例

拼接证书链不是”把文件堆一起”这么随意——腾讯云 CDN 回源到你自己的源站、或你从源站取证书上传到 CDN 时,如果链里只有站点证书而没有中间证书,Android 7 以下、部分 Java 客户端和老版本 curl 都会直接报 unable to get local issuer certificate。据 OpenSSL 官方文档,s_client 默认只加载系统根证书库,服务端若不主动下发中间证书,客户端无法自行补齐。所以先用两条命令把”拼得对不对”和”私钥配不配”钉死,再去腾讯云cdn https配置页面里粘贴。

怎么拼接 fullchain 并确认私钥与证书真的是一对?

顺序是硬约束:站点证书在前、中间证书在后,根证书不要放(客户端自带)。适用 OpenSSL 1.1.1 及以上,1.0.2 亦可。

# 1) 拼接完整链:server.crt 在前,intermediate.crt 在后,顺序不能反
cat server.crt intermediate.crt > fullchain.crt

# 2) 校验证书与私钥是否配对:两条命令输出的 MD5 必须完全一致
openssl x509 -noout -modulus -in fullchain.crt | openssl md5
openssl rsa  -noout -modulus -in server.key      | openssl md5

# 3) ECC 证书:把 rsa 换成 ec 参数
openssl x509 -noout -modulus -in fullchain.crt | openssl md5
openssl ec   -noout -modulus -in server.key    | openssl md5

若 ECC 私钥是 PKCS#8 格式(首行为 -----BEGIN PRIVATE KEY-----),openssl ec 会报 unable to load key ... Expecting: EC PRIVATE KEY,此时改用公钥指纹法,对 RSA/ECC 通用,且比 MD5 更安全(可用 sha256 替代):

openssl pkey -in server.key -pubout | openssl sha256
openssl x509 -in fullchain.crt -noout -pubkey | openssl sha256

上传后如何验证链真的完整、TLS 版本真的生效?

# 统计服务端下发的证书数量,返回值 ≥2 说明链完整
openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'

# 核对 CN/SAN 与到期时间,notAfter 需覆盖你的预期周期
openssl s_client -connect www.example.com:443 -servername www.example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates

# 探测 TLS 1.1 是否已关闭:期望返回 alert protocol version 或 handshake failure
openssl s_client -connect www.example.com:443 -servername www.example.com -tls1_1 </dev/null
# 把 -tls1_1 换成 -tls1_2 应能正常完成握手(RFC 8446 定义 TLS 1.3 握手,1.3 用 -tls1_3 探测)

注意 -servername 不能省:腾讯云 CDN 是多租户共享 IP,不带 SNI 会命中默认证书,验证结果失真。

三条 curl 快速体检:跳转、HTTP/2、HSTS

curl -sI http://www.example.com | head -3                                  # 应见 301 与 Location: https://...
curl -sI --http2 https://www.example.com | head -1                         # 应返回 HTTP/2 200
curl -sI https://www.example.com | grep -i strict-transport-security      # 应见 max-age 值

腾讯云 CDN 控制台参数:默认值 vs 推荐值

参数 默认值 推荐值 说明
TLS 版本 1.0 / 1.1 / 1.2 1.2 / 1.3 关闭 1.0、1.1 以规避 PCI DSS 不合规
HTTP/2 关闭 开启 需先配置证书
OCSP Stapling 开启 保持开启 减少客户端额外握手往返
强制跳转 关闭 301 301 利于权重传递与浏览器缓存
回源 SNI 关闭 开启 源站多域名共用 IP 时必须开
回源端口 80 443 配合回源协议 HTTPS 使用
HSTS max-age 未开启 31536000 即 1 年,据 Mozilla SSL 配置生成器建议值

证书到期如何自动告警?

Let’s Encrypt 证书有效期已缩短至 90 天,人工盯不住。把下面这行放进 crontab,每天 08:00 跑一次,2592000 是 30 天的秒数,|| 左侧失败即触发告警:

# crontab -e 中加入(0 8 * * * 表示每天 08:00)
0 8 * * * echo | openssl s_client -connect www.example.com:443 -servername www.example.com 2>/dev/null | openssl x509 -noout -checkend 2592000 || echo '证书 30 天内到期'

证书类型与 TLS 策略怎么选?两张对比表

证书买哪一档、TLS 版本开到几、RSA 还是 ECC、加速区域选境内还是全球——这四个问题决定了腾讯云cdn https配置的成本上限与兼容性下限。先用两张表把选项收敛,再动手传证书。

先看证书。据 Let’s Encrypt 文档,免费 DV 与付费 DV 在浏览器信任链上没有任何差别,差别只在有效期、赔付条款和审核流程;据 CA/Browser Forum 2025 年通过的 SC-081 提案,公有证书最长有效期将分阶段压缩(2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天),这意味着”买一年省事”的付费证书优势会逐年变薄。

证书类型 价格区间(2024–2025 腾讯云公开报价常见档位) 有效期 覆盖范围 适合谁
免费 DV 0 元 90 天,需自动续期 单域名 个人站、测试环境、证书成本高于流量成本的站点
付费 DV 单域名 约 200–600 元/年 1 年 单域名 不想每 90 天维护续期脚本的小型业务
DV 泛域名 约 1000–2000 元/年 1 年 *.example.com,覆盖一级子域;不含 example.com 本身,也不含二级子域 多子域共用一张证书,如 api/img/static
OV 单域名 约 1500–4000 元/年 1 年 单域名,需提交营业执照等企业资质,人工审核约 1–3 个工作日 金融、政企等需要组织身份背书的站点
EV 高于 OV 1 年 单域名 浏览器地址栏自 2019 年起不再特殊展示组织名,性价比低

算法上,RSA 2048 位兼容性最好,是默认选择;ECC P-256 证书体积约为 RSA 2048 的 1/6,握手时少传一个大数据包,移动端首包收益明显,但极老客户端可能不支持。腾讯云 CDN 允许同一域名同时上传 RSA 与 ECC 两张证书,节点按客户端 signature_algorithms 自动协商,不必二选一。上传前先自检,避免控制台报「证书与私钥不匹配」:

# 1) 确认证书密钥类型与长度:RSA 输出 rsaEncryption / 2048 bit,ECC 输出 id-ecPublicKey / 256 bit
openssl x509 -in fullchain.pem -noout -text | grep -E "Public Key Algorithm|Public-Key"

# 2) 校验证书与私钥是否配对:两行 md5 必须一致,不一致即控制台报「证书与私钥不匹配」
openssl x509 -in fullchain.pem -noout -pubkey | openssl md5
openssl pkey -in privkey.key -pubout | openssl md5

# 3) 配置生效后,查看节点实际协商出的协议与套件(-servername 不可省,否则可能拿到默认站点证书)
openssl s_client -connect cdn.example.com:443 -servername cdn.example.com -tls1_2 /dev/null | grep -E "Protocol|Cipher"

适用版本:以上命令在 OpenSSL 1.1.1 与 3.x 通用;CentOS 7 自带的 OpenSSL 1.0.2 不支持 -tls1_3 参数,需升级或改用 openssl11。注意 openssl pkey 对 RSA 和 ECC 私钥都适用,比老教程里的 openssl rsa -modulus 更通用(ECC 私钥没有 modulus)。

TLS 版本在腾讯云 CDN 控制台是多选而非单选,历史域名的勾选状态可能是全兼容组合,上线前以当前勾选为准;据 Mozilla Server Side TLS 指南,TLS 1.2 应作为最低基线,TLS 1.3 为推荐。

策略档位 握手协议 兼容范围 风险与建议
TLS 1.0 + 1.1 + 1.2 1.0/1.1/1.2 Android 4.x、IE8 等 2015 年前设备 Chrome 84、Firefox 74 于 2020 年前后弃用,RFC 8996 已正式弃用 1.0/1.1;仅建议过渡期使用
仅 TLS 1.2 1.2 2015 年后设备与浏览器 通用基线,满足 PCI DSS 对 TLS 1.2 以上的要求
TLS 1.2 + 1.3 1.2/1.3 现代浏览器与移动端 现代站点推荐值:TLS 1.3(RFC 8446)1-RTT 握手,移除 RSA 密钥交换与 CBC 套件,首包更快
仅 TLS 1.3 1.3 Chrome 70+、iOS 12.2+ 只适合内网或新业务;公网站点会挡掉一批存量客户端

关闭旧协议后,用探测命令确认,被拒绝时典型输出是 alert protocol version:

# 主动尝试 TLS 1.0:有 Protocol 行说明仍开放;输出 alert protocol version 说明已被拒绝
openssl s_client -connect cdn.example.com:443 -servername cdn.example.com -tls1 &1 | grep -E "Protocol|alert"

加速区域这一步常被忽略:中国境内加速要求域名完成 ICP 备案,适合国内用户为主;全球加速覆盖境外节点,但境内访问需跨境回源,延迟更高;用户主要在境外时,直接用境外加速或海外 CDN 方案,可同时避开备案与跨境链路双重成本。

成本上,CDN 流量按阶梯计价,中国境内约 0.2 元/GB 起,HTTPS 请求本身不额外计费——这是腾讯云cdn https配置里最容易被误解的一点:开 HTTPS 不涨价,涨价的是证书。日 PV 10 万、单页 200KB 的站点,月流量约 600GB,流量费约 120 元;而一张 DV 泛域名证书年费 1000 元以上,此时证书成本已高于流量成本,免费 DV 配合自动续期更划算。证书成本 + 流量成本才是完整 TCO。

档位定下来后,下一步就是把证书传进控制台并配置强制跳转。

腾讯云 CDN HTTPS 常见报错与逐条排查方法

问:浏览器报 ERR_CERT_AUTHORITY_INVALID,curl 报 (60) unable to get local issuer certificate,是什么原因?

九成是证书链不完整——你只上传了叶子证书,没带中间 CA。据 Let’s Encrypt 文档,其签发的 fullchain.pem 就是”叶子在前、中间证书在后”的拼接格式;腾讯云 CDN 只认这种顺序。先数一下线上实际下发的证书段数:

# 统计服务端下发的证书段数,正常应 ≥ 2(叶子 + 中间 CA)
openssl s_client -connect cdn.example.com:443 -servername cdn.example.com 
  -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'

# 只有 1 段时:重新下载中间 CA 并拼接(顺序不可颠倒)
cat example.com.crt intermediate.crt > fullchain.crt
openssl verify -untrusted intermediate.crt fullchain.crt   # 期望输出 fullchain.crt: OK

问:ERR_CERT_COMMON_NAME_INVALID 怎么定位?

证书 SAN 里没有当前访问的域名。按 RFC 6125,现代客户端只校验 SAN、完全忽略 CN 字段,所以要直接看 SAN:

openssl x509 -noout -text -in fullchain.crt | grep -A1 'Subject Alternative Name'

特别注意泛域名匹配规则:*.example.com 只覆盖一级,a.b.example.com 不在其内,必须重新签发或改用多域名(SAN)证书。

问:ERR_SSL_VERSION_OR_CIPHER_MISMATCH 或 sslv3 alert handshake failure?

客户端与服务端的 TLS 版本/套件没有交集。逐版本复现(OpenSSL 3.x 默认已禁用 TLS 1.0/1.1,需显式降安全级别,否则会误报 “no protocols available”):

# 逐个版本试探,成功的会打印 "Protocol  : TLSv1.1" 等
openssl s_client -connect cdn.example.com:443 -servername cdn.example.com 
  -tls1_1 -cipher 'DEFAULT@SECLEVEL=0' </dev/null

结果与控制台勾选范围比对即可定位。若业务确实要兼容旧设备,临时放开 TLS 1.0/1.1,并在变更单里记录 PCI DSS 3.2 已明确不接受的合规风险。

问:控制台上传时报「证书格式错误」?

通常是上传了 DER/PFX 二进制、把私钥粘进证书框,或漏了 BEGIN/END 行。PEM 必须是 Base64 文本:证书首行 -----BEGIN CERTIFICATE-----,私钥首行 -----BEGIN PRIVATE KEY----- 或 -----BEGIN RSA PRIVATE KEY-----,且不能带口令。上传前自检:

file cert.crt                      # 出现 "PEM certificate" 才对,ASCII text 才是文本
head -1 cert.crt; head -1 key.pem  # 确认首行标记
openssl rsa -in key.pem -check -noout   # 报 "RSA key ok" 且不提示输入密码才合格

问:回源 502 / 525 该从哪一层查?

525 是 CDN 与源站 TLS 握手失败,502 多为源站拒绝连接。先跳出 CDN、直连源站验证,避免在错误层面反复改配置:

# 带 SNI 直连源站,确认源站证书有效且未过期
openssl s_client -connect 203.0.113.10:443 -servername origin.example.com </dev/null 
  | openssl x509 -noout -subject -dates

三项优先级:回源 SNI 是否开启(多域名共用 IP 的源站不开必失败)→ 源站证书是否过期 → 源站 443 是否放通。

问:开了强制跳转,HTTP 仍返回 200?

先排除入口绕过:源站 IP 直连、旧 CDN 未下线、对象存储默认域名。另外浏览器会缓存 301,测试别用浏览器:

curl -sI http://cdn.example.com/ | head -3            # 期望 301/302 + Location: https://...
curl -sI -H 'Cache-Control: no-cache' http://cdn.example.com/   # 排除缓存干扰
报错现象 根因 一条验证命令 修复动作
ERR_CERT_AUTHORITY_INVALID / curl (60) 缺中间 CA s_client -showcerts | grep -c 'BEGIN CERT' 叶子+中间证书拼接后重传
ERR_CERT_COMMON_NAME_INVALID SAN 不含该域名 x509 -text | grep -A1 'Alternative Name' 重签或多域名证书
ERR_SSL_VERSION_OR_CIPHER_MISMATCH TLS 版本/套件无交集 s_client -tls1_1 -cipher 'DEFAULT@SECLEVEL=0' 调整控制台 TLS 范围
证书格式错误 非 PEM 文本 / 私钥带密码 file cert.crt 转 PEM、去口令后重传
回源 502 / 525 SNI 未开 / 源站证书过期 s_client -connect IP:443 -servername 域名 开回源 SNI、续签源站证书
强制跳转失效 绕过 CDN 的入口或 301 缓存 curl -sI -H 'Cache-Control: no-cache' 收敛入口、下线旧 CDN

排查顺序建议固定为:DNS 解析到的 IP → 线上实际下发的证书链 → TLS 握手版本 → 回源链路。腾讯云 CDN 控制台的”证书详情”只反映配置状态,不反映线上握手结果,务必以 openssl s_client 实测为准;加密套件选型可参考 Mozilla SSL Configuration Generator 的 intermediate 档位,作为 TLS 1.2/1.3 的兼容基线。

怎么确认腾讯云 CDN 的 HTTPS 配置真的生效了?

控制台上那个绿色对勾只代表「配置已提交」,不代表「全网节点已生效」。腾讯云 CDN 的配置下发是异步的,边缘节点存在分钟级的时间差,所以要用外部视角逐层验证。下面这六步按「解析 → 证书 → 协议 → 评级 → 多地域 → 浏览器」的顺序做,前一步不通就别看后一步。

第一步:先确认域名真的解析到了 CDN。如果解析还没生效,后面所有 TLS 检查都可能打到源站,结论完全无效。

# 查 A 记录与 CNAME,正常应返回形如 xxx.cdn.dnsv1.com 的调度域名
dig +short www.example.com
dig +short www.example.com CNAME

# 换两个公共 DNS 交叉验证,排除本地缓存造成的误判
dig @8.8.8.8 +short www.example.com
dig @223.5.5.5 +short www.example.com

如果返回的是源站 IP 而不是 CNAME,说明接入未完成或 CNAME 被其他记录覆盖;用 dig +trace 可以定位是哪一级权威服务器在返回旧值。

第二步:确认 CDN 加载的是新证书,而不是旧缓存。证书链不完整是最常见的隐蔽故障,PC 浏览器能过、旧版 Android 和 Java 客户端会直接报 unable to get local issuer certificate。

# 证书链深度:叶证书 + 至少 1 张中间证书,结果应 ≥2
openssl s_client -connect www.example.com:443 -servername www.example.com 
  -showcerts /dev/null | grep -c 'BEGIN CERTIFICATE'

# 到期时间与签发者,notAfter 必须与你上传的证书一致
openssl s_client -connect www.example.com:443 -servername www.example.com 
  /dev/null | openssl x509 -noout -dates -issuer

据 Let’s Encrypt 文档,其证书链自 2024 年 6 月起不再提供 ISRG Root X1 的交叉签名,只上传站点证书而不带中间证书时,老旧终端的失败率会明显上升。腾讯云 CDN 的证书管理页支持粘贴完整 PEM 链,把中间证书按「站点证书在前、中间证书在后」拼接上传即可。

第三步:验证协议行为三件套——强制跳转、HTTP/2、旧协议拒绝,三项同时通过才算闭环。

# 期望首行是 HTTP/1.1 301,且带 Location: https://
curl -sI http://www.example.com | head -3

# 期望首行是 HTTP/2 200
curl -sI --http2 https://www.example.com | head -1

# 期望握手被拒:sslv3 alert handshake failure / no protocols available
openssl s_client -connect www.example.com:443 -servername www.example.com 
  -tls1_1 &1 | grep -iE 'alert|no protocols'

踩坑提醒:在 RHEL 9 / Ubuntu 22.04 自带的 OpenSSL 3.x 上,系统 crypto-policy 可能已在本地禁用 TLS 1.1,-tls1_1 无论 CDN 怎么配都会失败,属于假阳性。加 -cipher 'DEFAULT@SECLEVEL=0' 或改用 testssl.sh 复测更可靠。腾讯云 CDN 的 TLS 版本最低可选 TLS 1.0 / 1.1 / 1.2 / 1.3,生产环境建议锁定 1.2 起,与 Mozilla 服务器端 TLS 推荐的「Intermediate」档一致。

第四步:跑外部评级。testssl.sh 3.x 是开源脚本,能逐项列出套件、协议与 HSTS 问题:

git clone --depth 1 https://github.com/drwetter/testssl.sh.git
cd testssl.sh
# --severity HIGH 只报高危与警告项,输出更聚焦;目标是 A 级及以上
./testssl.sh --severity HIGH www.example.com

也可以直接用 Qualys SSL Labs 在线检测。出现 WARN 时优先看两类:一是仍在协商 CBC 套件或未启用 HSTS,二是缺少 OCSP Stapling——前者在 CDN 控制台的「TLS 加密套件」里切换预设模板即可,后者在证书配置中开启 Stapling 开关。

第五步:多地域拨测。用腾讯云「云拨测」从华北、华东、华南、新加坡等节点分别发起 HTTPS 请求,比对各节点返回的证书指纹是否一致(openssl x509 -noout -fingerprint -sha256)。单点通过不代表全网生效,海外节点通常比境内晚数分钟。

第六步:浏览器复核。Chrome 开发者工具 Security 面板中,Connection 应显示 TLS 1.3,Certificate 应能展开完整链且无红色警告;同时看 Console 是否有 Mixed Content 报错,页面里残留的 http:// 图片或脚本会让地址栏锁标变成「不安全」,这是 CDN 侧无论如何配置都修不好的部分。

验证现象 最可能原因 处理动作
grep -c 返回 1 只上传了站点证书,缺中间证书 拼接完整 PEM 链后重新上传
notAfter 仍是旧日期 配置已提交但节点未刷新 等待 5–10 分钟或重新部署证书
--http2 返回 HTTP/1.1 未开启 HTTP/2 或 TLS 最低版本过低 控制台开启 HTTP/2,TLS 最低 1.2
http 请求未返回 301 「强制跳转 HTTPS」未开启 开启强制跳转,勿只依赖 HSTS

证书 90 天就过期,如何做续期与轮换自动化?

为什么免费证书总在半夜过期?据 Let’s Encrypt 官方文档,其 DV 证书有效期固定为 90 天,官方明确建议在剩余 30 天时启动续签——这是必须遵守的期限,不能只当作“提醒”。腾讯云免费 DV 证书同属 90 天档位,付费 DV/OV 一般为 1 年。两者的运维方式差别很大:前者必须自动化,靠人工记日历迟早出事故;后者一年一续,人工操作仍然可行。

证书类型 典型有效期 续期方式 可否控制台自动续期 典型场景
腾讯云免费 DV 90 天 控制台或自动续期 可以(SSL 控制台开启「自动续期」) 测试、中小站点
付费 DV 1 年 人工或自动 可以 生产单域名
付费 OV/EV 1 年 人工(需重审资质) 部分支持 金融、政企
Let’s Encrypt 自建 ACME 90 天 acme.sh / certbot 定时任务 不可以,需自建流水线 多云、泛域名

第一道防线:把到期日变成可告警的指标。blackbox_exporter(0.24.x 起稳定提供)的 probe_ssl_earliest_cert_expiry 会返回证书链中最早到期证书的 Unix 时间戳(秒),可以直接用于告警,不需要额外编写探测脚本。

# blackbox.yml —— 适用 blackbox_exporter 0.24.x / 0.25.x
modules:
  https_2xx:
    prober: http
    timeout: 10s
    http:
      preferred_ip_protocol: ip4
      tls_config:
        insecure_skip_verify: false   # 关键:保持 false,否则证书链错误会被静默吞掉

# prometheus.yml 片段
scrape_configs:
  - job_name: 'cdn_tls'
    metrics_path: /probe
    params: { module: [https_2xx] }
    static_configs:
      - targets: ['cdn.example.com']     # 填 CDN 加速域名,不是源站
    relabel_configs:
      - source_labels: [__address__]
        target_label: __param_target
      - source_labels: [__param_target]
        target_label: instance
      - target_label: __address__
        replacement: 127.0.0.1:9115

# 告警规则:剩余不足 21 天
- alert: CDNCertExpiringIn21Days
  expr: (probe_ssl_earliest_cert_expiry - time()) / 86400 < 21
  for: 1h
  labels: { severity: warning }
  annotations:
    summary: "{{ $labels.instance }} 证书仅剩 {{ $value | printf "%.1f" }} 天"

把阈值定为 21 天而不是 30 天,是为了留出 9 天人工处理时间,同时避免 30 天阈值与“提前 30 天自动续签”的时间重叠,导致告警反复触发。

第二道防线:优先使用托管证书。在腾讯云 SSL 证书控制台开启「自动续期」后,CDN 侧务必选择「腾讯云托管证书」而非手工上传。续期完成后,新证书会自动同步到已绑定的 CDN 域名,省去一次人工上传和一次 腾讯云cdn https配置 变更,这也是托管证书相对自有上传的核心优势。手工上传的证书即使已开启自动续期,也不会自动替换 CDN 上的旧版本。

第三道防线:自建 ACME 全自动链路。据 RFC 8555(ACME v2)与 acme.sh 官方文档,可用 DNS-01 方式签发泛域名证书,再用 --reloadcmd 钩子完成“拼接 fullchain → 上传证书 → 绑定 CDN”:

# acme.sh 3.x,ACME v2(RFC 8555)
export Tencentcloud_SecretId="AKIDxxxxxxxx"
export Tencentcloud_SecretKey="xxxxxxxx"
acme.sh --issue -d '*.example.com' --dns dns_tencent --keylength ec-256

# 安装证书并挂载部署钩子;acme.sh 的 cron 默认每天检查一次,剩余 30 天内自动续
acme.sh --install-cert -d '*.example.com' --ecc 
  --fullchain-file /etc/ssl/example.com.fullchain.pem 
  --key-file       /etc/ssl/example.com.key 
  --reloadcmd      "/usr/local/bin/deploy-to-cdn.sh"

# deploy-to-cdn.sh 关键两行(需先 pip install tccli && tccli configure)
CERT_ID=$(tccli ssl UploadCertificate 
  --CertificatePublicKey "$(cat /etc/ssl/example.com.fullchain.pem)" 
  --CertificatePrivateKey "$(cat /etc/ssl/example.com.key)" 
  --Alias "wildcard-$(date +%Y%m%d)" --output json | jq -r '.CertificateId')
tccli cdn UpdateDomainConfig --Domain cdn.example.com 
  --Https "{"Switch":"on","CertId":"$CERT_ID","Http2":"on"}"

轮换窗口要保留 24 小时双证书共存。正确顺序是:先上传新证书(旧证书保留)→ 切换 CDN 绑定 → 观察 1 天 → 删除旧证书。如果直接覆盖上传,新证书出问题时回滚需要重新走一遍上传流程,故障持续时间会被放大数倍。多域名共用一张泛域名证书时,一次续期影响面覆盖所有子域名,更要先执行灰度切换。

把验证脚本纳入发布流水线。据 OpenSSL 文档,s_client -showcerts 会输出服务端发送的完整证书链,这是判断中间证书是否遗漏的唯一可靠手段:

#!/usr/bin/env bash
set -euo pipefail
HOST=cdn.example.com
CHAIN=$(echo | openssl s_client -connect "$HOST:443" -servername "$HOST" -showcerts 2>/dev/null)
# 断言 1:链上至少 2 张证书(叶子 + 中间证书)
COUNT=$(echo "$CHAIN" | grep -c 'BEGIN CERTIFICATE')
[ "$COUNT" -ge 2 ] || { echo "FAIL: 链仅 $COUNT 张,缺中间证书"; exit 1; }
# 断言 2:notAfter 剩余 ≥ 21 天
END=$(echo "$CHAIN" | openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
[ "$LEFT" -ge 21 ] || { echo "FAIL: 证书仅剩 $LEFT 天"; exit 1; }
echo "OK: 链 $COUNT 张,剩余 $LEFT 天"

如果只上传了叶子证书,openssl s_client 会输出 Verify return code: 21 (unable to verify the first certificate),此时 grep -c 通常只返回 1——这个断言能挡住绝大多数手工操作遗漏。脚本失败即阻断发布,不依赖任何人的记忆。

最后补一份变更记录。每次变更至少记录:证书域名(含泛域名覆盖范围)、签发机构、生效时间、到期时间、绑定的 CDN 域名列表、操作人。泛域名证书一次续期影响几十个域名,有记录后故障定位可以从反复猜测变成直接查表,把 MTTR 压到分钟级。这份记录本身也是下一轮 腾讯云cdn https配置 审计的输入。

控制台提交后通常 5-10 分钟完成全网下发,跨区域最迟约 30 分钟。生效时间取决于节点缓存刷新速度,可用 openssl s_client 从不同网络环境抽查证书 notAfter 是否已更新。下发期间不要重复修改配置,否则会重新排队。

免费 DV 为单域名、有效期 90 天、每账号每年约 20 张额度,浏览器信任链与付费 DV 完全一致;付费 DV 有效期 1 年、支持泛域名与多域名,续期频率低。个人站与测试环境用免费证书足够,多子域业务建议直接买泛域名 DV,约 1000-2000 元/年。

先确认文件是 PEM 文本而非 DER/PFX 二进制,首行必须是 —–BEGIN CERTIFICATE—–;其次确认没有把私钥粘贴进证书输入框;最后检查是否包含中间证书。用 cat server.crt intermediate.crt > fullchain.crt 重新拼接后上传,多数情况可解决。

三者都支持证书上传、强制跳转、TLS 版本选择与 HTTP/2。差异在于:腾讯云与阿里云均要求境内加速域名完成 ICP 备案,Cloudflare 无此限制但境内访问速度受跨境链路影响;Cloudflare 免费版提供通用 SSL 与自动续期,腾讯云免费证书为 90 天且需手动或托管续期;OCSP Stapling 三者默认开启策略不同,切换厂商时需重新验证。

常见原因有三个:一是浏览器缓存了此前的 301,测试时请用 curl -sI 并加 -H 'Cache-Control: no-cache';二是存在绕过 CDN 的入口,例如源站 IP 直连或对象存储默认域名;三是该请求命中了未开启强制跳转的其他加速域名。逐个排除即可定位。

先在 CDN 之外直连源站验证:openssl s_client -connect 源站IP:443 -servername 源站域名,若拿不到正确证书或连接超时,问题在源站或回源 SNI 未开启;若源站正常而 CDN 仍报 502,再检查回源端口是否为 443、回源协议是否与源站能力匹配。

不能完全覆盖。*.example.com 覆盖 www.example.com、api.example.com 等一级子域,但不包含裸域 example.com,也不覆盖 a.b.example.com 这类二级子域。正确做法是签发「example.com + *.example.com」的多域名证书,或在 CDN 上为不同子域分别绑定证书。


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

内容审核

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