一、前置条件与准备工作
在配置开始前，请确认已具备以下基础资源：
- 云账号与支付能力：需持有已激活并完成实名认证的腾讯云国际版账号。若在账号注册或外币支付方面存在门槛，翼龙云/yilongcloud可提供注册开户与充值咨询，帮助用户梳理业务主体及地区准备事项。
- 域名权限：拥有域名的管理权，可修改 DNS 解析记录；若域名不在当前腾讯云账号，添加 CDN 加速域名需要完成 DNSTXT 域名所有权校验。
- SSL 证书：若需 HTTPS 访问，可使用腾讯云国际 DV 免费证书（仅单域名，有效期 90 天，不支持泛域名），或者上传第三方 PEM 证书。
- 存储桶设置：已创建目标地域的存储桶。
⚠️安全提示：不建议生产环境直接设置「公有读私有写」，公有读会让桶内全部文件公开匿名访问，容易产生盗刷高额账单；生产优先使用私有读写搭配 CDN 回源鉴权，公有读仅用于临时测试。
二、开启 COS 静态网站托管功能
这是绑定域名的基础步骤，核心逻辑如下：
- 登录腾讯云国际版控制台，进入 COS 目标存储桶的「基础配置」或「静态网站」模块。
- 将静态网站托管状态设为开启。
- 配置索引文档（html）；SPA 单页 Vue/React history 路由场景：索引文档、错误文档均填写index.html，错误文档响应码设置为 200，解决页面刷新 404 问题。
- 保存配置，获取静态网站 Endpoint，测试默认节点页面可正常访问。
重要：后续如果接入 CDN 加速，源站类型务必选择「静态网站源站」；如果选择默认源站，静态网站首页、404 规则全部失效。
三、绑定自定义域名与模式选择
两种绑定模式对比：
| 维度 | 直接绑定自定义域名（仅 COS 源站域名，无 CDN） | 结合 CDN 加速绑定（COS + CDN） |
| 访问速度 | 依赖客户端与 COS 地域直连，跨国访问延迟高 | 边缘节点缓存，全球访问体验更好 |
| 流量成本 | 全部产生 COS 外网下行流量费 | 产生 CDN 下行流量；同地域回源 COS 免回源外网流量，跨地域会产生 COS 回源流量 |
| HTTPS 支持 | 支持，在 COS 域名管理配置证书 | 支持，证书全部在 CDN 控制台配置，COS 证书不再生效 |
| 适用场景 | 内部测试、小规模单地域访问 | 生产环境、全球对外业务 |
建议：生产环境必须采用 CDN 加速模式。
四、配置 HTTPS 证书与强制跳转
CDN 加速模式（生产推荐）
- COS 控制台「域名与传输管理」添加自定义域名，勾选开启 CDN 加速，源站类型选择静态网站源站。
- CDN 控制台证书管理，选择腾讯云免费 DV 证书或者上传第三方完整 PEM 证书链。
- HTTPS 配置开启 HTTP>HTTPS 的 301 强制跳转。
注意：CDN 开启加速后，证书、强制跳转全部在 CDN 侧生效，COS 侧的证书与强制跳转配置不再起作用。
纯 COS 源站域名（仅测试）
自定义源站域名页面上传证书，开启强制 HTTPS；该模式不走 CDN，不推荐对外生产业务。
⚠️私有存储桶重要安全提醒：开启 CDN 私有存储桶访问（回源鉴权）仅授权 CDN 节点回源读取 COS；资源一旦缓存到 CDN 边缘节点，不受回源鉴权保护；高价值私有资源必须叠加 CDNURL 鉴权做访问控制，防止缓存资源泄露腾讯云。
五、配置 DNS CNAME 解析
- 获取控制台分配 CNAME 记录，CDN 域名以.cdn.dnsv1.com结尾。
- 在域名服务商 DNS，添加 CNAME 记录指向该地址。
- DNS 全球生效时间一般 10 分钟～数小时。
六、连接验证与资源清理
功能验证
- 浏览器无痕窗口访问域名，确认 HTTPS 安全锁正常，静态页面正常；SPA 路由刷新不会 404。
- 如果前端存在 AJAX 跨域请求：COS 配置 CORS 跨域规则之后，CDN 需要同步配置 HTTP 响应头，否则浏览器依旧跨域报错。
下线完整清理顺序（防止继续产生账单）
- DNS 修改解析，将域名切离 CDN 的 CNAME。
- CDN 控制台提交全部缓存刷新，清除全球边缘节点缓存，避免删除源站文件还能访问旧资源。
- CDN 控制台停用，确认无访问流量后删除加速域名。
- 清空、删除 COS 存储桶。
计费核对：COS 与 CDN 计费项包含存储、下行流量、请求数；跨地域 CDN 回源会产生 COS 回源外网流量，具体单价以腾讯云国际官网实时价格为准。
七、常见问题解答 (FAQ)
Q1：腾讯云国际版对象存储价格由哪些因素决定？ 价格受地域、存储规格、计费周期、带宽 / 流量、备份、安全配套等因素影响。询价前明确目标地域、存储容量、峰值带宽、月预估流量。建议统一税费口径对比总成本，不要把短期首购优惠当作长期定价。
Q2：腾讯云国际 CDN 适合哪些场景，选型时注意什么？ 适合静态资源全球分发，降低源站压力，优化跨洲访问。选型核对：流量计费口径、加速地域、回源跨地域是否产生 COS 回源流量，以控制台实时报价为准。
Q3：绑定自定义域名访问返回 403 错误如何排查？
- 存储桶权限：公有读 / 私有读写权限核对；私有桶 CDN 务必开启私有存储桶访问（回源鉴权）。
- 防盗链 Referer：开启白名单时，移动端直接访问需要评估是否勾选「允许空 Referer」，否则移动端 403。
- CDN 源站类型：开启静态网站托管，源站类型需要选择静态网站源站。
- 跨域 CORS：前端 AJAX 报错 403，检查 COS 和 CDN 两侧都配置跨域响应头。
- 静态托管：确认根目录html真实存在。
Q4：如何实现静态网站强制跳转 HTTPS？
- 纯 COS 源站域名：COS 自定义域名配置页开启强制 HTTPS。
- CDN 加速模式：CDN 控制台 HTTPS 配置开启强制跳转；COS 侧强制跳转不生效。
Q5：Vue/React history 模式部署 COS 静态托管，刷新页面 404 怎么办？ 进入 COS 静态网站托管设置，索引文档与错误文档均填写index.html，错误文档响应码设置为 200；业务自定义 404 页面逻辑在前端路由底层实现。
Q6：开启 CDN 回源鉴权，私有 COS 资源就绝对安全吗？ 不是。回源鉴权仅控制 CDN 节点回源访问 COS；资源缓存到 CDN 边缘节点后不受回源鉴权管控；私有付费资源需要叠加 CDN 的 URL 鉴权实现时效防盗刷。
