すべてのプロダクト
Search

このプロダクト

    Object Storage Service:一般的なオプション

    ドキュメントセンター

    Object Storage Service:一般的なオプション

    最終更新日:Dec 20, 2023

    -hオプションを使用すると、ossfsでサポートされている共通オプションを表示できます。

    コマンド構文

    . /ossfs -h

    このコマンドは、ossfsがあるディレクトリで使用する必要があります。 デフォルトのディレクトリは /usr/local/bin/ で、パスは実際のインストール環境によって異なります。

    一般的なオプション

    ossfsは、Flesystem in Userspace (FUSE) に基づいて実装され、fuseオプションとossfsオプションをサポートします。 バケットをマウントするときに、さまざまな起動オプションを指定できます。 オプションは、次のいずれかの形式にすることができます。
    -o option_name[=option_value] または-ooption_name[=option_value]
    たとえば、次のオプションを使用して、バケットをマウントするときにuidおよびgidパラメーターを指定できます。
    ossfs bucket_name mount_point -ourl=endpoint -ouid=uid=gid
    次のセクションでは、一般的なossfsオプションについて説明します。
    • url: バケットへのアクセスに使用するドメイン名を指定します。 形式: url=endpoint デフォルトのリクエストプロトコルはHTTPです。

      例：

      -私たちのl=oss-cn-hangzhou.aliyuncs.com
-ourl=http://oss-cn-hangzhou.aliyuncs.com
-ourl=https://oss-cn-hangzhou.aliyuncs.com
    • passwd_file: バケットへのアクセスに使用されるAccessKeyペアを格納するオブジェクトを指定します。 デフォルト値: /etc/passwd-ossfs このオブジェクトの権限が正しく設定されていることを確認してください。 オブジェクトが /etc/passwd-ossfsの場合、権限を640に設定できます。 オブジェクトが /etc/passwd-ossfsでない場合は、権限を600に設定する必要があります。 オブジェクトのコンテンツの形式は ${bucket }:${ access-key-id }:{ access-key-secret} です。

      例：

      エコーバケットテスト: LTAIbZcdVCmQ ****:MOk8x0y9hxQ31coh7A5e2MZEUz **** > /etc/passwd-ossfs
chmod 640 /etc/passwd-ossfs

エコーバケットテスト: LTAIbZcdVCmQ ****:MOk8x0y9hxQ31coh7A5e2MZEUz **** > /passwd-path/passwd-ossfs
chmod 600 /passwd-path/passwd-ossfs

