通過-h選項來查看ossfs支援的設定參數 - Object Storage Service

您可以通過-h選項來查看ossfs支援的設定參數。

命令格式

./ossfs -h

您需要在ossfs程式所在目錄使用該命令，預設目錄為/usr/local/bin/，以實際安裝環境為準。

常用選項

ossfs是基於fuse使用者態檔案系統來實現的，所以除了ossfs自身的選項外，也支援fuse的選項。掛載儲存空間（Bucket）時，您可以根據具體的業務情境設定不同的啟動選項。選項格式如下：

-o option_name[=option_value]  或者  -ooption_name[=option_value]

例如在掛載時指定uid和gid參數：

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

ossfs常用選項如下：

選項名稱	描述
url	用於指定儲存空間的訪問網域名稱，格式為`url=endpoint`。當不指定具體的請求協議時，預設選擇HTTP。樣本： `-ourl=oss-cn-hangzhou.aliyuncs.com -ourl=http://oss-cn-hangzhou.aliyuncs.com -ourl=https://oss-cn-hangzhou.aliyuncs.com`
passwd_file	用於指定儲存儲存空間存取金鑰的檔案，預設為/etc/passwd-ossfs。檔案的許可權必須正確設定，當密鑰檔案為/etc/passwd-ossfs時，許可權可設定為640；當密鑰檔案不為/etc/passwd-ossfs時，許可權需要設定為600。密鑰檔案內容的格式為`${bucket}:${access-key-id}:{access-key-secret}`。樣本： #將密鑰寫入/etc/passwd-ossfs檔案並設定640許可權 echo bucket-test:LTAIbZcdVCmQ**:MOk8x0y9hxQ31coh7A5e2MZEUz > /etc/passwd-ossfs chmod 640 /etc/passwd-ossfs #將密鑰寫入/passwd-path/passwd-ossfs檔案並設定600許可權 echo bucket-test:LTAIbZcdVCmQ:MOk8x0y9hxQ31coh7A5e2MZEUz** > /passwd-path/passwd-ossfs chmod 600 /passwd-path/passwd-ossfs # 定義變數`opasswd_file`，其值為/passwd-path/passwd-ossfs -opasswd_file=/passwd-path/passwd-ossfs
max_stat_cache_size	用於指定檔案中繼資料的緩衝空間可緩衝多少個檔案的中繼資料。單位為個，預設值為100,000。當目錄下檔案比較多時，可以調整這個參數，加快ls的速度。如果要禁止使用中繼資料快取，可以設定為0。 `ossfs bucket_name mount_point -omax_stat_cache_size=0`
allow_other	賦予電腦上其他使用者訪問掛載目錄的許可權，但不包括目錄內的檔案。如果您要變更檔夾中的檔案存取權限，請用chmod命令。該選項不需要設定選項值，如果需要啟用，請直接添加-oallow_other選項。 `ossfs bucket_name mount_point -ourl=endpoint -oallow_other`
dbglevel	用於設定日誌資訊的層級，支援日誌資訊層級為critical、error、warn、info和debug ，預設值為critical，例如需要開啟info層級的日誌，請添加-odbglevel=info選項。日誌資訊會寫到系統日誌中，例如在centos系統會寫到/var/log/messages中。 `ossfs bucket_name mount_point -odbglevel=info`
f	以前台方式而非守護進程方式運行ossfs，在前台模式下，日誌會輸出到終端螢幕。該參數一般用於調試問題時使用。 `ossfs bucket_name mount_point -f`
d	用於開啟日誌資訊，同時該選項也會傳遞到fuse。在ossfs裡，該選項等效於-odbglevel=info。 `ossfs bucket_name mount_point -d`

選項列表

一般情況下，選項的格式均為-ooption_name=option_value 或-o option_name=option_value。

說明

以下選項描述適用於ossfs 1.91.2版本及以上，其餘版本部分選項可能不支援或預設參數發生變化，具體可以通過-h選項查看支援的設定參數。您可以通過進入ossfs程式所在目錄執行./ossfs --version命令來查看ossfs版本。其中ossfs程式的預設目錄為/usr/local/bin/，具體請以實際安裝環境為準。

ossfs選項列表

