简介
注意:
2024年1月1日后创建的存储桶,若用户使用默认域名(包括静态网站域名)访问文件,不支持预览。因此,开启静态网站后,还需要配置自定义域名,源站类型为静态网站,使用自定义域名访问。详情请参见 设置自定义域名。
注意事项
如果您的静态网站是不对外的,建议把存储桶的访问权限设置为私有读写,同时通过 CDN 回源鉴权、CDN 鉴权的方式实现数据的全链路保护,详情请参见 CDN 加速配置。
如果您希望把静态网站开放给所有人访问,可将存储桶的访问权限设置为公有读私有写,但需注意这样设置可能会导致资源被盗用,因此请谨慎配置。详情可参见 防盗刷指引。
开启静态网站配置后,您需要使用静态网站域名访问 COS 源站才能生效,如果使用 COS 默认域名访问则无静态网站效果。
前提条件
操作步骤
1. 登录 对象存储控制台。
2. 在左侧导航栏中,单击存储桶列表,进入存储桶列表页面。
3. 找到需要用来托管静态网站的存储桶,单击其存储桶名称,进入存储桶详情页面。
4. 在左侧导航栏中,选择权限管理 > 存储桶访问权限,在公共权限栏中,选择公有读私有写并保存。
5. 在左侧导航栏中,选择基础配置 > 静态网站,在静态网站栏中,单击编辑,将当前状态的开启按钮打开。
6. 依次填写静态网站的配置项。
![](https://qcloudimg.tencent-cloud.cn/image/document/a8c5cd9f072c972182965f74504cd79e.png)
配置说明如下:
![](https://qcloudimg.tencent-cloud.cn/image/document/a8c5cd9f072c972182965f74504cd79e.png)
访问节点:开启静态网站,您会得到一个与该存储桶相关联的静态网站访问节点(即静态网站域名)。该访问节点只支持 GET/HEAD Object 操作。
注意:
静态网站的访问节点区分英文大小写。请注意在配置索引文件、错误文件、重定向规则前缀匹配时填写的文件名称和后缀的英文大小写需要与存储桶中的文件保持一致。
强制 HTTPS(可选):当您开启强制 HTTPS 后,在用户访问您的静态网站时,静态网站的访问节点会强制使用 HTTPS 协议方式打开。
注意:
如果您通过自定义域名访问静态网站,同时静态网站开启了强制 HTTPS,请确认您已给该自定义域名正确配置相关证书,如果证书异常,则会跳转至默认域名进行访问。
忽略 html 扩展名(可选):访问路径为 index 时,会自动匹配 index.html 对象进行返回。
索引文档(必选):索引文档即静态网站的首页,是当用户对网站的根目录或任何子目录发出请求时返回的网页,通常此页面被命名为 index.html。
注意:
如果存储桶中创建了文件夹,则需要在每个文件夹层级上都添加索引文档。
2024年1月1日后创建的存储桶,若使用静态网站域名访问,索引文档在请求时不会直接返回网页内容,而是直接下载。
错误文档(可选):错误文档指访问静态网站出错后返回的页面。该配置项方便您自行定义错误文档。当静态网站无法响应用户的请求时,将返回指定的自定义错误页面。例如您配置了命名为 error.html 的错误文档,当用户访问遇到 HTTP 错误时,页面将返回 error.html 页面,为其提供帮助指引。当您未配置错误文档时,此时用户访问遇到 HTTP 错误,页面将返回默认的错误信息。
注意:
错误文档配置可支持存储桶根目录或子目录下的文件,请使用浏览器可识别的
.html
或 .htm
等格式的文件。若使用了浏览器不可识别的文件,例如 .zip
文件,大部分浏览器将显示错误无法访问或拒绝访问请求。错误文档响应码:如有设置错误文档则展示该项。可配置返回错误文档时的 HTTP 响应码为原始错误码或者200。
重定向规则(可选):利用重定向规则,您可以根据特定的文件路径、请求中的前缀或者响应代码来按条件重定向请求。
例如,您在存储桶中删除或重命名某个文件。您可以添加一个重定向规则,将访问该文件的请求重定向至其他文件。
类型:指重定向规则的原始类型。
错误码:目前重定向规则仅支持对
4xx
错误码(例如 404)进行重定向配置。您可以选择性地自定义错误页面,若用户触发了对应的 HTTP 错误,您可以在该错误页面中为您的用户提供其他指引。前缀匹配:您可以使用前缀匹配规则对存储桶内的文件或文件夹进行重定向设置。具体示例请参见 重定向规则示例。
注意:
前缀匹配不支持通配符。如您希望对前缀为 index1/、index2/ 的两个文件夹进行重定向,不能使用
index*/
作为匹配规则,需要分别创建对应的匹配规则。描述:重定向规则的原始错误码或前缀。
规则:重定向规则的替换规则,包括替换路径和替换前缀。
若类型选择错误码,规则默认为“替换路径”。替换路径即触发该重定向规则后,原请求地址会被替换到新页面的路径。
若类型选择前缀,规则支持选择“替换路径”或“替换前缀”。
注意:
替换路径必须是存储桶内的对象路径。
替换内容:被替换的文件路径或前缀。
7. 设置完成后,单击保存即可。
设置自定义域名
2024年1月1日后创建的存储桶,若用户使用默认域名(包括静态网站域名)访问文件,不支持预览。因此,开启静态网站后,还需要配置自定义域名,源站类型为静态网站,使用自定义域名访问。
1. 登录 对象存储控制台,进入存储桶详情页面,选择域名与传输管理 > 自定义源站域名。
![](https://qcloudimg.tencent-cloud.cn/image/document/ef145552642b3f96ca30373ce579f453.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/ef145552642b3f96ca30373ce579f453.png)
2. 点击添加域名,选择源站类型为静态网站源站,创建自定义域名。
![](https://qcloudimg.tencent-cloud.cn/image/document/27d369ef9f927036b07f5f56515b2a7f.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/27d369ef9f927036b07f5f56515b2a7f.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/93acf47e95c82a04cd190bd7a88c8420.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/93acf47e95c82a04cd190bd7a88c8420.png)
新旧版本控制台差异
由于存储桶域名存在差异,您在使用静态网站功能时,新旧版本的静态网站访问节点同样存在差异,以成都地域的存储桶为例:
如果您使用的是 V5 控制台,则您的静态网站访问节点格式为:
https://<BucketName-APPID>.cos-website.ap-chengdu.myqcloud.com
。如果您使用的是 V4 控制台,则您的静态网站访问节点格式为:
https://<BucketName>.cos-website.coscd.myqcloud.com
。如果您在旧版控制台上设置过静态网站功能,后面升级到新版控制台后,您可以在新版控制台上进行查看,如下图所示,您可以在历史版本静态网站栏,单击点此加载即可。
![](https://qcloudimg.tencent-cloud.cn/image/document/1027f215ede2c82ebd1a2e3fa22c616c.png)
单击加载后,可以看到历史静态网站配置,如下图所示:
![](https://qcloudimg.tencent-cloud.cn/image/document/28961b7dab446eec498d8776f368c783.png)
需要注意的是,历史静态网站配置仅支持查看,无法进行编辑。如需体验新版控制台更加丰富和稳定的功能,我们推荐您在新版本控制台上重新配置您的静态网站域名。重新配置前,您需要注意以下事项:
![](https://qcloudimg.tencent-cloud.cn/image/document/1027f215ede2c82ebd1a2e3fa22c616c.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/28961b7dab446eec498d8776f368c783.png)
修改旧版本静态网站配置前,请务必检查您是否有业务依赖于旧版本静态网站,如果有则需要进行修改。
将旧版本静态网站配置切换至新版本静态网站配置,您只需要记录旧版本静态网站配置,并删除旧版本静态网站配置,然后再新建一个新版本静态网站配置即可。
如果您有业务依赖于历史版本静态网站域名,在切换至新版本静态网站配置后,请将您业务所使用的静态网站域名修改为新版本的静态网站域名。
注意:
除了域名差异外,新旧版本控制台所调用的 API 也存在差异,我们推荐您使用新版本控制台以及使用新版本 API、工具、SDK,因为这能够让您体验更加丰富和稳定的功能。COS 新版本控制台所调用的操作对象或存储桶的 API 是 XML API,旧版本控制台上调用的则是 JSON API,有关新旧两个版本 API 的差异,请参见 API 常见问题。