Skip to content

使用指南

腾讯云国际渠道商: COS 静态网站托管与自定义域名绑定教程(2026版)

出海企业、前端开发者经常使用腾讯云国际版对象存储 COS 托管静态网站,采用「COS 源站 + CDN 全球加速 + 自定义域名 + HTTPS」架构,可以实现全球分发、降低带宽成本,适配品牌官网、营销落地页、前端 SPA 项目。

前置重要提示:

  1. 生产环境不建议直接开启存储桶公有读私有写,极易被盗刷产生高额流量账单;推荐存储桶设置私有读写,配合 CDN 回源鉴权对外提供访问。公有读仅适合短期测试场景。
  2. CDN 接入静态网站托管,源站类型务必选择「静态网站源站」,选择默认源站会出现目录访问 404、索引文档不生效问题。
  3. Vue/React SPA 单页 History 路由,需要错误文档填写html并设置错误响应码 200,否则刷新子页面 404。
  4. CDN 回源访问 COS,国际版会产生COS 回源外网流出流量,并非内网免费,成本测算需要计入该部分开销。
  5. 即使配置 CDN 加速,COS 原生静态网站域名依然可以直接访问源站,需要配置桶策略禁止直接源站访问,防止绕过 CDN 盗刷流量。

前置准备:

部署前确认完成以下准备:

  1. 账号与支付:拥有已激活的腾讯云国际版账号。海外信用卡绑定、外币支付遇到障碍,可咨询云枢国际 /yunshuguoji。云枢国际可根据用户主体和地区梳理开户事项,提供售前选型建议;仅提供技术咨询,不登录、不操作客户账号。
  2. 域名权限:拥有域名 DNS 解析管理权限;海外业务仅使用境外加速,域名无需 ICP 备案。
  3. SSL 证书:准备匹配域名的 SSL 证书,可使用腾讯云国际免费证书或者第三方 CA 证书,证书部署在 CDN 侧。

步骤一:配置 COS 存储桶

  1. 创建存储桶 登录腾讯云国际控制台,进入 COS 页面新建存储桶,选择靠近目标客户的地域。

安全最佳实践:生产环境访问权限设置为私有读写;仅测试临时使用才选择公有读私有写。

  1. 上传静态资源 将 HTML、CSS、JS、图片等全部静态文件上传至桶根目录。
  • 普通多页面网站:准备html(首页)、error.html(自定义 404 页面)
  • SPA 单页应用(Vue/React History 路由):根目录只需要html,静态网站配置中索引文档与错误文档均填写index.html,错误文档响应码设置为200。
  1. 开启静态网站托管 进入存储桶【基础配置】-【静态网站】,开启静态网站功能。
  • 索引文档:填写首页文件名(一般为html)
  • 错误文档:普通网站填html;SPA 单页应用填index.html,错误文档响应码选择 200 保存配置,记录系统生成的静态网站 Endpoint。

注意:该静态网站域名仅用于 CDN 回源,不要直接对外暴露给终端用户访问。

步骤二:绑定自定义域名与 CDN 全球加速

概念区分

  • 自定义源站域名:直接解析指向 COS,不走 CDN 加速,不推荐对外业务使用。
  • CDN 加速域名:经过全球边缘节点缓存加速,出海业务优先选择该模式。

添加 CDN 加速域名 进入 COS 控制台【域名与传输管理】→【自定义 CDN 加速域名】,添加业务自定义域名。

  • 加速地域:选择中国大陆境外(出海业务)
  • 源站类型:静态网站源站(关键配置,否则会出现大量 404 报错)
  • 存储桶为私有读写场景:开启CDN 回源鉴权,授权 CDN 访问 COS 桶资源。

配置 DNS 解析 获取控制台给出的 CDN CNAME 记录,前往 DNS 服务商(Cloudflare、DNSPod 等)添加 CNAME 记录,将业务域名指向 CDN 分配的 CNAME 地址。

调试阶段建议把 DNS TTL 调小,加快解析生效。

验证解析生效 使用nslookup/dig查询域名,返回腾讯云 CDN 节点 IP,代表解析已经生效;访问站点查看响应头XCacheLookup,确认请求已经走到 CDN 节点。

步骤三:部署 HTTPS 证书与 HTTP 强制跳转

  1. 关联 SSL 证书 进入 CDN 控制台【域名管理】-【HTTPS 配置】,上传或者选择对应域名 SSL 证书。

