All Products
Search
Document Center

Object Storage Service:ossfs 2.0 overview

Last Updated:Oct 31, 2025

ossfs 2.0 is a client that mounts Object Storage Service (OSS) buckets to provide high-performance access. It delivers excellent sequential read and write performance by fully leveraging the high bandwidth of OSS.

Performance improvements

ossfs 2.0 offers significant performance improvements over ossfs 1.0 in sequential read and write operations and high-concurrency small file reads. For more information about the performance of ossfs 2.0, see Performance Testing.

  • Sequential write performance: For single-threaded sequential writes of large files, ossfs 2.0 provides nearly 18× the bandwidth of ossfs 1.0.

  • Sequential read performance

    • For single-threaded sequential reads of large files, ossfs 2.0 provides about 8.5× the bandwidth of ossfs 1.0.

    • For multi-threaded (4 threads) sequential reads of large files, ossfs 2.0 provides more than the bandwidth of ossfs 1.0.

  • Concurrent small file read performance: For high-concurrency (128 threads) reads of small files, ossfs 2.0 provides more than 280× the bandwidth of ossfs 1.0.

Scenarios

ossfs 2.0 is ideal for scenarios that demand high storage access performance, such as AI training, inference, big data processing, and autonomous driving. These compute-intensive workloads primarily involve sequential and random reads, sequential writes (append-only), and do not depend on full POSIX semantics.

Operating environment

ossfs 2.0 is developed based on Filesystem in Userspace (FUSE).

Operating system

System version

System architecture

Kernel version

Download link

CentOS

CentOS 7 series

x86_64

3.10

ossfs2_2.0.4_linux_x86_64.rpm

CentOS 8 series

x86_64

4.18

Alibaba Cloud Linux

Alibaba Cloud Linux 2 series

x86_64

4.19

Alibaba Cloud Linux 3 series

x86_64

5.10

aarch64

5.10

ossfs2_2.0.4_linux_aarch64.rpm

Ubuntu

Ubuntu 20.04

x86_64

5.4

ossfs2_2.0.4_linux_x86_64.deb

Ubuntu 22.04

x86_64

5.15

Ubuntu 24.04

x86_64

6.8

Limits

  • Permissions: Ensure the AccessKey has full permissions for the resources in the target bucket or prefix. Otherwise, mounting may fail or features may not work correctly.

  • Storage class: Mounting buckets of the Archive Storage, Cold Archive, or Deep Cold Archive storage classes is not supported.

  • File name length: The maximum file name length is 255 characters, which complies with the Linux limit. Files or directories in OSS that exceed this limit are not visible in the mount target.

  • File reads: A newly written file is uploaded to OSS only after it is closed. An error may occur if you read a file that is being written but has not yet been closed.

  • File writes: Random writes and concurrent writes to the same file are not supported. The default write shard size is 8,388,608 bytes (8 MiB), which supports a maximum file size of 83,886,080,000 bytes (78.125 GiB). The shard size can be configured with the upload_buffer_size mount option.

  • File rename operations (non-atomic)

    • File: Deletes the remote file after a successful copy.

    • Directories: A rename operation first copies all files in the directory, and then deletes the original source files in a batch operation. By default, the number of descendant files is limited to 2 million when a directory is renamed. This limit can be configured with the rename_dir_limit mount option.

  • Concurrent write consistency: Data consistency is not guaranteed when multiple clients mount the same bucket and concurrently write to the same file.

  • POSIX API compatibility: Partially compatible. For more information, see POSIX API support.

Features

Features

  • Offers basic POSIX compatibility with a focus on the server-side read and write capabilities of OSS.

  • Delivers high-efficiency sequential read and write performance for large files through end-to-end path optimization.

  • Enables high-efficiency concurrent loading of small files through effective metadata management.

POSIX API support

The following table compares the support for common POSIX APIs in ossfs 1.0 and ossfs 2.0.

Category

Operation/Feature

ossfs 1.0

ossfs 2.0

Basic file operations

open

Supported

Support

flush

Supported

Supported

close

Supported

Supported

File read/write

read

Support

Support

write

Supports random writes (requires disk cache configuration)

Supports sequential writes only (no disk cache required)

truncate

Supported (file size can be adjusted)

Supports clearing file content only

File metadata operations

create

Supported

Supported

unlink

Supported

Supported

rename

Supported

Support

Directory operations

mkdir

Supported

Supported

readdir

Support

Supported

rmdir

Supported

Supported

Permissions and properties

getattr

Supported

Supported

chmod

Supported

Supported (The operation does not report an error, but the setting has no effect)

chown

Supported

Supported (The operation does not report an error, but the setting has no effect)

utimes

Supported

Supported

Extended features

setxattr

Supported

Not supported

symlink

Supported

Not supported

lock

Not supported

Not supported

Next steps