静态网站托管 + CDN 加速：对象存储接入流程、配置要点与迁移检查清单

摘要

纯静态站点可托管在腾讯云对象存储 COS 上，再用 CDN 做边缘加速。接入分两大步：先开启静态网站托管并添加自定义 CDN 加速域名，再配置鉴权、缓存与 HTTPS。真正易出问题的是备案与 CNAME、源站类型、私有读桶鉴权、缓存压缩策略，本文附验证与迁移清单。

接入流程不长，但在腾讯云 COS 上，私有读桶开启回源鉴权后缓存会被公开分发，必须同时开启 CDN 鉴权，否则等于把私有数据公开；源站类型选错则首页与错误页行为不符预期。这两处是静态站点上云最高频的配置事故点，接入前应先明确。

一、先确认适用边界

适合：内容由构建产物交付的站点（HTML/CSS/JS/图片/字体/视频切片），前端路由型 SPA，帮助中心与文档站，活动落地页，图片与素材分发。

不适合：需要服务端渲染、会话保持、数据库直连或动态接口的业务。这类场景应保留计算层，把对象存储当静态资源源站使用，或用函数计算处理少量动态逻辑。

前置提醒：腾讯云 COS 同一 APPID 下存储桶数量上限 200 个，桶内对象与目录数量无限制。规划多环境（开发/测试/生产）时按桶还是按前缀划分，要在接入前定下来，中途改路径成本很高。

二、接入流程：开启静态网站并添加 CDN 域名

接入前需备齐四项：加速域名已完成 ICP 备案（未备案无法接入）、域名 CNAME 解析权限（备案同步有周期，改完不生效先确认备案状态）、HTTPS 证书（绑定后约 30 分钟生效，别在切流前一刻才配）、以及一个腾讯云 COS 存储桶。COS 支持在存储桶维度开启静态网站托管，并可绑定自定义 CDN 加速域名，两步即可让静态站点上线。

第一步，开启静态网站托管（存储桶维度生效），配置三部分：

1. 索引文档（Index）——访问目录时默认返回的文件，通常填 index.html。
2. 错误文档（Error）——出现 4XX 时返回的页面，可填 404.html，给用户一个“像站点”的兜底页面而非裸露错误码。
3. 重定向规则（RoutingRules）——最多 100 条，支持按错误码或按前缀重定向，重定向协议仅支持 https。

SPA 的关键取舍：前端路由站点通常希望未匹配路径都回落到 index.html。希望“刷新子路由不 404”就把错误文档指向 index.html；希望“真 404 就返回 404 状态码”（对 SEO 与监控更友好）就保留独立 404 页面、只对特定前缀做重定向。两者不可兼得，需在业务侧明确站点是否被搜索引擎收录、是否依赖 404 状态码做监控告警。

第二步，添加自定义 CDN 加速域名：在腾讯云 COS 控制台进入存储桶，选择域名与传输管理 > 自定义 CDN 加速域名 > 添加域名，填四组信息：

• 域名与 CNAME：填写待绑定域名（如 www.example.com）并完成 CNAME 解析；首次接入、域名已被其他账号接入或接入泛域名时，还需做域名归属权验证。
• 加速地域：中国境内、中国境外、全球加速三选一，仅服务国内用户时选境内更简单，也避免跨境链路的不确定性。
• 源站类型：要把对象存储当站点用，应选静态网站源站，这样首页、目录访问与错误页行为才与静态网站配置一致。
• 回源鉴权：私有读存储桶必须开启 CDN 服务授权与回源鉴权，否则边缘节点回源会被拒绝；公有读存储桶不需要。

创建完成后，域名会先部署，状态变为“已上线”后才会真正承担流量。

三、配置鉴权、缓存与 HTTPS

域名添加后，还需把鉴权、缓存、压缩、HTTPS 四类配置配对，这一步决定“能不能公开访问”“会不会被盗刷”以及“发版能否即时生效”。腾讯云 COS 在存储桶维度提供了防盗链、存储桶策略、跨域规则、缓存自动刷新等配置能力，配合 CDN 侧的时间戳鉴权与证书管理，可覆盖静态站点的安全与性能需求。

