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

场景说明

例如,您需要为目标存储空间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. 在左侧导航栏,选择数据管理 > 静态页面
  4. 静态页面区域,单击设置,按如下说明配置各项参数。
    静态页面
    参数 说明
    默认首页 默认首页是您通过浏览器访问静态网站域名时,OSS返回的网站首页。此处设置为index.html
    子目录首页 选择不开通,此时访问静态网站根域名或者根域名下任何一个以正斜线(/)结尾的URL都会返回根目录默认首页。
    默认404页 访问Bucket内文件出现404错误时,OSS返回的错误页面。默认404页仅支持根目录下的文件。此处设置为error.html
    错误文档响应码 您可以配置返回错误文档时的HTTP响应码为404200
  5. 单击保存

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

  1. 在左侧导航栏,选择数据管理 > 静态页面
  2. 静态页面区域,单击设置,按如下说明配置各项参数。
    静态页面2
    参数 说明
    默认首页 默认首页是您通过浏览器访问静态网站域名时,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响应码为404200
  3. 单击保存

创建并上传默认首页

当您为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. 在左侧导航栏,选择数据管理 > 静态页面
  2. 静态页面区域,单击设置
  3. 清空默认首页和默认404页配置,然后单击保存
    返回如下页面,表示已成功关闭静态网站托管功能。关闭静态页面