配置静态网站托管

注意事项

基于安全合规要求，华为云对象存储服务OBS禁止通过OBS的默认域名（桶访问域名或静态网站访问域名）使用静态网站托管功能，即使用上述域名从浏览器访问网页类型文件时，不会显示对象内容，而是以附件形式下载。

各区域将自以下两个时间点起生效：

自2022年1月1日起生效：华北-北京一、华北-北京四、华北-乌兰察布一、华东-上海一、华东-上海二、华南-广州、西南-贵阳一

自2022年3月25日起生效：中国-香港、亚太-曼谷、亚太-新加坡、非洲-约翰内斯堡、拉美-墨西哥城一、拉美-墨西哥城二、拉美-圣保罗一、拉美-圣地亚哥

通过自定义域名使用静态网站托管功能不受影响，仍然支持文件内容的直接预览，详情请参见如何在浏览器中在线预览OBS中的对象？

前提条件

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

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

如果静态网站文件为“归档存储”或“深度归档存储”类别，则需要先恢复，具体操作步骤请参见恢复归档存储对象或深度归档存储。

操作步骤

1. 在OBS管理控制台左侧导航栏选择“桶列表”。
2. 在OBS管理控制台桶列表中，单击待操作的桶，进入“对象”页面。
3. 可选：如果还未将桶内静态网站文件配置为任何用户可访问，请执行本步骤配置所有账户的访问权限。如果已经配置，请跳过此步骤。

   参考对所有账号授予指定对象的读权限为所有账号授予静态网站文件的读取权限。

   如果桶中只有静态网站文件，则配置桶策略为“对象只读”，使桶内所有文件能被公开访问。

   1. 单击“访问权限控制>桶策略”。
   2. 单击“创建”。
   3. 配置桶策略信息。
      图1 配置对象只读权限
      

      表1 配置公共读策略参数配置说明

      参数		说明
      策略配置方式		支持可视化视图和JSON视图。此处以可视化视图为例，JSON视图的说明请参见自定义创建桶策略（JSON视图）。
      策略名称		输入自定义桶策略的名称。
      策略内容	效力	允许
      	被授权用户	被授权用户：所有账号
      	授权资源	资源范围：指定对象 资源路径：*（*表示桶内所有对象）
      	授权操作	动作范围：模板配置 模板：对象只读

   4. 单击“创建”，完成桶策略创建。
   5. 权限配置信息可以在桶策略列表查看。
      图2 查看桶策略列表权限配置信息
      

4. 在左侧导航栏，单击“概览”，进入“概览”页面。
5. 在“基础配置”区域下，单击“静态网站托管”卡片，系统跳转至“静态网站托管”界面。

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

6. 单击“配置静态网站托管”，系统弹出“配置静态网站托管”对话框。
7. 打开“状态”开关。
8. “托管模式”选择“配置到当前桶”，如图3所示。
   图3 配置静态网站托管
   

9. 在“默认首页”、“默认404错误页面”中设置默认首页页面和404（Not Found）页面。
   • 默认首页：即访问静态网站时的默认首页。当使用OBS管理控制台配置静态网站托管时，仅支持“html”格式的网页文件；当使用API的方式配置时，OBS不进行限制，用户必须指定对象的“Content-Type”。

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

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

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

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

    表2 参数说明

    容器	键值	键值说明
    Condition	KeyPrefixEquals	重定向生效时的对象名前缀。当向对象发送请求时，如果对象名前缀等于这个值，那么重定向生效。 例如：重定向ExamplePage.html对象的请求，KeyPrefixEquals设为ExamplePage.html。
    	HttpErrorCodeReturnedEquals	重定向生效时的HTTP错误码。当发生错误时，如果错误码等于这个值，那么重定向生效。 例如：当返回的HTTP错误码为404时重定向到NotFound.html，可以将Condition中的HttpErrorCodeReturnedEquals设置为404，Redirect中的ReplaceKeyWith设置为NotFound.html。
    Redirect	Protocol	重定向请求生效时使用的协议。取值为http或https，如不设置，默认为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/"
      		}
      	}
      ]

11. 单击“确定”。

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

    

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