在Windows macOS和Linux上下载并安装ossbrowser 2.0-对象存储-阿里云-对象存储(OSS)-阿里云帮助中心

本文为您介绍在Windows、macOS以及Linux系统上如何安装ossbrowser 2.0。

重要

Windows系统仅支持Windows 7及以上版本包括Windows Server。
Linux x64发行版本众多，需要安装图形界面依赖文件，因此不推荐使用。建议您在Windows或macOS上使用ossbrowser 2.0。

Windows系统

单击下载Windows x86-64安装包。
双击运行下载安装包，选择安装目录后点击安装。
在桌面找到oss-browser2应用程序双击运行打开。打开后显示 AK 登录界面，支持 AK登录、账号登录、授权码登录 三种方式。AK 登录需填写以下信息：
- AccessKeyID：必填，可直接输入或从历史记录中选择。
- AccessKeySecret：必填，支持切换密码可见性。
- Endpoint：默认为外网域名，可勾选使用 HTTPS。
- 预设OSS路径：可选填 Bucket 和文件前缀。
底部可勾选保持登录和记录会话，完成后单击登录。

macOS系统

打开命令行窗口执行uname -m查看系统架构（以 arm64 架构为例）。
请根据您的系统架构下载对应的安装包：
- x86_64架构：macOS x86-64安装包。
- arm64架构：macOS arm64安装包。
双击打开安装包。
根据提示将oss-browser2.app拖动到Applications文件夹。
打开启动台，找到oss-browser2应用程序双击运行打开。
1. 提示有风险，依然单击打开。
2. 打开后显示 AK登录 界面，包含以下配置项：
  - AccessKeyID：输入或选择 AccessKey ID。
  - AccessKeySecret：输入 AccessKey Secret。
  - Endpoint：选择端点类型（默认为外网域名），可勾选使用 HTTPS。
  - 预设OSS路径：以 oss:// 为前缀，可选填 Bucket 名称和文件前缀。
  - 可勾选保持登录和记录会话，然后单击登录。

Linux系统

重要

root用户无法运行ossbrowser 2.0，请使用非root用户登录系统来使用ossbrowser 2.0。

以下示例以Ubuntu 22.04版本为例。

安装图形界面。
请执行以下命令安装图形界面。其他Linux系统发行版安装图形界面，请参见为Linux实例安装图形化界面。
```
sudo apt-get update
sudo apt-get install ubuntu-desktop
reboot
```
使用非root用户登录系统。
使用ECS实例安装完图形界面后，需重启系统通过VNC远程连接的方式进入系统图形界面。在弹出的通过VNC远程连接对话框中，单击立即登录。

下载安装包。

wget https://gosspublic.alicdn.com/oss-browser2-prod/2.2.0/oss-browser2-linux-x86_64-2.2.0.AppImage

安装ossbrowser 2.0。
1. 右键单击下载的安装包，点击Properties。
2. 单击Permissions勾选Execute开关，允许将该文件作为程序执行。
3. 双击打开 ossbrowser 2.0 软件包，打开后显示登录界面，包含三个登录方式页签：AK登录、账号登录、授权码登录。选择AK登录后需填写 AccessKeyID、AccessKeySecret，并选择 Endpoint（默认为外网域名，可勾选使用 HTTPS）。还可配置预设 OSS 路径（Bucket 和文件前缀），以及勾选保持登录和记录会话。

常见问题

Ubuntu 22.04系统无法正常启动ossbrowser 2.0

问题：若您在启动 ossbrowser 2.0 时遇到以下报错信息，通常是由于 AppImage 应用里的 Chromium 沙箱需要特定权限才能正常运行，而当前用户未具备此权限。

xxx@iZxxx:~/Desktop$ ./oss-browser2-linux-x86_64-xxx.AppImage
[7849:0709/103133.830504:FATAL:setuid_sandbox_host.cc(157)] The SUID sandbox helper binary was found, but is not configured correctly. Rather than run without sandboxing I'm aborting now.
You need to make sure that /tmp/.mount_oss-brQeJ8RW/chrome-sandbox is owned by root and has mode 4755.
Trace/breakpoint trap (core dumped)

解决方案：您可以评估并安装AppImageLauncher工具，之后再次启动ossbrowser 2.0时，该工具会自动解决AppImage应用相关的权限和依赖问题。具体的下载与安装步骤如下。

#下载AppImageLauncher工具
sudo wget https://github.com/TheAssassin/AppImageLauncher/releases/download/v2.2.0/appimagelauncher_2.2.0-travis995.0f91801.bionic_amd64.deb

#安装AppImageLauncher工具
sudo apt install ./appimagelauncher_2.2.0-travis995.0f91801.bionic_amd64.deb

后续步骤

登录ossbrowser 2.0以及相关配置项说明，请参见登录ossbrowser 2.0。