租户端 存储 对象存储（COS） 控制台指南

设置静态网站

最近更新时间: 2024-06-12 15:06:00

简介

您可以通过对象存储控制台，把一个存储桶设置为托管静态网站，并且通过访问存储桶的静态网站域名来访问静态网站。关于静态网站的相关说明，请参见 托管静态网站。

注意：

  • 使用存储桶托管静态网站，您首先需要把存储桶的访问权限设置为公有读私有写。
  • 开启静态网站配置后，您需要使用静态网站域名访问 COS 源站才能生效，如果使用 COS 默认域名访问则无静态网站效果。

前提条件

已创建存储桶，详情请参见 创建存储桶 文档。

操作步骤

  1. 登录 对象存储控制台，单击左侧【存储桶列表】菜单栏，单击需要用来托管静态网站的存储桶，进入存储桶详情界面。

  2. 选择【权限管理】> 【存储桶访问权限】，在【公共权限】一栏中，选择公有读私有写并保存。

  3. 选择【基础配置】>【静态网站】，单击【编辑】，把当前状态的开启按钮打开，然后依次填写静态网站的配置项。

配置说明如下：

  • 忽略 html 扩展名（可选）：访问路径为 index 时，会自动匹配 index.html 对象进行返回。

  • 索引文档（必选）：索引文档即静态网站的首页，是当用户对网站的根目录或任何子目录发出请求时返回的网页，通常此页面被命名为 index.html。

    注意：

    如果存储桶中创建了文件夹，则需要在每个文件夹层级上都添加索引文档。

  • 错误文档（可选）：错误文档指访问静态网站出错后返回的页面。该配置项方便您自行定义错误文档。当静态网站无法响应用户的请求时，将返回指定的自定义错误页面。例如您配置了命名为 error.html 的错误文档，当用户访问遇到 HTTP 错误时，页面将返回 error.html 页面，为其提供帮助指引。当您未配置错误文档时，此时用户访问遇到 HTTP 错误，页面将返回默认的错误信息。

    注意：

    错误文档配置可支持存储桶根目录或子目录下的文件，请使用浏览器可识别的.html或.htm等格式的文件。若使用了浏览器不可识别的文件，例如.zip文件，大部分浏览器将显示错误无法访问或拒绝访问请求。

  • 错误文档响应码：如有设置错误文档则展示该项。可配置返回错误文档时的 HTTP 响应码为原始错误码或者200。

  • 重定向规则（可选）：利用重定向规则，您可以根据特定的文件路径、请求中的前缀或者响应代码来按条件重定向请求。 例如，您在存储桶中删除或重命名某个文件。您可以添加一个重定向规则，将访问该文件的请求重定向至其他文件。

    • 错误码：目前重定向规则仅支持对4xx错误码（例如 404）进行重定向配置。您可以选择性地自定义错误页面，若用户触发了对应的 HTTP 错误，您可以在该错误页面中为您的用户提供其他指引。

    • 前缀匹配：您可以使用前缀匹配规则对存储桶内的文件或文件夹进行重定向设置。具体示例请参见 重定向规则示例。

  1. 设置完成后，单击保存即可。