用戶可將自己的桶配置成靜態網站托管模式,并通過桶域名訪問該靜態網站。
靜態網站托管配置會在兩分鐘內生效。
前提條件
靜態網站所需的網頁文件已上傳到指定桶中。
桶內的靜態網站文件必須配置為匿名用戶可訪問。
如果靜態網站文件為“歸檔存儲”類別,則需要先恢復。
操作步驟
步驟 1 在桶列表單擊待操作的桶,進入“對象”頁面。
步驟 2 可選 :如果還未將桶內靜態網站文件配置為匿名用戶可訪問,請執行本步驟配置匿名訪問權限。如果已經配置,請跳過此步驟。
若桶中只有靜態網站文件,則配置桶策略為“公共讀”,使桶內所有文件能被公開訪問。
- 單擊“訪問權限控制>桶策略”。
- 單擊“創建”。
- 單擊“公共讀”模板右側的“使用模板創建”。

- 無需修改桶策略模板內容,直接單擊“配置確認”后再單擊“創建”,完成桶策略創建。
步驟 3 在左側導航欄,單擊“概覽”,進入“概覽”頁面。
步驟 4 在“基礎配置”區域下,單擊“靜態網站托管”卡片,系統跳轉至“靜態網站托管”界面。
或您可以直接在左側導航欄單擊“基礎配置>靜態網站托管”,進入“靜態網站托管”界面。
步驟 5 單擊“配置靜態網站托管”,系統彈出“配置靜態網站托管”對話框。
步驟 6 “狀態”設置為使能狀態。
步驟 7 “托管模式”選擇“配置到當前桶”,如下圖所示。

步驟 8在“默認首頁”、“默認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”。
步驟 9 可選 :在“重定向規則”中配置重定向規則。滿足重定向規則的請求將被重定向到指定主機或頁面。
“重定向規則”采用JSON或XML格式編寫,可以包含多條重定向規則,每條重定向規則包含一個Condition和一個Redirect,參數說明如下所示。
容器 鍵值 鍵值說明 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 重定向請求生效時使用的對象名前綴。 ReplaceKeyWith 重定向請求生效時使用的對象名。 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/"
}
}
]
步驟 10 單擊“確定”。
在OBS上托管靜態網站配置生效后,您可以通過靜態網站托管訪問域名訪問該靜態網站。
說明由于瀏覽器緩存等原因,您可能需要清除瀏覽器緩存后才能查看到預期效果。