控制台管理静态资源
本文档介绍如何管理 CloudBase 静态托管服务,包括资源管理、域名配置、安全设置等核心功能。
概述
CloudBase 静态托管为您提供了完整的静态网站管理能力,支持文件上传、域名绑定、缓存配置、安全防护等功能。通过 云开发CloudBase/静态网站托管 可以便捷地管理您的静态网站。
资源管理
基本操作
在静态托管控制台中,您可以执行以下操作:
- 文件管理:上传、下载、删除文件
- 文件夹管理:创建、删除文件夹
- 批量操作:支持批量上传和删除
- 在线编辑:支持在线编辑文本文件
文件命名规范
命名要求
- 文件和文件夹名称仅支持数字、中英文字符组合
- 名称长度限制为 255 个字符
- 建议使用有意义的命名,便于管理和维护
服务状态
自动管理
静态托管服务无需手动启停:
- 当托管空间内有文件时,服务自动运行
- 当托管空间为空时,服务自动暂停
- 暂停状态下不产生费用
域名管理
默认域名
CloudBase 为每个静态托管提供默认域名,特点如下:
- 免费使用:无需额外配置即可访问
- 测试用途:适合开发和测试阶段使用
- 访问限制:存在访问频率限制,超限后暂时不可访问
自定义域名
为了获得更好的访问体验和品牌展示,建议配置自定义域名:
- 无访问限制:不受默认域名的频率限制
- 品牌展示:使用自己的域名提升品牌形象
- SEO 友好:有利于搜索引擎优化
推荐配置
建议为生产环境配置自定义域名,详细配置方法请参考 配置自定义域名。
索引文档配置
默认索引文档
- 默认文件:
index.html
- 作用范围:根目录和所有子目录
- 访问行为:访问目录时自动返回索引文档
配置建议
最佳实践
- 在根目录和重要子目录下都放置
index.html
文件 - 确保索引文档内容完整,提供良好的用户体验
- 可以在索引文档中添加导航链接,方便用户访问其他页面
重定向规则
重定向规则帮助您处理 URL 变更和错误页面,提升用户体验。
应用场景
- 文件迁移:文件移动或重命名后的 URL 重定向
- URL 简化:将长 URL 重定向到短 URL
- 错误处理:自定义 404 等错误页面
- SEO 优化:保持搜索引擎排名
规则类型
1. 错误码重定向
针对 HTTP 错误状态码(如 404、403)进行重定向:
- 支持范围:4xx 错误码
- 自定义页面:可以设计友好的错误页面
- 用户引导:在错误页面提供导航和帮助信息
2. 前缀匹配重定向
基于 URL 前缀进行重定向:
- 灵活匹配:支持文件和文件夹的前缀匹配
- 批量重定向:一条规则可以处理多个相似 URL
- 路径映射:将旧路径映射到新路径
示例场景:
旧路径:docs/guide.html
新路径:documents/guide.html
规则:docs/ → documents/
配置注意事项
重要提醒
- 优先级:重定向规则优先级高于索引文档配置
- 路径格式:替换路径只需填写相对路径,无需包含域名
- 测试验证:配置后请充分测试确保重定向正常工作
缓存配置
合理的缓存配置可以显著提升网站访问速度,减少带宽消耗。
缓存类型
CloudBase 静态托管支持两级缓存:
- 浏览器缓存:在用户浏览器中缓存资源
- 节点缓存:在 CDN 节点中缓存资源
配置方式
支持多种缓存配置方式:
- 文件后缀:如
.jpg
、.png
、.css
、.js
- 文件夹:如
/static
、/assets
、/images
- 文件路径:如
/static/*.js
、/css/main.css
缓存策略建议
资源类型 | 建议缓存时间 | 说明 |
---|---|---|
图片文件 | 30 天 | 图片通常不经常变更 |
CSS/JS 文件 | 7 天 | 样式和脚本文件相对稳定 |
HTML 文件 | 1 小时 | 页面内容可能经常更新 |
字体文件 | 30 天 | 字体文件很少变更 |
缓存机制
- 缓存时间以
Cache-Control: max-age=<seconds>
形式设置 - 控制台上传文件会自动刷新 CDN 缓存
- 用户访问时优先使用浏览器缓存,其次是节点缓存
安全配置
CloudBase 静态托管提供多层安全防护,保护您的资源免受恶意访问。
防盗链配置
通过 Referer 检查防止资源被盗用:
黑名单模式
- 功能:拒绝指定域名的访问请求
- 适用场景:已知恶意域名的防护
- 配置方式:添加需要拒绝的域名列表
白名单模式
- 功能:仅允许指定域名的访问请求
- 适用场景:严格控制访问来源
- 配置方式:添加允许访问的域名列表
检测机制
CloudBase 通过检查 HTTP 请求头中的 Referer
字段来判断请求来源,非法请求将返回 403 状态码。
IP 访问控制
IP 黑白名单
支持格式:
- IPv4 地址:
192.168.1.1
- IPv4 网段:
192.168.1.0/24
、10.0.0.0/8
- IPv6 地址:完整的 IPv6 地址格式
配置模式:
- 黑名单:阻止指定 IP 或网段的访问
- 白名单:仅允许指定 IP 或网段的访问
IP 访问限频
- 功能:限制单个 IP 的访问频率
- 防护效果:可防御部分 CC 攻击
- 配置建议:根据业务需求合理设置限频阈值
配置提醒
IP 访问限频可能影响正常用户访问,请根据实际业务情况谨慎配置。建议先在测试环境验证配置效果。