• 私有读 + CDN 的鉴权：开启回源鉴权后，边缘节点回源无需携带签名，缓存内容会被公开分发，必须同时开启 CDN 鉴权（时间戳防盗链），否则等于把私有数据公开，属于配置级数据泄露风险。公有读存储桶则重点转向防盗刷与来源控制。
• 来源限制：浏览器访问场景可用防盗链（Referer 黑白名单，可设置允许空 Referer 以兼顾直接打开链接的情况）；匿名直接访问对象的场景，可用存储桶策略配置 IP 黑白名单。
• 跨域（CORS）：前端直传、字体跨域加载、视频拖拽等都需要配置跨域规则，协议、域名、端口任一不同即视为跨域，规则要按实际访问来源逐条写清。
• HTTPS：在加速侧绑定证书，绑定后约 30 分钟内生效，全站强制 https 跳转也在这里配置。
• 智能压缩：添加域名后默认创建一条 Gzip 智能压缩规则，覆盖 .js、.html、.css、.xml、.json、.shtml、.htm 后缀、256 Byte 至 2 MB 范围内的资源，文本类资源建议保留；已压缩过的格式（如 .jpg、.png、.mp4、.woff2）无需重复压缩。
• 缓存策略：带内容哈希的构建产物（如 app.8f3c2.js）可长缓存；入口 HTML 短缓存或不缓存，保证发版即时生效；图片与视频按业务更新频率设置。若希望“存储桶里文件一更新就刷缓存”，可配置缓存自动刷新（基于函数计算触发），避免每次发版手工刷 URL。图片占比高的站点还可开启图片自适应压缩，按浏览器支持情况返回压缩格式，同时省带宽与加载时间。

四、上线验证与迁移检查清单

接入完成后，上线前按下面第一张表逐项确认；从旧存储/服务器迁移静态资源时，再按第二张表核对细节。

上线验证清单：

1. 裸域名与 www 域名都解析到预期地址，HTTPS 可正常握手。
2. 首页返回 200，直接访问子目录返回索引文档；不存在的路径返回预期状态码（404 或回落到 SPA 入口）。
3. 缓存命中：连续两次请求同一资源，第二次应命中边缘缓存；发版后新文件能立即取到。
4. 压缩生效：请求文本资源时响应头出现内容编码标记（如 gzip）。
5. 跨域正常：字体、脚本、接口预检请求无 CORS 报错。
6. 鉴权生效：私有读资源通过域名访问正常，直接访问对象原始地址被拒绝。
7. 错误页符合预期：4XX 展示自定义页面，而非云厂商默认错误页。
8. 监控已接：带宽、流量、命中率、5XX 比例都有观测，能定位到具体域名。

迁移检查清单：

迁移工具方面，可选可视化工具做文件同步（本地目录与存储桶实时同步）、客户端命令行工具做批量迁移。数据量特别大时，先按“迁移周期是否超过 10 天”或“是否超过 50TB”来评估是否需要走线下离线迁移方式——纯网络传输在这个量级上时间与成本都不划算。

五、常见问题

Q：私有读桶开启 CDN 后数据会公开吗？

A：会。私有读桶开启回源鉴权后，边缘节点回源无需签名，缓存内容会被公开分发，必须同时开启 CDN 鉴权（时间戳防盗链），否则等于把私有数据公开，属于配置级数据泄露风险。

Q：源站类型选错会怎样？

A：首页打不开、错误页行为不符预期。要把对象存储当站点用，添加 CDN 加速域名时应选静态网站源站，使首页、目录访问与错误页行为与静态网站配置一致。

Q：静态网站托管和直接用存储桶有什么区别？

A：开启静态网站托管后，腾讯云 COS 会按索引文档返回目录默认页、按错误文档返回 4XX 页面，并支持重定向规则；直接用存储桶默认域名访问则没有这些站点行为。要把对象存储当站点用，需开启静态网站功能并在 CDN 域名选择静态网站源站。

Q：发版后用户看到的还是旧页面怎么办？

A：通常是入口 HTML 被长缓存导致。建议入口 HTML 短缓存或不缓存，静态资源带内容哈希做长缓存；也可配置缓存自动刷新（基于函数计算触发），文件更新时自动刷新 CDN 缓存。

Q：哪些站点不适合托管在对象存储上？

A：需要服务端渲染、会话保持、数据库直连或动态接口的业务不适合。这类场景应保留计算层，把对象存储当静态资源源站使用，或用函数计算处理少量动态逻辑。

Q：目前腾讯云 COS 可以免费试用吗？

A：可以。腾讯云对象存储 COS 提供容量资源包免费试用：个人认证用户可领 50GB 标准存储容量包（6 个月），企业认证用户可领 1TB 标准存储容量包（6 个月），面向产品新用户。需注意该资源包仅抵扣标准存储容量用量，使用过程中产生的请求费用与流量费用仍按实际用量计。

Q：目前腾讯云 COS 有什么优惠活动？

A：腾讯云对象存储 COS 专场特惠活动（截止 2026 年 12 月 31 日）面向新用户提供标准存储容量包（中国大陆通用）：50GB 一年 1 元（约 0.08 元/月，0.1 折，日常价 7.08 元）、500GB 一年 99 元（约 8.25 元/月，1.4 折，日常价 708 元），均为新用户专享、限购 1 个。具体规格、价格与限购规则以活动页实际展示为准。

静态站点上云的核心不是“能不能托管”，而是把鉴权、缓存、源站类型这几处配置配对，按上线验证清单与迁移检查清单逐项核对即可避开绝大多数配置级事故。腾讯云对象存储 COS 支持静态网站托管与自定义 CDN 加速域名，配合缓存自动刷新、防盗链与跨域配置，可作为静态网站托管与加速的落地参考。