ossfs を使用して OSS バケットを Linux システムにマウントする - Object Storage Service

ossfs は、Object Storage Service (OSS) バケットをローカルの Linux システムにマウントするツールです。これにより、アプリケーションは open や read などのファイルシステム操作を使用して OSS 内のオブジェクトにアクセスできます。ossfs はこれらの操作を自動的に OSS API 呼び出しに変換します。

説明

ossfs には 1.0 と 2.0 の 2 つのバージョンがあります。バージョン 2.0 は、計算集約型のアプリケーション向けに完全に再設計されています。大幅なパフォーマンスのスペックアップを提供しますが、POSIX セマンティクスにはいくつかの制限があります。これは将来の開発のための主要なバージョンです。AI トレーニング、推論、自動運転シミュレーションなどのアプリケーションに取り組んでおり、OSS ソフトウェア開発キット (SDK) や AI/ML 用 OSS コネクタを使用してモデルトレーニングを高速化するを簡単に使用できない場合は、ossfs 2.0 を使用してください。対照的に、ossfs 1.0 は POSIX セマンティクスをより包括的にサポートしており、高いパフォーマンス要件がないシナリオでの日常的な使用に適しています。

前提条件

Alibaba Cloud アカウントを登録済みであること。
OSS を有効化し、バケットを作成済みであること。

動作環境

ossfs 2.0 は Filesystem in Userspace (FUSE) に基づいています。

オペレーティングシステム	システムバージョン	システムアーキテクチャー	カーネルバージョン
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 バケットをマウントするには、ossfs 2.0 専用の構成ファイルを作成します。その後、バケットをマウントするときにこのファイルを参照できます。

OSS 管理権限を持つ Resource Access Management (RAM) ユーザーの AccessKey ペアを作成します。
Resource Orchestration Service (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
```
マウント情報を入力します。次の構成は、バケット全体を読み取り専用モードでマウントする例です。
説明
[バケットリスト] ページに移動してバケットのエンドポイントを表示し、ターゲットバケットを選択して入力し、左側のナビゲーションウィンドウで [概要] をクリックします。概要ページの [アクセスポート] セクションで、ターゲットバケットのリージョンノードを表示できます。この例では、中国 (杭州) リージョンのバケットを使用します。
作成した ossfs 2.0 構成ファイルを開きます。中国 (杭州) リージョンの内部エンドポイントを使用する次の例に基づいてファイルを構成し、ファイルを保存します。より高速で安定したデータ転送を確保するには、同じリージョンの VPC 内にあるインスタンスから、内部または OSS アクセラレータのエンドポイントを使用してバケットをマウントします。パブリックエンドポイントを使用して ossfs にアクセスしないでください。レイテンシが高く、インターネット接続が不安定な場合、途切れ途切れになる可能性があります。
```
# バケットが配置されているリージョンのエンドポイント
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com

# バケット名
--oss_bucket=bucketName

# 読み取り専用モードでマウント
--ro=true
```

マウントとアクセス

マウントディレクトリを作成します。
必要に応じてマウントディレクトリのパスを指定できます。たとえば、/tmp/ossfs2-bucket ディレクトリを作成します。
```
mkdir /tmp/ossfs2-bucket
```
マウントコマンドを実行します。
次のコマンドを実行して、ossfs2.conf ファイルで構成されているバケットを、ローカルの /tmp/ossfs2-bucket/ ディレクトリに読み取り専用モードでマウントします。バケットを読み取り/書き込みモードでマウントする場合は、ossfs2.conf 構成ファイルから --ro=true オプションを削除します。
```
ossfs2 mount /tmp/ossfs2-bucket/ -c /etc/ossfs2.conf 
```
マウントされたバケットにアクセスします。
バケットがマウントされると、ローカルファイルにアクセスするのと同じ方法でバケット内のオブジェクトにアクセスできます。たとえば、sudo ls -lh /tmp/ossfs2-bucket/ コマンドを実行して、マウントされたバケット内のファイルを一覧表示します。
バケットをアンマウントします。
バケットをマウントする必要がなくなった場合は、次のコマンドを実行してアンマウントします。
```
sudo umount /tmp/ossfs2-bucket/ 
```

Object Storage Service:ossfs を使用して OSS バケットを Linux システムにマウントする