ossbrowser 是 OSS 官方提供的图形化管理工具,提供类似 Windows 资源管理器的功能。使用 ossbrowser,您可以方便地浏览、上传、下载和管理文件。

说明
  • 只支持 5GB 以下文件的移动或复制,5GB 以上文件的移动或复制操作建议使用 ossutil
  • 支持 Windows 7 及以上版本、Linux 和 Mac 平台,不建议在 Windows XP 和 Windows Server 平台上使用。

快速安装

  1. 下载并安装 ossbrowser。
    支持平台 下载地址
    Windows x32 Windows x32
    Windows x64 Windows x64
    MAC MAC
    Linux x64 Linux x64
    说明 更多下载地址请参见 GitHub
  2. 打开 ossbrowser 并登录。

    • Endpoint:选择登录的地域域名。
      • 默认:使用默认的 Endpoint 登录。
      • 自定义:输入 Endpoint 信息,填写 http 或 https 加对应地域的域名,选择使用 http 或 https 方式登录,例如:https://oss-cn-beijing.aliyuncs.com。地域域名信息请参见访问域名和数据中心
      • cname:可使用绑定的自定义域名登录。绑定自定义域名请参见绑定自定义域名
    • AccessKeyId/AccessKeySecret:填写账号的 AccessKey(AK)信息。为保证数据安全,推荐您使用 RAM 账号(子账号)的 AK 登录 ossbrowser。获取 AK 信息请参考创建AccessKey
    • 预设 OSS 路径:
      • 拥有所有 Bucket 管理权限的管理员子账号:无需配置。
      • 操作员子账号:需要配置。填写您需要访问的 OSS Bucket 名称或子目录(该 RAM 子账号需要有该路径的访问权限),格式为 oss://bucketname/path
      • 请求者付费模式:如果对应的路径开启了请求者付费模式,需勾选此项。请求者付费模式介绍请参见请求者付费模式
      • 区域:选择 OSS 路径对应的地域。
    • 记住秘钥:勾选可保存 AK 秘钥。再次登录时,单击 AK 历史,可选择该密钥登录,不需要手动输入 AK,请不要在临时使用的电脑上勾选。

快速使用

ossbrowser 支持简单的 OSS 资源管理。
  • 管理 Bucket
    • 创建 Bucket
      1. 在 ossbrowser 首页,单击新建 Bucket
      2. 配置 Bucket 信息。
        • 名称:最大 63 字符,名称需唯一,不可重名。
        • 区域:选择 Bucket 所在地域。
        • ACL 权限:选择 Bucket 的 ACL 权限。ACL 权限介绍请参见基于读写权限 ACL 的权限控制
        • 类型:选择 Bucket 的默认存储类型。存储类型详情请参见存储类型介绍
      3. 配置完成后单击确定
    • 删除 Bucket

      选中指定的 Bucket,之后单击更多 > 删除即可。当 Bucket 内存在文件或碎片时,无法被删除。

  • 管理文件/目录
    • 创建目录
      1. 在 ossbrowser 首页,单击对应的 Bucket。
      2. 单击创建目录
      3. 填写目录名并单击确定
        说明
        • 不允许使用表情符,请使用符合要求的 UTF-8 字符。
        • 一次仅可以创建一个目录,且仅可以创建单级目录,无法创建多级目录。例如:可以创建目录 abc,无法创建目录 abc/123
        • 不允许出现名为 .. 的子目录。
        • 总长度控制在 1-254 个字符。
    • 上传文件/目录

      在指定的 Bucket 或目录内,单击上传/目录,之后选择需要上传的文件/目录,即可完成上传文件/目录的操作。上传时可同时选择多个数据进行批量上传。

    • 下载文件/目录

      在指定的 Bucket 或目录内,选中需要下载的数据,单击下载即可。 可同时选中多个数据进行批量下载。

    • 复制文件/目录
      1. 在指定的 Bucket 或目录内,选中需要复制的数据,单击复制
      2. 进入需要粘贴文件的 Bucket 或目录,单击粘贴即可。 若复制文件的源地址和目的地址一致,则会覆盖原有文件。若该文件是低频或归档类型文件,且存储天数未满指定天数,会产生提前删除费用。提前删除费用请参考计量项和计费项
    • 移动文件/目录
      1. 在指定的 Bucket 或目录内,选中需要移动的文件/目录,单击更多 > 移动
      2. 进入需要粘贴文件的 Bucket 或目录,单击粘贴即可。
        注意 移动文件/目录,实际上是将文件/目录从源地址复制到目的地址,之后将源地址的文件删除。若被移动的文件是低频或归档类型文件,且存储天数未满指定天数,会产生提前删除费用。
    • 重命名文件/目录
      在指定的 Bucket 或目录内,选中需要重命名的文件/目录,单击更多 > 重命名,输入新的名称即可。
      注意
      • 重命名操作仅针对 1GB 以下的文件有效。
      • 重命名文件/目录,实际上是将文件/目录复制后重新命名,并保存,之后将原文件删除。若被重命名的文件/目录是低频或归档类型文件,且存储天数未满指定天数,会产生提前删除费用。
    • 删除文件/目录

      选择需要删除的文件/目录,单击更多 > 删除。 若被删除的文件/目录是低频或归档类型文件,且存储天数未满指定天数,会产生提前删除费用。

    • 生成文件 URL
      1. 选择指定文件,单击更多 > 获取地址
      2. 填写链接有效时间,并单击生成
      3. 单击点击复制发送邮件,将文件 URL 发送给需要访问该文件的用户。扫描生成的二维码也可以访问该文件。
    • 预览文件

      双击指定的文件即可完成预览。ossbrowser 目前支持 txt、pdf 和大部分图片文件的预览。

    • 管理碎片

      选择指定的 Bucket,之后单击碎片。通过管理碎片,您可以将不需要的碎片删除。

更多操作

  • 上传/下载性能调优
    您可以单击设置,进入 ossbrowser 的设置界面修改上传下载的参数。
    • 最大上传任务数:设置同时上传的任务数,超过任务数量的上传任务会进入队列,等待前面的任务完成。根据您的带宽合理设置任务数,可提高文件上传速度。
    • 最大下载任务数:设置同时下载的任务数,超过任务数量的下载任务会进入队列,等待前面的任务完成。根据您的带宽合理设置任务数,可提高文件下载速度。
    • 超时时间:设置任务的超时时间。
    • 分片大小:设置文件的分片大小。当文件过大或网络条件较差时,可设置合理的分片大小,将文件分片上传。
    • 重试次数:设置上传/下载任务的重试次数。
  • 邮件发送设置

    您可以单击设置,进入 ossbrowser 的设置界面设置您的邮箱账号信息,ossbrowser 所有涉及发送邮件的操作,均通过您设置的邮箱账号发送。

  • 日志设置
    • 开启调试模式
      您可以打开调试模式,通过调试模式查看上传下载日志、操作日志等信息。
      • 方式一:单击设置,在日志设置区域,单击开启调试,弹出调试面板。

      • 方式二:通过单击左上角应用 Logo 图标连续 10 次,弹出调试面板。

    • 开启日志功能

      您可以在设置页的日志设置区域选择是否开启日志记录。

      • 勾选本地日志文件可以开启本地日志功能,收集错误信息日志。ossbrowser 日志默认存储位置如下:
        • Linux:~/.config/oss-browser/log.log
        • Mac: ~/Library/Logs/oss-browser/log.log
        • Windows: %USERPROFILE%\AppData\Roaming\oss-browser\log.log
      • 勾选本地info日志文件将收集普通的 info 信息。