在Linux系统安装ossfs并挂载Bucket-对象存储-阿里云

ossfs是一款能够将对象存储OSS中的Bucket挂载到本地Linux系统的工具。您的应用程序可以通过文件系统操作（例如open和read）访问存储在OSS中的对象。ossfs会自动将这些操作转换为OSS的API调用。

说明

ossfs分为1.0和2.0两个版本。2.0版本是面向新形态计算密集型应用进行了全面重构的版本，实现了性能的全面升级，但对POSIX语义进行了部分限制，是未来的主线演进版本。如果您正在开展AI训练、推理、自动驾驶仿真等新型应用，且不方便使用OSS SDK和使用OSS Connector for AI/ML加速模型训练，强烈建议使用ossfs 2.0。相较之下，ossfs 1.0对POSIX语义支持更为全面，适合对性能无特殊需求的场景日常使用。

前提条件

运行环境

ossfs 2.0基于FUSE（用户态文件系统，Filesystem in Userspace）开发。

操作系统	系统版本	系统架构	内核版本
CentOS	CentOS（7系列）	x86_64	3.10
CentOS	CentOS（8系列）	x86_64	4.18
Alibaba Cloud Linux	Alibaba Cloud Linux （2系列）	x86_64	4.19
	Alibaba Cloud Linux （3系列）	x86_64	5.10
	Alibaba Cloud Linux （3系列）	aarch64	5.10
Ubuntu	Ubuntu 20.04	x86_64	5.4
	Ubuntu 22.04	x86_64	5.15
	Ubuntu 24.04	x86_64	6.8

安装ossfs 2.0

Alibaba Cloud Linux

根据平台的系统架构执行相应命令，下载安装包。
- x86_64架构：sudo wget https://gosspublic.alicdn.com/ossfs/ossfs2_2.0.4_linux_x86_64.rpm
- aarch64架构：sudo wget https://gosspublic.alicdn.com/ossfs/ossfs2_2.0.4_linux_aarch64.rpm
根据平台的系统架构执行相应命令，安装ossfs 2.0。
- x86_64架构：sudo yum install ossfs2_2.0.4_linux_x86_64.rpm -y
- aarch64架构：sudo yum install ossfs2_2.0.4_linux_aarch64.rpm -y
执行以下命令，验证ossfs 2.0是否成功安装。
```
ossfs2 --version
```
返回示例如下：
```
Version ID: 2.0.4
Commit  ID: e6c73293ca0c79f492f85525d01d4db04f0ef9a2
Build Time: 2025-10-27.01:44:58.UTC
```
说明
ossfs2的可执行文件安装在/usr/local/bin/ossfs2路径下，若您的环境变量PATH有特殊配置，可直接通过/usr/local/bin/ossfs2路径访问该程序。

CentOS

执行以下命令，下载安装包。

sudo wget https://gosspublic.alicdn.com/ossfs/ossfs2_2.0.4_linux_x86_64.rpm

执行以下命令，安装ossfs 2.0。

sudo yum install ossfs2_2.0.4_linux_x86_64.rpm -y

执行以下命令，验证ossfs 2.0是否成功安装。
```
ossfs2 --version
```
返回示例如下：
```
Version ID: 2.0.4
Commit  ID: e6c73293ca0c79f492f85525d01d4db04f0ef9a2
Build Time: 2025-10-27.01:44:58.UTC
```
说明
ossfs2的可执行文件安装在/usr/local/bin/ossfs2路径下，若您的环境变量PATH有特殊配置，可直接通过/usr/local/bin/ossfs2路径访问该程序。

Ubuntu

执行以下命令，下载安装包。

sudo wget https://gosspublic.alicdn.com/ossfs/ossfs2_2.0.4_linux_x86_64.deb

执行以下命令，安装ossfs 2.0。

sudo dpkg -i ossfs2_2.0.4_linux_x86_64.deb

执行以下命令，验证ossfs 2.0是否成功安装。
```
ossfs2 --version
```
返回示例如下：
```
Version ID: 2.0.4 
Commit  ID: e6c73293ca0c79f492f85525d01d4db04f0ef9a2
Build Time: 2025-10-27.01:44:58.UTC
```
说明
ossfs2的可执行文件安装在/usr/local/bin/ossfs2路径下，若您的环境变量PATH有特殊配置，可直接通过/usr/local/bin/ossfs2路径访问该程序。

配置ossfs 2.0

在实际使用过程中，为满足不同场景下对存储空间（OSS Bucket）的挂载需求，需对ossfs 2.0配置文件进行针对性配置，然后在挂载存储空间（OSS Bucket）时，引用该配置文件即可完成挂载。

创建拥有OSS管理权限的RAM用户AccessKey。
通过ROS脚本快速创建具备OSS管理权限的RAM用户及其AccessKey
1. 在资源编排ROS控制台的创建资源栈页面的安全确认下，勾选确认，然后单击创建。
2. 创建完成后，在输出中复制新创建的AccessKey。

配置用于访问对象存储OSS的凭证环境变量。

export OSS_ACCESS_KEY_ID=LTAI******************
export OSS_ACCESS_KEY_SECRET=8CE4**********************

您可按需自由设定ossfs 2.0配置文件的文件名与路径。例如，创建/etc/ossfs2.conf文件作为配置文件。
```
sudo touch /etc/ossfs2.conf
```
填写挂载信息。以只读方式挂载整个Bucket的配置为例。
说明
查看Bucket的Endpoint请进入Bucket列表页面，选择目标Bucket并进入，接着单击左侧导航栏的概览选项，在概览页的访问端口栏中即可查看目标Bucket所处的地域节点。如图所示，以杭州地域Bucket为例。
打开已创建的ossfs 2.0配置文件，参照以下示例（以杭州地域内网Endpoint为例）配置并保存。内网和OSS加速器Endpoint仅支持同地域VPC内实例挂载，数据传输更快速、稳定；不建议使用外网Endpoint访问ossfs，受高延迟和不稳定的Internet网络连接影响，可能会出现各种卡顿问题。
```
# Bucket所处Endpoint（地域节点）
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com

# Bucket名称
--oss_bucket=bucketName

# 以只读方式挂载
--ro=true
```

挂载访问

创建挂载目录。
您可按需自由设定挂载目录的文件名与路径。例如，创建/tmp/ossfs2-bucket目录作为挂载目录。
```
mkdir /tmp/ossfs2-bucket
```
执行命令挂载。
执行命令将ossfs 2.0配置文件ossfs2.conf中所配置的Bucket只读挂载至本地/tmp/ossfs2-bucket/ 目录下。如果您需要采用读写挂载，请删除ossfs2.conf配置文件中的--ro=true选项。
```
ossfs2 mount /tmp/ossfs2-bucket/ -c /etc/ossfs2.conf 
```
操作已挂载的Bucket。
挂载完成后您就可以像访问本地文件系统一样操作Bucket中的对象。例如执行sudo ls -lh /tmp/ossfs2-bucket/命令，查看已挂载Bucket的文件列表。
卸载已挂载的Bucket。
如果您不希望继续挂载此Bucket，可以执行以下命令将其卸载。
```
sudo umount /tmp/ossfs2-bucket/ 
```

使用ossfs将OSS的Bucket挂载到Linux系统中