使用指南

BOS 桌面是百度对象存储 BOS 提供的图形化管理工具，支持在 Windows 和 Mac 系统中安装后使用。关于 BOS 桌面的下载及安装，请查看安装及登录。

BOS桌面功能概览

BOS 桌面支持 Object 级别的操作和管理，包括文件的上传和下载、删除、重命名、创建文件夹、查看文件ACL等操作。您通过 BOS 桌面对 Bucket 中文件做出的修改（包括上传、删除、重命名等）会自动和控制台同步。

功能名称	功能描述
新建存储桶（Bucket）	支持在 BOS 桌面新建 Bucket
查看Bucket详情	支持查看存储桶基本信息
搜索存储桶	支持搜索已创建的存储桶
删除Bucket	支持在 BOS 桌面删除非空 Bucket，需要确定您的存储桶不存在任何文件和未完成的分片（Part）
文件（文件夹）上传	支持通过拖拽或者点击的形式将本地文件上传到 BOS 的 Bucket 中
文件（文件夹）下载	支持将 Bucket 中文件、文件夹下载至本地
文件（文件夹）批量下载	支持将 Bucket 中文件、文件夹批量下载至本地
查看文件详情	支持查看存储桶中的文件基本信息
文件重命名	支持对 Bucket 中的文件进行重命名
文件复制	支持通过下拉选择的方式将 Bucket 中文件复制到 BOS 中其他 Bucket 中
文件/文件夹分享	支持分享文件和文件夹，支持设置分享的有效时间
文件删除	支持单个和批量删除 Bucket 中已有文件
搜索文件	支持以前缀搜索的方式对存储桶中的文件进行搜索
新建文件夹	支持在 Bucket 中新建文件夹，用以添加新的存储目录
本地文件自动同步上传	支持通过同步盘的方式，将本地数据自动同步到 BOS，无需手动上传
传输管理	（功能适用于 v0.2.4 及更低版本）单个或批量文件的上传，下载等操作均可在任务管理中进行查看，暂停，重试等操作
任务管理	（功能适用于 v1.0.0 及更高版本）单个或批量文件的上传，下载，移动，复制，删除，重命名操作任务均可在任务管理中进行查看和管理
指定路径登录	用户登录时，在配置AK/SK登录的基础上，可选配置访问路径，路径访问方式支持单个存储桶或者具体存储桶下某个文件路径，该功能可实现通过桌面工具进行细粒度文件管理。
本地日志	支持全部日志（包含info、warm、error等全部信息）与仅含info信息，默认开启，您可在应用设置中修改配置
上传/下载性能优化	为了进一步提升上传下载性能，BOS Browser提供控制并发任务数量的能力，用户可根据自身配置和网络环境等因素对相关参数进行灵活调整，从而获得最大传输效率。

BOS桌面使用指南

下面以 Mac 操作系统中 v 0.1.0 相关操作为例进行说明。若您使用的是 Windows 系统，也可以参考该使用指南。

1. 创建/删除/查看存储桶

功能	说明	如何操作
创建存储桶	可以通过桌面工具客户端直接创建存储桶	1. 在存储桶列表，单击左上角【新建Bucket】 2. 正确填写存储桶名称，并选择地域、默认存储桶类型、访问权限 3. 单击确定，即可完成创建
删除存储桶	删除存储桶前，请确认存储桶中文件与碎片已清空	1. 在存储桶列表，单击对应存储桶操作栏中【删除】 2. 确认存储桶中的数据已全部清空，单击确定进行删除
查看存储桶详情	存储桶详细信息包含存储桶名称、地域、访问权限，官方存储桶域名。	您可通过单击存储桶列表操作栏中【查看详情】

2. 文件/文件夹上传

点击 BOS 桌面中的上传按钮选择单个或者批量文件与文件夹进行上传，或者也可以直接通过拖拽的方式，将本地文件（文件夹）直接拖拽到目标 Bucket 中。多个文件上传任务可以在左侧目录【传输管理】-【上传】中进行查看与管理。

说明：

