文档中心

对象存储

请输入

快速入门

控制台快速入门

本文主要介绍如何快速上手火山引擎对象存储服务，包括在对象存储控制台创建存储桶、上传文件、下载文件和获取文件 URL 等操作。

前提条件

在使用 TOS 之前，请确保您已注册火山引擎账号并完成实名认证，具体步骤，请参见账号注册和实名认证。

步骤一：开通 TOS 服务

当您首次使用 TOS 时，您需要开通该服务才能正常使用 TOS 的相应功能。

登录对象存储控制台，在弹出的对话框中，勾选我已阅读并同意《存储产品和服务条款》，然后单击立即开通，即可开通 TOS 服务。

说明

如果您的账号已开通 TOS 服务，请忽略该步骤。

步骤二：创建存储桶

存储桶（Bucket）是用于存储文件（Object）的空间。在上传任意文件前，您需要先创建存储桶。

登录对象存储控制台。

在左侧导航栏单击桶列表，在页面左上方单击创建桶。

设置存储桶参数，单击确定。

参数			说明
基础设置	名称	存储桶的名称，创建后不可更改。命名规范如下：在 TOS 范围内全局唯一，即所有地域所有账号下的桶名均不能重复。只能包含数字、中划线（-）、字母 a-z。开始和结尾只能是数字或字母。长度在 3～63 字符。
		区域	存储桶所归属的地域，创建后不可更改。
		版本控制	是否开通版本控制功能。开通后针对对象覆盖及删除操作，TOS 将保存对象的历史版本。
		桶策略	设置存储桶的桶策略（Bucket Policy），说明如下：私有：默认值，只有该桶的归属者及有授权的账号对桶中的对象有读写权限，推荐使用。公共读：任何人均可对公共读权限的存储桶进行读取操作，同时产生流量费用，存在财产损失和数据泄露风险，建议选择私有。公共读写：任何人均可对公共读写权限的存储桶进行读写操作，同时产生流量费用，存在财产损失和数据泄露风险，建议选择私有。如需更精细的资源授权，创建存储桶后可通过桶 ACL、桶策略（Policy）和访问控制 IAM 策略进行配置。
		对象 ACL 默认策略	是否开启对象 ACL 默认策略功能，开启后，新上传的对象的 ACL 默认将和桶 ACL 保持一致。如果不开启对象 ACL 默认策略功能，则对象 ACL 默认为私有。说明关于对象 ACL 和桶 ACL 的对应关系，请参见对象继承桶 ACL。
		项目	在下拉列表中选择存储桶所属的项目，选填。说明项目是一个虚拟的概念，包括一组资源、用户和角色。通过项目可以对一组资源进行统一的查看和管理，并且控制项目内用户和角色对这些资源的权限。更多详情，请参见资源管理。您可以单击右侧的创建新项目，前往 IAM 控制台创建新的项目。