選項名稱	描述
retries	指定請求失敗後的重試次數，預設值為2。
storage_class	指定寫入OSS檔案的儲存類型。選擇性參數為： Standard（預設值）：標準儲存 IA：低頻訪問儲存 Archive：Archive Storage 關於儲存類型的更多詳情請參見儲存類型概述。
public_bucket	指定使用者通過匿名方式訪問儲存空間，該選項僅對Bucket ACL為public-read-write的儲存空間有效。選擇性參數為： 0（預設值）：不使用匿名方式訪問。 1：使用匿名方式訪問。
passwd_file	用於指定儲存儲存空間存取金鑰的檔案，預設為/etc/passwd-ossfs。
connect_timeout	指定串連的逾時時間，單位為秒，預設值為300秒。
readwrite_timeout	指定讀或者寫請求的逾時時間，單位為秒，預設值為120秒。
max_stat_cache_size	指定檔案中繼資料的緩衝數量，單位為個，預設值為100,000，約額外消耗40 MB大小的空間。
stat_cache_expire	指定檔案中繼資料快取的失效時間，單位為秒，預設值為900秒。
no_check_certificate	對服務端的認證不做校正，僅在使用HTTPS協議時有效，預設開啟認證校正。該選項無選項值，使用時請直接添加-ono_check_certificate選項。
multireq_max	列舉檔案時，訪問檔案中繼資料時的最大的並發數，預設值為20。
parallel_count	以分區模式上傳大檔案時，分區的並發數，預設值為5。
multipart_size	以分區模式上傳資料時分區的大小，單位是MB，預設值為10。該參數會影響最大支援的檔案大小。分區模式上傳時，最多的分區數為10000，預設值下，最大支援的檔案為100 GB。如果需要支援更大的檔案，需要根據需求調整這個值。
url	指定儲存空間的訪問網域名稱。
umask	用來設定掛載點內檔案/檔案夾的許可權掩碼。例如需要設定掛載點內檔案/檔案夾的許可權為770，則增加-oumask=007；需要設定掛載點內檔案/檔案夾的許可權為700，則增加-oumask=077。
enable_content_md5	指定進行上傳操作時，是否設定CONTENT_MD5，預設不設定。如果您需要設定Content-MD5，則增加-oenable_content_md5選項。
ram_role	使用ram_role方式訪問OSS。當使用該方式訪問OSS時，會忽略密鑰檔案的AccessKey ID和AccessKey Secret參數。
listobjectsv2	當Bucket開啟版本控制時，建議使用-olistobjectsv2選項列舉檔案。
notsup_compat_dir	用於限制不相容多種目錄類型。預設情況下，ossfs會將`dir/`、`dir`以及`dir_$folder$`識別為目錄。如果您需要限制ossfs僅將`dir/`識別為目錄，以減少ossfs與服務端的互動請求，您需要使用-onotsup_compat_dir選項。
ensure_diskfree	用於設定ossfs保留的可用磁碟空間大小。為提升效能，預設情況下ossfs會使用磁碟空間來儲存上傳或下載的臨時資料。您可以通過該選項設定保留的可用硬碟空間大小，單位為MB。例如，您需要設定ossfs保留1024 MB的可用磁碟空間，則使用-oensure_diskfree=1024。
direct_read	預設情況下ossfs會使用磁碟空間來儲存上傳或下載的臨時資料。您可以通過設定該選項來直接從OSS讀取資料而不使用本地磁碟空間。預設不設定，您可以使用-odirect_read來開啟直讀模式。說明當檔案在直讀過程中檢測到用write、rename或truncate操作時，該檔案會退出直讀模式直至檔案重新被開啟。
direct_read_chunk_size	直讀模式下指定一次讀請求從OSS中讀取的資料量大小，單位為MB，預設值是4。取值範圍為1～32。該選項僅在開啟直讀模式，即使用-odirect_read選項時生效。
direct_read_prefetch_thread	直讀模式下，ossfs以後台非同步任務的方式來進行預讀，該選項可以指定同一時間預取請求的最大線程數量，預設值是64。該選項僅在開啟直讀模式，即使用-odirect_read選項時生效。
direct_read_prefetch_chunks	直讀模式下指定預讀到記憶體中chunk的數量，用來提升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。例如，您需要設定ossfs保留1024 MB的可用磁碟空間，則可以在掛載時添加`-oensure_diskfree=1024`。
del_cache	控制刪除本機快取。預設不刪除。您可以通過設定該選項來配置ossfs清理本機資料緩衝。例如，您可以在掛載時添加`-odel_cache`選項，ossfs會在mount和umount時清理`use_cache`指定的檔案夾下的快取檔案。
max_dirty_data	當寫檔案大小超過這個值時，不用關閉檔案就會提前上傳。預設值為5120 MB。例如，您需要設定寫檔案超過2000 MB就提前上傳，則可以在掛載時添加`-omax_dirty_data=2000`。
tmpdir	預設情況下，資料會臨時緩衝在系統硬碟/tmp目錄下，您可以通過指定該選項來配置預設的臨時緩衝路徑。該選項和use_cache選項不可同時使用。例如，您可以在掛載時添加-otmpdir=path，配置預設的臨時資料緩衝路徑為path。其中path請根據實際路徑設定，例如/data/your_foldername。

fuse選項列表

選項名稱	描述
allow_other	修改掛載點的許可權，允許所有的使用者訪問。該選擇預設情況下只允許root使用者佈建。該選項無選項值，使用時請直接添加-oallow_other選項。
uid	指定檔案夾歸屬使用者的使用者UID。
gid	指定檔案夾歸屬使用者的使用者GID。