• 如果上传文件时提示“上传失败”，可能是由于您在登录 BOS 桌面后一直未进行操作而导致的连接超时。此时需要关闭 BOS 桌面后重新启动并登录，然后在上传列表中重新上传即可。

3. 文件/文件夹下载

可直接下载单个文件/文件夹，也可对多个文件/文件夹进行批量下载。

• 点击 BOS 桌面中文件（Object）列表操作栏中的【下载】图标，可对单个文件/文件夹进行下载。 也可选择多个文件/文件夹后，点击顶部【批量下载】按钮，对多个文件/文件夹批量下载，下载任务在左侧导航栏【传输管理】-【下载】中进行查看与管理。

4. 文件重命名

点击文件（Object）列表操作栏中的【...】图标，下拉列表中选择【重命名】。点击之后，在弹框中输入文件的新名称，点击确认后保存。

5. 文件复制

点击文件（Object）列表操作栏中的【...】，下拉列表中选择【复制到】，将文件复制到其他 Bucket，需在复制到弹框中选择或者直接输入希望复制到的目标 Bucket或更细粒度的目标文件夹，存储路径需包含存储桶，可选配置到具体目录。批量复制文件，可选择多个文件后，点击顶部【更多操作】-下拉选择【复制到】。

6. 文件与文件夹分享

6.1 文件分享

当需要分享单个文件时，可以点击 BOS 桌面中 Object 列表后的【分享】图标，设置分享链接有效期后，点击复制，即可进行文件分享。

6.2 文件夹分享

为了提升分享的效率，您可以为直接分享某个目录（文件夹）下的所有文件，操作方式为点击选中待分享的文件夹，并点击操作栏中【分享】图标，设置分享链接有效期与6位提取码，点击生成链接，复制进行文件夹分享链接与提取码，即可进行文件夹分享

7. 文件删除

点击文件（Object）列表操作栏中的【...】，下拉列表中选择【删除】，将文件进行删除。也可选择多个文件后，点击【更多操作】-【删除】进行文件的批量删除。

文件一旦在 BOS 桌面中删除，将在 BOS 中彻底删除，请谨慎操作。

8. 新建文件夹

点击【新建文件夹】按钮可为 Bucket 新建目录。新建成功后，可以在新的文件夹中对文件进行上传下载等管理操作。

9. 本地文件自动上传（数据同步）

BOS 桌面支持本地文件自动上传，到达自动将本地目录与云端数据同步的效果。当在 BOS 桌面中设置数据同步后（旧版本中【同步盘】后，已选本地目录中的文件将会实时自动同步到 BOS 的 Bucket 中。当有新的文件被添加到本地目录中，BOS Bucket 中的文件列表也会自动完成同步更新。可以对已经建立的同步任务进行暂停、查看日志、删除操作，通过【更多操作】可批量对同步任务进行以上管理。

说明：

• 用户需要选择一个本地文件夹和一个云端文件夹，确认后在这两个文件夹间建立映射关系；
• BOS 文件目录可选择 Bucket，也可选择 Bucket 中的一个文件夹；本地文件夹只能选择本地的文件夹。两者都不能选择单个文件；
• BOS 对映射关系的数量有限制，同一账户最多只能同时存在 20 个映射关系。

对于不同的情况，BOS 桌面会分别执行不同的操作：

• 一个文件在本地目录中存在，但是在存在映射关系的 Bucket 中不存在，那么该文件会被自动同步上传到该 Bucket。
• 一个文件在本地目录和存在映射关系的 BOS Bucket 中均已存在，但是该文件在本地目录中发生改动，那么该文件会被覆盖上传到该 Bucket。
• 一个文件在本地目录和存在映射关系的 BOS Bucket 中均已存在，但该文件在本地目录中被删除，那么该文件将会继续保存在BOS 的指定Bucket中，BOS不会同步删除该文件。
• 一个文件在 Bucket 中存在，但是在存在映射关系的本地目录中不存在，那么该文件不会自动同步到本地目录中。若您希望将该文件保存在本地目录中，请从 Bucket 中下载该文件。

