すべてのプロダクト
Search
ドキュメントセンター

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

最終更新日:Jul 09, 2026

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 セマンティクスをより包括的にサポートしており、高いパフォーマンス要件がないシナリオでの日常的な使用に適しています。

前提条件

動作環境

ossfs 2.0 は、ユーザースペースのファイルシステム (FUSE) に基づいています。

システムアーキテクチャ

オペレーティングシステム

バージョン

x86_64

CentOS

CentOS 7 および CentOS 8

Rocky Linux

Rocky Linux 9.0 以降

Alibaba Cloud Linux

Alibaba Cloud Linux 2 以降

Ubuntu

Ubuntu 20.04 LTS およびそれ以降の LTS バージョン

Debian

Debian 11 以降

aarch64

Alibaba Cloud Linux

Alibaba Cloud Linux 3

ossfs 2.0 のインストール

Alibaba Cloud Linux

  1. お使いのシステムアーキテクチャ用のパッケージをダウンロードします。

    • x86_64 アーキテクチャ: sudo wget https://gosspublic.alicdn.com/ossfs/ossfs2_2.0.8_linux_x86_64.rpm

    • aarch64 アーキテクチャ: sudo wget https://gosspublic.alicdn.com/ossfs/ossfs2_2.0.8_linux_aarch64.rpm

  2. お使いのシステムアーキテクチャに応じて ossfs 2.0 をインストールします。

    • x86_64 アーキテクチャ: sudo yum install ossfs2_2.0.8_linux_x86_64.rpm -y

    • aarch64 アーキテクチャ: sudo yum install ossfs2_2.0.8_linux_aarch64.rpm -y

  3. インストールを確認します。

    ossfs2 --version
    説明

    ossfs2 は /usr/local/bin/ossfs2 にインストールされます。 PATH がカスタマイズされている場合は、絶対パス /usr/local/bin/ossfs2 を使用して ossfs2 を実行してください。

CentOS/Rocky Linux

  1. パッケージをダウンロードします。

    sudo wget https://gosspublic.alicdn.com/ossfs/ossfs2_2.0.8_linux_x86_64.rpm
  2. ossfs 2.0 をインストールします。

    sudo yum install ossfs2_2.0.8_linux_x86_64.rpm -y
  3. インストールを確認します。

    ossfs2 --version
    説明

    ossfs2 は /usr/local/bin/ossfs2 にインストールされます。 PATH がカスタマイズされている場合は、絶対パス /usr/local/bin/ossfs2 を使用して ossfs2 を実行してください。

Ubuntu

  1. パッケージをダウンロードします。

    sudo wget https://gosspublic.alicdn.com/ossfs/ossfs2_2.0.8_linux_x86_64.deb
  2. ossfs 2.0 をインストールします。

    sudo dpkg -i ossfs2_2.0.8_linux_x86_64.deb
  3. インストールを確認します。

    ossfs2 --version
    説明

    ossfs2 は /usr/local/bin/ossfs2 にインストールされます。 PATH がカスタマイズされている場合は、絶対パス /usr/local/bin/ossfs2 を使用して ossfs2 を実行してください。

ossfs 2.0 の設定

ossfs 2.0 は、さまざまなマウントシナリオをサポートするために設定ファイルを使用します。バケットをマウントする際に、この設定ファイルを参照します。

  1. OSS の管理権限を持つ RAM ユーザーの AccessKey ペアを作成します

    ROS スクリプトを使用すると、OSS の管理権限を持つ RAM ユーザーと AccessKey ペアを迅速に作成できます。

    1. ROS コンソールで、[スタックの作成] に進みます。[セキュリティ確認] で、チェックボックスをオンにし、[作成] をクリックします。

      1.png

    2. スタックが作成されたら、出力 タブで新しい AccessKey ペアをコピーします。

      画像

  2. ossfs 2.0 の設定ファイルを作成し、認証情報とマウントオプションを入力します。

    export OSS_ACCESS_KEY_ID=LTAI******************
    export OSS_ACCESS_KEY_SECRET=8CE4**********************
  3. ossfs 2.0 の設定ファイルには、任意の名前とパスを使用できます。例えば、/etc/ossfs2.conf という名前のファイルを作成します。

    sudo touch /etc/ossfs2.conf
  4. Enter the mount information. The following example shows how to mount an entire bucket in read-only mode.

    説明

    バケットのエンドポイントを確認するには、バケットページに移動し、対象のバケットを選択してから、左側メニューで 概要 をクリックします。エンドポイントは アクセスタイプ セクションに表示されます。以下の例では、中国 (杭州) リージョンのバケットを使用しています。

    中国 (杭州) リージョンのバケットのエンドポイントは次のとおりです。パブリックエンドポイントは oss-cn-hangzhou.aliyuncs.com です。クラシックネットワークまたは Virtual Private Cloud (VPC) 内の Elastic Compute Service (ECS) インスタンスからのアクセス用の内部エンドポイントは oss-cn-hangzhou-internal.aliyuncs.com です。全世界のアップロードおよびダウンロード用の転送高速化エンドポイントは oss-accelerate.aliyuncs.com です。OSS アクセラレータエンドポイントは cn-hangzhou-internal.oss-data-acc.aliyuncs.com です。すべてのエンドポイントは HTTPS をサポートしています。

    Open the ossfs 2.0 configuration file that you created. Configure the file by using the following example, which uses an internal endpoint for the China (Hangzhou) region, and then save the file. For faster and more stable data transfer, use an internal endpoint or an OSS accelerator endpoint to mount from an instance within a VPC in the same region. Avoid using a public endpoint to access ossfs. High latency and unstable internet connections often lead to performance issues.

    # The endpoint of the region where the bucket is located
    --oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
    
    # The bucket name
    --oss_bucket=bucketName
    
    # Mount in read-only mode
    --ro=true

マウントとアクセス

  1. マウントポイントを作成します。

    マウントポイントには、カスタムの名前とパスを指定できます。 たとえば、マウントポイントとして /tmp/ossfs2-bucket ディレクトリを作成します。

    sudo mkdir /tmp/ossfs2-bucket
  2. バケットをマウントします。

    次のコマンドを実行し、ossfs2.conf ファイルで設定されているバケットを、ローカルの /tmp/ossfs2-bucket/ ディレクトリに読み取り専用モードでマウントします。 読み書き権限でのマウントが必要な場合は、ossfs2.conf 設定ファイルから --ro=true オプションを削除します。

    sudo ossfs2 mount /tmp/ossfs2-bucket/ -c /etc/ossfs2.conf 
  3. マウントされたバケットにアクセスします。

    マウントされると、バケット内のオブジェクトにローカルファイルのようにアクセスできます。たとえば、マウントされたバケット内のファイルを一覧表示するには、sudo ls -lh /tmp/ossfs2-bucket/ コマンドを実行します。

    画像

  4. バケットをアンマウントします。

    バケットをアンマウントするには、次のコマンドを実行します。

    sudo umount /tmp/ossfs2-bucket/ 

関連ドキュメント