把静态站点放进对象存储:OBS 托管、CORS 与 HTTPS 的落地实操
把静态站点放进对象存储:OBS 托管、CORS 与 HTTPS 的落地实操
背景
上一篇文章对比了沙箱、ECS、OBS 三种静态托管方案,结论是"纯静态、高并发、低成本选 OBS"。但真到落地,会发现还有一堆配置细节:桶权限怎么给、默认首页和 404 怎么设、跨域怎么配、HTTPS 从哪来、缓存怎么控制。本文把 OBS 静态网站托管这条链路完整走一遍,给出可直接照做的步骤和踩坑点。
一、建桶与权限:先最小化,再开放
对象存储的桶名在全局范围内唯一,命名建议用 项目名-用途-区域 这种结构,避免撞名。
权限是第一个必须想清楚的点。静态网站托管需要公共读,但只需要读:
- 桶策略设为"公共读、私有写",只允许匿名
GET对象。 - 绝不开公共写,否则任何人都能往你桶里塞文件。
- 如果站点里有敏感资源(配置、备份),不要放在公开桶里,用独立私有桶 + 签名 URL。
一个常见误区:把整个桶设成公共读写图省事。这等于把存储空间变成公开网盘,是安全事故的温床。
二、静态网站托管:默认首页与 404
开启"静态网站托管"后,需要指定两个文档:
- 默认首页:访问根路径时返回的文件,通常是
index.html。 - 错误文档:访问不存在的对象时返回的页面,通常是
404.html。
对于单页应用(SPA),路由是前端控制的,刷新子路由会请求不存在的对象。这时要把错误文档也指向 index.html,让前端接管路由,否则用户刷新就 404。
默认首页: index.html
错误文档: index.html # SPA 场景
如果是多页站点,错误文档用独立的 404.html 更友好。
三、CORS:跨域场景别漏配
静态站点本身不一定需要 CORS,但当页面要用 fetch/XHR 请求其他域的资源(比如后端 API、另一个桶里的字体/图片),浏览器会做跨域校验,没配 CORS 就会被拦。
CORS 规则要按需最小化:
- 允许来源:写具体域名,不要图省事用
*,尤其涉及凭证时。 - 允许方法:只放通实际用到的(GET/HEAD,必要时 POST)。
- 允许头:只放通必要请求头,别全量放开。
- 预检缓存:合理设置
MaxAge,减少 OPTIONS 请求。
字体文件尤其容易漏:Web 字体跨域加载需要 Access-Control-Allow-Origin,很多站点图片正常、字体却加载失败,就是这里没配。
四、HTTPS 与自定义域名:靠 CDN 补上
OBS 的默认网站域名通常是 HTTP,且是平台分配的域名。要自定义域名 + HTTPS,标准做法是接 CDN:
- 在 CDN 添加加速域名,源站选 OBS 桶。
- 为域名申请/上传 SSL 证书,开启 HTTPS。
- 配置 DNS,把域名 CNAME 到 CDN 节点。
- 回源协议按需设置(HTTPS 回源更安全)。
这样用户的请求走 CDN,CDN 回源到 OBS。HTTPS 在 CDN 层终止,OBS 侧可以保持简单。
五、缓存与刷新:让更新立即可见
静态资源最大的性能红利来自缓存,但缓存也会导致"更新了看不到"。策略是分级缓存 + 版本化:
index.html:短缓存或不缓存(Cache-Control: no-cache),保证入口总是最新的。- 带哈希的静态资源(
app.abc123.js):长缓存(max-age=31536000, immutable),文件名变了自然失效。 - 发布新版本时,只刷新
index.html和 CDN 的目录刷新,不必全量刷新。
用"文件名哈希"代替"手动刷缓存",是静态站点最省心的版本管理方式。
六、常见坑清单
- 桶名大小写/唯一性:桶名全局唯一、通常要求小写,撞名就换。
- 默认文档缺失:没配默认首页,访问根路径直接 403/404。
- SPA 刷新 404:错误文档没指向
index.html。 - 权限过宽:桶策略开了公共写,务必收回。
- CORS 只配了 GET:前端用 POST 或带自定义头时预检失败。
- 字体跨域失败:漏配
Access-Control-Allow-Origin。 - HTTPS 缺失:只用桶默认 HTTP 域名,浏览器标记不安全。
- 缓存不刷新:更新后用户看到旧页面,需版本化或刷新入口文件。
七、成本与治理
OBS 的成本主要来自三块:存储、请求次数、下行流量。纯静态站点里流量是大头,所以接 CDN 不只是为了 HTTPS,也能显著降低回源流量成本、提升访问速度。
治理上记住两点:定期清理无用对象(旧版本资源),给桶配生命周期规则自动归档/删除;监控流量异常,防止被刷。
八、总结
OBS 静态托管的链路其实不复杂:建桶(最小权限)→ 开网站托管(首页 + 404)→ 按需配 CORS → 接 CDN 上 HTTPS → 分级缓存 + 版本化。真正容易翻车的是权限给太宽、SPA 忘记 404 回退、字体漏配 CORS、更新后缓存不刷这几个细节。
把这几步做扎实,你就能得到一个"几乎零运维、成本极低、天然高可用"的静态站点。对纯前端项目来说,这往往是最优解。
(本文为原创技术分享,基于对象存储静态托管的真实配置实践整理。)
- 点赞
- 收藏
- 关注作者
评论(0)