All Products
Search
Document Center

Object Storage Service:Get started with ossbrowser 2.0

Last Updated:Mar 20, 2026

ossbrowser 2.0 is a free graphical desktop client for managing Object Storage Service (OSS). It runs on Windows, macOS, and Linux, and provides an intuitive GUI for uploading, downloading, and managing objects without writing code. ossbrowser 2.0 runs locally on your device to ensure smooth performance.

Prerequisites

Before you begin, ensure that you have:

Manage objects

Click a bucket name to open the object list. The following sections describe the available operations.

Upload an object

ossbrowser 2.0 uses multipart upload and resumable upload by default, supporting objects up to 48.8 TB.

Important

If an uploaded object has the same name as an existing object in the bucket, the existing object is overwritten.

If an upload is interrupted and not resumed, the unfinished parts remain in the bucket and incur storage costs. To remove them:

Upload a directory

Click Upload at the top of the page and select Upload Directory from the drop-down list.

Important

A single upload supports up to 100,000 objects, including files in subdirectories. If the limit is exceeded, the upload fails with the error: files and folders hit limit=100000.

Download an object or directory

  • To download one or more objects, select them and click Download.

  • To download a directory, select the folder and click Download.

Preview and edit an object

Click an object name to preview it. Objects up to 100 MB can be previewed and edited directly in ossbrowser 2.0.

Supported file types for inline preview and editing: .java, .js, .go, .php, .py, .json, .html, .csv, .txt, .xml, and .yml.

Copy an object

  1. Select an object and choose More > Copy To.

  2. Select the destination.

  3. Click Copy > Confirm Copy.

Important
  • The maximum object size for copying is 5 GB. For larger objects, use ossutil.

  • If a batch copy is interrupted, the tool cannot resume the task.

Move an object

Moving copies the object to the destination and then deletes the source.

  1. Select an object and choose More > Move To.

  2. Select the destination.

  3. Click Move > Confirm Move.

Important
  • The maximum object size for moving is 5 GB. For larger objects, use ossutil to copy the object, then delete the source.

  • If the copy step fails, the source object is not deleted.

  • If the copy succeeds but the delete fails (for example, due to insufficient permissions), both the source and destination objects are retained.

  • If a batch move is interrupted, the tool cannot resume the task.

Rename an object

Renaming copies the object under the new name and then deletes the original.

  1. Select the object and click the image icon.

  2. Select Rename, enter a name, and click Confirm.

Important
  • If the copy step fails, the source object is not deleted.

  • If the copy succeeds but the delete fails (for example, due to insufficient permissions), both the source and destination objects are retained.

  • If a folder rename is interrupted, the tool cannot resume the task.

Search for objects

Enter a prefix in the search box to filter objects and folders in the root directory.

Restore an object

Select the object and choose More > Restore.

Delete an object

Select the object and choose More > Delete.

Set a symbolic link

  1. Select the object and click the image icon.

  2. Select Set Symbolic Link.

  3. In the Set Symbolic Link panel, set Object to Which Symbolic Link Points (Full Path) and click OK.

Set object metadata

  1. Select the object and click the image icon.

  2. Select Set Metadata.

  3. In the Set Metadata panel, configure the metadata and click OK.

Share an object

Share an object URL with others for downloading or previewing.

  1. Select the object and click the image icon.

  2. Select Obtain URL.

  3. Set a validity period, click Generate, and copy the URL.

Set object ACL

  1. Select the object and click the image icon.

  2. Select Set ACL.

  3. In the dialog box, select an access control list (ACL) and click OK.