全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

静态网站托管

最近更新时间:2026-11-16 10:51:00

KS3 静态网站托管支持将存储桶(Bucket)中的 HTML、CSS、JavaScript 等静态文件直接发布为一个公开访问的网站。配置网站首页及默认 404 页面后,即可通过指定域名访问网站,无需部署和维护传统服务器,显著降低运维成本和技术门槛。

前提条件

  • 已创建存储桶(Bucket)。

  • 已将网站内容文件上传至存储桶,且文件 ACL 设置为公共读或桶 Bucket Policy 策略设置为支持匿名访问。详情请参见文档:访问权限管理。

  • 在存储桶上绑定自定义域名,详情请参见文档:域名绑定。

注意事项

  • 一个存储桶中只能创建一条静态网站托管规则。

  • 仅2026年8月3日及之后创建的桶,支持使用静态网站功能,2026年8月3日前创建的桶,不支持使用静态网站功能。

  • 静态网站功能必须使用自定义域名访问才会生效,使用非自定义域名访问会当做普通请求处理,静态网站规则不生效。

  • 静态网站功能仅支持匿名用户访问,带签名访问时静态网站功能不生效,当做普通请求处理。因此使用静态网站功能,必须将相关文件的 ACL 权限设置为公开读(或 Bucket Policy 设置支持匿名用户访问)。

  • 如果设置了多个重定向规则(RoutingRule),KS3 会从前往后依次匹配,如果匹配成功,则执行此规则,后续的规则不再执行。

  • 访问返回 404 错误时,优先匹配对应错误码的重定向规则(RoutingRule),命中则执行重定向;未命中返回默认404页(ErrorDocument) 的内容,即重定向规则的优先级高于默认404页。

  • 仅GET Object(含 Range GET)、HEAD Object请求会执行静态网站托管规则,其他请求(如GET Object ACL或GET Object Tagging等)均会被当做普通请求处理,不执行静态网站托管规则。

  • 静态网站资源遭外部站点盗链会产生额外流量与负载,可通过配置防盗链域名白名单,防范流量盗用、控制业务成本。详情请参见文档:防盗链设置。

操作步骤

控制台操作步骤

  1. 登录对象存储控制台。

  2. 进入目标存储空间详情页,切换至【空间设置】→【数据管理】→【静态网站】。

  1. 点击开启按钮,填写相关配置。

具体配置内容如下所示:

配置内容

说明

默认首页

访问所有 /结尾的域名或访问结尾不带/的跟域名时,将返回该文件。为空则表示不启用默认首页设置。

输入Object的名称,不能包含/。

子目录首页

访问子目录时,是否跳转到该子目录下的默认首页文件。不开启时将跳转到根目录下的默认首页文件,开启后将跳转到子目录下的默认首页文件。

默认404页

访问的文件不存在时,将返回此错误页面,为空则表示不启用默认404页设置。

需输入Object的Key。

错误文档响应码

返回错误页面时返回的HTTP状态码。

重定向规则

匹配条件

表示执行重定向规则的匹配条件,支持状态码匹配和前缀匹配。

1. 如果同时设置状态码匹配和前缀匹配,则两者均匹配时,才会触发重定向规则。

2. 全部为空表示全部请求均触发重定向规则。

重定向域名

表示跳转时的域名,需符合域名规范,且不能包含/。示例:example.com。

不填写时重定向默认继承原请求的域名。

重定向返回的状态码

表示跳转时返回的状态码,可选值有:301、302、307。

开通HTTPS

重定向请求时使用的协议,不开通时默认使用HTTP协议。

开启携带请求参数

执行跳转规则时,是否携带请求参数,不开启表示不携带请求参数。

  • 替换规则

  • 替换内容

支持替换前缀和替换Key。

1. 如果不需要替换前缀或Key选择不设置即可,不设置时重定向会保留原始请求的路径(默认不带查询参数),仅更换重定向域名。

2. 设置替换内容为空时,表示删除指定前缀或Key。

操作

支持删除配置。

  1. 点击【保存】完成配置。

其他方式操作步骤

操作方式

参见文档

API

创建静态网站规则:PUT Bucket Website

查看静态网站规则:GET Bucket Website

删除静态网站规则:DELETE Bucket Website

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