Ubuntu 将阿里云 OSS 对象存储挂载为本地硬盘(含开机自启)

目录

一、前提准备

[二、安装 ossfs 2.0](#二、安装 ossfs 2.0)

[1、下载 ossfs 2.0 安装包并安装(仅支持 x86_64 架构):](#1、下载 ossfs 2.0 安装包并安装(仅支持 x86_64 架构):)

2、验证安装是否成功:

3、配置访问凭证

4、创建配置文件

[5、挂载 OSS Bucket](#5、挂载 OSS Bucket)

三、设置开机自动挂载

[1、编辑 /etc/fstab 文件添加以下内容:](#1、编辑 /etc/fstab 文件添加以下内容:)

2、测试配置是否正确:

3、卸载挂载点


在 Ubuntu 服务器上,我们经常需要把阿里云 OSS 对象存储当成本地硬盘直接读写,不用改造应用、不用集成 OSS SDK。ossfs 2.0 是阿里云官方推出的 FUSE 客户端,能把 OSS Bucket 透明挂载到 Linux 文件系统,完美适配 AI 训练、文件共享、备份归档等场景。

本文基于官方文档,整理一套Ubuntu 专属的 ossfs 2.0 安装、配置、挂载、开机自启全流程,开箱即用。

适配 Ubuntu 20.04/22.04/24.04,生产环境可直接照搬

一、前提准备

开始前请确保:

  • 阿里云账号已完成个人 / 企业实名认证,并开通 OSS 服务。
  • 已创建 OSS Bucket,记下:
    • Bucket 名称
    • 地域内网 Endpoint(优先内网,稳定低延迟)
  • 服务器环境:
    • Ubuntu 20.04 / 22.04 / 24.04(x86_64)
    • 内核 ≥ 5.4(Ubuntu 20.04 及以上默认满足)
    • 拥有 sudo 权限
  • 已创建具备 OSS 读写权限的 RAM 用户,并获取 AccessKey ID + AccessKey Secret。

二、安装 ossfs 2.0

1、下载 ossfs 2.0 安装包并安装(仅支持 x86_64 架构):
bash 复制代码
wget https://gosspublic.alicdn.com/ossfs/ossfs2_2.0.4_linux_x86_64.deb
sudo dpkg -i ossfs2_2.0.4_linux_x86_64.deb
2、验证安装是否成功:
bash 复制代码
ossfs2 --version

出现版本信息即成功:

bash 复制代码
Version ID: 2.0.4
Commit ID: e6c73293ca0c79f492f85525d01d4db04f0ef9a2
Build Time: 2025-10-27.01:44:58.UTC
3、配置访问凭证

ossfs 2.0.1+ 推荐用环境变量配置凭证,不写死在配置文件更安全。:

bash 复制代码
# 临时生效(当前会话)
export OSS_ACCESS_KEY_ID=LTAI******************
export OSS_ACCESS_KEY_SECRET=8CE4**********************

# 永久生效(写入 profile)
echo 'export OSS_ACCESS_KEY_ID=LTAI******************' >> /etc/profile
echo 'export OSS_ACCESS_KEY_SECRET=8CE4**********************' >> /etc/profile
source /etc/profile
4、创建配置文件

为每个需要挂载的 Bucket 创建独立的配置文件:

bash 复制代码
sudo touch /etc/ossfs2.conf
sudo chmod 600 /etc/ossfs2.conf

配置文件示例:

bash 复制代码
# OSS 地域内网 Endpoint(替换成你的)
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
# Bucket 名称
--oss_bucket=my-ubuntu-oss
# 只读挂载(需要读写请删除该参数)
--ro=true

#如第3步的环境变量配置不生效,也可以在该文件写死
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************
5、挂载 OSS Bucket

创建挂载点并挂载:

bash 复制代码
mkdir -p /mnt/oss
ossfs2 mount /mnt/oss -c /etc/ossfs2.conf

验证挂载是否成功:

bash 复制代码
#如果挂载成功会提示
Mount oss://***** to /mnt/oss successfully

#查看挂载
ls /mnt/oss

三、设置开机自动挂载

1、编辑 /etc/fstab 文件添加以下内容:
bash 复制代码
your_bucket_name /mnt/oss ossfs2 _netdev,nofail,x-systemd.after=networkd-dispatcher.service,conf=/etc/ossfs2.conf 0 0
2、测试配置是否正确:
bash 复制代码
sudo mount -a 
3、卸载挂载点

当不再需要挂载时,可以卸载:

bash 复制代码
sudo umount /mnt/oss
相关推荐
夏日听雨眠44 分钟前
LInux(逻辑地址与物理地址的区别,文件描述符,lseek函数)
linux·运维·网络
哲霖软件2 小时前
ERP 赋能非标自动化行业:破解物料与库存管理难题
运维·自动化
qq_542515413 小时前
Ubuntu 22.04.4 LTS安装ToDesk最新版打不开,无响应?旧版本4.7.2_277版本分享
linux·ubuntu·todesk
火车叼位3 小时前
替代 Tiny Win10 的 Linux 方案:Debian XFCE 精简桌面搭建
linux·运维
小麦嵌入式3 小时前
FPGA入门(四):时序逻辑计数器原理与 LED 闪烁实现
linux·驱动开发·stm32·嵌入式硬件·fpga开发·硬件工程·dsp开发
小碗羊肉3 小时前
【JavaWeb | 第十一篇】文件上传(本地&阿里云OSS)
java·阿里云·servlet
皮卡蛋炒饭.4 小时前
传输层协议UDP
linux·网络协议·udp
大明者省4 小时前
宝塔开了端口,Ubuntu 还得开相应端口才能打通
服务器·数据库·ubuntu
syagain_zsx4 小时前
Linux指令初识(实用篇)
linux·运维·服务器
OYangxf4 小时前
Git Commit Message
运维·git