文档

安装并登录ossbrowser

更新时间:
重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

当您需要快速使用图形化工具上传文件、下载文件、删除文件、设置权限策略时,可以下载并安装ossbrowser工具,使用多种方式登录工具,进行相关操作。

版本

本文以最新版本1.18.0版本为例进行说明。关于ossbrowser的所有版本,请参见all-releases.md

下载地址

Windows x32

oss-browser-win32-ia32.zip

说明
  • 仅支持Windows 7及以上版本。

  • 如果遇到安装ossbrowser后无法正常使用的问题,请参见Windows系统安装某软件后无法打开ossbrowser

  • 不推荐在Windows Server安装ossbrowser。如果您在使用Windows Server安装ossbrowser时遇到问题,你可以构建源码解决兼容性问题。

Windows x64

oss-browser-win32-x64.zip

说明
  • 仅支持Windows 7及以上版本。

  • 如果遇到安装ossbrowser后无法正常使用的问题,请参见Windows系统安装某软件后无法打开ossbrowser

  • 不推荐在Windows Server安装ossbrowser。如果您在使用Windows Server安装ossbrowser时遇到问题,你可以构建源码解决兼容性问题。

macOS

oss-browser-darwin-x64.zip

说明

macOS默认无法打开未验证的开发者应用。如果出现该问题,您需要修改系统安全设置。详情请参见macOS系统无法打开ossbrowser

Linux x64

oss-browser-linux-x64.zip

说明
  1. 不推荐在Linux x64使用ossbrowser。建议您在Windows或者macOS,使用ossbrowser。Linux x64发行版本众多,需要安装图形界面和多种依赖文件。本文以CentOS 7、CentOS 8、Ubuntu 14等为例说明如何安装ossbrowser。

  2. 如果您在Linux x64安装ossbrowser时遇到问题,您可以下载源码编译排查。

步骤一:安装ossbrowser

Windows x32

  1. 下载Windows x32压缩包

  2. 解压。

  3. 在文件夹oss-browser-win32-ia32中,双击oss-browser.exe,打开ossbrowser。

Windows x64

  1. 下载Windows x64压缩包

  2. 解压。

  3. 在文件夹oss-browser-win32-x64中,双击oss-browser.exe

macOS

  1. 下载macOS压缩包

  2. 解压。

  3. 在文件夹oss-browser-darwin-x64中,右键单击oss-browser.app,选择打开

  4. 在对话框中,单击打开

  5. 在对话框中,单击允许

CentOS 7

  1. 安装图形界面。

    如何为CentOS 7安装图形化软件,请参见如何在Linux系统的ECS实例中安装图形界面

  2. 安装依赖文件。

    1. 执行以下命令更新yum源。

      sudo yum update
    2. 执行以下命令安装依赖文件libgtk-x11-2.0.so.0。

      sudo yum install gtk2-2.24.31-1.el7.x86_64
    3. 执行以下命令安装依赖文件libXtst.so.6。

      sudo yum install libXtst-1.2.3-1.el7.x86_64
    4. 执行以下命令安装依赖文件libXss.so.1。

      sudo yum install libXScrnSaver-1.2.2-6.1.el7.x86_64
    5. 执行以下命令安装依赖文件libgconf-2.so.4。

      sudo yum install GConf2-3.2.6-8.el7.x86_64
  3. 安装ossbrowser。

    1. 执行以下命令下载CentOS 7压缩包。

      sudo wget https://gosspublic.alicdn.com/ossbrowser/1.18.0/oss-browser-linux-x64.zip
    2. 执行以下命令解压。

      sudo unzip oss-browser-linux-x64.zip
    3. 执行以下命令进入目录oss-browser-linux-x64

      sudo cd oss-browser-linux-x64/
    4. 执行以下命令打开ossbrowser。

      sudo ./oss-browser

