全部产品

对象存储 OSS：如何配置访问OSS文件时是预览行为

更新时间：Dec 20, 2024

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

排查项目	异常原因	解决方法
OSS	使用OSS默认域名或传输加速域名访问某个时间点创建的Bucket内的特定类型文件时（例如Content-Type为text/html、image/jpeg等），OSS会强制在返回头中增加下载Header（`x-oss-force-download: true`和`Content-Disposition: attachment`）。导致浏览器强制下载而不是预览行为。更多信息，请参见附录：强制下载命中的x-oss-ec规则。	使用自定义域名访问，并完成域名绑定操作。具体操作，请参见默认域名。
	`Content-Ty pe`的值与实际的文件类型不一致。浏览器无法正确渲染，只能将其作为下载文件处理。	设置合理的Content-Type。具体操作，请参见如何设置Content-Type（MIME）？。
	`Content-Disposition`被设置为`attachment`。浏览器会触发下载行为。	将Content-Disposition设置为`inline`。具体步骤，请参见管理文件元数据。
CDN	缓存资源未刷新。	刷新CDN缓存资源。具体步骤，请参见刷新和预热资源。
浏览器	浏览器不支持预览该格式的文件。	为浏览器安装插件

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

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

OSS默认域名

以下是各地域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起
中国香港	2019年11月25日14: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