文档中心>轻量对象存储

静态网站

最近更新时间:2025-12-25 11:49:22

我的收藏
您可以通过控制台开启存储桶的静态网站功能。开启后,通过自定义域名访问存储桶,可以实现网站首页、错误码重定向等网站效果,如果使用存储桶体验域名访问(格式为<Bucket-Appid>.light-cos.com)则无网站效果,仍保持直接访问桶内文件的形式。
静态网站指包含静态内容(例如 HTML)或客户端脚本的网站,而动态网站的内容包含诸如 PHP、JSP 或 ASP.NET 等服务器端脚本,需要依赖服务器端处理。存储桶仅支持静态网站的托管,不支持服务器端脚本编写。当您需要部署动态网站时,推荐使用 CVM 进行服务端代码部署。
注意:
使用自定义域名访问,才能实现静态网站效果。
开启静态网站后,使用自定义域名调用 GetBucket、HeadBucket 等接口会受到影响,详情见 接口调用影响
使用存储桶托管静态网站,您首先需要把存储桶的访问权限设置为公有读私有写。

操作步骤

2. 在存储桶卡片页面中,进入指定的存储桶页面,进入基础配置 > 权限设置
3. 进入公共访问权限,单击编辑,将存储桶访问权限设置为公有读私有写
4. 进入静态网站,单击开启按钮,并设置静态网站的首页。
默认首页:是用户对网站的根目录或任何子目录发出请求时返回的网页,通常此页面被命名为 index.html。
说明:
静态网站的页面名称区分英文大小写。请注意在默认首页、错误页面、重定向规则前缀匹配时填写的文件名称和后缀的英文大小写需要与存储桶中的文件保持一致。



5. 开启后,可继续配置错误页面、重定向页面等其他静态网站的可选配置。
6. 错误页面配置:
错误文档:错误文档指访问静态网站出错后返回的页面,用于自行定义错误文档。当静态网站无法响应用户的请求时,将返回指定的自定义错误页面。当您未配置错误文档时,用户访问遇到 HTTP 错误,页面将返回默认的错误信息。
公益404页面:开启后,静态网站报错404时,会返回404公益页面。
响应码:用于配置静态网站响应错误文档时,返回的 HTTP 相应吗。选择返回原始错误码(例如,400、403等),或返回200。



7. 重定向页面配置。通过配置重定向规则,您可以根据特定的文件路径、请求中的前缀或者响应代码来按条件重定向请求。例如,您在存储桶中删除或重命名某个文件。您可以添加一个重定向规则,将访问该文件的请求重定向至其他文件。
类型:
错误码:目前重定向规则仅支持对4xx错误码(例如404)进行重定向配置。您可以选择性地自定义错误页面,若用户触发了对应的 HTTP 错误,您可以在该错误页面中为您的用户提供其他指引。
前缀匹配:您可以使用前缀匹配规则对存储桶内的文件或文件夹进行重定向设置。
描述:输入具体的要匹配的错误码或前缀。
强制 HTTPS:当您开启强制 HTTPS 后,在用户访问自定义域名时,会强制使用 HTTPS 协议方式打开。

8. 强制 HTTPS:当您开启强制 HTTPS 后,在用户访问自定义域名时,会强制使用 HTTPS 协议方式打开。



9. 忽略 html 扩展名:开启该开关后,访问会忽略扩展名。例如,访问路径为 index 时,会自动匹配 index.html 对象进行返回。

使用自定义域名访问

开启静态网站配置后,使用自定义域名访问会实现静态网站。自定义域名的配置方法详见 自定义域名

开启静态网站对自定义域名调用 API 接口的影响

开启静态网站后,静态网站的重定向效果,会作用在自定义域名上。部分接口,将无法获得 LightCOS 的原始返回。如果您需要获得原始返回,需要关闭静态网站功能,或使用体验域名(<bucket-apppid>.light-cos.com)访问。
主要受影响的接口为:
GetBucket :该接口用于列出对象列表。开启静态网站后,用户通过自定义域名列出根目录对象件列表将会被识别为访问静态网站的索引文档。非列出根目录的操作,不受影响。
HeadBucket:该接口用于获取存储桶的元数据信息。开启静态网站后,用户通过自定义域名调用 HeadBucket 接口将会被识别为 HeadObject 接口(指向文件为静态网站的索引文档)。
此外,GetObject、HeadObject 接口会根据静态网站的规则,执行正常的重定向效果。PUT*、DELETE*、POST* 接口不会受到静态网站效果的影响,GetBucketWebsite、GetBucketReferer、ListParts 等 GET* 接口不会受到静态网站效果的影响。