如何配置访问OSS文件时是预览行为

浏览器访问OSS文件强制下载时,请检查OSS、CDN和浏览器设置。

排查项目

异常原因

解决方法

OSS

使用OSS默认域名或传输加速域名访问某个时间点创建的Bucket内的特定类型文件时(例如Content-Typetext/html、image/jpeg等),OSS会强制在返回头中增加下载Header(x-oss-force-download: trueContent-Disposition: attachment)。导致浏览器强制下载而不是预览行为。更多信息,请参见附录:强制下载命中的x-oss-ec规则

使用自定义域名访问,并完成域名绑定操作。具体操作,请参见默认域名

Content-Ty pe的值与实际的文件类型不一致。浏览器无法正确渲染,只能将其作为下载文件处理。

设置合理的Content-Type。具体操作,请参见如何设置Content-Type(MIME)?

Content-Disposition被设置为attachment。浏览器会触发下载行为。

Content-Disposition设置为inline。具体步骤,请参见管理文件元数据

CDN

缓存资源未刷新。

刷新CDN缓存资源。具体步骤,请参见刷新和预热资源

浏览器

浏览器不支持预览该格式的文件。

为浏览器安装插件或者使用智能媒体管理IMM的文档在线预览。具体步骤,请参见文档在线预览

附录:强制下载命中的x-oss-ec规则

使用OSS默认域名或传输加速域名访问不同类型文件,导致强制下载命中的x-oss-ec规则。

OSS默认域名

以下是各地域OSS默认域名的生效时间和相关信息:

生效地域

生效时间

生效对象

Content-Type

x-oss-ec

华东1(杭州)、华东2(上海)、华北1(青岛)、华北2(北京)、华北 3(张家口)、华北5(呼和浩特)、华南1(深圳)、西南1(成都)

2018092808:00

指定地域创建的Bucket

text/html

0048-00000001

华东5(南京-本地地域)、华东6(福州-本地地域)、华中1(武汉-本地地域)、华北6(乌兰察布)、华南2(河源)、华南3(广州)、美国(硅谷)、美国(弗吉尼亚)、 韩国(首尔)、新加坡、马来西亚(吉隆坡)、 印度尼西亚(雅加达)、菲律宾(马尼拉)、泰国(曼谷)、英国(伦敦)、阿联酋(迪拜)

2019092512:00

中国香港

2019112514:00

华北5(呼和浩特)

2019092317: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(成都)

2019092411:00

0048-00000101

华北 3(张家口)

2019092417:00

0048-00000102

华东2(上海)、华南1(深圳)

2019092917:00

0048-00000103

华北2(北京)

2019092918:00

0048-00000104

华东1(杭州)、华北6(乌兰察布)

2019093015:00

0048-00000105

全部

2022100900:00

开通OSS的用户

全部

0048-00000113

传输加速域名

以下是各地域传输加速域名的生效时间和相关信息:

生效地域

生效时间

生效对象

Content-Type

x-oss-ec

全部

2020123100:00

指定地域开启了传输加速的Bucket

text/html

0048-00000002

阿联酋(迪拜)

2021010712:00

全部

0048-00000107

马来西亚(吉隆坡)、英国(伦敦)

2021010718:00

0048-00000108

日本(东京)、印度尼西亚(雅加达)、德国(法兰克福)

2021010818:00

0048-00000109

美国(硅谷)、美国(弗吉尼亚)、新加坡

2021011412:00

0048-00000110

中国香港

2021011600:00

0048-00000111

韩国(首尔)、菲律宾(马尼拉)、泰国(曼谷)

2023020100:00

0048-00000112