ossfs allows you to mount an Object Storage Service (OSS) bucket to a local directory on the Linux operating system. This enables you to manage data in the bucket in the same way you manage local files.
Version upgrade
If you are developing AI training, inference, autonomous driving simulation, or other new applications and cannot use the OSS SDK and OSS Connector for AI/ML, we recommend that you use ossfs 2.0 (Preview).
ossfs 2.0 has the following features:
Provides basic POSIX compatibility and focuses on leveraging the server-side read and write capabilities of OSS.
Delivers efficient sequential read and write capabilities for large files through end-to-end read and write link optimization.
Offers efficient concurrent loading capabilities for small files through effective metadata management.
Introduction to ossfs
ossfs is a Filesystem in Userspace (FUSE) based file system that allows you to mount an OSS bucket to a local directory on the Linux operating system and supports the following features:
Support for most features described in Portable Operating System Interface (POSIX) standards, such as file and directory uploads and downloads, and user permissions.
Uses multipart upload and resumable upload provided by OSS to upload objects by default.
Supports MD5 verification to ensure data integrity.
Supported environments
ossfs is a FUSE-based file system and works only on FUSE-compatible machines. ossfs provides installation packages for Ubuntu and CentOS. To run ossfs in other environments, you need to use the source code to build the required program.
Linux operating system
CentOS 7.0 or later.
Ubuntu 14.04 or later.
Anolis7 or later.
FUSE 2.8.4 or later
You can run the
fusermount -Vcommand to check the version of FUSE. If the value of the fusermount version parameter in the response is 2.8.4 or later, such as 2.9.2, the version of FUSE meets the requirements.
Limits
The following limits apply when you use ossfs to mount a bucket to a local directory on the Linux operating system:
ossfs is not suitable for scenarios that require highly concurrent read and write operations.
NoteBoth read and write operations consume disk capacity. In highly concurrent read/write scenarios, disk performance limits read and write operations.
Concurrent read and write requests compete for resources, which affects bandwidth.
ossfs does not support hard links.
Archive, Cold Archive, and Deep Cold Archive buckets cannot be mounted to local file systems by using ossfs.
If you use ossfs to edit an uploaded object, the object is re-uploaded.
Metadata operations, such as
list directory, have poor performance because they require remote access to OSS servers.Errors may occur if you rename an object or a directory. Operation failures may cause data inconsistencies.
If a bucket is mounted to multiple clients and data is simultaneously written to the mount points, ossfs does not guarantee consistency.
Make sure that your AccessKey pair has all permissions on the resources related to the target bucket or target prefix. Insufficient permissions may cause the mount target to be unavailable and other potential issues.
What to do next
Before you use ossfs to mount an OSS bucket to a local directory on the Linux operating system, you need to install ossfs 1.0 and configure ossfs 1.0. After you install and configure ossfs, you can mount a bucket to a local directory on the Linux operating system.