最近更新时间: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等)均会被当做普通请求处理,不执行静态网站托管规则。
静态网站资源遭外部站点盗链会产生额外流量与负载,可通过配置防盗链域名白名单,防范流量盗用、控制业务成本。详情请参见文档:防盗链设置。
登录对象存储控制台。
进入目标存储空间详情页,切换至【空间设置】→【数据管理】→【静态网站】。
点击开启按钮,填写相关配置。
具体配置内容如下所示:
配置内容 | 说明 | |
|---|---|---|
默认首页 | 访问所有 输入Object的名称,不能包含 | |
子目录首页 | 访问子目录时,是否跳转到该子目录下的默认首页文件。不开启时将跳转到根目录下的默认首页文件,开启后将跳转到子目录下的默认首页文件。 | |
默认404页 | 访问的文件不存在时,将返回此错误页面,为空则表示不启用默认404页设置。 需输入Object的Key。 | |
错误文档响应码 | 返回错误页面时返回的HTTP状态码。 | |
重定向规则 | 匹配条件 | 表示执行重定向规则的匹配条件,支持状态码匹配和前缀匹配。 1. 如果同时设置状态码匹配和前缀匹配,则两者均匹配时,才会触发重定向规则。 2. 全部为空表示全部请求均触发重定向规则。 |
重定向域名 | 表示跳转时的域名,需符合域名规范,且不能包含 不填写时重定向默认继承原请求的域名。 | |
重定向返回的状态码 | 表示跳转时返回的状态码,可选值有:301、302、307。 | |
开通HTTPS | 重定向请求时使用的协议,不开通时默认使用HTTP协议。 | |
开启携带请求参数 | 执行跳转规则时,是否携带请求参数,不开启表示不携带请求参数。 | |
| 支持替换前缀和替换Key。 1. 如果不需要替换前缀或Key选择不设置即可,不设置时重定向会保留原始请求的路径(默认不带查询参数),仅更换重定向域名。 2. 设置替换内容为空时,表示删除指定前缀或Key。 | |
操作 | 支持删除配置。 | |
点击【保存】完成配置。
操作方式 | 参见文档 |
|---|---|
API | 创建静态网站规则:PUT Bucket Website 查看静态网站规则:GET Bucket Website 删除静态网站规则:DELETE Bucket Website |
纯净模式