高级设置	多 AZ 冗余	设置是否开启多AZ冗余。开启多 AZ 冗余功能后，TOS 会将您的数据存储在同一地域的多个可用区，当某个可用区发生故障时，其他可用区仍然能为您提供稳定的存储服务。详细介绍，请参见多 AZ 冗余。说明仅华北2（北京）、华东2（上海）、华南1（广州）和亚太东南（柔佛）地域支持多 AZ 冗余功能。 HNS 桶的多 AZ 冗余功能支持状态，请以控制台显示为准。多 AZ 冗余的存储容量收费标准高于单 AZ 存储，且开启后不能关闭，请您谨慎开启。关于多 AZ 冗余的存储容量费用说明，请参见存储容量计费。
		默认存储类型	设置桶的存储类型，TOS 默认存储类型如下所示：标准存储：默认值，高可用、高可靠、高性能存储类型，适用于频繁被访问的数据。低频存储：适用于不频繁被访问的数据，最少存储 30 天。智能分层：适用于访问频率不确定的数据，可根据访问频率转换访问层。归档闪回：适用于基本不会被访问的数据，最少存储 90 天。归档：适用于数据长期存储、基本不访问且访问可接受有一定响应时间的数据，最少存储90天。冷归档：适用于数据长期存储、基本不访问且访问可接受有一定响应时间的数据，最少存储 180 天。深度冷归档：适用于需要超长时间存放的极冷数据，最少存储 180 天。说明当前仅华北2（北京）、华东2（上海）和华南1（广州）支持冷归档存储。当前仅华北2（北京）、华东2（上海）和华南1（广州）支持深度冷归档，且都处于邀测状态，如您需要使用该功能，请联系客户经理。关于存储类型的详细说明，请参见存储类型。开启多 AZ 冗余后，默认存储类型仅支持标准存储（多 AZ）、低频存储（多 AZ）、归档闪回（多 AZ）。关于多 AZ 的详细介绍，请参见多 AZ 冗余。
		服务端加密	设置存储桶的服务端加密方式。在存储桶设置服务端加密后，在该存储桶上传文件时，如果您没有指定文件的服务端加密方式，则文件会默认继承存储桶的服务端加密方式。不同加密方式说明如下：无：不加密。 SSE-TOS：TOS 托管密钥方式，是指文件上传后 TOS 对文件自动加密落盘存储，下载时自动解密，密钥由 TOS 托管，更多信息，请参见服务端加密。 SSE-KMS：使用火山引擎 KMS 托管的密钥对文件进行加解密，更多信息，请参见服务端加密。说明仅华北2（北京）、华东2（上海）、华南1（广州）、中国香港、亚太东南（柔佛）和亚太东南（雅加达）地域支持 SSE-TOS 和 SSE-KMS。首次使用 SSE-KMS 进行服务端加密，您需要开通 KMS 服务。开通 KMS 服务免费，使用 KMS 服务会收费。使用 SSE-KMS 进行服务端加密会产生 API 调用费用，创建 KMS 密钥会产生密钥托管费用，API 调用费用和密钥托管费用由 KMS 收取，更多信息，请参见 KMS 计费说明。
		加密算法	选择密钥的加密算法，可选 AES256 和 SM4 算法。说明仅服务端加密选择 SSE-KMS 或 SSE-TOS 时，展示该参数。仅华北2（北京）、华东2（上海）、华南1（广州）、中国香港、亚太东南（柔佛）和亚太东南（雅加达）地域支持 AES-256 算法；仅华北2（北京）、华东2（上海）、华南1（广州）支持 SM4 算法。
		加密密钥类型	默认为自定义密钥。说明仅服务端加密选择 SSE-KMS 时，展示该参数。
		密钥项目	选择自定义密钥所属的项目。选择项目后，系统将展示该项目下可用的自定义密钥。如需使用新的项目，请单击新建项目创建。详细操作，请参见项目管理。说明仅服务端加密选择 SSE-KMS 时，展示该参数。
		自定义密钥	选择用于服务端加密的 KMS 自定义密钥。选择后，TOS 将使用该密钥对存储桶中的对象进行服务端加密。如需使用新的密钥，请先参照 KMS 快速入门创建密钥。说明仅服务端加密选择 SSE-KMS 时，展示该参数。
		日志分析	设置是否开启日志分析功能。 TOS 与日志服务深度结合，TOS 免费提供最近 7 天内的 TOS 实时日志查询。开通该功能后，您可对 Bucket 的访问记录进行实时查询分析。日志默认保存 7 天，如您需保存更长时间，可灵活修改（超出 7 天的部分，由日志服务单独收费）。日志服务的计费说明，请参见产品计费。注意首次使用日志分析功能，您需要授予 TOS 访问火山引擎 TLS 日志服务的权限。关于日志分析的详细说明，请参见日志分析。
		RenameObject	设置是否开启 RenameObject 功能。开启 RenameObject 功能后，您可以使用 RenameObject 接口重命名对象，详细介绍，请参见使用 RenameObject。说明 RenameObject 功能与版本控制功能互斥。如果您的存储桶开通了版本控制功能，则将无法使用 RenameObject 功能。
		标签	设置桶标签，更多信息，请参见设置桶标签。
		保留策略	设置是否开启保留策略功能，详细介绍，请参见设置保留策略（WORM）。