提示:COS 本身自定义源站域名无法配置 HTTPS 证书,证书统一部署在 CDN 加速域名上。

  1. 设置 HTTP 强制跳转 开启强制跳转,配置HTTP→HTTPS,状态码选择 301 永久重定向。
  2. 访问验证:访问 http:// 域名,确认自动跳转 HTTPS,浏览器地址栏安全锁标识正常。

步骤四:安全与成本优化配置

安全加固(出海生产必配)

  1. 存储桶策略:配置策略拒绝终端用户直接访问 COS 静态网站源站域名,只允许 CDN 回源访问,防止绕过 CDN 盗刷流量。
  2. CDN 防盗链:配置 Referer 白名单,拒绝空 Referer 请求,拦截恶意盗链访问。
  3. 前端跨域:业务有 JS 跨域访问资源需求,在 COS 配置 CORS 跨域规则,CDN 侧配置Vary:Origin响应头,避免跨域缓存异常报错。

成本优化建议

  1. CDN 缓存 TTL 配置:图片、CSS、JS 等不常变动资源设置较长缓存有效期(30 天);HTML 页面设置较短 TTL,兼顾更新速度与缓存命中率。
  2. 文件更新之后,在 CDN 控制台提交 URL / 目录刷新,清除旧缓存。
  3. 关注账单:同时观测 CDN 流出流量、COS 回源流出流量两项计费项。

常见排障对照表格:

现象 / 状态码 可能原因 解决方向
403 Forbidden 私有桶未开启 CDN 回源鉴权;防盗链拦截;存储桶访问权限异常 私有桶务必开启 CDN 回源鉴权;核对 CDN Referer 防盗链白名单;检查桶策略限制
404 Not Found 文件没有上传到根目录;CDN 源站类型错误;SPA 没有配置错误文档为 index.html 核对文件上传路径;CDN 源站切换为静态网站源站;SPA 将错误文档设置为 index.html,响应码 200
502 Bad Gateway CDN 回源无法连通 COS 静态网站源站 确认静态网站功能已经开启;核对回源地址、回源协议配置
修改文件后页面依旧是旧内容 CDN 缓存未刷新 控制台提交 URL / 目录刷新;合理调整 CacheControl 响应头
SPA 子路由刷新 404 静态网站错误文档未配置 index.html 静态网站配置错误文档填写 index.html,错误响应码设置 200

总结与资源清理:

部署完成后,完整测试:301 跳转、404 页面、SPA 路由刷新、全球不同地区访问速度。 测试完毕不再使用,请按顺序清理资源,避免持续扣费:

  1. CDN 控制台停用并删除加速域名;等待 DNS TTL 过期。
  2. COS 存储桶清空全部对象。
  3. 删除 COS 存储桶。

提示:存储桶内存在对象时,无法直接删除存储桶。

常见问题 (FAQ):

Q1:出海静态网站,存储桶应该设置公有读还是私有读写? A:生产环境优先私有读写 + CDN 回源鉴权,安全性最高,避免盗刷账单;公有读私有写仅适合短期测试,一旦泄露 URL 会产生大量恶意下载流量。

Q2:腾讯云国际 COS 绑定 CDN 做静态网站,源站类型有什么坑? A:开启静态网站托管后接入 CDN,源站类型必须选择「静态网站源站」;如果使用默认源站,访问目录路径、SPA 路由会大量返回 404。

Q3:Vue/React 打包的 SPA 项目部署到 COS 静态托管,刷新子页面 404 如何处理? A:静态网站配置中,索引文档、错误文档都填写index.html,错误文档响应码设置为 200;前端路由使用 BrowserRouter 模式即可正常工作。

Q4:CDN 已经接入,还会产生 COS 外网流量是什么原因? A:①CDN 回源拉取资源会产生 COS 回源流出流量;②用户直接访问 COS 静态网站源站域名,绕过 CDN,产生 COS 外网流量,建议配置桶策略禁止公网直接访问源站。

Q5:腾讯云国际版 COS 绑定自定义域名需要 ICP 备案吗? A:CDN 加速区域仅选择中国大陆境外,域名不需要 ICP 备案;如果加速区域包含中国大陆,则域名必须完成 ICP 备案,以控制台规则为准。

 

文章标签