ossfs allows you to mount OSS buckets as local file systems in Linux. Then, you can manage OSS objects in the same manner as you manage local files.
We recommend that you run ossfs in the following environments:
- Linux-based operating systems
- CentOS later than 7.0
- Ubuntu 14.04 or later
- Fuse 2.8.4 or later
ossfs is subject to errors and disconnections when run on earlier versions of Linux kernel. OSS provides installation packages for earlier versions of Linux-based operating systems. However, we recommend that you upgrade your operating system to the preceding versions to ensure the stable operation of ossfs.
|Ubuntu 18.04 (x64)||ossfs_1.80.6_ubuntu18.04_amd64.deb|
|Ubuntu 16.04 (x64)||ossfs_1.80.6_ubuntu16.04_amd64.deb|
|Ubuntu 14.04 (x64)||ossfs_1.80.6_ubuntu14.04_amd64.deb|
|CentOS 7.0 (x64)||ossfs_1.80.6_centos7.0_x86_64.rpm|
|CentOS 6.5 (x64)||ossfs_1.80.6_centos6.5_x86_64.rpm|
The preceding table provides the download URLs of ossfs installation packages for common operating systems. If your operating system is not included in the table, install ossfs by compiling the source code. For the source code, visit GitHub ossfs.
?spm=xxxxsection from the URLs.
- Download the installation package. For example, run the following command to download the ossfs installation package for CentOS 7.0 (x64):
- Install ossfs.
For example, you can run the following command to install ossfs in Ubuntu 16.04 (x64):
sudo apt-get update sudo apt-get install gdebi-core sudo gdebi ossfs_1.80.6_ubuntu16.04_amd64.deb
For example, you can run the following command to install ossfs in CentOS 7.0 (x64):
sudo yum ossfs_1.80.6_centos7.0_x86_64.rpmNote If your client uses yum to install the RPM package, dependencies may fail to be downloaded when the client node network environment is not suitable. To resolve this issue, you can use yum to download the dependencies over the normal network to a node running the same operating system version, and then copy the dependencies to the required node. For example, if ossfs requires fuse 2.8.4 or later to run, you can run the following command to download the latest version of fuse from the yum source to your local device:
To download other dependencies, replace fuse with the name of the required package.
sudo yum install --downloadonly --downloaddir=./ fuse
- Configure access information of the account. Store the bucket name and the AccessKey pair that can be used to access the bucket in the /etc/passwd-ossfs object. Make sure that the permission on this object is set correctly. We recommend that you set the permission to 640.
echo BucketName:yourAccessKeyId:yourAccessKeySecret > /etc/passwd-ossfs chmod 640 /etc/passwd-ossfs
- Mount the bucket to the specified directory.
ossfs BucketName mountfolder -ourl=EndpointExample: Mount a bucket named
echo bucket-test:LTAIbZcdVCmQ****:MOk8x0y9hxQ31coh7A5e2MZEUz**** > /etc/passwd-ossfs chmod 640 /etc/passwd-ossfs mkdir /tmp/ossfs ossfs bucket-test /tmp/ossfs -ourl=http://oss-cn-hangzhou.aliyuncs.comNotice If you use an Alibaba Cloud ECS instance to provide ossfs services, you can use an internal endpoint. In the preceding example, you can set the OSS endpoint to
oss-cn-hangzhou-internal.aliyuncs.comto minimize costs. For more information about OSS internal endpoints, see Regions and endpoints.
- If you no longer need the bucket, you can run the following command to unmount it.
fusermount -u /tmp/ossfs
For more information about the version history of ossfs, visit GitHub ChangeLog.