Object Storage Service:View options

コマンドフォーマット

./ossfs -h

このコマンドは、ossfs プログラムが配置されているディレクトリから実行します。デフォルトのディレクトリは /usr/local/bin/ です。実際のディレクトリは、ご利用のインストール環境によって異なります。

一般的なオプション

-o option_name[=option_value]  or  -ooption_name[=option_value]

ossfs bucket_name mount_point -ourl=endpoint -ouid=uid -ogid=gid

-ourl=oss-cn-hangzhou.aliyuncs.com
-ourl=http://oss-cn-hangzhou.aliyuncs.com
-ourl=https://oss-cn-hangzhou.aliyuncs.com

# キーを /etc/passwd-ossfs ファイルに書き込み、権限を 640 に設定します。
echo bucket-test:yourAccessKeyID:yourAccessKeySecret > /etc/passwd-ossfs
chmod 640 /etc/passwd-ossfs

# キーを /passwd-path/passwd-ossfs ファイルに書き込み、権限を 600 に設定します。
echo bucket-test:yourAccessKeyID:yourAccessKeySecret > /passwd-path/passwd-ossfs
chmod 600 /passwd-path/passwd-ossfs

# opasswd_file 変数を定義し、その値を /passwd-path/passwd-ossfs に設定します。
-opasswd_file=/passwd-path/passwd-ossfs

ossfs bucket_name mount_point -omax_stat_cache_size=0

ossfs bucket_name mount_point -ourl=endpoint -oallow_other

ossfs bucket_name mount_point -odbglevel=info

ossfs bucket_name mount_point -f

ossfs bucket_name mount_point -d

オプションのリスト

ほとんどの場合、オプションのフォーマットは -ooption_name=option_value または -o option_name=option_value です。

