下载与安装

软件下载

支持平台	系统要求	下载地址
Windows	Windows 7 32/64位以上、Windows Server 2008 R2 64位以上	Windows
macOS	macOS 10.13以上	macOS
Linux	需带有图形界面并支持 AppImage 格式	Linux

软件安装

COSBrowser 安装包为可执行应用程序，用户下载完程序安装包后，双击安装包，然后按照系统提示即可进行安装。

登录软件

COSBrowser 桌面端仅支持通过云 API 密钥进行登录使用，该密钥可在访问管理控制台的 API 密钥管理 页面获取，成功登录后密钥将保存在历史密钥中，方便下次继续使用，软件登录界面如下所示。

注意：

COSBrowser 不支持使用项目密钥进行登录。

基本功能

1. 创建/删除存储桶

功能	说明	如何操作
创建存储桶	可以通过客户端直接创建存储桶	1. 在存储桶列表，单击左上角【添加桶】 2. 正确填写存储桶名称，并选择好地域、访问权限 3. 单击【确定】，即可完成创建
删除存储桶	删除存储桶前，请确认存储桶中数据已清空	1. 在存储桶列表，单击对应存储桶右侧的【删除】 2. 确认存储桶中的数据已全部清空，然后单击【确定】进行删除

2. 查看存储桶详情

您可通过单击存储桶列表右侧的【详情】，查看存储桶详情。存储桶详细信息包含存储桶名称、访问权限、版本控制状态。

存储桶详情中，支持更改存储桶访问权限、开启或暂停版本控制功能。

3. 添加访问路径

若您使用无访问存储桶列表权限的子账号进行登录，可以通过添加访问路径的方式进行访问，COSBrowser 提供了两种添加访问路径的方式：
（1）在登录界面直接添加访问路径，并选择好对应的存储桶地域信息，登录完成后，即可管理资源。

（2）子账号登录后，在存储桶列表页左上角，单击【添加路径】，并输入指定的路径进入存储桶管理资源。

4. 上传文件/文件夹

上传功能	说明	如何操作
上传文件	COSBrowser 支持多种上传方式，支持单个或批量上传	上传文件的几种方式如下，在指定的存储桶或路径内： 1. 单击【上传】，选择文件后，直接上传文件。 2. 在文件列表空白处右键单击【上传文件】，进行上传。 3. 通过鼠标将文件拖拽至文件列表窗口进行上传。
上传文件夹及其文件	若存储桶或路径内存在同名文件或文件夹，则默认覆盖	上传文件夹的几种方式如下，在指定的存储桶或路径内： 1. 单击【上传】，选择文件夹，直接上传文件夹。 2. 在文件列表空白处右键选择【上传文件夹】，进行上传。 3. 通过鼠标将文件夹拖拽至文件列表窗口即可完成上传。
增量上传	增量上传指执行上传操作前，对上传文件与存储桶已有对象做比对， 若存在同名对象，则跳过该文件不执行上传操作	增量上传操作步骤如下，在指定的存储桶或路径内： 1. 使用上传文件夹的方式，单击下一步。 2. 【存储方式】选择【跳过】，单击【上传】后，即可完成增量上传。

5. 下载文件/文件夹

下载功能	说明	如何操作
下载文件	COSBrowser 支持多种下载方式，支持单个或批量下载文件	下载文件的几种方式如下： 1. 选中需要下载的文件，单击界面内的【下载】，即可下载该文件。 2. 选中文件，右键单击【下载】。 3. 通过鼠标将文件拖拽至本地的方式进行下载。
下载文件夹及其文件	若本地已存在同名文件或文件夹，则默认重命名	下载文件夹及其文件的几种方式如下： 1. 选中需要下载的文件夹，通过单击界面内的【下载】，即可下载。 2. 右键单击【下载】，直接下载该文件夹。 3. 通过鼠标将文件夹拖拽至本地的方式进行下载。
增量下载	增量下载指执行下载操作前，将下载的对象与本地文件进行比对， 若存在同名对象，则跳过该对象不执行下载操作	增量下载操作步骤如下： 1. 选中想要下载的文件/文件夹，将鼠标移至【更多】出现下拉框。 2. 单击下拉框内的【高级下载】，在弹窗中选择【跳过】。 3. 然后单击【立即下载】即可完成不重名文件/文件夹的增量下载。

6. 删除文件/文件夹

选中想要删除的文件/文件夹，可通过单击界面上方【更多】中的【删除】或右键单击【删除】，完成文件/文件夹的删除，支持批量删除。

7. 文件同步

用户可以通过文件同步功能，将指定本地文件夹中的文件自动实时地上传至存储桶中。具体操作步骤如下：

（1）单击界面右上方的【同步】。
（2）在弹窗中指定本地文件夹和存储桶目录。
（3）单击【开始同步】，即可开启文件同步功能。
（4）可在同步日志中，查看文件的同步历史日志。

