更新时间:2024-03-04 GMT+08:00

配置静态网站托管

用户可将自己的桶配置成静态网站托管模式,并通过桶域名访问该静态网站。

静态网站托管配置会在两分钟内生效。

前提条件

静态网站所需的网页文件已上传到指定桶中。

桶内的静态网站文件必须配置为匿名用户可访问。

如果静态网站文件为“冷存储”类别,则需要先恢复,具体操作步骤请参见恢复冷存储文件

操作步骤

  1. OBS管理控制台桶列表中,单击待操作的桶,进入“概览”页面。
  2. 可选:如果还未将桶内静态网站文件配置为匿名用户可访问,请执行本步骤配置匿名访问权限。如果已经配置,请跳过此步骤。

    参考为匿名用户设置对象的访问权限为匿名用户授予静态网站文件的读取权限。

    如果桶中只有静态网站文件,可直接配置桶为“公共读”权限,使桶内所有文件能被公开访问。

    1. 单击“访问权限控制>桶策略”。
    2. 在“标准桶策略”下配置桶的“公共读”权限。
    3. 单击“公共读”卡片。并在弹出的确认信息对话框中单击“是”。

  3. 在“基础配置”区域下,单击“静态网站托管”卡片,系统跳转至“静态网站托管”界面。

    或您可以直接在左侧导航栏单击“基础配置>静态网站托管”,进入“静态网站托管”界面。

  4. 单击“配置静态网站托管”,系统弹出“配置静态网站托管”对话框。
  5. 打开“状态”开关。
  6. “托管模式”选择“配置到当前桶”。

  7. 在“默认首页”、“默认404错误页面”中设置默认首页页面和404(Not Found)页面。

    • 默认首页:即访问静态网站时的默认首页。当使用OBS管理控制台配置静态网站托管时,仅支持“html”格式的网页文件;当使用API的方式配置时,OBS不进行限制,用户必须指定对象的“Content-Type”。

      OBS仅支持配置桶根目录下的文件(如“index.html”)作为默认首页,暂不支持按目录层级的方式(如“/page/index.html”)配置默认首页。

    • 默认404错误页面:即访问静态网站遇到错误时,OBS返回给用户的错误页面。当使用OBS管理控制台配置静态网站托管时,仅支持桶根目录下html、jpg、png、bmp、webp格式的文件;当使用的方式配置时,OBS不进行限制,用户必须指定对象的“Content-Type”。

  8. 可选:在“重定向规则”中配置重定向规则。满足重定向规则的请求将被重定向到指定主机或页面。

    “重定向规则”采用JSON或XML格式编写,可以包含多条重定向规则,每条重定向规则包含一个Condition和一个Redirect,参数说明如表1所示。

    表1 参数说明

    容器

    键值

    键值说明

    Condition

    KeyPrefixEquals

    重定向生效时的对象名前缀。当向对象发送请求时,如果对象名前缀等于这个值,那么重定向生效。

    例如:重定向ExamplePage.html对象的请求,KeyPrefixEquals设为ExamplePage.html。

    HttpErrorCodeReturnedEquals

    重定向生效时的HTTP错误码。当发生错误时,如果错误码等于这个值,那么重定向生效。

    例如:当返回的HTTP错误码为404时重定向到NotFound.html,可以将Condition中的HttpErrorCodeReturnedEquals设置为404,Redirect中的ReplaceKeyWith设置为NotFound.html。

    Redirect

    Protocol

    重定向请求生效时使用的协议。取值为httphttps,如不设置,默认为http

    HostName

    重定向请求生效时使用的主机名。如不设置,代表重定向至原请求的HostName。

    ReplaceKeyPrefixWith

    描述重定向请求时使用的对象名前缀,请求中的对象名会将KeyPrefixEquals的内容替换为ReplaceKeyPrefixWith的内容。

    例如:想把所有对docs(目录下的对象)的请求重定向到documents(目录下的对象),可以将Condition中的KeyPrefixEquals设置为docs,Redirect中的ReplaceKeyPrefixWith设置为documents。那么对于对象名称为"docs/a.html",重定向的结果为"documents/a.html"。

    ReplaceKeyWith

    描述重定向请求时使用的对象名,请求中的整个对象名会被替换为ReplaceKeyWith的内容。

    例如:想把所有对"docs"目录下的所有对象的请求重定向到"documents/error.html",可以将Condition中的KeyPrefixEquals设置为docs,Redirect中的ReplaceKeyWith设置为"documents/error.html"。那么对于对象名称为"docs/a.html"和"docs/b.html",重定向的结果都为"documents/error.html"。

    HttpRedirectCode

    响应中的HTTP状态码。默认值为301,表示永久重定向到Redirect指定的位置,也可根据业务实际情况设置。

    重定向规则示例

    • 示例一:对所有前缀为“folder1/”对象的请求,自动重定向至主机“www.example.com”上前缀为“target.html”的页面,并使用https协议。
      [
      	{
      	"Condition": {
      		"KeyPrefixEquals": "folder1/"
      		},
      	"Redirect":{
      		"Protocol": "https",
      		"HostName": "www.example.com",
      		"ReplaceKeyPrefixWith": "target.html"
      		}
      	}
      ]
    • 示例二:对所有前缀为“folder2/”对象的请求,自动重定向至本OBS桶中前缀为“folder/”的对象上。
      [
      	{
      	"Condition": {
      		"KeyPrefixEquals": "folder2/"
      		},
      	"Redirect":{
      		"ReplaceKeyPrefixWith": "folder/"
      		}
      	}
      ]
    • 示例三:对所有前缀为“folder.html”对象的请求,自动重定向至本OBS桶的“folderdeleted.html”对象上。
      [
      	{
      	"Condition": {
      		"KeyPrefixEquals": "folder.html"
      		},
      	"Redirect":{
      		"ReplaceKeyWith": "folderdeleted.html"
      		}
      	}
      ]
    • 示例四:在未找到请求对象返回HTTP状态码404时,自动重定向至主机“www.example.com”上前缀为“report-404/” 的页面。
      例如,如果您请求页面ExamplePage.html,且它导致了HTTP 404错误,该请求将重定向至www.example.com上的report-404/ExamplePage.html页面。如果没有设置404的重定向规则,在发生HTTP 404错误时将返回上一步中配置的默认404错误页面。
      [
      	{
      	"Condition": {
      		"HttpErrorCodeReturnedEquals": "404"
      		},
      	"Redirect":{
      		"HostName": "www.example.com",
      		"ReplaceKeyPrefixWith": "report-404/"
      		}
      	}
      ]

  9. 单击“确定”。

    OBS上托管静态网站配置生效后,您可以通过静态网站托管访问域名访问该静态网站。

    由于浏览器缓存等原因,您可能需要清除浏览器缓存后才能查看到预期效果。