使用ossfs將OSS的Bucket掛載到Linux系統中 - Object Storage Service

ossfs是一款能夠將Object Storage Service中的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語義支援更為全面，適合對效能無特殊需求的情境日常使用。

前提條件

已註冊阿里雲帳號。
已開通OSS服務並建立OSS Bucket。

運行環境

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. 在Resource Orchestration Service控制台的建立資源棧頁面的安全確認下，勾選確認，然後單擊建立。
2. 建立完成後，在輸出中複製新建立的AccessKey。

配置用於訪問Object Storage Service的憑證環境變數。

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/ 
```

Object Storage Service：使用ossfs將OSS的Bucket掛載到Linux系統中