-opasswd_file=/passwd-path/passwd-ossfs
    • max_stat_cache_size: メタデータをキャッシュできるオブジェクトの最大数を指定します。 デフォルト値は 1000 です。 ディレクトリに多数のオブジェクトが含まれている場合、lsコマンドを実行してオブジェクトを一覧表示するときに、このオプションを調整してオブジェクトの一覧表示を高速化できます。 メタデータキャッシュを無効にするには、このオプションの値を0に設定します。
    • allow_other: 他のユーザーがバケットがマウントされているディレクトリへのアクセスを許可しますが、ディレクトリ内のオブジェクトへのアクセスは許可しません。 ディレクトリ内のオブジェクトのアクセス許可を変更するには、chmodコマンドを実行する必要があります。 このオプションには値がありません。 他のユーザーに権限を付与するには、-oallow_otherオプションを使用します。
    • dbglevel: ログレベルを指定します。 有効な値: critical、error、warn、info、debug。 デフォルト値: critical。 たとえば、情報ログの収集を有効にする場合は、-odbglevel=infoオプションを使用します。 ログはシステムログに書き込まれます。 たとえば、ログはCentOSの /var/log/messagesに書き込まれます。
    • -f: ossfsをデーモンではなくフォアグラウンドプログラムとして実行します。 この場合、端末の画面にログが表示される。 このオプションはデバッグで使用されます。
    • -d: ロギングを有効にします。 このオプションはヒューズでも使用されます。 ossfsでは、このオプションは -odbglevel=info設定と同等です。

    オプション

    特に指定のない限り、オプションは次のいずれかの形式になります。-ooption_name=option_valueまたは -o option_name=option_value。

    • ossfsオプション
      オプション説明
      default_aclオブジェクトがobject Storage Service (OSS) にアップロードされるときのオブジェクトのアクセス制御リスト (ACL) を指定します。 デフォルト値: private。 有効な値：
      • プライベート
      • パブリック読み取り
      • public-read-write
      詳細については、「オブジェクトACL」をご参照ください。
      再試行リクエストが失敗したときにシステムで実行する再試行の回数を指定します。 デフォルト値：2
      storage_classOSSにアップロードするオブジェクトのストレージクラスを指定します。 デフォルト値: Standard。 有効な値：
      • 標準
      • IA
      • アーカイブ
      ストレージクラスの詳細については、「概要」をご参照ください。
      public_bucketユーザーが匿名ユーザーとしてバケットにアクセスできるようにします。 このオプションは、ACLがパブリック読み取り /書き込みであるバケットにのみ適しています。 デフォルト値：0 有効な値：
      • 0: ユーザーが匿名ユーザーとしてバケットにアクセスすることはできません。
      • 1: ユーザーは匿名ユーザーとしてバケットにアクセスできます。
      passwd_ファイルバケットへのアクセスに使用するAccessKeyペアを格納するオブジェクトを指定します。 デフォルト値: /etc/passwd-ossfs
      connect_timeout接続のタイムアウト時間を秒単位で指定します。 デフォルト値は 300 です。
      readwrite_timeout読み取りまたは書き込みリクエストのタイムアウト時間を秒単位で指定します。 デフォルト値: 0。
      max_stat_cache_sizeメタデータをキャッシュできるオブジェクトの最大数を指定します。 デフォルト値は 1000 です。 1,000のオブジェクトのメタデータは約4 MBを消費します。
      stat_cache_expireオブジェクトメタデータキャッシュの有効期限を指定します。 単位は秒です。 デフォルトでは、メタデータキャッシュは期限切れになりません。
      no_check_certificateサーバー証明書が検証されないことを指定します。 このオプションは、リクエストプロトコルがHTTPSの場合にのみ有効です。 デフォルトでは、証明書の検証は有効です。 このオプションで使用できる値はありません。 証明書の検証を無効にするには、-ono_check_certificateオプションを使用します。
      multireq_maxオブジェクトの一覧表示中にオブジェクトメタデータにアクセスする同時リクエストの最大数を指定します。 デフォルト値は 20 です。
      parallel_countマルチパートアップロードを使用してラージオブジェクトをアップロードする場合に、同時にアップロードできるパーツの数を指定します。 既定値：5
      multipart_sizeマルチパートアップロードを使用してデータをアップロードする場合、各パーツのサイズをMB単位で指定します。 デフォルト値は 10 です。 このオプションは、アップロードするオブジェクトの最大サイズを制限します。 マルチパートアップロードを使用する場合、アップロードできるパーツの最大数は10,000です。 デフォルトでは、アップロードできるオブジェクトの最大サイズは100 GBです。 このオプションの値を調整して、より大きなオブジェクトをアップロードできます。
      urlバケットへのアクセスに使用するドメイン名を指定します。
      mp_umaskマウントポイントの権限マスクを指定します。 このオプションは、allow_otherオプションが設定されている場合にのみ有効になります。 デフォルト値: 000。 このオプションは、umaskコマンドと同じ方法で使用されます。 たとえば、-oallow_other -omp_umask=007を設定してマウントポイントの権限を770に設定し、-oallow_other -omp_umask=077を設定してマウントポイントの権限を700に設定できます。
      enable_content_md5オブジェクトのアップロードにCONTENT_MD5ヘッダーを設定するかどうかを指定します。 デフォルトでは、このヘッダーは設定されていません。 Content-MD5ヘッダーを設定する場合は、-oenable_content_md5オプションを追加します。
      ram_roleRAMロールを使用してOSSへのアクセスを許可します。 RAMロールを使用してOSSにアクセスすると、キーオブジェクトのAccessKey IDとAccessKey secretは無視されます。
      listobjectsv2バケットのバージョン管理が有効になっている場合は、-olistobjectsv2オプションを使用してオブジェクトを一覧表示することを推奨します。
      notsup_compat_dirサポートされているディレクトリタイプ。 デフォルトでは、ossfsはdir/ 、dir、およびdir_$folde r$ をディレクトリとして認識します。

      ossfsがdir/ のみをディレクトリとして認識して、ossfsとサーバー間の対話リクエストの数を減らす場合は、-onotsup_compat_dirオプションを使用する必要があります。

      ensure_diskfreeossfsで予約できるディスクの使用可能なストレージ容量。 パフォーマンスを向上させるために、ossfsはディスクのストレージ容量を使用して、デフォルトでアップロードまたはダウンロードされた一時データを保存します。 このオプションを使用して、ossfsが予約できるディスクの使用可能なストレージ容量を設定できます。 単位：MB。 たとえば、ossfsがディスクの1024 MBのストレージ容量を予約する場合は、-oensure_diskfree=1024オプションを使用します。
      dbglevelログレベルを指定します。 有効な値：
      • critical (デフォルト)
      • error
      • 警告
      • info
      • デバッグ
      curldbglibcurlロギングを有効にするかどうかを指定します。 デフォルトでは、libcurlログは無効になっています。 libcurlログを取得するには、-ocurldbgオプションを使用します。
    • ヒューズオプション
      オプション説明
      allow_otherマウントポイントの権限を変更して、すべてのユーザーからのアクセスを許可します。 デフォルトでは、rootユーザーのみがこのオプションを設定できます。 このオプションには値がありません。 すべてのユーザーからのアクセスを許可するには、-oallow_otherオプションを使用します。
      uidディレクトリの所有者のユーザーID (UID) を指定します。
      gidディレクトリの所有者のグループID (GID) を指定します。