ossbrowser is a graphical management tool developed by Alibaba Cloud. This tool provides features that are similar to the features of Windows Explorer. This topic describes how to install and log on to ossbrowser.
Versions
In this topic, the latest ossbrowser version 1.16.0 is used as an example. For more information about all versions of ossbrowser, see all-releases.md.
Download URLs
Windows x32
oss-browser-win32-ia32.zip- Only Windows 7 and later are supported.
- If ossbrowser does not run as expected after it is installed, you can refer to What do I do if I cannot run ossbrowser after I install a piece of software on Windows? to resolve the issue.
- We recommend that you do not install ossbrowser on Windows Server. If compatibility issues occur when you install ossbrowser on Windows Server, build your source code to resolve the issues. For more information, see https://github.com/aliyun/oss-browser.
Windows x64
oss-browser-win32-x64.zip- Only Windows 7 and later are supported.
- If ossbrowser does not run as expected after it is installed, you can refer to What do I do if I cannot run ossbrowser after I install a piece of software on Windows? to resolve the issue.
- We recommend that you do not install ossbrowser on Windows Server. If compatibility issues occur when you install ossbrowser on Windows Server, build your source code to resolve the issues. For more information, see https://github.com/aliyun/oss-browser.
macOS
oss-browser-darwin-x64.zipLinux x64
oss-browser-linux-x64.zip- We recommend that you do not use ossbrowser on Linux x64. We recommend that you use ossbrowser on Windows or macOS. Linux x64 has many distributions. You need to install the GUI and various dependency files to run ossbrowser. In this topic, distributions such as CentOS 7, CentOS 8, and Ubuntu 14 are used as examples to describe how to install ossbrowser on Linux x64.
- If issues occur when you install ossbrowser on Linux x64, download the source code from GitHub and compile the code to resolve the issues.
Step 1: Install ossbrowser
Windows x32
- Download the Windows x32 package.
- Decompress the package.
- In the oss-browser-win32-ia32 directory, double-click oss-browser.exe to run ossbrowser.
Windows x64
- Download the Windows x64 package.
- Decompress the package.
- In the oss-browser-win32-x64 directory, double-click oss-browser.exe to open ossbrowser.
macOS
- Download the macOS package.
- Decompress the package.
- In the oss-browser-darwin-x64 directory, right-click oss-browser.app and select Open.
- In the dialog box that appears, click Open.
- In the dialog box that appears, click Allow.
CentOS 7
- Install the GUI.
For more information about how to install the GUI for CentOS 7, see Installing a graphical desktop environment for a Linux instance.
- Install dependency files.
- Run the following command to update the YUM repository:
sudo yum update
- Run the following command to install the dependency file named libgtk-x11-2.0.so.0:
sudo yum install gtk2-2.24.31-1.el7.x86_64
- Run the following command to install the dependency file named libXtst.so.6:
sudo yum install libXtst-1.2.3-1.el7.x86_64
- Run the following command to install the dependency file named libXss.so.1:
sudo yum install libXScrnSaver-1.2.2-6.1.el7.x86_64
- Run the following command to install the dependency file named libgconf-2.so.4:
sudo yum install GConf2-3.2.6-8.el7.x86_64
- Run the following command to update the YUM repository:
- Install ossbrowser.
- Run the following command to download the CentOS 7 package:
sudo wget https://gosspublic.alicdn.com/oss-browser/1.16.0/oss-browser-linux-x64.zip
- Run the following command to decompress the package:
sudo unzip oss-browser-linux-x64.zip
- Run the following command to go to the oss-browser-linux-x64 directory:
sudo cd oss-browser-linux-x64/
- Run the following command to run ossbrowser:
sudo ./oss-browser
- Run the following command to download the CentOS 7 package:
CentOS 8
- Install the GUI.
For more information about how to install the GUI for CentOS 8, see Installing a graphical desktop environment for a Linux instance.
- Install dependency files.
- Run the following command to update the YUM repository:
sudo yum update
- Run the following command to install the dependency file named libgtk-x11-2.0.so.0:
sudo yum install gtk2-2.24.32-5.el8.x86_64
- Run the following command to install the dependency file named libX11-xcb.so.1:
sudo yum install libX11-xcb-1.6.8-5.el8.x86_64
- Run the following command to install the dependency file named libXtst.so.6:
sudo yum install libXtst-1.2.3-7.el8.x86_64
- Run the following command to install the dependency file named libXss.so.1:
sudo yum install libXScrnSaver-1.2.3-1.el8.x86_64
- Run the following command to install the dependency file named libgconf-2.so.4:
sudo yum install GConf2-3.2.6-22.el8.x86_64
- Run the following command to install the dependency file named libasound.so.2:
sudo yum install alsa-lib-1.2.5-4.el8.x86_64
- Run the following command to update the YUM repository:
- Install ossbrowser.
- Run the following command to download the CentOS 8 package:
sudo wget https://gosspublic.alicdn.com/oss-browser/1.16.0/oss-browser-linux-x64.zip
- Run the following command to decompress the package:
sudo unzip oss-browser-linux-x64.zip
- Run the following command to go to the oss-browser-linux-x64 directory:
sudo cd oss-browser-linux-x64/
- Run the following command to run ossbrowser:
sudo ./oss-browser
- Run the following command to download the CentOS 8 package:
Ubuntu 14
- Install the GUI.
For more information about how to install the GUI for Ubuntu 14, see Installing a graphical desktop environment for a Linux instance.
- Install dependency files.
- Run the following command to update the APT repository:
sudo apt update
- Run the following command to install the dependency file named libgtk-x11-2.0.so.0:
sudo apt install libgtk2.0-0
- Run the following command to install the dependency file named libX11-xcb.so.1:
sudo apt install libx11-xcb-dev
- Run the following command to install the dependency file named libXtst.so.6:
sudo apt install libxtst6
- Run the following command to install the dependency file named libXss.so.1:
sudo apt install libxss1
- Run the following command to install the dependency file named libgconf-2.so.4:
sudo apt install libgconf-2-4
- Run the following command to install the dependency file named libasound.so.2:
sudo apt install libasound2
- Run the following command to update the APT repository:
- Install ossbrowser.
- Run the following command to download the Ubuntu package:
sudo wget https://gosspublic.alicdn.com/oss-browser/1.16.0/oss-browser-linux-x64.zip
- Run the following command to decompress the package:
sudo unzip oss-browser-linux-x64.zip
- Run the following command to go to the oss-browser-linux-x64 directory:
sudo cd oss-browser-linux-x64/
- Run the following command to run ossbrowser:
sudo ./oss-browser
- Run the following command to download the Ubuntu package:
Step 2: Log on to ossbrowser
Log on to ossbrowser by using an AccessKey pair
If you want to access specific resources in your bucket for a long period of time, you can use the AccessKey pair of an Alibaba Cloud account or a RAM user to log on to ossbrowser.

