全部產品
Search
文件中心

Object Storage Service:如何配置訪問OSS檔案時是預覽行為?

更新時間:Nov 13, 2024

在瀏覽器中訪問OSS中的檔案無法預覽而是以附件形式強制下載時,請排查您的OSS、CDN、瀏覽器設定。

排查專案

異常原因

解決方案

OSS

使用OSS預設網域名稱或傳輸加速網域名稱訪問。出於資料轉送安全考慮,當使用OSS預設網域名稱或傳輸加速網域名稱訪問某個時間點建立的Bucket內的特定類型檔案時(例如Content-Type為text/html、image/jpeg等),OSS會強制在返回頭中增加下載Header(x-oss-force-download: trueContent-Disposition: attachment)。標準瀏覽器檢測到Content-Disposition: attachment時,會出現強制下載而不是預覽行為。關於訪問指定時間建立的Bucket內特定類型檔案,導致強制下載行為時命中的x-oss-ec規則說明,請參見附錄:強制下載命中的x-oss-ec規則

您需要使用自訂網域名訪問。使用自訂網域名訪問前,您需要完成網域名稱綁定操作。具體步驟,請參見綁定自訂網域名至Bucket預設網域名稱

Content-Type的值與實際的檔案類型不一致。瀏覽器無法正確解析和渲染該檔案,而只能將其作為下載檔案處理。

根據檔案類型,設定合理的Content-Type。具體操作,請參見如何設定Content-Type(MIME)?

Content-Disposition被設定為attachment。瀏覽器檢測到Content-Disposition: attachment時,會觸發下載行為。

將Content-Disposition設定為inline。具體步驟,請參見管理檔案中繼資料

CDN

緩衝資源未重新整理。

重新整理CDN緩衝資源。具體步驟,請參見重新整理和預熱資源

瀏覽器

不支援預覽該格式的檔案,例如表格檔案、文字檔案、示範檔案以及pdf檔案。

您可以為瀏覽器安裝外掛程式以支援預覽該格式的檔案。

附錄:強制下載命中的x-oss-ec規則

以下為使用OSS預設網域名稱或傳輸加速網域名稱訪問不同類型檔案,導致強制下載時命中的x-oss-ec規則說明。

OSS預設網域名稱

生效地區

生效時間

生效對象

Content-Type

x-oss-ec

華東1(杭州)、華東2(上海)、華北1(青島)、華北2(北京)、華北 3(張家口)、華北5(呼和浩特)、華南1(深圳)、西南1(成都)

2018年09月28日08:00或該日期之後

指定地區建立的Bucket

text/html

0048-00000001

華東5(南京-本地地區)、華東6(福州-本地地區)、華中1(武漢-本地地區)、華北6(烏蘭察布)、華南2(河源)、華南3(廣州)、美國(矽谷)、美國(維吉尼亞)、 韓國(首爾)、新加坡、馬來西亞(吉隆坡)、 印尼(雅加達)、菲律賓(馬尼拉)、泰國(曼穀)、英國(倫敦)、阿聯酋(杜拜)

2019年09月25日12:00:00或該日期之後

中國香港

2019年11月25日14:00:00或該日期之後

華北5(呼和浩特)

2019年09月23日17:00或該日期之後

  • image/jpeg

  • image/gif

  • image/tiff

  • image/png

  • image/webp

  • image/svg+xml

  • image/bmp

  • image/x-ms-bmp

  • image/x-cmu-raster

  • image/exr

  • image/x-icon

  • image/heic

  • text/html

0048-00000100

華北1(青島)、西南1(成都)

2019年09月24日11:00或該日期之後

0048-00000101

華北 3(張家口)

2019年09月24日17:00或該日期之後

0048-00000102

華東2(上海)、華南1(深圳)

2019年09月29日17:00或該日期之後

0048-00000103

華北2(北京)

2019年09月29日18:00或該日期之後

0048-00000104

華東1(杭州)、華北6(烏蘭察布)

2019年09月30日15:00或該日期之後

0048-00000105

全部

2022年10月09日00:00或該日期之後

開通OSS的使用者

全部

0048-00000113

傳輸加速網域名稱

生效地區

生效時間

生效對象

Content-Type

x-oss-ec

全部

2020年12月31日00:00或該日期之後

指定地區開啟了傳輸加速的Bucket

text/html

0048-00000002

阿聯酋(杜拜)

2021年01月07日12:00或該日期之後

全部

0048-00000107

馬來西亞(吉隆坡)、英國(倫敦)

2021年01月07日18:00或該日期之後

0048-00000108

日本(東京)、印尼(雅加達)、德國(法蘭克福)

2021年01月08日18:00或該日期之後

0048-00000109

美國(矽谷)、美國(維吉尼亞)、新加坡

2021年01月14日12:00或該日期之後

0048-00000110

中國香港

2021年01月16日00:00或該日期之後

0048-00000111

韓國(首爾)、菲律賓(馬尼拉)、泰國(曼穀)

2023年02月01日00:00或該日期之後

0048-00000112