准备工作:(阿里云官网)
创建阿里云oss,并给bucket命名

创建RAM用户,并授权oss读写,服务器只读访问权限(用于AK认证)

创建RAM角色,并同上授权,再到ECS控制台绑定到ECS,用于ECS RAM角色身份认证方式



安装ossfs2.0
- 执行以下命令,下载安装包。
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.4Commit ID: e6c73293ca0c79f492f85525d01d4db04f0ef9a2Build Time: 2025-10-27.01:44:58.UTC说明ossfs2的可执行文件安装在/usr/local/bin/ossfs2路径下,若您的环境变量PATH有特殊配置,可直接通过/usr/local/bin/ossfs2路径访问该程序。
安装完ossfs 2.0后,需要在其配置文件中配置待挂载的OSS存储空间(OSS Bucket)相关信息,以及访问OSS所需的凭证信息。
创建配置文件
重要: 一个配置文件仅能挂载一个Bucket。若要挂载多个Bucket,需创建多个配置文件,对每个Bucket分别进行配置,文件名与路径可自定义。挂载时引用相应的配置文件,就能实现多个Bucket的挂载。
您可按需自由设定ossfs 2.0配置文件的文件名与路径。例如,创建/etc/ossfs2.conf文件作为配置文件。
sudo touch /etc/ossfs2.conf
配置访问凭证
Accesskey(创建RAM用户)
ossfs 2.0.1及后续版本推荐您使用更安全便捷的环境变量方式配置RAM用户的AccessKey(访问密钥) 挂载OSS Bucket。如已通过环境变量配置,无需在配置文件中重复设置。
环境变量:
export OSS_ACCESS_KEY_ID=LTAI******************
export OSS_ACCESS_KEY_SECRET=8CE4**********************
配置文件:
#oss bucket页面显示的endpoint
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
#bucket名字
--oss_bucket=bucketName
#RAM用户id+secret
--oss_access_key_id=AAAI************
--oss_access_key_secret=AAA8x*************************
ECSRAMRole(创建RAM角色,并绑定ecs)
ossfs 2.0.2及后续版本支持在配置文件中使用ECSRAMRole(实例RAM角色)完成访问凭证配置。
配置文件:
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
--oss_bucket=bucketName
--ram_role=EcsRamRoleOssTest
配置文件格式
格式说明
--为挂载选项前缀,<option>为挂载选项名称,[=<value>]中value为挂载选项值,[]代表挂载选项值为可选。
--<option>[=<value>]
常用配置示例
挂载整个Bucket
挂载整个Bucket中的所有目录文件到本地。
# Bucket所处Endpoint(地域节点)
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
# Bucket名称
--oss_bucket=bucketName
# 访问密钥AccessKey ID和AccessKey Secret(ossfs 2.0.1及后续版本该配置项可选)
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************
挂载Bucket中的指定目录
挂载Bucket时,指定目标Bucket中的特定目录挂载到本地。
# Bucket所处Endpoint(地域节点)
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
# Bucket名称
--oss_bucket=bucketName
# OSS文件目录路径(可选)
--oss_bucket_prefix=folder-test/folder-prefix/
# 访问密钥AccessKey ID和AccessKey Secret(ossfs 2.0.1及后续版本该配置项可选)
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************
更多有关ossfs 2.0挂载选项说明,请参见挂载选项说明。
完整配置:
# Bucket所处Endpoint(地域节点)
--oss_endpoint=https://oss-cn-shanghai-internal.aliyuncs.com
# Bucket名称
--oss_bucket=zpsh
# OSS文件目录路径(挂载子目录)
--oss_bucket_prefix=cloudrepo_nginx/
# ECS RAM角色(用于身份认证)
--ram_role=blogfile
#--oss_access_key_id=************
#--oss_access_key_secret=************
# 内存限制200MB
--total_mem_limit=209715200
# 日志存放路径
--log_dir=/var/log/ossfs2
# 日志级别
--log_level=error
# 全局文件夹权限属性
--dir_mode=0755
# 全局文件权限属性
--file_mode=0644
挂载操作:使用ossfs 2.0挂载Bucket到本地Linux系统
前提条件:已安装ossfs 2.0并配置ossfs 2.0。
#创建挂载目录
您可按需自由设定挂载目录的文件名与路径。例如,创建`/tmp/ossfs2-bucket`目录作为挂载目录。
mkdir /tmp/ossfs2-bucket
#挂载Bucket
#将ossfs 2.0配置文件`ossfs2.conf `中所配置的Bucket挂载至本地`/tmp/ossfs2-bucket/`目录下 。
ossfs2 mount /tmp/ossfs2-bucket/ -c /etc/ossfs2.conf
# 卸载已挂载的Bucket
#例如,卸载挂载在`/tmp/ossfs2-bucket/ `路径下的文件系统。
sudo umount /tmp/ossfs2-bucket/