• ossfs オプション

  オプション	説明
  retries	リクエストが失敗した後の再試行回数を指定します。デフォルト値は 2 です。
  storage_class	OSS に書き込まれるファイルのストレージクラスを指定します。有効な値は次のとおりです。 Standard (デフォルト): 標準ストレージ IA: 低頻度アクセス Archive: アーカイブストレージ ストレージクラスの詳細については、「ストレージクラス」をご参照ください。
  public_bucket	バケットに匿名でアクセスするかどうかを指定します。このオプションは、アクセス制御リスト (ACL) が公開読み書きのバケットに対してのみ有効です。有効な値は次のとおりです。 0 (デフォルト): バケットに匿名でアクセスしません。 1: バケットに匿名でアクセスします。
  passwd_file	バケットの AccessKey ペアを格納するファイルを指定します。デフォルトのファイルは /etc/passwd-ossfs です。
  connect_timeout	接続タイムアウト期間を秒単位で指定します。デフォルト値は 300 秒です。
  readwrite_timeout	読み取りまたは書き込みリクエストのタイムアウト期間を秒単位で指定します。デフォルト値は 120 秒です。
  max_stat_cache_size	キャッシュするファイルメタデータエントリの数を指定します。 デフォルト値は 100,000 で、約 40 MB の追加領域を消費します。
  readdir_optimize	キャッシュの最適化を使用するかどうかを制御します。 デフォルトでは、この機能は無効になっています。 このマウントオプションを追加すると、ls コマンドを実行したときに、ossfs は gid や uid などのファイルメタデータを取得するために HeadObject リクエストを送信しません。HeadObject リクエストは、アクセスされたファイルのサイズが 0 の場合にのみ送信されます。ただし、権限チェックやその他の理由により、多数の HeadObject リクエストが生成される場合があります。アプリケーションの属性に基づいてこのパラメーターを選択してください。この機能を有効にするには、バケットをマウントするときに -oreaddir_optimize を追加します。
  stat_cache_expire	ファイルメタデータキャッシュの有効期限を秒単位で指定します。デフォルト値は 900 秒です。
  no_check_certificate	サーバー側の証明書検証を無効にします。このオプションは、HTTPS プロトコルを使用する場合にのみ有効です。デフォルトでは、証明書検証は有効になっています。このオプションには値がありません。使用するには、-ono_check_certificate オプションを追加するだけです。
  multireq_max	ファイルをリスト表示するときの、ファイルメタデータにアクセスするための同時リクエストの最大数を指定します。デフォルト値は 20 です。
  parallel_count	マルチパートアップロードモードで大きなファイルをアップロードするときの同時パート数を指定します。デフォルト値は 5 です。
  multipart_size	マルチパートアップロードの各パートのサイズを MB 単位で指定します。デフォルト値は 10 です。このパラメーターは、サポートされる最大ファイルサイズに影響します。マルチパートアップロードの最大パート数は 10,000 です。デフォルト値では、サポートされる最大ファイルサイズは 100 GB です。より大きなファイルをサポートするには、必要に応じてこの値を調整してください。
  url	バケットのエンドポイントを指定します。
  umask	マウントポイント内のファイルとフォルダの権限マスクを設定します。 たとえば、マウントポイント内のファイルとフォルダの権限を 770 に設定するには、-oumask=007 を追加します。権限を 700 に設定するには、-oumask=077 を追加します。 説明 バージョン 1.91.*：ファイルのデフォルト権限は 0640、フォルダのデフォルト権限は 0750 です。 バージョン 1.80.*：ファイルとフォルダの両方のデフォルト権限は 0777 です。
  enable_content_md5	アップロード操作中に CONTENT_MD5 を設定するかどうかを指定します。 デフォルトでは、これは設定されていません。 Content-MD5 を設定するには、-oenable_content_md5 オプションを追加します。
  ram_role	RAM ロールを使用して OSS にアクセスします。このメソッドを使用して OSS にアクセスする場合、キーファイル内の AccessKey ID と AccessKey Secret は無視されます。
  listobjectsv2	バケットでバージョン管理が有効になっている場合は、-olistobjectsv2 オプションを使用してファイルを一覧表示します。
  notsup_compat_dir	互換性のないディレクトリタイプを制限します。デフォルトでは、ossfs は dir/、dir、および dir_$folder$ をディレクトリとして認識します。 ossfs とサーバー間のやり取りを減らすために、ossfs が dir/ のみをディレクトリとして認識するように制限したい場合は、-onotsup_compat_dir オプションを使用します。
  direct_read	デフォルトでは、ossfs はディスク領域を使用してアップロードまたはダウンロード用の一時データを保存します。このオプションを設定すると、ローカルディスク領域を使用せずに OSS から直接データを読み取ることができます。このオプションはデフォルトでは設定されていません。-odirect_read を使用してダイレクトリードモードを有効にできます。 説明 ダイレクトリード中にファイルに対する書き込み、名前変更、または切り捨て操作が検出された場合、ファイルは再オープンされるまでダイレクトリードモードを終了します。
  direct_read_chunk_size	ダイレクトリードモードで、1 回の読み取りリクエストで OSS から読み取るデータ量を指定します。単位は MB です。デフォルト値は 4 です。値の範囲は 1 から 32 です。 このオプションは、-odirect_read オプションを使用してダイレクトリードモードが有効になっている場合にのみ有効です。
  direct_read_prefetch_thread	ダイレクトリードモードでは、ossfs はバックグラウンドの非同期タスクとして先読みを実行します。このオプションは、同時に実行されるプリフェッチリクエストの最大スレッド数を指定します。デフォルト値は 64 です。 このオプションは、-odirect_read オプションを使用してダイレクトリードモードが有効になっている場合にのみ有効です。
  direct_read_prefetch_chunks	ダイレクトリードモードで、メモリにプリフェッチするチャンク数を指定します。これにより、シーケンシャルリードのシナリオで ossfs のパフォーマンスが向上します。デフォルト値は 32 です。 このオプションは、-odirect_read オプションを使用してダイレクトリードモードが有効になっている場合にのみ有効です。
  direct_read_prefetch_limit	ダイレクトリードモードでは、ossfs はメモリを使用して OSS からプリフェッチされたデータをキャッシュします。このオプションは、ossfs がプリフェッチできるデータの総量を制限します。単位は MB です。デフォルト値は 1024 です。 このオプションは、-odirect_read オプションを使用してダイレクトリードモードが有効になっている場合にのみ有効です。
  dbglevel	ログレベルを設定します。サポートされているログレベルは次のとおりです。 critical (デフォルト) error warn info debug
  curldbg	libcurl のロギングを有効にします。デフォルトでは、これは無効になっています。libcurl のログを出力するには、-ocurldbg オプションを追加します。