CentOS 8

  1. 安装图形界面。

    如何为CentOS 8安装图形化软件,请参见如何在Linux系统的ECS实例中安装图形界面

  2. 安装依赖文件。

    1. 执行以下命令更新yum源。

      sudo yum update
    2. 执行以下命令安装依赖文件libgtk-x11-2.0.so.0。

      sudo yum install gtk2-2.24.32-5.el8.x86_64
    3. 执行以下命令安装依赖文件libX11-xcb.so.1。

      sudo yum install libX11-xcb-1.6.8-5.el8.x86_64
    4. 执行以下命令安装依赖文件libXtst.so.6。

      sudo yum install libXtst-1.2.3-7.el8.x86_64
    5. 执行以下命令安装依赖文件libXss.so.1。

      sudo yum install libXScrnSaver-1.2.3-1.el8.x86_64
    6. 执行以下命令安装依赖文件libgconf-2.so.4。

      sudo yum install GConf2-3.2.6-22.el8.x86_64
    7. 执行以下命令安装依赖文件libasound.so.2。

      sudo yum install alsa-lib-1.2.5-4.el8.x86_64
  3. 安装ossbrowser。

    1. 执行以下命令下载CentOS 8压缩包。

      sudo wget https://gosspublic.alicdn.com/ossbrowser/1.18.0/oss-browser-linux-x64.zip
    2. 执行以下命令解压。

      sudo unzip oss-browser-linux-x64.zip
    3. 执行以下命令进入目录oss-browser-linux-x64

      sudo cd oss-browser-linux-x64/
    4. 执行以下命令打开ossbrowser。

      sudo ./oss-browser

Ubuntu 14

  1. 安装图形界面。

    如何为Ubuntu 14安装图形化软件,请参见How to Install a Desktop (GUI) on an Ubuntu Server

  2. 安装依赖文件。

    1. 执行以下命令更新apt源。

      sudo apt update
    2. 执行以下命令安装依赖文件libgtk-x11-2.0.so.0。

      sudo apt install libgtk2.0-0
    3. 执行以下命令安装依赖文件libX11-xcb.so.1。

      sudo apt install libx11-xcb-dev
    4. 执行以下命令安装依赖文件libXtst.so.6。

      sudo apt install libxtst6
    5. 执行以下命令安装依赖文件libXss.so.1。

      sudo apt install libxss1
    6. 执行以下命令安装依赖文件libgconf-2.so.4。

      sudo apt install libgconf-2-4
    7. 执行以下命令安装依赖文件libasound.so.2。

      sudo apt install libasound2
  3. 安装ossbrowser。

    1. 执行以下命令下载Ubuntu压缩包。

      sudo wget https://gosspublic.alicdn.com/ossbrowser/1.18.0/oss-browser-linux-x64.zip
    2. 执行以下命令解压。

      sudo unzip oss-browser-linux-x64.zip
    3. 执行以下命令进入目录oss-browser-linux-x64

      sudo cd oss-browser-linux-x64/
    4. 执行以下命令打开ossbrowser。

      sudo ./oss-browser

步骤二:登录ossbrowser

打开ossbrowser后,您可以根据授权对象和访问时效选择以下登录方式。

说明

请勿使用网络代理登录,否则可能登录失败。

通过AK登录

如果您想要长期访问您Bucket下的指定资源,您可以通过阿里云账号或RAM用户的AccessKey(AK)信息登录ossbrowser。登录成功后,您可以管理账号中的Bucket。

ak

通过AK登录时,需按如下说明完成各配置项。

参数

说明

Endpoint

选择登录的访问域名。

  • 默认(公共云):使用目标Bucket所在地域对应的Endpoint登录。选择此种登录方式时,可选中HTTPS加密对传输过程加密。

    重要

    对于不支持通过该方式访问的地域,需选择自定义的登录方式。

  • 自定义:使用自定义Endpoint的方式登录。示例值为http(s)://oss-cn-wulanchabu.aliyuncs.com。选择此种登录方式时,可使用公共云下OSS的任意Endpoint。有关Region与Endpoint的对应关系,请参见访问域名和数据中心

    说明

    如果未使用内网Endpoint发送请求,默认会产生公网流量,公网流量涉及流量费用。更多信息,请参见流量费用

  • cname:如果您希望通过自有域名访问OSS资源,请先绑定自有域名。具体操作,请参见绑定自定义域名。然后选择此项,填写绑定的自有域名。

AccessKeyIdAccessKeySecret

填写账号的AccessKey(AK)信息。获取AK的方式,请参见创建AccessKey

重要

为保证数据安全,推荐您使用RAM用户的AK登录ossbrowser。使用RAM用户登录之前,需要为RAM用户配置AliyunOSSFullAccessAliyunRAMFullAccess以及AliyunSTSAssumeRoleAccess的权限。具体操作请参见权限管理

预设OSS路径

如果当前账号仅拥有某个Bucket或Bucket下某个路径的权限,需填写预设OSS路径。

预设OSS路径格式为oss://bucketname/path。例如授权访问存储空间examplebucket下文件夹examplefolder下的文件或子文件夹,则填写oss://examplebucket/examplefolder/

