跳到主要内容

控制台管理静态资源

本文档介绍如何管理 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 静态托管支持两级缓存:

  1. 浏览器缓存:在用户浏览器中缓存资源
  2. 节点缓存:在 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/2410.0.0.0/8
  • IPv6 地址:完整的 IPv6 地址格式

配置模式

  • 黑名单:阻止指定 IP 或网段的访问
  • 白名单:仅允许指定 IP 或网段的访问

IP 访问限频

  • 功能:限制单个 IP 的访问频率
  • 防护效果:可防御部分 CC 攻击
  • 配置建议:根据业务需求合理设置限频阈值
配置提醒

IP 访问限频可能影响正常用户访问,请根据实际业务情况谨慎配置。建议先在测试环境验证配置效果。