全部產品
Search

搜尋本產品

    Object Storage Service：ossfs 2.0常用配置樣本

    文件中心

    Object Storage Service：ossfs 2.0常用配置樣本

    更新時間：Dec 04, 2025

    在實際使用過程中，為滿足不同情境下對儲存空間（OSS Bucket）的掛載需求，需對ossfs 2.0設定檔進行針對性配置，然後在掛載儲存空間（OSS Bucket）時，引用該設定檔即可完成掛載。本文將為您介紹，如何通過掛載選項，產生適用不同情境的ossfs 2.0設定檔。

    建立設定檔

    重要

    一個設定檔僅能掛載一個Bucket。若要掛載多個Bucket，需建立多個設定檔，對每個Bucket分別進行配置，檔案名稱與路徑可自訂。掛載時引用相應的設定檔，就能實現多個Bucket的掛載。

    您可按需自由設定ossfs 2.0設定檔的檔案名稱與路徑。例如，建立/etc/ossfs2.conf檔案作為設定檔。

    sudo touch /etc/ossfs2.conf

    配置訪問憑證

    Accesskey

    ossfs 2.0.1及後續版本推薦您使用更安全便捷的環境變數方式配置RAM使用者的AccessKey（存取金鑰） 掛載OSS Bucket。如已通過環境變數配置，無需在設定檔中重複設定。

    環境變數

    export OSS_ACCESS_KEY_ID=LTAI******************
export OSS_ACCESS_KEY_SECRET=8CE4**********************

    設定檔

    --oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
--oss_bucket=bucketName
--oss_access_key_id=AAAI************
--oss_access_key_secret=AAA8x*************************

    ECSRAMRole

    ossfs 2.0.2及後續版本支援在設定檔中使用ECSRAMRole（執行個體RAM角色）完成訪問憑證配置。

    --oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
--oss_bucket=bucketName
--ram_role=EcsRamRoleOssTest

    設定檔格式

    格式說明

    --為掛載選項首碼，<option>為掛載選項名稱，[=<value>]中value為掛載選項值，[]代表掛載選項值為可選。

    --<option>[=<value>]

    配置樣本

    # Bucket所處Endpoint（地區節點）
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com

# Bucket名稱
--oss_bucket=bucketName

# 存取金鑰AccessKey ID和AccessKey Secret（可選）。對於ossfs 2.0.1及後續版本的使用者，可通過環境變數來配置訪問憑證，無需在設定檔中進行設定。
--oss_access_key_id=AAAI************
--oss_access_key_secret=AAA8x*************************

    常用配置樣本

    說明

    查看Bucket的Endpoint請進入Bucket列表頁面，選擇目標Bucket並進入，接著單擊左側導覽列的概覽選項，在概覽頁的訪問連接埠欄中即可查看目標Bucket所處的地區節點。如圖所示，以杭州地區Bucket為例。

    image

    請開啟已建立的ossfs 2.0設定檔，參照以下樣本（均以杭州地區內網Endpoint為例）配置並儲存。內網和OSS加速器Endpoint僅支援同地區VPC內執行個體掛載，資料轉送更快速、穩定；不建議ossfs配合外網Endpoint使用，受高延遲和不穩定的Internet網路連接影響，可能會出現各種卡頓問題。

    掛載整個Bucket

    掛載整個Bucket中的所有目錄檔案到本地。

    # Bucket所處Endpoint（地區節點）
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com

# Bucket名稱
--oss_bucket=bucketName

# 存取金鑰AccessKey ID和AccessKey Secret（ossfs 2.0.1及後續版本該配置項可選）
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

    掛載Bucket中的指定目錄

    掛載Bucket時，指定目標Bucket中的特定目錄掛載到本地。

    # Bucket所處Endpoint（地區節點）
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com

# Bucket名稱
--oss_bucket=bucketName

# OSS檔案目錄路徑（可選）
--oss_bucket_prefix=folder-test/folder-prefix/

# 存取金鑰AccessKey ID和AccessKey Secret（ossfs 2.0.1及後續版本該配置項可選）
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

    掛載Bucket並配置記憶體限制

    在掛載Bucket時，分配指定的記憶體給ossfs 2.0進程使用。

    重要

    若不配置記憶體使用量限制，ossfs 2.0預設會以效能優先進行調優，最大會使用約8 GB記憶體用於資料讀寫，從而擷取最優效能。如果您的記憶體資源有限，建議配置total_mem_limit選項，以免出現OOM（記憶體不足）問題。

    # Bucket所處Endpoint（地區節點）
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com

# Bucket名稱
--oss_bucket=bucketName

# 記憶體限制參數，單位為位元組。（可選）
--total_mem_limit=4294967296

# 存取金鑰AccessKey ID和AccessKey Secret（ossfs 2.0.1及後續版本該配置項可選）
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

    掛載Bucket並開啟調試日誌

    在掛載Bucket時，將記錄層級指定為debug，同時自訂日誌存放路徑。

    # Bucket所處Endpoint（地區節點）
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com

# Bucket名稱
--oss_bucket=bucketName

# 日誌存放路徑（可選），請確保 /tmp/log 目錄存在。
--log_dir=/tmp/log/ossfs2

# 記錄層級（可選）
--log_level=debug

# 存取金鑰AccessKey ID和AccessKey Secret（ossfs 2.0.1及後續版本該配置項可選）
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

    掛載並配置Bucket存取權限

    重要

    ossfs 2.0掛載預設允許所有使用者讀寫所有檔案，若您需要更嚴格的許可權需求，請參考如下配置。以下配置樣本僅適用於ossfs 2.0.1及後續版本。

    • 掛載整個Bucket中的所有目錄到本地，同時限制非root使用者讀寫。

      # Bucket所處Endpoint（地區節點）
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com

# Bucket名稱
--oss_bucket=bucketName

# 禁止非root使用者（掛載使用者）訪問
--allow_other=false

# 通用檔案夾許可權屬性
--dir_mode=0755

# 通用檔案許可權屬性
--file_mode=0644

# 存取金鑰AccessKey ID和AccessKey Secret（ossfs 2.0.1及後續版本該配置項可選）
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

    • 掛載整個Bucket中的所有目錄到本地，僅允許root及特定使用者讀寫，其他使用者唯讀。

      # Bucket所處Endpoint（地區節點）
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com

# Bucket名稱
--oss_bucket=bucketName
 
# 通用檔案夾許可權屬性
--dir_mode=0755

# 通用檔案許可權屬性
--file_mode=0644

# 特定使用者uid和gid（可以使用id命令擷取對應使用者的uid和gid）
--uid=1000
--gid=1000

# 存取金鑰AccessKey ID和AccessKey Secret（ossfs 2.0.1及後續版本該配置項可選）
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

    後續步驟

    完成ossfs 2.0的安裝與配置後，接著您就可以將Bucket掛載到本地Linux系統中。具體操作，請參見掛載儲存空間。

    相關文檔

    更多有關ossfs 2.0掛載選項說明，請參見掛載選項說明。