The following table describes the parameters that you can configure when you log on to ossbrowser by using an AccessKey pair.
Parameter | Description |
---|---|
Endpoint | The endpoint of the region in which the bucket that you want to access is located.
|
AccessKeyId and AccessKeySecret | Enter the AccessKey pair of your account. For more information about how to obtain the AccessKey pair of an Alibaba Cloud account or a RAM user, see Obtain an AccessKey pair. Important To ensure data security, we recommend that you log on to ossbrowser by using the AccessKey pair of a RAM user. Before you use the AccessKey pair of a RAM user to log on to ossbrowser, you must grant the following permissions to the RAM user: AliyunOSSFullAccess , AliyunRAMFullAccess , and AliyunSTSAssumeRoleAccess . For more information, see Permission management. |
Preset OSS Path | If the current account has permissions to access only a specific bucket or a specific path in a bucket, you must specify this parameter in the following format: Format: oss://bucketname/path For example, if you are authorized to access only objects or subdirectories in the examplefolder directory of a bucket named examplebucket, enter oss://examplebucket/examplefolder/. If the pay-by-requester feature is enabled for the bucket that you are authorized to access, and you are not the bucket owner, select request payer. Otherwise, the |
Region | If you select Default (Public Cloud) for Endpoint, you must specify the region of the bucket in which the resources in the path specified by Preset OSS Path are stored. |
Keep me logged in | If you select this option, you remain logged on next time you start ossbrowser. |
Remember | If you select this option, your AccessKey pair used to log on to ossbrowser is remembered. The next time you log on to ossbrowser, click AK Histories and select the remembered AccessKey pair instead of entering the AccessKey pair again. Warning To ensure security, we recommend that you do not select this option if you use a shared computer. |
Log on to ossbrowser by using an authorization code
To authorize other users to temporarily access specific resources in your buckets, you can generate an authorization code that the users can use to log on to ossbrowser. The authorization code becomes invalid after it expires.
- Log on to ossbrowser as an administrator RAM user. Important When you log on to ossbrowser by using your Alibaba Cloud account or as an administrator RAM user, some of the features are inaccessible for data security reasons. We recommend that you use the AccessKey pair of an administrator RAM user to log on to ossbrowser and generate an authorization code. The administrator RAM user must have the bucket or directory management permissions and must be granted the AliyunRAMFullAccess permission and the AliyunSTSAssumeRoleAccess permission.
- Select the objects or directories to be temporarily accessed by the authorized users, and choose
- Save the generated authorization code.
- Log out of ossbrowser, and then use the authorization code to log on to ossbrowser.