Get started with ossbrowser 2.0-Object Storage Service(OSS)-阿里云帮助中心

ossbrowser 2.0 is a free desktop client for managing Object Storage Service (OSS) on Windows, macOS, and Linux. Upload, download, delete, and manage objects through an intuitive local GUI. ossbrowser 2.0 runs locally on your device to ensure smooth performance.

Operation video

Watch this video to learn how to use ossbrowser 2.0.

Prerequisites

Manage objects

ossbrowser 2.0 supports object-level operations similar to those in the OSS console. To manage objects, click a bucket name to go to the object list page and follow the UI instructions.

Actions	Description
Upload an object	By default, ossbrowser 2.0 uses multipart upload and resumable upload. You can upload objects up to 48.8 TB. If an upload is interrupted and not resumed, the uploaded data is stored as parts in the bucket. We recommend that you delete unneeded parts to avoid storage fees. To manually delete parts, click Parts at the top of the page. In the dialog box, select the parts to delete and click Delete Selected. Use a lifecycle rule to automatically delete parts. For more information, see Configure a lifecycle rule based on the last modified time. Important Uploading an object with the same name as an existing object overwrites the existing object.
Upload a folder	At the top of the page, click Upload and select Upload Folder from the drop-down list. Note A single upload task can include a maximum of 100,000 objects in a folder and its subfolders. Exceeding this limit reports the `files and folders hit limit=100000` error and causes the upload to fail.
Download an object	Select an object and click Download at the top of the page. Note You can also select multiple objects and click Download to download them in a batch. You can submit up to 15 batch download tasks at the same time. If you exceed this limit, an `ExceedLimitError` is reported and only some of the selected objects are downloaded. To download a large number of objects, run `ossutil cp -r` and specify the checkpoint information directory by using `--checkpoint-dir` for resumable downloads. For installation and command information, see Install ossutil and cp (upload, download, and copy objects).
Download a folder	Select a folder and click Download at the top of the page.
List objects	Click a bucket name to list the objects in the bucket. For folders, the File Size column displays Not counted. ossbrowser does not support displaying the size, storage class, or last modified time of folders. To view the size of a folder, use one of the following methods: OSS console: On the object list page of the bucket, click the refresh icon in the File Size column of the folder row to run a directory statistics operation. ossutil: Run the `ossutil du oss://bucket-name/folder-path/` command.
Preview an object	Click an object name to preview it. You can preview and edit text objects up to 100 MB in size. Note You can preview and edit most text objects online, including but not limited to objects with file extensions such as`.java`,`.js`,`.go`,`.php`,`.py`,`.json`,`.html`,`.csv`,`.txt`,`.xml`, and`.yml`.
Copy an object	Select an object, click More > Copy To, select a destination path, and then click Copy > Confirm Copy. Important You can copy objects up to 5 GB. To copy objects larger than 5 GB, we recommend that you use the ossutil 2.0 CLI. Interrupted batch copy tasks cannot be resumed.
Move an object	Select an object, click More > Move To, select a destination path, and then click Move > Confirm Move. Important A move operation copies the source object to the destination and then deletes the source object. Note the following: You can move objects up to 5 GB. To move objects larger than 5 GB, we recommend that you use the ossutil 2.0 CLI to copy the objects and then delete the source objects. If the copy succeeds but the source object deletion fails (for example, due to insufficient permissions), both the source and destination objects are retained. Interrupted batch move tasks cannot be resumed.
Rename an object	Select the target object, click the icon on the right, select Rename, modify the name, and then click Confirm. Important A rename operation copies the object under a new name and then deletes the original object. Note the following: If the copy succeeds but the original object deletion fails (for example, due to insufficient permissions), both the original and renamed objects are retained. Interrupted folder rename tasks cannot be resumed.
Search for objects	In the search box at the top of the page, enter an object name prefix to find matching objects and folders in the bucket's root directory.
Restore an object	Select the target object and click More > Restore.
Delete an object	Select the target file, and click More > Delete.
Set a symbolic link	Select the target object, click the icon on the right, and select Configure Symbolic Link. In the Configure Symbolic Link panel, specify the Symbolic Link File or Folder, and then click OK.
Set object metadata	Select the target object, click the icon on the right, and select Set Object Metadata. In the Set Metadata panel, set the object metadata and then click OK.
Share an object	You can share an object's URL with third parties for download or preview. Select the target object, click the icon on the right, and select Obtain URL. Specify a validity period for the URL and click Generate.
Set ACL	Select the target object, click the icon on the right, and select Set ACL. In the dialog box that appears, select an ACL and click OK.