当授权访问的Bucket开启了请求者付费模式,且您不是该Bucket拥有者的情况下,需选中请求者付费模式。否则,访问预设OSS路径下的指定资源时会报错AccessDenied。选中请求者付费模式后可正常访问预设OSS路径下的指定资源,且访问该Bucket产生的流量、请求次数等费用将由您支付。有关请求者付费模式的更多信息,请参见开启请求者付费模式

区域

当Endpoint配置为默认(公共云)时,需填写预设OSS路径对应Bucket所在的区域

保持登录

选中后,ossbrowser会保持登录状态,下次打开时将自动登录。

记住密钥

选中可保存AK密钥。再次登录时,单击AK历史,可选择指定密钥直接登录。

警告

为避免不必要的信息安全风险,请勿在临时使用的电脑上选中该项。

通过STS登录

如果您需要给子用户临时授权登录ossbrowser访问Bucket列表,可以通过STS服务给用户颁发一个临时访问凭证。该用户可使用临时访问凭证在规定时间内登录ossbrowser,访问您的OSS资源。临时访问凭证无需透露您的长期密钥,使您的OSS资源访问更加安全。登录成功后,您可以管理账号中的Bucket。

image

通过STS登录时,需按如下说明完成各配置项。

参数

说明

Endpoint

选择登录的访问域名。

  • 默认(公共云):使用目标Bucket所在地域对应的Endpoint登录。选择此种登录方式时,可选中HTTPS加密对传输过程加密。

    重要

    对于不支持通过该方式访问的地域,需选择自定义的登录方式。

  • 自定义:使用自定义Endpoint的方式登录。示例值为http(s)://oss-cn-wulanchabu.aliyuncs.com。选择此种登录方式时,可使用公共云下OSS的任意Endpoint。有关Region与Endpoint的对应关系,请参见访问域名和数据中心

    说明

    如果未使用内网Endpoint发送请求,默认会产生公网流量,公网流量涉及流量费用。更多信息,请参见流量费用

  • cname:如果您希望通过自有域名访问OSS资源,请先绑定自有域名。具体操作,请参见绑定自定义域名。然后选择此项,填写绑定的自有域名。

AccessKeyIdAccessKeySecretSTS Token

填写STS临时访问凭证,即AccessKey和STS Token信息。获取方式,请参见步骤五:使用RAM用户扮演RAM角色获取临时访问凭证

说明

只有当AccessKeyIdSTS.XXX格式时,才需要输入STS Token

预设OSS路径

如果当前账号仅拥有某个Bucket或Bucket下某个路径的权限,需填写预设OSS路径。

预设OSS路径格式为oss://bucketname/path。例如授权访问存储空间examplebucket下文件夹examplefolder下的文件或子文件夹,则填写oss://examplebucket/examplefolder/

当授权访问的Bucket开启了请求者付费模式,且您不是该Bucket拥有者的情况下,需选中请求者付费模式。否则,访问预设OSS路径下的指定资源时会报错AccessDenied。选中请求者付费模式后可正常访问预设OSS路径下的指定资源,且访问该Bucket产生的流量、请求次数等费用将由您支付。有关请求者付费模式的更多信息,请参见开启请求者付费模式

区域

当Endpoint配置为默认(公共云)时,需填写预设OSS路径对应Bucket所在的区域

保持登录

选中后,ossbrowser会保持登录状态,下次打开时将自动登录。

记住密钥

选中可保存AK密钥。再次登录时,单击AK历史,可选择指定密钥直接登录。

警告

为避免不必要的信息安全风险,请勿在临时使用的电脑上选中该项。

通过授权码登录

如果您需要授权用户临时访问Bucket中的某个目录,可以使用临时授权码登录ossbrowser。您可以将临时授权码提供给相应的人员,允许其在授权码到期前,临时访问您Bucket下某个目录。到期后,临时授权码会自动失效。登录成功后,您可以访问Bucket下某个目录。

  1. 使用AccessKey登录ossbrowser。

    更多信息,请参见创建AccessKey

  2. 单击目标Bucket名称。

  3. 勾选需要临时授权的目录,单击更多 > 生成授权码

    重要

    仅目录支持生成授权码。

  4. 设置权限、有效时长、角色,然后单击确定生成

  5. 单击点击复制,获取生成的授权码。

  6. 退出登录,并使用授权码登录ossbrowser,如下图所示。

相关文档