开发者指南

API 文档

SDK 文档

桌面端使用说明

最近更新时间:2020-04-30 10:57:59

下载与安装

软件下载

支持平台 系统要求 下载地址
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. 查看存储桶详情

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

注意:

多 AZ 特性目前仅支持广州、北京地域。有关多 AZ 特性的说明可参见 多 AZ 特性概述

3. 查看统计数据

您可通过单击存储桶列表右侧的【...】>【统计】,查看存储桶的统计数据。存储桶数据包含存储用量和对象数量。

4. 权限管理

COSBrowser 支持对存储桶及文件的权限管理。

  • 存储桶权限管理:可通过单击存储桶列表右侧操作栏中的【权限管理】进行操作。
  • 对象权限管理:可通过单击文件右侧操作栏中的【权限管理】进行操作。
说明:

有关 COS 的权限说明,可查看 ACL概述

5. 设置版本控制

COSBrowser 支持开启/关闭存储桶版本控制。

可通过单击存储桶列表右侧操作栏中的【版本控制】进行操作。

说明:

有关版本控制的说明,可查看版本控制概述

6. 添加访问路径

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

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

7. 上传文件/文件夹

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

8. 下载文件/文件夹

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

9. 删除文件/文件夹

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

10. 文件同步

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

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

注意:

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

11. 复制粘贴文件

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

注意:

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

12. 文件重命名

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

说明:

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

13. 新建文件夹

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

注意:

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

14. 查看文件详情

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

15. 生成文件链接

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

生成文件链接有以下几种方式:

  • 列表视图下,单击文件右侧的分享图标,可一键生成链接并复制。若文件为公有读权限,则链接不带签名永久有效。若文件为私有读权限,则链接带签名,2小时内有效。

  • 选择文件后,右键单击【复制链接】,可一键生成链接并复制。若文件为公有读权限,则链接不带签名永久有效。若文件为私有读权限,则链接带签名,2小时内有效。

  • 在文件详情中,单击【创建临时链接】,可以设置指定域名(例如开启了 CDN 加速域名,则可设置)的临时链接、链接类型、有效时间。

16. 文件预览

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

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

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

17. 搜索文件

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

18. 搜索存储桶

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

19. 查看历史版本或文件碎片

  • 当您的存储桶开启了版本控制后,可单击文件列表上方的【查看】>【历史版本】,查看文件的历史版本。历史版本列表中,支持按前缀搜索和清空所有历史版本(仅保留最新版本)。

  • 当您在上传对象过程中,暂停或取消上传时可能产生文件碎片。您可单击文件列表上方的【查看】>【文件碎片】来查看文件碎片,支持按前缀搜索和清空所有文件碎片。

软件设置

系统功能 说明 如何操作
设置网络代理 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. 单击【本地日志】,系统将打开本地日志所在目录。
目录