赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 对象存储
  4. 操作指南
  5. 对象文件(Object)
  6. 文件常见问题
  7. 分享文件常见问题
  8. 如何配置访问OSS文件时是预览行为?

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

  • 分享文件常见问题
  • 发布于 2025-04-21
  • 0 次阅读
文档编辑
文档编辑

浏览器访问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-Type的值与实际的文件类型不一致。浏览器无法正确渲染,只能将其作为下载文件处理。

设置合理的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(成都)

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

相关文章

为什么文件读写权限修改为私有后,通过文件URL下载文件报错? 2025-04-21 18:16

本文介绍文件读写权限修改为私有后,通过文件URL下载文件报错的原因。 当文件读写权限为公共读或者公共读写时,您可以通过文件URL直接下载文件。当文件读写权限修改为私有后,您需要在文件URL中包含签名,然后将签名URL分享给第三方用于下载文件。具体操作,请参见使用文件URL。

如何配置访问OSS文件时是预览行为? 2025-04-21 18:16

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

如何配置通过自定义域名访问OSS文件实现强制下载? 2025-04-21 18:16

通过浏览器使用自定义域名访问OSS上存储的文件时,如果您的浏览器支持预览所选的文件格式,则OSS将直接预览文件内容。如果您希望通过浏览器使用自定义域名访问OSS文件时,以附件形式下载文件,您可以通过预签名URL将response-content-disposition字段设置为attachment来

通过名称中包含中文的文件URL预览或下载文件时出现乱码,怎么办? 2025-04-21 18:16

本文介绍通过名称中包含中文的文件URL预览或下载文件时出现乱码的解决方法。 例如,通过文件URL将测试.txt下载到本地时出现乱码,您需要将名称中包含的中文字符进行URL编码。例如,将

通过文件URL无法正常访问文件怎么办? 2025-04-21 18:16

本文介绍通过文件URL无法正常访问文件(Object)的可能原因及解决方法。 出现以上问题,请按以下步骤排期可能的原因,并通过对应的解决方法进行处理: 签名错误

误删除AccessKey ID后无法通过文件URL访问文件或图片? 2025-04-21 18:16

本文介绍误删除AccessKey ID后无法通过文件URL访问文件或图片的解决方法。 解决方法: 在同一账号下新建AccessKey(包括AccessKey ID和AccessKey Secr

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号