华为云 OBS 静态网站托管与 CDN 加速实践:从公开访问到缓存调优
引言
企业官网、产品文档站、活动落地页和前端单页应用有一个共同点:内容以静态文件为主,访问量波动大,却对可用性和打开速度要求很高。用一台云服务器放这些静态文件并不难,但要自己处理扩容、带宽、证书和缓存,运维成本并不低。把静态文件交给对象存储托管,再用内容分发网络加速,是一种更贴合这类场景的做法。
本文以华为云对象存储服务 OBS 和内容分发网络 CDN 为例,梳理从桶规划、静态网站托管、公开访问控制、自定义域名与 HTTPS,到缓存策略、生命周期管理和成本控制的完整链路。目标不是罗列控制台按钮,而是讲清楚每一步为什么要这样做,以及容易踩的坑在哪里。
一、整体架构:先想清楚请求怎么走
一个典型的静态站架构只有三层:
- 源站:OBS 桶。 存放 HTML、CSS、JavaScript、图片和字体等静态文件,开启静态网站托管后,桶可以像一个 Web 服务器一样响应请求。
- 加速层:CDN。 用户先访问离自己最近的 CDN 节点,命中缓存就直接返回,未命中再回源到 OBS。这样既降低了源站压力,也缩短了首屏时间。
- 入口:自定义域名与 HTTPS。 对外使用自己的域名,CDN 上配置证书,浏览器到 CDN 节点走 HTTPS,CDN 到 OBS 的回源也可以按需配置协议。
这个架构的优势在于职责清晰:OBS 管存储和版本,CDN 管分发和缓存,域名和证书管入口。后续不论是换页面、做活动页,还是给文档站加新版本,都只需要在桶里更新文件,再按规则刷新缓存,而不用改动服务器。
二、准备工作:命名、区域与存储类别要先定好
动手之前,先把三件事定下来,后面改起来会很麻烦。
第一,桶名与区域。 桶名在对象存储服务内全局唯一,建议用“业务名-用途-环境”的方式命名,例如 docs-site-prod,避免使用含义不清的缩写。区域尽量选择与主要用户群体接近的区域,跨区域回源会增加延迟,也会让排查问题变得复杂。
第二,存储类别。 经常被访问的页面和资源用标准存储;访问频率明显下降的历史版本、备份包和日志,可以通过生命周期规则转到低频访问或归档存储。不要一开始就把所有文件都放进归档存储,否则取回时会产生额外等待时间和费用。
第三,目录结构。 建议按内容类型分目录,而不是把所有文件都堆在桶根目录,例如:
index.html
404.html
/css/site.css
/js/app.js
/images/logo.png
docs/v1/guide.html
docs/v2/guide.html
清晰的目录结构有两个好处:一是缓存规则可以按目录配置,二是后续做版本切换和回滚时,只需要替换对应目录,不用全量重传。
三、开启静态网站托管:两个页面文件不能少
在 OBS 控制台创建桶之后,找到“静态网站托管”配置,开启该功能,并设置两个关键文件:
- 默认首页:
index.html。 用户访问域名根路径时返回的页面。 - 错误页面:
404.html。 文件不存在或路径错误时返回的页面,建议做成带导航和搜索入口的友好页面,而不是只有一行“Not Found”。
开启后,OBS 会给出一个静态网站托管的访问地址,可以先用这个地址验证页面是否能正常打开。验证通过之后再接 CDN 和自定义域名,这样出问题时更容易定位是源站问题还是加速层问题。
上传文件时要注意三点:第一,确认本地构建产物是最新的,避免把开发环境的调试文件一并上传;第二,检查文件编码和换行,避免中文出现乱码;第三,图片和字体这类二进制文件不要用文本方式处理,上传后抽查几个文件的 Content-Type 是否正确,例如 HTML 是 text/html,CSS 是 text/css,JavaScript 是 application/javascript。
四、公开访问与桶策略:能读就行,不要多给权限
静态网站需要让匿名用户读取文件,但这并不意味着桶里的所有内容都可以公开。正确的做法是“最小权限”:只允许读取用于对外展示的目录,管理后台、构建产物、备份文件和日志不要放在同一个公开桶里。
一种常见的做法是使用桶策略,只对 GetObject 操作放行,示例如下:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": { "AWS": ["*"] },
"Action": ["obs:GetObject"],
"Resource": ["obs:*:*:object:docs-site-prod/*"]
}
]
}
使用这类策略前,需要注意三点:第一,确认策略里的桶名和路径与实际一致,不要用通配符把其他桶也放行;第二,上传和删除操作不要对匿名用户放行,写操作只能由有权限的账号和密钥完成;第三,定期检查桶的访问日志和策略变更记录,确认没有因为临时调试而留下长期公开的配置。
如果网站需要通过 JavaScript 从其他域名调用桶里的资源,还要配置跨域资源共享 CORS,明确允许的来源域名、方法和请求头。允许来源写 * 虽然省事,但对有鉴权或敏感接口的场景并不合适,生产环境建议写具体域名。
五、自定义域名与 HTTPS:让用户记住的是域名,不是桶地址
直接把 OBS 的托管地址发给用户并不合适,一是地址难记,二是后续换桶或换区域时链接会变。正确的做法是绑定自己的域名。
常见流程是:先在 CDN 中添加加速域名,源站选择对应的 OBS 桶;然后在域名解析服务中,把自定义域名解析到 CDN 分配的 CNAME 地址;最后在 CDN 上配置证书,开启 HTTPS。证书可以使用华为云证书管理服务申请和托管的证书,也可以上传已有证书,到期前及时续期,避免因为证书过期导致全站无法访问。
这里有几个容易忽略的细节:第一,域名需要完成备案才能在国内提供访问,未备案的域名不要急着上线;第二,回源协议建议与用户访问协议保持一致,避免出现 HTTPS 页面加载 HTTP 资源导致的混合内容告警;第三,开启 HTTP 到 HTTPS 的强制跳转之前,先确认所有引用资源都支持 HTTPS,否则页面样式和脚本可能加载失败。
六、CDN 缓存策略:缓存时间不是越长越好
CDN 的价值很大程度上体现在缓存策略上。缓存时间太短,回源请求多,源站压力和费用都会上升;缓存时间太长,页面更新后用户迟迟看不到新内容。合理的做法是按文件类型分别设置。
| 文件类型 | 建议缓存时间 | 说明 |
|---|---|---|
| HTML 页面 | 较短,例如 5 分钟到 1 小时 | 内容经常更新,缓存太长会影响发布 |
| CSS、JavaScript | 较长,例如 7 天到 30 天 | 文件名带哈希值时可以放心缓存 |
| 图片、字体 | 较长,例如 30 天 | 内容稳定,更新时换文件名即可 |
| API 接口和动态内容 | 不缓存或只缓存很短时间 | 这类内容不适合走静态缓存 |
前端构建时,给 CSS 和 JavaScript 文件名加上内容哈希是一个很实用的习惯,例如 app.a1b2c3.js。文件内容变了,文件名也会变,浏览器和 CDN 都会把它当作新文件处理,就不用担心旧缓存覆盖新版本。
发布新版本后,如果 HTML 文件本身被缓存了,用户可能仍然看到旧页面。这时可以在 CDN 控制台对首页和相关路径做缓存刷新,只刷新变更的 URL,不要动不动就全站刷新。刷新操作本身也有成本和次数限制,频繁全站刷新说明缓存策略或发布流程还需要优化。
另外,建议开启文件压缩和防盗链。压缩可以减小传输体积,对移动端用户尤其明显;防盗链可以在一定程度上防止图片和文件被其他网站直接引用,消耗自己的流量。配置防盗链时要把自己的域名和常用来源加进白名单,避免把正常引用也拦截掉。
七、版本控制与生命周期:历史版本要留,但不要一直高价保存
静态站经常需要回滚:新页面上线后发现样式异常,或者文档写错了关键参数,这时能快速回到上一个版本非常重要。开启 OBS 的版本控制后,每次覆盖同名对象都会保留历史版本,回滚时只需要把历史版本恢复为当前版本,不用重新找本地文件。
版本控制会增加存储占用,因此要配合生命周期规则一起使用,例如:
- 当前版本的文件按正常策略保存。
- 超过 30 天的历史版本转到低频访问存储。
- 超过 180 天的历史版本转到归档存储或直接删除。
- 访问日志和临时构建产物只保留 30 天,到期自动清理。
生命周期规则要在测试环境先验证,确认规则匹配的路径和时间符合预期,再应用到生产桶。规则一旦配错,可能会把还在用的文件提前转储或删除,恢复起来很麻烦。
八、成本与安全:先算清楚账,再谈优化
静态站的成本主要来自存储、请求次数和流量。存储按实际占用计费,请求次数按读、写操作分别计费,流量按 CDN 下行流量和回源流量计费。日常优化可以从这几个方面入手:第一,删除不再使用的历史版本和临时文件;第二,对图片做适当压缩,避免上传未经处理的大图;第三,合理设置缓存时间,减少重复回源;第四,给桶和 CDN 配置用量告警,流量异常时能尽早发现。
安全方面,除了前面提到的桶策略和防盗链,还建议做到以下几点:不在前端代码里写访问密钥和内部接口地址;管理操作使用子账号和最小权限,不要长期使用主账号的密钥;开启 OBS 的访问日志,定期抽查异常请求;定期检查证书有效期和域名解析记录。
九、常见问题排查:按链路分段定位
遇到问题时,按“浏览器、CDN、OBS、域名解析”的顺序分段排查,比反复刷新页面更有效。
- 访问返回 403: 先检查桶策略和静态网站托管是否开启,再确认请求的文件确实存在,路径大小写是否一致。
- 访问返回 404: 检查对象键是否与链接一致,确认默认首页和错误页面配置是否正确,目录后是否缺少斜杠。
- 更新后仍是旧页面: 先清浏览器缓存,再检查 CDN 缓存规则和刷新记录,确认 HTML 文件是否被缓存过久。
- 图片或样式加载失败: 打开浏览器开发者工具,看具体是哪个请求失败,再检查该文件的 Content-Type、跨域配置和防盗链规则。
- HTTPS 告警: 检查证书是否过期、域名是否匹配,以及页面是否引用了 HTTP 资源。
排查时保留一条可复现的路径:具体 URL、请求时间、浏览器和网络环境,以及控制台和日志里的关键信息。这样无论是自己复盘,还是向同事和技术支持描述问题,都能更快定位。
十、总结与上线检查清单
用 OBS 托管静态网站、CDN 做加速,本质上是把“存”和“发”分开:OBS 负责稳定存储,CDN 负责就近分发。把这两层各自做好,再加上清晰的目录结构、合理的缓存策略和生命周期规则,一个小型静态站完全可以在低运维成本下长期稳定运行。
上线前可以按这份清单逐项确认:桶名和区域是否符合规划;默认首页和错误页面是否已配置;桶策略是否只放行了必要的读取权限;自定义域名解析和 HTTPS 是否正常;缓存规则是否按文件类型区分;发布后刷新流程是否明确;历史版本和日志的生命周期是否已配置;用量告警和证书到期提醒是否已开启。
把这些基础工作做扎实,后续不论是新增页面、发布活动页,还是把文档站升级到多版本并存,都只是在这个架构上做增量改动,而不用推倒重来。
- 点赞
- 收藏
- 关注作者
评论(0)