Updated on 2026-07-29 GMT+08:00

Introduction to obsfs

obsfs is an OBS file system tool built on Filesystem in Userspace (FUSE). It allows you to mount an OBS parallel file system to Linux, so that you can access the practically unlimited storage of OBS as if it were a local file system.

obsfs is a great option if you are used to storing data locally but your data is now stored in OBS.

Functions

  • obsfs lets you mount an OBS parallel file system to your local Linux file system, so that you can manage objects stored in OBS as if they were stored locally.
  • obsfs synchronously uploads any incremental file from the local mount directory to OBS.
  • obsfs synchronizes objects from an OBS parallel file system to its mount directory in the local file system, so that you can copy, modify, rename, or truncate objects locally. Parallel file systems provide more powerful file semantics and allow you to directly operate remote files.

Constraints

  • The local directory used as the mount point does not need to be empty. After the mount, any existing files in that directory will become temporarily unavailable. However, those files will reappear after the unmount. You are advised to use an empty directory as the mount point.
  • If obsfs is used to mount a parallel file system, bucket policies and IAM policies configured for the parallel file system take effect, but those configured for directories do not take effect.

Applicable Operating Systems

obsfs is compatible with Linux. An installation package can be downloaded directly, or you can compile it from the source code. For details, see Table 1.

To better support concurrent access, you are advised to use the latest version of obsfs, either by installing it or upgrading your current version. For details about how to obtain the latest version, see Table 1.

Table 1 Obtaining obsfs

Method

Description

Compatible Distributions

Operation Guideline

Download

Download and install the official software package and configure the Linux environment for using obsfs. This method can be used for the x86 architecture.

Ubuntu 16 and CentOS 7

Downloading and Installing obsfs

Compilation

Download the source code from GitHub, configure the compilation environment, and run the script included with the source code to generate your obsfs installation package. This method can be used for both the x86 and Arm architectures.

CentOS 7, CentOS 8, Fedora 28, RHEL 7, RHEL 8, Ubuntu 14, Ubuntu 16, Ubuntu 18, Debian 8, SUSE 12, and openSUSE Leap 42.1

Generating obsfs by Compilation