说明：

• 本地目录中同名但内容不同的文件会上传覆盖到 Bucket。若您不希望覆盖上传，请区别文件名。

10. 下载分享文件夹

当您获取BOS文件分享链接及提取码后，您可使用BOS桌面工具查看并批量下载BOS分享链接中的文件。

前期准备

获取BOS文件分享链接及提取码。使用网页版BOS控制台或者桌面工具生成文件分享链接的过程请见文件夹分享。

操作步骤

1. 打开BOS桌面工具登录页，使用文件分享链接登录BOS桌面工具。

2.在 BOS 桌面工具左侧的导航栏中选择收到的分享，可查看分享的文件列表信息。

3. 点击需要批量下载的文件前的复选按钮，然后点击页面上方的批量下载，开始下载。
4. 在 BOS 桌面工具左侧的导航栏中选择任务管理，可查看任务状态。
5. 点击桌面工具右下角【注销】按钮可退出文件分享链接登录。

说明：请在链接到期前完成文件下载，链接到期后桌面工具将自动退出登录，进行中的下载任务将强制停止。

11. 搜索文件

可通过存储桶内右上方的搜索框，输入文件名进行搜索。支持文件名前缀搜索。

12. 查看文件详情

可通过单击文件名或右键单击操作栏中的详情来查看文件详情，文件详细信息包含文件名、修改时间、访问权限、ETag、Headers。

13. 修改文件访问权限

对象权限管理，可通过单击文件右侧操作栏中【...】图标，下拉选择【权限管理】进行查看与修改。

14. 直接输入路径与路径复制

可在工具地址导航栏直接输入路径，点击回车将自动定位到指定的路径，需注意路径需要包含完整的存储桶或存储桶/文件夹名称/，例如：bos:/a-bucket1-01/SDK使用/。也可以点击路径右侧的复制图标复制访问路径，分享给他人，可配合ak/sk密钥登录方式的，BOS访问路径一同使用，实现文件列表精准定位。

15. 搜索存储桶

可通过左侧存储桶列表上方的搜索框，输入存储桶名称快速定位存储桶。

16. 传输管理（适用于 v0.2.4 及更早期版本）

传输管理支持对历史的文件上传与下载任务进行管理，可批量进行开始，暂停，删除等操作。

17. 任务管理（适用于 v1.0.0 及后续版本）

任务管理支持对单个或批量文件的上传，下载，移动，复制，删除，重命名的任务进行查看和管理。

18. 本地日志

您通过桌面工具进行的各种操作将生成本地日志，供您查看与审计等场景，支持全部日志（包含info、warm、error等全部信息）与仅含info信息，日志按天生成。您可在【应用设置】-【高级设置】中修改本地日志配置，若二者都不勾选则默认默认不开启本地日志，不建议您关闭本地日志。点击日志输出路径，可打开本地日志所在文件夹，方便您查看。

19. 上传/下载性能优化

为了进一步提升上传下载性能，BOS Browser提供控制并发任务数量的能力，用户可根据自身配置和网络环境等因素对相关参数进行灵活调整，从而获得最大传输效率。 用户可在【应用设置】->【高级设置】中对并发任务数量进行动态调整。

相关参数说明

• 上传

参数	描述
文件并发数	同时运行上传任务的任务数量，默认设置为5，用户可进行调整，合法范围为1-1000000
分块并发数	文件分开上传时同时执行的分片数量，默认设置为5，用户可进行调整，合法范围为1-10000

• 下载

参数	描述
文件并发数	同时运行下载任务的任务数量，默认设置为5，用户可进行调整，合法范围为1-6

说明：

• 并发数的设置不宜过大。如果并发数配置过大，可能会因线程间资源切换、抢夺等原因，导致上传/下载的性能下降，因此需要根据实际的文件大小和网络情况调整；
• 在客户端网络情况不理想的情况下，为了减少受网络波动影响导致任务失败的情况，可以适当减小上传/下载的段大小和整体的并发数量；
• 目前暂只支持最多设置6个下载任务同时进行。