• データキャッシュオプション

  説明

  データキャッシュの原則の詳細については、「データキャッシュ」をご参照ください。

  オプション	説明
  use_cache	データキャッシュを有効にし、データキャッシュパスを指定します。デフォルトでは、この機能は無効になっています。このオプションを指定して、キャッシュパスを設定します。 たとえば、マウント時に -ouse_cache=path を追加すると、データキャッシュが有効になり、データキャッシュパスが path に設定されます。path は、/tmp/your_foldername などの実際のパスに設定してください。
  ensure_diskfree	予約済みのディスク領域の量を制御します。デフォルトでは、領域は予約されません。このオプションを使用して、予約する空きディスク領域の量を MB 単位で設定します。これにより、ディスクがいっぱいになり、他のアプリケーションに影響が及ぶのを防ぎます。 たとえば、少なくとも 1024 MB の空きディスク領域を確保するには、マウント時に -oensure_diskfree=1024 を追加します。
  del_cache	ローカルキャッシュの削除を制御します。デフォルトでは、キャッシュは削除されません。このオプションを設定して、ossfs がローカルデータキャッシュをクリアするように設定します。 たとえば、-odel_cache オプションを追加すると、ossfs はマウントおよびアンマウント操作中に use_cache で指定されたフォルダ内のキャッシュファイルをクリアします。
  max_dirty_data	書き込み中のファイルのサイズがこの値を超えると、ファイルが閉じられる前に中間の一時ファイルがアップロードされます。 デフォルト値は 5120 MB です。 たとえば、ファイルのサイズが 2000 MB を超えたときにファイルをアップロードするには、マウント時に -omax_dirty_data=2000 を追加します。OSS のバージョン管理を有効にしている場合、大きなファイルを書き込むと、複数のバージョンの中間ファイルが生成されることがあります。このオプションは大きな値に設定してください。
  tmpdir	デフォルトでは、データはシステムディスクの /tmp ディレクトリに一時的にキャッシュされます。このオプションを指定して、デフォルトの一時キャッシュパスを設定できます。このオプションは use_cache オプションと併用できません。 たとえば、マウント時に -otmpdir=path を追加して、デフォルトの一時データキャッシュパスを path に設定できます。path は、/data/your_foldername などの実際のパスに設定してください。
  free_space_ratio	キャッシュ後に維持する空きディスク領域の最小パーセンテージを制御します。 たとえば、ディスク領域が 50 GB で、このオプションを -ofree_space_ratio=20 に設定した場合、10 GB の領域 (50 GB × 20%) が予約されます。
  disable_noobj_cache	このオプションは ossfs 1.91.6 で追加されました。noobj メタデータキャッシュを無効または有効にします。有効にすると、ファイルが存在しない場合でも情報がキャッシュされます。デフォルト値は false (有効) です。 たとえば、マウント中に -o disable_noobj_cache を追加して、noobj メタデータキャッシュを無効にできます。 ossfs 1.91.6 以降では、noobj キャッシュがデフォルトで使用されます。 無効にするには、このオプションを追加します。

• FUSE オプション

  オプション	説明
  allow_other	マウントポイントの権限を変更して、すべてのユーザーがマウントディレクトリにアクセスできるようにします。これにはディレクトリ内のファイルは含まれません。ディレクトリ内のファイルの権限は別途設定する必要があります。特定のファイルの権限を変更するには、chmod コマンドを使用します。すべてのファイルに同じ権限を設定するには、umask オプションを設定します。デフォルトでは、root ユーザーのみが -oallow_other オプションを設定できます。このオプションには値がありません。使用するには、-oallow_other オプションを追加するだけです。
  uid	フォルダを所有するユーザーのユーザー ID (UID) を指定します。
  gid	フォルダを所有するユーザーのグループ ID (GID) を指定します。