• 同步是指在上传文件时，系统会自动识别存储桶是否存在同样的文件，通过同步功能仅会上传存储桶中不存在的文件。
• 目前仅支持将本地文件同步上传至存储桶，不支持逆向操作。
• 文件同步功能支持设置手动同步和自动同步。

8. 复制粘贴文件

在指定的存储桶或路径内，选中想要复制的文件/文件夹，可通过单击界面上方【更多】中的【复制】或右键单击【复制】，完成文件/文件夹的复制，复制成功后可在其他存储桶或路径中进行粘贴，支持批量复制粘贴。

注意：

对于已复制的文件或文件夹，若其粘贴的目标路径中包含同名文件，则默认覆盖。

9. 文件重命名

选中想要重命名的文件，右键选择【重命名】或单击文件右侧【更多操作】中的【重命名】，输入文件名并确定，即可完成文件的重命名。

说明：

文件夹无法进行重命名操作。

10. 新建文件夹

在指定的存储桶或路径内，单击界面内的【新建文件夹】或右键单击【新建文件夹】，输入文件夹名并确认，完成文件夹的创建。

注意：

• 文件夹名称长度限制在255个字符内，可用数字、英文和可见字符的组合。
• 文件夹名称不可包含\ / : * ? " | < >等特殊字符。
• 不允许以..作为文件夹名称。
• 文件夹无法进行重命名操作，请谨慎命名。

11. 查看文件详情

可通过单击文件名或右键单击菜单中的【详情】来查看文件详情，文件详细信息包含文件名、文件大小、修改时间、访问权限、存储类型、ETag、Headers、对象地址、创建临时链接。

12. 生成文件链接

存在 COS 中的每个文件均可通过特定的链接来进行访问，若文件是私有读权限，则可通过请求临时签名的方式生成带有时效的临时访问链接。

COSBrowser 中有以下几种方式可生成文件链接：

• 列表视图下，单击文件右侧的分享图标，可一键生成链接并复制。若文件为公有读权限，则链接不带签名永久有效。若文件为私有读权限，则链接带签名，2小时内有效。
• 选择文件后，右键单击【复制链接】，可一键生成链接并复制。若文件为公有读权限，则链接不带签名永久有效。若文件为私有读权限，则链接带签名，2小时内有效。
• 在文件详情中，单击【创建临时链接】，可以设置临时链接的有效时间。

13. 文件预览

COSBrowser 支持预览媒体类文件，目前支持图片、视频、音频。可通过双击媒体格式文件或单击右键菜单中的【预览】或【播放】选项，即可打开文件预览界面。在文件预览或播放界面，您可以选择：

• 复制链接：生成文件访问链接并复制。
• 下载：将文件下载至本地，若本地存在同名文件，则默认覆盖。
• 手机查看：在预览界面会生成文件访问二维码，通过手机扫码可直接在手机上查看此文件。

注意：

• 预览支持大多数图片格式，视频格式仅支持 mp4、webm，音频格式仅支持 mp3、wav。
• 文件预览会产生下行流量，请酌情使用。

14. 搜索文件

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

15. 搜索存储桶

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

16. 查看多版本文件

当您的存储桶开启了版本控制后，可通过单击文件列表空白处右键菜单中的【查看多版本】选项，查看文件的历史版本。

软件设置

系统功能	说明	如何操作
设置网络代理	COSBrowser 默认会使用系统配置的代理来尝试网络连接，请确保您的代理配置正常或请停用无法连接互联网的代理配置	1. 选择【设置】>【代理】。 2. 设置网络代理来进行网络连接。
设置传输并发数	COSBrowser 支持批量上传和下载文件	1. 选择【设置】>【下载/上传】。 2. 设定批量传输的并发数，默认为5
设置传输分块数	COSBrowser 支持分块上传、下载文件，当传输的文件超过一定大小时，会默认使用分块的方式传输	1. 选择【设置】>【下载/上传】。 2. 设定分块传输的并发数，默认为5。
设置传输失败重试数	COSBrowser 在文件传输的时候，会默认重试失败的任务	1. 选择【设置】>【下载/上传】。 2. 设定传输失败的重试次数，默认为5。
设置上传二次校验	COSBrowser 支持在上传后进行二次校验，检查线上文件大小和状态是否正确	1. 选择【设置】>【上传】。 2. 勾选二次校验。
设置上传计算 md5	COSBrowser 支持在上传文件时计算文件的 md5，并以 x-cos-meta-md5 的自定义头部添加至文件的元数据中，下次请求该文件时，会返回该头部，可用于文件校验	1. 选择【设置】>【上传】。 2. 勾选计算 meta-md5 头。
查看本地日志	COSBrowser 会记录使用者的操作，以 cosbrowser.log 的日志形式保存在本地	1. 选择【设置】>【关于】。 2. 单击【本地日志】，系统将打开本地日志所在目录。