静态网站是指所有的网页都由静态内容构成，包括客户端执行的脚本（例如JavaScript）。您可以通过静态网站托管功能将您的静态网站托管到OSS的存储空间（Bucket），并使用Bucket的访问域名访问这个网站。

注意事项

出于安全考虑，中国区域自2018年8月13日起，中国以外区域自2019年9月25日起，通过浏览器访问OSS上网页类型文件（mimetype为text/html，扩展名包括HTM、HTML、JSP、PLG、HTX、STM）：
  • 使用OSS默认域名访问时，Response Header中会自动加上 Content-Disposition:'attachment=filename;'。即从浏览器访问网页类型文件时，不会显示文件内容，而是以附件形式进行下载。
  • 使用绑定的自定义域名访问OSS时，Response Header中不会加上 Content-Disposition:'attachment=filename;'，只要您的浏览器支持该类型文件的预览，可以直接预览文件内容。绑定自定义域名详细步骤请参见绑定自定义域名。

更多信息请参见静态网站托管介绍。

场景说明

例如，您需要为目标存储空间examplebucket开启静态网站托管，examplebucket内的文件结构如下所示：

examplebucket
 ├── index.html
 ├── error.html
 ├── example.txt
 └── subdir/
      └── index.html

您希望访问子目录subdir/时，不支持跳转至子目录下的index.html页面，而是跳转至根目录下的index.html页面。此外，当访问Bucket内不存在的文件时，返回默认错误页面。具体步骤，请参见配置静态网站托管时未开通子目录首页。

您希望访问子目录subdir/时，支持直接跳转至子目录下的index.html页面。此外，当访问Bucket内不存在的文件时，返回默认错误页面，并通过文件404规则指定访问不存在文件时的返回结果。具体步骤，请参见配置静态网站托管时开通子目录首页。

配置静态网站托管时未开通子目录首页

  1. 登录OSS管理控制台。
  2. 单击Bucket列表，之后单击目标Bucket名称。
  3. 选择基础设置 > 静态页面，在静态页面区域单击设置，按如下说明配置各项参数：
    index1
    参数 说明
    默认首页 默认首页是您通过浏览器访问静态网站域名时，OSS返回的网站首页。此处设置为index.html。
    子目录首页 选择不开通，此时访问静态网站根域名或者根域名下任何一个以正斜线（/）结尾的URL都会返回根目录默认首页。
    默认404页 访问Bucket内文件出现404错误时，OSS返回的错误页面。默认404页仅支持根目录下的文件。此处设置为error.html。
    错误文档响应码 您可以配置返回错误文档时的HTTP响应码为404或200。
  4. 单击保存。

配置静态网站托管时开通子目录首页

  1. 登录OSS管理控制台。
  2. 单击Bucket列表，之后单击目标Bucket名称。
  3. 选择基础设置 > 静态页面，在静态页面区域单击设置，按如下说明配置各项参数：
    error
    参数 说明
    默认首页 默认首页是您通过浏览器访问静态网站域名时，OSS返回的网站首页。此处设置为index.html。
    子目录首页 选择开通。开通子目录首页后，访问静态网站根域名时，返回根目录默认首页。访问根域名下以正斜线（/）结尾的URL时会返回对应目录的默认首页。例如，访问示例中的https://examplebucket.oss-cn-hangzhou.aliyuncs.com/subdir/时，则返回subdir/目录下的默认首页文件index.html。
    文件404规则 开通子目录首页后，通过文件404规则决定访问不存在的Object时的返回结果。例如，访问https://examplebucket.oss-cn-hangzhou.aliyuncs.com/exampledir，因示例中不存在exampledir文件，则根据设置的文件404规则返回对应信息：
    • Redirect（默认值）：检查exampledir/index.html是否存在。
      • 如果文件存在则返回302，并将访问请求重定向为https://examplebucket.oss-cn-hangzhou.aliyuncs.com/exampledir/index.html。
      • 如果文件不存在则返回404，并继续检查https://examplebucket.oss-cn-hangzhou.aliyuncs.com/error.html。如果error.html页面也不存在该文件，则返回404状态码。
    • NoSuckKey：直接返回404，并继续检查https://examplebucket.oss-cn-hangzhou.aliyuncs.com/error.html。
    • Index：检查exampledir/index.html是否存在。
      • 如果文件存在则返回200，并直接返回文件内容。
      • 如果文件不存在，则继续检查https://examplebucket.oss-cn-hangzhou.aliyuncs.com/error.html。
    默认404页 访问Bucket内文件出现404错误时，OSS返回的错误页面。默认404页仅支持根目录下的文件。此处设置为error.html。
    错误文档响应码 您可以配置返回错误文档时的HTTP响应码为404或200。
  4. 单击保存。

创建并上传默认首页

当您为examplebucket配置静态网站托管时指定的默认首页为index.html，您需要将与默认首页名称相同的文件上传至examplebucket根目录下。由于examplebucket中包含了子目录subdir/，则子目录subdir/下也必须包含index.html文件。

  1. 创建index.html文件。index.html文件配置示例如下： 
    <html>
<head>
    <title>My Website Home Page</title>
    <meta charset="utf-8">
</head>
<body>  
  <p>Now hosted on OSS.</p>
</body>
</html>
  2. 将index.html文件保存至本地。
  3. 分别将index.html文件上传至examplebucket根目录以及子目录subdir下。上传文件时，您需要将文件读写权限设置为公共读。
    有关上传文件的具体操作，请参见 上传文件。

创建并上传默认404页

当您为examplebucket配置静态网站托管时指定的默认404页为error.html，您需要将与默认404页名称相同的文件上传至examplebucket根目录下。

  1. 创建error.html文件。error.html文件配置示例如下： 
    <html>
<head>
    <title>Hello OSS!</title>
    <meta charset="utf-8">
</head>
<body>  
  <p>This is error 404 page.</p>
</body>
</html>
  2. 将error.html文件保存至本地。
  3. 将error.html文件上传至examplebucket根目录下。上传文件时，您需要将文件读写权限设置为公共读。
    有关上传文件的具体操作，请参见 上传文件。

关闭静态网站托管

当您不再需要使用默认首页、默认404页等静态网站托管配置时，请按如下步骤关闭静态网站托管功能：

  1. 登录OSS管理控制台。
  2. 单击Bucket列表，之后单击目标Bucket名称。
  3. 选择基础设置 > 静态页面，在静态页面区域单击设置。
  4. 清空默认首页和默认404页配置，然后单击保存。
    返回如下页面，表示已成功关闭静态网站托管功能。 close