如何在浏览器预览和下载对象？--对象存储-火山引擎

文档中心

导航

对象存储

如何在浏览器预览和下载对象？

最近更新时间：2024.05.14 15:03:54首次发布时间：2024.03.05 10:07:42

本文介绍访问存储桶内文件时的文件分发策略，以及如何在浏览器预览对象、下载对象。

文件分发策略

使用存储桶的默认域名在浏览器访问文件时，浏览器会直接下载非常见文件类型，而对于常见的文件类型（根据 content-type 判断），浏览器根据是否返回头域 content-disposition: attachment 来决定下载文件还是浏览文件。常见的文件类型如下：

文本文件（.txt、.csv、.xml 等）
图片文件（.jpg、.png、.gif 等）
PDF 文件（.pdf）
Microsoft Office 文档（.doc、.docx、.xls、.xlsx、.ppt、.pptx 等）
HTML

访问对象时，TOS 是否返回头域 content-disposition: attachment 受存储桶创建时间和文件类型的影响，说明如下：

创建时间	返回头域说明
2024 年 01 月 03 日 23:59:59 之前创建的存储桶	出于安全合规考虑，从 2022 年 10 月 18 日开始，如果您使用存储桶的默认域名访问网页类型文件（mimetype 为 text/html，扩展名包括 HTM、HTML、JSP、PLG、HTX、STM），Response Header 中会自动加上 `Content-Disposition:attachment`，即从浏览器访问网页类型文件时，将不会直接预览网站，而会将网站的内容下载到本地；其他类型的对象可直接预览。
2024 年 01 月 03 日 23:59:59 之后创建的存储桶	使用默认域名以预签名或匿名方式访问文件，TOS 会在 Response Header 中自动添加 `Content-Disposition:attachment` 参数，即任意类型的文件均会直接下载到本地，而非在线预览。详细域名变更说明，请参见对象存储桶域名使用限制变更公告和站内信等。

创建时间

返回头域说明

2024 年 01 月 03 日 23:59:59 之前创建的存储桶

出于安全合规考虑，从 2022 年 10 月 18 日开始，如果您使用存储桶的默认域名访问网页类型文件（mimetype 为 text/html，扩展名包括 HTM、HTML、JSP、PLG、HTX、STM），Response Header 中会自动加上 Content-Disposition:attachment，即从浏览器访问网页类型文件时，将不会直接预览网站，而会将网站的内容下载到本地；其他类型的对象可直接预览。

2024 年 01 月 03 日 23:59:59 之后创建的存储桶

使用默认域名以预签名或匿名方式访问文件，TOS 会在 Response Header 中自动添加 Content-Disposition:attachment 参数，即任意类型的文件均会直接下载到本地，而非在线预览。详细域名变更说明，请参见对象存储桶域名使用限制变更公告和站内信等。

因此，通过存储桶的默认域名访问对象时，只有在 2024 年 01 月 03 日 23:59:59 之前创建的存储桶，且访问的非网页类型文件，才可以在浏览器预览对象。如果您访问的存储桶和文件类型不满足该条件，将直接下载对象。

在浏览器预览对象

您可以通过以下方法在浏览器预览常见类型的文件。说明如下：

使用自定义域名访问对象，详细介绍，请参见设置自定义域名。
使用火山引擎 CDN 或 DCDN 域名访问对象，详细介绍，请参见新增域名。
说明
访问对象时，如果您使用的不是火山引擎的 CDN 或 DCDN 域名，您可以删除响应头 Content-Disposition:attachment 实现对象预览。

在浏览器下载对象

您还可以通过以下方法，将预览对象修改为下载对象：

上传对象时，在 Header 设置 content-disposition: attachment 参数。详细介绍，请参见PutObject。
下载对象时，在 Query 设置 response-content-disposition=attachment 参数。详细介绍，请参见GetObject。