CDN 更新证书时，如果把不完整的 `Https` 对象传给 `UpdateDomainConfig`，原有的 HTTPS 配置可能被重置。本文说明 EdgeOne 自带证书、CDN 证书托管的适用范围，以及自行调用 API 时如何只替换证书。

## EdgeOne 自带的免费证书

域名已经接入 EdgeOne 的话，最省事的办法是在域名的 HTTPS 配置里直接选「申请免费证书」。按[官方文档](https://cloud.tencent.com/document/product/1552/90437)，这张证书由 TrustAsia 或 Let's Encrypt 签发，有效期 90 天，到期前 15 天平台自动续期，签发后自动部署。续期仍需要域名验证条件保持有效。

它的限制有这几条：

- 证书不能下载，只能在 EdgeOne 上用。源站、负载均衡要用同一个域名的证书，得另外申请。
- CNAME 接入时，通配符证书只能用 DNS 委派验证。站点从 NS 接入切到 CNAME 接入后，原来的通配符证书到期无法自动续期。
- CNAME 接入用自动验证时，域名要在一小时内把 CNAME 指到 EdgeOne，而且不能用分线路解析。
- 不提供 SLA。Let's Encrypt 签发的那张不支持 OCSP 装订。

只在 EdgeOne 上使用证书、且满足上述验证条件时，优先用它自带的免费证书。源站或其他云产品也需要证书时，需分别安排签发和更新。

## CDN 的证书托管

CDN 没有 EdgeOne 这样的一键免费证书，常规做法是先在 SSL 证书服务申请证书，再部署到 CDN 域名上。

腾讯云的[证书托管](https://cloud.tencent.com/document/product/400/55818)能减少一半工作：开启后，新证书签发出来，会在你设定的时间自动部署到旧证书关联的云资源上，比如 CDN、负载均衡，免费证书也能托管。官方说的全自动是「自动续费 + 证书托管」，自动续费针对的是付费证书；文档里没有写免费证书到期会自动申请下一张。所以用免费证书时，每 90 天申请新证书、完成验证这一步还是要自己做，托管只负责最后的替换。

托管还有一个要求：新旧证书绑定的域名必须一致，指定错了会直接影响线上。

## 用 API 更新证书

不想依赖控制台，可以自己签发再调腾讯云 API 部署。签发这一段现成的工具很多，acme.sh 的 `dns_tencent` 插件可以用 DNSPod 的 API 完成 DNS 验证，签出 Let's Encrypt 的通配符证书。

自己调 API 时，先把证书上传到 SSL 证书服务拿到证书 ID，再绑定到 CDN 或 EdgeOne。下面是参数示意，不是可直接执行的命令；调用时使用对应产品的 SDK，并检查接口返回的错误：

```text
# 1. 上传证书，Repeatable=false 时同一张证书不会重复上传，返回已有的 ID
ssl.UploadCertificate
  CertificatePublicKey  = fullchain.pem 的内容
  CertificatePrivateKey = privkey.pem 的内容
  Repeatable            = false

# 2a. 腾讯云 CDN：只更新证书 ID 这一个配置路径
cdn.ModifyDomainConfig
  Domain = cdn.example.com
  Route  = Https.CertInfo.CertId
  Value  = {"update":"<上一步返回的证书 ID>"}

# 2b. EdgeOne：给加速域名换证书
teo.ModifyHostsCertificate
  ZoneId         = <站点 ID>
  Hosts          = ["www.example.com"]
  Mode           = sslcert
  ServerCertInfo = [{"CertId":"<证书 ID>"}]
```

CDN 这一步容易写错。如果用 `UpdateDomainConfig` 传一个只放了证书和私钥的 `Https` 对象，会碰上[接口文档](https://cloud.tencent.com/document/api/228/41116)里的这条规则：复杂类型的配置项「必须传递整个对象的所有属性，未传递的属性将使用默认值」。也就是说，域名原来开着的 HSTS、OCSP 装订、TLS 版本限制，每次续期都会被重置成默认值。[ModifyDomainConfig](https://cloud.tencent.com/document/product/228/94258) 按路径更新，路径以外的配置保持不变，换证书用它更稳妥。

只更新 `Https.CertInfo.CertId` 有一个前提：域名已经开启了 HTTPS。还没开启时，单改证书 ID 不会生效，单把 `Https.Switch` 设为 on 又会因为没有证书被拒绝，这时要把 `Route` 设为 `Https`，`Value` 写成 `{"update":{"Switch":"on","CertInfo":{"CertId":"<证书 ID>"}}}`。脚本里可以先用 `DescribeDomainsConfig` 查一下 `Https.Switch`，再决定走哪条。

脚本跑起来以后，还要自己处理定时任务、失败重试和告警。凭证建议用 CAM 子用户，只给 DNSPod、SSL 证书上传和 CDN / EdgeOne 改配置的权限。

## 核对实际生效的证书

API 调用成功后，还要给边缘节点留出下发时间，再从客户端检查实际返回的证书。下面的命令同时指定连接域名和 SNI，查看有效期与 SHA-256 指纹：

```bash
openssl s_client -connect www.example.com:443 -servername www.example.com </dev/null 2>/dev/null \
  | openssl x509 -noout -subject -issuer -dates -fingerprint -sha256
```

把指纹与本次部署的叶证书比较。如果仍是旧证书，检查域名绑定的证书 ID、任务状态和节点下发情况。一个访问点的检查不能代表所有边缘节点；同一张证书同时用于 CDN 和源站时，分别检查，并给每个公开 HTTPS 地址配置到期监控。


CDN 更新证书时，如果把不完整的 Https 对象传给 UpdateDomainConfig，原有的 HTTPS 配置可能被重置。本文说明 EdgeOne 自带证书、CDN 证书托管的适用范围，以及自行调用 API 时如何只替换证书。

腾讯云 CDN / EdgeOne 更新证书：如何保留原有 HTTPS 配置

EdgeOne 自带证书与 CDN 证书托管的适用范围，以及使用 ModifyDomainConfig 按路径更新证书、检查线上证书的方法。

网络与通信

运维

后端

在EdgeOne或CDN更新HTTPS证书时，务必避免使用UpdateDomainConfig传不完整对象，否则会重置原有配置。EdgeOne自带免费证书（90天有效，自动续期）适合仅本站使用；CDN建议通过SSL证书服务配合托管功能。自行调用API时，用ModifyDomainConfig仅更新CertId，并确保HTTPS已开启，避免重置HSTS等设置。部署后需用openssl核对指纹验证生效。

负载均衡

代码解释

EdgeOne

CDN免费试用


2026上云采购 | AI焕新·智启新局

免费为网站领一份“网站综合险”

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

在EdgeOne或CDN更新HTTPS证书时，务必避免使用UpdateDomainConfig传不完整对象，否则会重置原有配置。EdgeOne自带免费证书（90天有效，自动续期）适合仅本站使用；CDN建议通过SSL证书服务配合托管功能。自行调用API时，用ModifyDomainConfig仅更新CertId，并确保H...

腾讯云 CDN / EdgeOne 更新证书：如何保留原有 HTTPS 配置-腾讯云开发者社区-腾讯云

腾讯云 CDN / EdgeOne 更新证书：如何保留原有 HTTPS 配置

腾讯云 CDN / EdgeOne 更新证书：如何保留原有 HTTPS 配置

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