tencent cloud

对象存储

动态与公告
产品动态
产品公告
产品简介
产品概述
功能概览
应用场景
产品优势
基本概念
地域和访问域名
规格与限制
产品计费
计费概述
计费方式
计费项
免费额度
计费示例
查看和下载账单
欠费说明
常见问题
快速入门
控制台快速入门
COSBrowser 快速入门
用户指南
创建请求
存储桶
对象
数据管理
批量处理
全球加速
监控与告警
运维中心
数据处理
内容审核
智能工具箱
数据工作流
应用集成
工具指南
工具概览
环境安装与配置
COSBrowser 工具
COSCLI 工具
COSCMD 工具
COS Migration 工具
FTP Server 工具
Hadoop 工具
COSDistCp 工具
HDFS TO COS 工具
GooseFS-Lite 工具
在线辅助工具
自助诊断工具
实践教程
概览
访问控制与权限管理
性能优化
使用 AWS S3 SDK 访问 COS
数据容灾备份
域名管理实践
图片处理实践
COS 音视频播放器实践
工作流实践
数据直传
内容审核实践
数据安全
数据校验
大数据实践
COS 成本优化解决方案
在第三方应用中使用 COS
迁移指南
本地数据迁移至 COS
第三方云存储数据迁移至 COS
以 URL 作为源地址的数据迁移至 COS
COS 之间数据迁移
Hadoop 文件系统与 COS 之间的数据迁移
数据湖存储
云原生数据湖
元数据加速
数据加速器 GooseFS
数据处理
数据处理概述
图片处理
媒体处理
内容审核
文件处理
文档处理
故障处理
获取 RequestId 操作指引
通过外网上传文件至 COS 缓慢
访问 COS 时返回403错误码
资源访问异常
POST Object 常见异常
API 文档
简介
公共请求头部
公共响应头部
错误码
请求签名
操作列表
Service 接口
Bucket 接口
Object 接口
批量处理接口
数据处理接口
任务与工作流
内容审核接口
云查毒接口
SDK 文档
SDK 概览
准备工作
Android SDK
C SDK
C++ SDK
.NET(C#) SDK
Flutter SDK
Go SDK
iOS SDK
Java SDK
JavaScript SDK
Node.js SDK
PHP SDK
Python SDK
React Native SDK
小程序 SDK
错误码
鸿蒙(Harmony) SDK
终端 SDK 质量优化
安全与合规
数据容灾
数据安全
访问管理
常见问题
热门问题
一般性问题
计费计量问题
域名合规问题
存储桶配置问题
域名和 CDN 问题
文件操作问题
日志监控问题
权限管理问题
数据处理问题
数据安全问题
预签名 URL 问题
SDK 类问题
工具类问题
API 类问题
服务协议
Service Level Agreement
隐私政策
数据处理和安全协议
联系我们
词汇表

设置静态网站

PDF
聚焦模式
字号
最后更新时间: 2025-11-18 15:31:02

静态网站

静态网站指包含静态内容(例如 HTML)或客户端脚本的网站,用户可以通过 对象存储控制台 对已绑定自定义域名的存储桶,配置静态网站。而动态网站的内容包含 PHP、JSP 或 ASP.NET 等服务器端脚本,需要依赖服务器端处理。腾讯云对象存储(Cloud Object Storage,COS)支持静态网站的托管,不支持服务器端脚本编写。当您需要部署动态网站时,推荐使用 云服务器(Cloud Virtual Machine,CVM) 进行服务端代码部署。

这里将举例介绍托管静态网站的能力。
用户创建名为 examplebucket-1250000000 的存储桶,上传了如下文件: 
index.html
404.html
403.html
test.html
docs/a.html
images/
开启前:使用如下默认访问域名访问存储桶,弹出下载提示,可以保存 index.html 文件到本地。
https://examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com/index.html
开启后:使用如下访问节点访问存储桶,可以直接在浏览器中查看 index.html 的页面内容。
https://examplebucket-1250000000.cos-website.ap-guangzhou.myqcloud.com/index.html
注意:
2024年1月1日后创建的存储桶,不再支持通过 COS 默认域名(包括静态网站域名)直接访问对象,详情请参见 COS 存储桶域名使用安全管理通知(2024年1月施行)。您可通过自定义域名访问对象。详情请参见 开启自定义源站域名

强制 HTTPS

开启前:请求来源为 HTTP 时,访问节点 URL 保持 HTTP 未加密的传输协议。
http://examplebucket-1250000000.cos-website.ap-guangzhou.myqcloud.com
开启后:无论请求来源为 HTTP 或 HTTPS,访问节点始终保持 HTTPS 加密的传输协议。
https://examplebucket-1250000000.cos-website.ap-guangzhou.myqcloud.com

索引文档

索引文档即静态网站的首页,是当用户对网站的根目录或任何子目录发出请求时返回的网页,通常此页面被命名为 index.html。 当用户使用存储桶访问域名(例如 https://examplebucketbucket-1250000000.cos-website.ap-guangzhou.myqcloud.com)访问静态网站时,且未请求特定的页面。在这种情况下,Web 服务器将返回首页。
您的用户访问存储桶包括根目录在内的任何目录,URL 地址以/为结尾的会优先自动匹配该目录下的索引文档。根级 URL 的/是可选的,以下任意一个 URL 将返回索引文档。
http://www.examplebucket.com/
http://www.examplebucket.com
注意:
如果存储桶中创建了文件夹,则需要在每个文件夹层级上都添加索引文档。

错误文档

假设您在配置错误文档前,访问以下页面,将返回404状态码,页面上显示为默认的错误页面信息。
https://examplebucket-1250000000.cos-website.ap-guangzhou.myqcloud.com/webpage.html
配置错误文档后,访问以下页面,同样返回404状态码,但页面上将显示您所指定的错误页面信息。
https://examplebucket-1250000000.cos-website.ap-guangzhou.myqcloud.com/webpage.html

重定向规则

说明:
托管静态网站配置重定向规则,替换文档路径必须是存储桶内的对象路径。
重定向规则优先级是先触发强制 HTTPS 或前缀匹配重定向,最后触发错误码跳转。

配置错误码重定向

假设您为 webpage.html 这个文档设置了私有读写的公共访问权限,用户访问该文件时,将返回403错误。
配置403错误码重定向至 403.html 后:浏览器将返回 403.html 的内容。
如果您未配置 403.html 文档,浏览器将返回错误文档或默认错误信息。


配置前缀匹配

注意:
前缀匹配不支持通配符。如您希望对前缀为 index1/、index2/ 的两个文件夹进行重定向,不能使用 index*/ 作为匹配规则,需要分别创建对应的匹配规则。
当您将文件夹从docs/重命名为documents/后,用户在访问docs/文件夹会产生错误。所以,您可以将前缀docs/的请求重定向至 documents/

当您删除了images/文件夹(即删除了具有前缀images/的所有对象)。您可以添加重定向规则,将具有前缀images/的任何对象的请求重定向至test.html页面。



操作场景

您可以通过对象存储控制台,把一个存储桶设置为托管静态网站,并且通过存储桶的静态网站域名来访问静态网站。

注意事项

如果您的静态网站是不对外的,建议把存储桶的访问权限设置为私有读写,同时通过 CDN 回源鉴权、CDN 鉴权的方式实现数据的全链路保护,详情请参见 CDN 加速配置
如果您希望把静态网站开放给所有人访问,可将存储桶的访问权限设置为公有读私有写,但需注意这样设置可能会导致资源被盗用,因此请谨慎配置。您可参见 防盗刷指引,以降低被盗刷的风险。
开启静态网站配置,并设置自定义域名后,您需要使用自定义域名访问 COS 源站才能生效,如果使用 COS 默认域名访问则无静态网站效果(例如无法正常呈现排版效果)。

前提条件

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

操作步骤

开启静态网站

2. 在左侧导航栏中,单击存储桶列表,进入存储桶列表页面。
3. 找到需要用来托管静态网站的存储桶,单击其存储桶名称,进入存储桶详情页面。
4. 在左侧导航栏中,选择权限管理 > 存储桶访问权限,在公共权限栏中,选择公有读私有写并保存。
5. 在左侧导航栏中,选择基础配置 >** 静态网站,在静态网站栏中,单击编辑,将当前状态**的开启按钮打开。
6. 依次填写静态网站的配置项。


配置说明如下:
访问节点:开启静态网站,您会得到一个与该存储桶相关联的静态网站访问节点(即静态网站域名)。该访问节点只支持 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. 登录 对象存储控制台,进入存储桶详情页面,选择域名与传输管理 > 自定义源站域名。
2. 自定义源站域名区域,单击添加域名,输入自定义域名(如无,则注册域名后再输入),源站类型选择为静态网站源站。关于配置项的更多介绍,请参见 开启自定义源站域名



3. 为使自定义域名生效,还需要设置自定义域名解析到静态网站 CNAME 域名。如需要 HTTPS 访问,需要绑定 HTTPS 证书。详情可参见 配置域名解析绑定证书






帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