跳到主要内容
支持地域：上海

控制台管理静态资源

本文档介绍如何管理 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/24、10.0.0.0/8
  • IPv6 地址：完整的 IPv6 地址格式

配置模式：

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

IP 访问限频​

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

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