Object Storage Service:FAQ

"AccessDenied: You are forbidden to list buckets" when logging in

This error indicates that your Alibaba Cloud account or RAM user lacks the permission to list all buckets. To resolve this issue:

1. Grant the missing permission. Add the oss:ListBuckets permission to the account or RAM user, then log in again. For details, see Grant permissions to a RAM user.

2. Scope access to a specific bucket or object. If the account only has access to certain resources, set Preset OSS Path to the bucket or object path and set Region to the bucket's region when logging in. For details, see Install ossbrowser 1.0.

Slow uploads or downloads with large numbers of objects

By default, ossbrowser runs up to 3 concurrent upload or download tasks. Additional tasks wait in a queue, which slows down bulk transfers.

To increase throughput:

1. On the ossbrowser homepage, click Settings in the top navigation bar.

2. In the Settings dialog box, increase Upload tasks concurrent number and Download tasks concurrent number.

The maximum effective concurrency depends on your hardware (CPU, memory, and network bandwidth). Adjust and test incrementally to find the optimal value for your setup.

ossbrowser does not launch on macOS

1. Decompress the downloaded installation package.

2. Copy oss-browser.app to the Applications directory.

3. In the Applications directory, right-click the oss-browser icon and click Open.

Do not double-click to open. Right-clicking and selecting Open bypasses the macOS security prompt for unsigned apps.

"Developer cannot be verified" error on macOS

If macOS blocks ossbrowser because it is not from an identified developer:

1. Open System Preferences > Security & Privacy.

2. In the Allow apps downloaded from section, select App Store and identified developers.

3. Click Open Anyway next to the message "oss-browser" was blocked from opening because it is not from an identified developer.

4. In the dialog box that appears, click Open.

ossbrowser fails to start after installing other software on Windows

Some software adds a NODE_OPTIONS=--max-http-header-size=value environment variable to Windows, which prevents ossbrowser from starting. Delete this variable to fix the issue.

On 64-bit Windows 10:

1. Open Control Panel > System and Security > System.

2. Click Advanced system settings in the left-side navigation pane.

3. On the Advanced tab of the System Properties dialog box, click Environment Variables.

4. In the User Variables list, select NODE_OPTIONS=--max-http-header-size=_value_ and click Delete.

5. Click OK.

ossbrowser starts normally after the variable is removed.

How do I enable the debugging mode?

Two ways to open the debugging panel:

• Quick method: Click the OSS Browser logo in the upper-left corner 10 consecutive times to open the debugging panel.

• From settings: Open the Settings dialog box and click Open debug to go to the debugging panel.

Log file locations

To collect operation logs, turn on Local log on the Settings page. By default, only error logs are collected.

Log file paths by operating system:

To collect informational logs in addition to error logs, turn on local info file log in Settings.

ossbrowser cannot connect due to network issues

This is typically caused by an incorrect proxy configuration or a proxy that cannot reach the internet. Check the proxy settings on your operating system:

"Being added to the upload queue" message for .asar files

ossbrowser does not support uploading .asar files. To upload .asar files to OSS, use an alternative method such as ossutil or the OSS API.

Does ossbrowser support MD5 verification?

No. ossbrowser uses CRC-64 for data integrity verification by default. MD5 verification is not supported.

Am I charged for downloading objects through ossbrowser?

Yes. Downloading objects through ossbrowser generates outbound traffic over the internet, which incurs traffic fees. ossbrowser itself does not add extra costs beyond standard OSS traffic charges.

For pricing details, see Traffic fees.