步骤三：上传文件

注意

上传文件前，请确保您已经创建存储桶。

登录对象存储控制台。

在左侧导航栏，单击桶列表。

在顶部导航栏，选择存储桶所属项目。

在桶列表页面单击目标桶名称。

在文件列表页面，单击上传文件。

在上传文件页面，设置文件参数。

参数	说明
上传到	指定对象上传到 TOS 存储桶中的存储路径。当前目录：将文件上传到当前目录下。指定目录：可自定义目录名称，并将文件上传到该目录下。指定目录命名规范如下：支持中文、英文、数字及常见字符。您可以使用正斜线（/）快速创建子文件夹，但文件夹命名不能以正斜线（/）或反斜线（\）开头，且不能使用连续的正斜线（/）。不能以 .. 作为文件夹名称。
待上传	通过选择或者拖拽方式，指定需要上传的本地文件或文件夹。说明同一存储桶中的文件不允许重名，如果您上传的文件与桶中已存在的文件重名，将按照如下策略处理：存储桶未启用版本控制功能：上传文件会覆盖原有的同名文件。存储桶开启了版本控制功能：上传文件会成为最新版本，已有同名文件会成为历史版本。关于版本控制的更多信息，请参见版本控制。
高级设置	存储类型	展开高级设置，设置文件的存储类型，文件存储类型默认继承桶的存储类型。不同存储类型说明如下：继承存储桶：默认值，与桶的存储类型保持一致。标准存储：高可用、高可靠、高性能存储类型，适用于频繁被访问的数据。智能分层：适用于访问模式不固定的数据，需要收取对象监控费用。关于智能分层存储类型的详细信息，请参见智能分层。低频存储：适用于频繁被访问的数据，最少存储 30 天。归档闪回：适用于基本不会被访问的数据，最少存储 90 天。归档：适用于基本不访问且需要长期保存的数据，最少存储 90 天。访问归档数据前需要先恢复数据。冷归档：适用于数据长期存储、基本不访问且访问可接受有一定响应时间的数据，最少存储 180 天。访问冷归档数据前需要先恢复数据。深度冷归档：适用于需要超长时间存放的极冷数据，最少存储 180 天。访问深度冷归档数据前需要先恢复数据。说明当前仅华北2（北京）、华东2（上海）和华南1（广州）支持冷归档存储。当前仅华北2（北京）、华东2（上海）和华南1（广州）支持深度冷归档，且都处于邀测状态，如您需要使用该存储类型，请联系客户经理。关于存储类型的详细说明，请参见存储类型。当存储桶开启多 AZ 冗余时，文件的存储类型将仅支持继承存储桶、标准存储（多 AZ）、智能分层（多 AZ）、低频存储（多 AZ）、归档闪回（多 AZ）。关于多 AZ 的详细介绍，请参见多 AZ 冗余。
		服务端加密	展开高级设置，设置服务端加密方式。不同加密方式说明如下：继承桶加密配置：默认值，与存储桶的服务端加密方式保持一致。您可以在存储桶的概览页面基本信息区域，查看存储桶的服务端加密方式。您也可以修改存储桶的服务端加密方式，具体操作，请参见设置桶的服务端加密。无：不加密。 SSE-TOS：TOS 托管密钥方式，是指文件上传后 TOS 对文件自动加密落盘存储，下载时自动解密，密钥由 TOS 托管，更多信息，请参见服务端加密。 SSE-KMS：使用火山引擎 KMS 托管的密钥对文件进行加解密，更多信息，请参见服务端加密。说明仅华北2（北京）、华东2（上海）、亚太东南（柔佛）和亚太东南（雅加达）地域支持 SSE-TOS 和 SSE-KMS。仅支持在上传文件时设置服务端加密，上传后的文件不支持修改服务端加密。首次使用 SSE-KMS 进行服务端加密，您需要开通 KMS 服务。开通 KMS 服务免费，使用 KMS 服务会收费。使用 SSE-KMS 进行服务端加密会产生 API 调用费用，创建 KMS 密钥会产生密钥托管费用，API 调用费用和密钥托管费用由 KMS 收取，更多信息，请参见 KMS 计费说明。
		加密算法	展开高级设置，选择密钥的加密算法，可选 AES256 和 SM4 算法。说明仅服务端加密选择 SSE-KMS 或 SSE-TOS 时，展示加密算法参数。仅华北2（北京）、华东2（上海）、亚太东南（柔佛）和亚太东南（雅加达）地域支持 AES-256 算法；仅华北2（北京）、华东2（上海）支持 SM4 算法。
		加密密钥类型	展开高级设置，默认为自定义密钥。说明仅服务端加密选择 SSE-KMS 时，展示加密密钥类型参数。
		自定义密钥	展开高级设置，选择在 KMS 服务创建的密钥。如果您未创建密钥，您可以前往 KMS 服务创建密钥。具体操作，请参见 KMS 快速入门。说明仅服务端加密选择 SSE-KMS 时，需要设置自定义密钥参数。
		元数据	展开高级设置，单击添加字段可设置对象元数据信息。TOS 支持设置的对象元数据详细说明，请参见管理对象元数据。
		访问权限	设置对象的 ACL 策略，说明如下：继承桶：对象将继承桶 ACL ，即对象的 ACL 策略将和桶 ACL 策略保持一致。关于对象 ACL 和桶 ACL 的对应关系，请参见对象继承桶 ACL。说明您还可以开启默认继承桶 ACL 功能，开启后，新上传的对象的 ACL 策略默认将和桶 ACL 策略保持一致。具体操作，请参见开启默认继承桶 ACL 。私有：默认值，只有该对象的归属者及有授权的账号拥有读写权限，推荐使用。公共读：任何用户对该对象都有读权限（包含匿名用户），但只有该对象的归属者及有授权的账号有写权限。公共读写：任何用户对该对象都有读权限和写权限（包含匿名用户）。

