human: 如何处理七牛云的对象存储图形化工具 Kodo Browser

gpt: [对象存储](https://developer.qiniu.com/kodo) > 实用工具 > 图形化工具 Kodo Browser

#  图形化工具 Kodo Browser

最近更新时间: 2024-06-28 18:52:05

Kodo Browser 是七牛对象存储提供的图形化管理工具，支持用户通过可视化页面进行上传、下载等操作。

Github [代码地址 __](https://github.com/qiniu/kodo-browser)

# 下载

支持平台 | 链接  
---|---  
Windows x86 | [下载 __](https://kodo-toolbox-new.qiniu.com/kodobrowser/client/kodo-browser-Windows-x86-v2.3.1.zip)  
Windows x64 | [下载 __](https://kodo-toolbox-new.qiniu.com/kodobrowser/client/kodo-browser-Windows-x64-v2.3.1.zip)  
Mac OS | [下载 __](https://kodo-toolbox-new.qiniu.com/kodobrowser/client/kodo-browser-Mac%20OS-v2.3.1.zip)  
Linux x64 | [下载 __](https://kodo-toolbox-new.qiniu.com/kodobrowser/client/kodo-browser-Linux-x64-v2.3.1.zip)  
  
[查看更新日志/下载历史版本 __](https://github.com/qiniu/kodo-browser/releases)

# 登录

安装后，点击 Kodo Browser
图标进入登录页面；默认是登录、管理公有云存储资源，Endpoint也可以选择「自定义（私有云）」，登录、管理私有云存储资源。

![image.png](https://dn-odum9helk.qbox.me/FhMfb50vakSlRA_0kxKPL-Myg4v-)

  * AccessKeyId/AccessKeySecret：通过[七牛控制台个人中心 __](https://portal.qiniu.com/user/key)获取 AK/SK

登录私有云环境时，需要先在登录页面配置区域信息；Endpoint选择「自定义（私有云）」后，点击右侧设置图标即可打开配置页面

![image.png](https://dn-odum9helk.qbox.me/Fsjf5_jmieWUXIz3OHS5mPirewQn)

  * 自定义 Endpoint 未配置时，禁止登录私有云环境。支持开启区域设置，配置区域 Endpoint。
  * 自 1.0.10 版本开始，支持 IAM 用户登录使用 Kodo Browser。

## **记住密钥**

可以勾选「记住密钥」，记录登录成功的 AccessKeyId/AccessKeySecret 信息，以便于下一次的快速登录。

**注意：请不要在临时使用的电脑上勾选记住密钥！**

![image.png](https://dn-odum9helk.qbox.me/FvmaU1N-2bJ84XSV55523nieFRj3)

点击「AK 历史」，可以选择之前已验证通过的 AccessKeyId/AccessKeySecret 对来做登录。已添加的 AK 历史记录可以被删除。

![image.png](https://dn-odum9helk.qbox.me/FvE4UXQrwbPTqfa49DgqYHrJ6QnE)

  * 登录私有云环境时，需保证当前的私有云环境区域配置信息与 AccessKeyId/AccessKeySecret 相匹配。

## **切换账号**

客户端允许在不退出登录的情况下，直接切换账号。

![image.png](https://dn-odum9helk.qbox.me/Fg8uE0rPsHZWcOfeNRS5WJafg3Z-)

  * 点击客户端右上角的账户小图标
  * 点击切换账号，在 AK 历史弹窗中选择要切换的 AK 点击「使用」
  * 客户端就会尝试以所选择的账号重新登录，并定位到首页展示

## **使用分享链接登录**

点击「使用分享链接登录」，支持使用 Kodo Browser 或 Kodo 控制台生成的目录分享链接和链接提取码登录、进而访问已授权文件列表。

![image.png](https://dn-odum9helk.qbox.me/Fizj8fXVkzBWsys39GU_kN8na4SX)

  * 输入分享链接，支持由 Kodo Browser 或 Kodo 控制台获取目录分享链接
  * 输入提取码，为6位由数字或字母组成
  * 点击「登录」，即可查看被授权访问的文件列表

# 功能说明

## **Bucket 操作**

自1.0.13 版本开始，客户端支持公有云的授权空间管理。

### **创建 Bucket**

  * 在 Kodo browser 首页点击【新建 Bucket】
  * 输入 Bucket 信息 
    * 名称：由 3 ~ 63 个字符组成 ，可包含小写字母、数字和短划线，且必须以小写字母或者数字开头和结尾
    * 区域：选择 Bucket 所在区域
    * ACL 权限：暂不支持设置，默认创建公开 Bucket
  * 点击【确定】

![image.png](https://dn-odum9helk.qbox.me/FlK4Q0UVmrbTiGoxnd54JXGkzAH4)

### **删除 Bucket**

在 Bucket 列表中选中指定的 Bucket，点击【更多】-【删除】即可。

![image.png](https://dn-odum9helk.qbox.me/Fn7sNC15SiE28mFX6lpO35SUvxi0)

### **编辑 Bucket 备注**

在 Bucket 列表中选中指定的 Bucket，点击【更多】-【编辑备注】即可。

![image.png](https://dn-odum9helk.qbox.me/FmgN9GL9brGlRokLoqepXvQmgK83)

## **Object 操作**

![image.png](https://dn-odum9helk.qbox.me/Fi42ertE5m2H9z04-WxZX3BcoMzR)

### **创建目录**

  * 在 Bucket 列表中点击对应的 Bucket，进入 Bucket 内对象列表
  * 点击【创建目录】
  * 输入目录名称，点击【确定】

![image.png](https://dn-odum9helk.qbox.me/FuY3dw-GnR2DDmesbK2WGkAXl-eP)

### **上传文件/目录**

  * 在指定的 Bucket 或目录内，点击【上传】
  * 选择需要上传的文件或目录即可

![image.png](https://dn-odum9helk.qbox.me/FnS3qywIgswXJI4n2XGx6rqR7P2C)

  * 上传文件/目录，支持拖拽操作。**注意，Windows 系统下做目录上传时，需要采用拖拽操作。**
  * 上传文件时，可以指定要保存的存储类型。客户端默认禁止上传同名文件，但是可以在上传确认界面中开启「覆盖上传」，在本次上传中执行覆盖上传、变更同名文件。

![image.png](https://dn-odum9helk.qbox.me/Fsd8zFMy9o4G6rq6B4jKf8NaML3m)

  * 客户端默认允许上传空目录，但是可以在上传任务管理器中设置「是否允许空目录上传」；图标为蓝色时表示「允许空目录上传」。

![image.png](https://dn-odum9helk.qbox.me/FidbqAYYJ0TODkA9XoGpzERjMw5x)

### **下载文件/目录**

  * 在指定的 Bucket 或目录内，选中需要下载的文件或目录
  * 点击【下载】，并选择下载目录即可
  * 如本地下载目录中包含同名文件，将会在原文件名后添加后缀保存

![image.png](https://dn-odum9helk.qbox.me/FiuZX8R5RTAVVwZc6ndjPrJO_Azz)

  * 客户端下载同名文件时，默认会在文件名最后添加数字编号；但是可以在上传任务管理器中设置「是否开启覆盖下载」模式，在下载同名文件时覆盖所选路径下已存在的文件；图标为蓝色时表示「开启覆盖下载」。

![image.png](https://dn-odum9helk.qbox.me/FlgsKPvqJVL81SG8i2gSr-aaG0JW)

  * 客户端默认使用空间源站域名做文件预览和下载，也支持选用空间已绑定的cdn域名来预览和下载文件。

![image.png](https://dn-odum9helk.qbox.me/Fosphyzk-Al9hilJsdE12XX2kdNi)

**注意**

默认不使用自有域名下载公有云存储的文件时，**会产生一定的外网流出流量** ，**可能会产生流量计费** 。  
使用空间已绑定的cdn域名下载公有云存储的文件时，**则会产生CDN回源流量** 。

### **复制文件/目录**

  * 在指定的 Bucket 或目录内，选中需要复制的文件或目录
  * 点击【复制】
  * 进入需要粘贴文件的 Bucket 或目录，点击【粘贴】

![image.png](https://dn-odum9helk.qbox.me/FqAiC38d0lqFGUBiYAfNAOzarPUr)

  * 当原 Bucket 与目标 Bucket 一致，需要重命名文件，否则会提示【已有同名文件，是否覆盖？】，此时可根据您的需求选择【确定】或【取消】
  * 当原 Bucket 与目标 Bucket 不一致，会覆盖目标 Bucket 中的同名原文件

![image.png](https://dn-odum9helk.qbox.me/FlGxuZkMLgD0Sl6vyCC2m5DpKIUt)

  * 不支持跨区域复制

### **移动文件/目录**

  * 在指定的 Bucket 或目录内，选中需要移动的文件或目录
  * 点击【更多】-【移动】
  * 进入需要粘贴文件的 Bucket 或目录，点击【粘贴】

![image.png](https://dn-odum9helk.qbox.me/FpDyj6K9cpRmtVZ3YmeV9jOzGHS7)

  * 当原 Bucket 与目标 Bucket 一致，需要重命名文件，否则会提示【已有同名文件，是否覆盖？】，此时可根据您的需求选择【确定】或【取消】
  * 当原 Bucket 与目标 Bucket 不一致，会覆盖目标 Bucket 中的同名原文件

![image.png](https://dn-odum9helk.qbox.me/FhZQS-QxgxAMICEgmXlL1ThqQKWG)

  * 不支持跨区域移动

### **重命名文件/目录**

  * 在指定的 Bucket 或目录内，选中需要重命名的文件或目录
  * 点击【重命名】
  * 输入文件名称：禁止以 `/` 开头或结尾，禁止输入连续的 `/`。当文件名在 Bucket 中已存在，会提示【已有同名文件，是否覆盖？】，此时可根据您的需求选择【确定】或【取消】
  * 点击【确定】

![image.png](https://dn-odum9helk.qbox.me/FswyquUt1qKETBinXwKiSzJ3qAHr)

### **删除文件/目录**

  * 在指定的 Bucket 或目录内，选中需要删除的文件或目录
  * 点击【删除】并【确定】

![image.png](https://dn-odum9helk.qbox.me/Fl543QnOJFL83gta8D7iutNbC27x)

  * 支持单个文件/目录的删除，也支持批量删除

### **解冻归档存储和深度归档存储文件**

归档存储和深度归档存储类型的文件，鼠标悬停在文件「名称」上时，可以查看解冻状态。

![image.png](https://dn-odum9helk.qbox.me/FlZNBdPaVoKudzhowyd3P0tXGii_)

在文件列表视图的「操作」列中点击解冻图标，可以解冻归档存储和深度归档存储类型的文件。

![image.png](https://dn-odum9helk.qbox.me/Fsp5fhceYja5G7C86-1G-oRA1UCZ)

  * 设置解冻天数：1~7。
  * 点击【确定】
  * 成功提交解冻请求后，文件会切换为「解冻中」的状态。
  * 归档存储 1~5 分钟解冻完成，深度归档存储 5~12 小时解冻完成。当文件变为「已解冻」状态时，文件的内容才可以被正常访问。

![image.png](https://dn-odum9helk.qbox.me/Fkj0AAE1Ldpp56tzLFPsksKThMeg)

### **修改文件存储类型**

文件列表中会展示文件的存储类型信息。[不同存储类型的差别 __](https://developer.qiniu.com/kodo/3956/kodo-
category)

![image.png](https://dn-odum9helk.qbox.me/Fjj4na28TXJMKy3eslQN0E2Kwu-t)

在列表视图的「操作」列中点击修改存储类型的图标，可以修改文件的存储类型。

![image.png](https://dn-odum9helk.qbox.me/FnijVLRF47Hstw8NH9mdG8oApKe5)

  * 归档存储和深度归档存储类型的文件需要先解冻为可读取状态，才能进行类型转换。
  * 低频存储、归档直读存储、归档存储和深度归档存储类型，Object 最小计量 64KB。
  * 从低频存储类型转换为其他类型时，如果该 Object 保存时间少于 30 天，将按照 30 天来计费。
  * 从归档直读存储类型转换为其他类型时，如果该 Object 保存时间少于 60 天，将按照 60 天来计费。
  * 从归档存储类型转换为其他类型时，如果该 Object 保存时间少于 60 天，将按照 60 天来计费。
  * 从深度归档存储类型转换为其他类型时，如果该 Object 保存时间少于 180 天，将按照 180 天来计费。

### **预览文件**

在列表视图中双击文件名，或在矩阵视图中双击文件即可预览。目前支持 txt 和大部分图片文件的预览。

![image.png](https://dn-odum9helk.qbox.me/Fl-4g0wvB3SxkRE3XEEcar4bPfBK)

**注意：归档存储和深度归档存储文件，必须先解冻才能预览。**

![image.png](https://dn-odum9helk.qbox.me/FpeZpo78cyd7HfBr_fXwhz1md2IK)

### **获取外链**

在文件列表视图的「操作」列中点击外链图标，或在文件的预览界面点击「获取外链」，都能方便地生成并复制文件外链。

![image.png](https://dn-odum9helk.qbox.me/FpPrpFmopeuwIuj6HLCXIgI3rme5)

默认不使用自有域名时，文件外链必须设置有效期，有效期范围1-604800s，默认600。

![image.png](https://dn-odum9helk.qbox.me/FrzKrPi5G5d8g3RSVuTpe7ZbVjOF)

  * 设置外链有效期
  * 外链生成，【点击复制】文件外链即拷贝到剪切板

客户端支持选用空间已绑定的自定义 cdn 域名或自定义源站域名来生成外链。使用自定义域名时，

  * 空间是公开的，生成永久有效外链，无需设置有效期
  * 空间是私有的，必须设置外链有效期，有效期最长 1 年，默认 600s

![image.png](https://dn-odum9helk.qbox.me/Fvdiulw6WIAcK06jsXk2t3c53B2h)

**注意**

不使用自有域名（使用空间的源站域名）或使用自定义源站域名生成外链，经由外链访问公有云存储的文件时，**会产生一定的外网流出流量**
，**可能会产生流量计费** 。  
使用空间的cdn域名生成外链，经由外链访问公有云存储的文件时，**产生的是 CDN 回源流量** 。  
归档存储和深度归档存储文件，可以直接获取外链，但是文件访问前需要先解冻。

### **批量导出外链**

在文件列表视图中勾选多个文件，点击批量操作区域的「导出外链」，可以一次性将多个文件的外链以 csv 文件保存到本地。  
勾选目录时，会把目录下所有文件的外链导出，而目录本身则不会导出外链。

![image.png](https://dn-odum9helk.qbox.me/FqTgbq--thOVtedu3G0I7gdwhwLC)

客户端支持选用空间已绑定的自定义 cdn 域名或自定义源站域名来生成外链：

  * 不使用自有域名时，文件外链必须设置有效期，有效期范围1-604800s，默认600s
  * 使用自定义域名时，空间是公开的，无需设置外链有效期；空间是私有的，则必须设置有效期，有效期最长 1 年，默认 600s

![image.png](https://dn-odum9helk.qbox.me/FofGSxEYgsjdmJCGVYrwgIuKkdrw)

  * 设置外链有效期
  * 点击【生成并导出】
  * 客户端会弹出本地目录选择框，选择外链文件要保存的路径
  * 确认后，客户端将把所有文件外链以 csv 格式保存至所选路径下。csv 文件命名举例：kodo-browser-download-links-20200317110450.csv 
    * 使用时建议以文本编辑工具打开csv文件
    * 文件名有中文字符时，使用 Excel 打开csv文件需要选择编码方式：打开新的空白sheet ——> 数据 ——> 从文本 ——> 选择已下载的 csv 文件，点击获取数据 ——> 选择文件原始格式或编码为：Unicode(UTF-8) ——> 设置数据分隔，点击完成，导入的中文字符即可正常显示

### **分享目录**

在文件列表目录栏的「操作」列中点击分享图标

![image.png](https://dn-odum9helk.qbox.me/FvuFOrqLr0Yp9p0uaH116EDhjfBB)

  * 设置分享链接有效期，支持自定义范围 900 - 7200 秒或快速选择15分钟、30分钟、1小时、2小时
  * 定义提取码，必须为 6 位，只能由字母数字组成；支持自定义或点击「随机生成」自动生成
  * 点击「提交」获取分享链接，点击「复制链接与提取码」按钮进行复制
  * 将链接和提取码分发给他人，即可通过链接访问该目录下的文件。支持通过浏览器或 Kodo Browser 打开分享链接。

![image.png](https://dn-odum9helk.qbox.me/Fpzr0NHn2EseauYYu6n87XgKHF_z)

## **管理外部路径**

经由 Bucket Policy 授予权限的空间或目录，需要添加为「外部路径」，才能在客户端中使用和管理。

### **开启外部路径功能**

点击【设置】进入设置页面

  * 外部路径：勾选时，表示启用外部路径功能；不勾选时，客户端不显示「外部路径」菜单。外部路径功能，默认不启用。

![image.png](https://dn-odum9helk.qbox.me/FvPw6iOF9NxjhhSn2F7EH8JwPFNY)

### **管理外部路径**

外部路径功能启用后，界面会出现「外部路径」的菜单

![image.png](https://dn-odum9helk.qbox.me/FuMKfZ7TGXw_8dkwPxd4gXr1cgmS)

点击「添加外部路径」打开弹窗

![image.png](https://dn-odum9helk.qbox.me/FnkPWy6XlogFcw-S0HqF8FBOlKk6)

  * 输入外部路径名：可以是被授权的空间或目录，需要由授权者提供。
  * 选择外部路径的区域
  * 点击确定，添加完成

添加好的外部路径，只要有相应的权限，支持的操作与自己创建的空间一致。

选中某个已添加的外部路径，点击「更多」的「删除」，可以把这个外部路径移除。

![image.png](https://dn-odum9helk.qbox.me/Fvmj7x8SAiL7qevRrPJ6ApCefEIo)

  * 此操作为客户端的配置移除，并没有真正删除对应的空间或目录。客户端不支持删除通过 Bucket Policy 授予权限的空间或目录。

## **其他操作**

### **断点上传设置**

点击【设置】进入设置页面

  * 断点上传：勾选时表示开启断点上传功能；不勾选时，「断点上传」相关设置不生效
  * 断点上传文件阈值：当开启断点上传且文件大小大于此阈值时，自动使用可恢复的分片上传，范围：10MB~1000MB
  * 断点上传文件大小：分片大小，范围 1MB~100MB
  * 断点上传分片并发数：同时进行上传的分配文件数，范围 1~5
  * 最大上传任务数：同时上传的任务数，不仅限于断点上传模式；超过任务数量会进入队列，等待前面的任务完成，范围 1~10  
![image.png](https://dn-odum9helk.qbox.me/FjdKf1OKX4nSoHSHUu-RZ2QCVRGF)

### **上传限速**

客户端支持设置单个文件的上传限速(单个上传任务的限速)，结合「最大上传任务数」的设置，实现客户端上传的整体限速控制。

  * 上传限速：勾选时表示开启限速控制；不勾选时，「单个文件上传限速」的设置不生效
  * 单个文件上传限速：单个文件上传的带宽限制值，范围 1KB/s - 100MB/s

![image.png](https://dn-odum9helk.qbox.me/Ft3bRc103yjxLSHi_9s_dXVnqBUV)

### **断点下载设置**

  * 断点下载：勾选时表示开启断点下载功能；不勾选时，「断点下载」相关设置不生效
  * 断点下载文件阈值：当开启断点下载且文件大小大于此阈值时，自动使用可恢复的分片下载，范围 10M~1000MB
  * 断点下载文件大小：分片大小，范围 8M~100MB
  * 最大下载任务数：同时下载的任务数，不仅限于断点下载模式；超过任务数量会进入队列，等待前面的任务完成，范围 1~10

![image.png](https://dn-odum9helk.qbox.me/FiIgmHsmbenbf8rSCzyMtWyP65QA)

### **下载限速**

客户端支持设置单个文件的下载限速(单个下载任务的限速)，结合「最大下载任务数」的设置，实现客户端下载的整体限速控制。

  * 下载限速：勾选时表示开启限速控制；不勾选时，「单个文件下载限速」的设置不生效
  * 单个文件下载限速：单个文件下载的带宽限制值，范围 1KB/s - 100MB/s

![image.png](https://dn-odum9helk.qbox.me/Fl-qp4BNBPUtVFTEtuGaovta9PR6)

### **文件列表分步加载**

客户端默认会把当前路径下的所有文件/目录全部列举出来，文件数量特别多的时候，等待时间会比较久，可以设置开启文件列表的分页加载模式。

  * 文件列表分页加载：勾选时表示分页加载文件列表，而不是一次性列举出来所有的文件列表。

![image.png](https://dn-odum9helk.qbox.me/FqbQpZrw9NcY2RQTHQZz1xSwtECy)

开启分页加载后，文件列表滑动到底部会触发列举下一页的文件列表。

  * 自定义列举条目数：客户端支持自定义每次列举文件时的加载条目数，默认是 100。只有当「分页加载」模式开启时，此设置才生效。

![image.png](https://dn-odum9helk.qbox.me/FjBDjdVN5Q1xVQY0aQFQYUabkllJ)

### **书签**

客户端支持书签功能。

![image.png](https://dn-odum9helk.qbox.me/FrYwh1KAhjQmj2iQd_E8gqwIIRec)

  * 在对应的界面访问路由下，点击五角星图标，可以将页面保存为书签
  * 点击「书签管理」，可以查看、使用和删除已保存的书签

![image.png](https://dn-odum9helk.qbox.me/FvH8t9IHdGSA9gHrJX9AQBXmpwwb)

  * 点击已保存的书签URL，客户端会跳转到对应的页面
  * 不再需要使用的书签，可以点击删除

以上内容是否对您有帮助？