说明

设置文件参数后，您可以在上传文件页面查看待上传的文件列表。

您可以单击目标文件操作列的移除，取消所选文件的上传；或单击文件列表上方的清空列表，取消所有文件的上传。

文件上传过程中，请勿刷新或关闭页面，否则上传任务会被中断且列表会被清空。

确定上传文件后，单击上传，即可开始上传文件。

单击上传后，页面自动跳转至任务进度管理面板。您也可以单击控制台右上方的任务中心，查看任务进度及状态。

步骤四：下载文件

您可以通过控制台，将已上传到存储桶中的文件下载到本地（浏览器默认的下载路径）。

登录对象存储控制台。

在左侧导航栏，单击桶列表。

在顶部导航栏，选择存储桶所属项目。

在桶列表页面单击目标桶名称。

在文件列表页面，单击指定文件操作列的下载，即可下载该文件。

步骤五：获取文件 URL

您可以在对象存储控制台查看上传文件的 URL 地址，并将 URL 地址分享给第三方用以下载或者预览文件。

登录对象存储控制台。

在左侧导航栏，单击桶列表。

在顶部导航栏，选择存储桶所属项目。

在桶列表页面单击目标桶名称。

在文件列表页面，单击指定文件操作列的详情。

在弹出的文件基本信息面板，单击 URL 字段后面的复制按钮，即可获取文件 URL。

最近更新时间：2026.10.19 11:39:50

这个页面对您有帮助吗？

有用

无用