命令格式

./ossfs -h

您需要在ossfs程序所在目錄使用該命令，默認(rèn)目錄為/usr/local/bin/，以實(shí)際安裝環(huán)境為準(zhǔn)。

常用選項(xiàng)

-o option_name[=option_value]  或者  -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文件并設(shè)置640權(quán)限
echo bucket-test:LTAIbZcdVCmQ****:MOk8x0y9hxQ31coh7A5e2MZEUz**** > /etc/passwd-ossfs
chmod 640 /etc/passwd-ossfs

#將密鑰寫入/passwd-path/passwd-ossfs文件并設(shè)置600權(quán)限
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

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

選項(xiàng)列表

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

• ossfs選項(xiàng)列表

  選項(xiàng)名稱	描述
  retries	指定請(qǐng)求失敗后的重試次數(shù)，默認(rèn)值為2。
  storage_class	指定寫入OSS文件的存儲(chǔ)類型?？蛇x參數(shù)為： Standard（默認(rèn)值）：標(biāo)準(zhǔn)存儲(chǔ) IA：低頻訪問(wèn)存儲(chǔ) Archive：歸檔存儲(chǔ) 關(guān)于存儲(chǔ)類型的更多詳情請(qǐng)參見(jiàn)存儲(chǔ)類型概述。
  public_bucket	指定用戶通過(guò)匿名方式訪問(wèn)存儲(chǔ)空間，該選項(xiàng)僅對(duì)Bucket ACL為public-read-write的存儲(chǔ)空間有效。可選參數(shù)為： 0（默認(rèn)值）：不使用匿名方式訪問(wèn)。 1：使用匿名方式訪問(wèn)。
  passwd_file	用于指定保存存儲(chǔ)空間訪問(wèn)密鑰的文件，默認(rèn)為/etc/passwd-ossfs。
  connect_timeout	指定連接的超時(shí)時(shí)間，單位為秒，默認(rèn)值為300秒。
  readwrite_timeout	指定讀或者寫請(qǐng)求的超時(shí)時(shí)間，單位為秒，默認(rèn)值為120秒。
  max_stat_cache_size	指定文件元數(shù)據(jù)的緩存數(shù)量，單位為個(gè)，默認(rèn)值為100,000，約額外消耗40 MB大小的空間。
  stat_cache_expire	指定文件元數(shù)據(jù)緩存的失效時(shí)間，單位為秒，默認(rèn)值為900秒。
  no_check_certificate	對(duì)服務(wù)端的證書不做校驗(yàn)，僅在使用HTTPS協(xié)議時(shí)有效，默認(rèn)開(kāi)啟證書校驗(yàn)。該選項(xiàng)無(wú)選項(xiàng)值，使用時(shí)請(qǐng)直接添加-ono_check_certificate選項(xiàng)。
  multireq_max	列舉文件時(shí)，訪問(wèn)文件元數(shù)據(jù)時(shí)的最大的并發(fā)數(shù)，默認(rèn)值為20。
  parallel_count	以分片模式上傳大文件時(shí)，分片的并發(fā)數(shù)，默認(rèn)值為5。
  multipart_size	以分片模式上傳數(shù)據(jù)時(shí)分片的大小，單位是MB，默認(rèn)值為10。該參數(shù)會(huì)影響最大支持的文件大小。分片模式上傳時(shí)，最多的分片數(shù)為10000，默認(rèn)值下，最大支持的文件為100 GB。如果需要支持更大的文件，需要根據(jù)需求調(diào)整這個(gè)值。
  url	指定存儲(chǔ)空間的訪問(wèn)域名。
  umask	用來(lái)設(shè)定掛載點(diǎn)內(nèi)文件/文件夾的權(quán)限掩碼。 例如需要設(shè)置掛載點(diǎn)內(nèi)文件/文件夾的權(quán)限為770，則增加-oumask=007；需要設(shè)置掛載點(diǎn)內(nèi)文件/文件夾的權(quán)限為700，則增加-oumask=077。
  enable_content_md5	指定進(jìn)行上傳操作時(shí)，是否設(shè)置CONTENT_MD5，默認(rèn)不設(shè)置。如果您需要設(shè)置Content-MD5，則增加-oenable_content_md5選項(xiàng)。
  ram_role	使用ram_role方式訪問(wèn)OSS。當(dāng)使用該方式訪問(wèn)OSS時(shí)，會(huì)忽略密鑰文件的AccessKey ID和AccessKey Secret參數(shù)。
  listobjectsv2	當(dāng)Bucket開(kāi)啟版本控制時(shí)，建議使用-olistobjectsv2選項(xiàng)列舉文件。
  notsup_compat_dir	用于限制不兼容多種目錄類型。默認(rèn)情況下，ossfs會(huì)將dir/、dir以及dir_$folder$識(shí)別為目錄。 如果您需要限制ossfs僅將dir/識(shí)別為目錄，以減少ossfs與服務(wù)端的交互請(qǐng)求，您需要使用-onotsup_compat_dir選項(xiàng)。
  ensure_diskfree	用于設(shè)置ossfs保留的可用磁盤空間大小。為提升性能，默認(rèn)情況下ossfs會(huì)使用磁盤空間來(lái)保存上傳或下載的臨時(shí)數(shù)據(jù)。您可以通過(guò)該選項(xiàng)設(shè)置保留的可用硬盤空間大小，單位為MB。例如，您需要設(shè)置ossfs保留1024 MB的可用磁盤空間，則使用-oensure_diskfree=1024。
  direct_read	默認(rèn)情況下ossfs會(huì)使用磁盤空間來(lái)保存上傳或下載的臨時(shí)數(shù)據(jù)。您可以通過(guò)設(shè)置該選項(xiàng)來(lái)直接從OSS讀取數(shù)據(jù)而不使用本地磁盤空間。默認(rèn)不設(shè)置，您可以使用-odirect_read來(lái)開(kāi)啟直讀模式。 說(shuō)明 當(dāng)文件在直讀過(guò)程中檢測(cè)到用write、rename或truncate操作時(shí)，該文件會(huì)退出直讀模式直至文件重新被打開(kāi)。
  direct_read_chunk_size	直讀模式下指定一次讀請(qǐng)求從OSS中讀取的數(shù)據(jù)量大小，單位為MB，默認(rèn)值是4。取值范圍為1～32。 該選項(xiàng)僅在開(kāi)啟直讀模式，即使用-odirect_read選項(xiàng)時(shí)生效。
  direct_read_prefetch_thread	直讀模式下，ossfs以后臺(tái)異步任務(wù)的方式來(lái)進(jìn)行預(yù)讀，該選項(xiàng)可以指定同一時(shí)間預(yù)取請(qǐng)求的最大線程數(shù)量，默認(rèn)值是64。 該選項(xiàng)僅在開(kāi)啟直讀模式，即使用-odirect_read選項(xiàng)時(shí)生效。
  direct_read_prefetch_chunks	直讀模式下指定預(yù)讀到內(nèi)存中chunk的數(shù)量，用來(lái)提升ossfs在順序讀場(chǎng)景下的性能，默認(rèn)值是32。 該選項(xiàng)僅在開(kāi)啟直讀模式，即使用-odirect_read選項(xiàng)時(shí)生效。
  direct_read_prefetch_limit	直讀模式下，ossfs通過(guò)內(nèi)存來(lái)緩存從OSS中預(yù)讀取的數(shù)據(jù)，通過(guò)該選項(xiàng)可以對(duì)ossfs預(yù)取的數(shù)據(jù)總量進(jìn)行限制，單位是MB，默認(rèn)值是1024。 該選項(xiàng)僅在開(kāi)啟直讀模式，即使用-odirect_read選項(xiàng)時(shí)生效。
  dbglevel	設(shè)置日志信息的級(jí)別，支持日志信息級(jí)別如下： critical（默認(rèn)值） error warn info debug
  curldbg	打開(kāi)libcurl的日志信息，默認(rèn)不打開(kāi)。如果需要輸出libcurl日志，則需要增加-ocurldbg選項(xiàng)。

• 數(shù)據(jù)緩存選項(xiàng)列表

  說(shuō)明

  關(guān)于數(shù)據(jù)緩存原理，具體請(qǐng)參見(jiàn)數(shù)據(jù)緩存。

  選項(xiàng)名稱	描述
  use_cache	啟用數(shù)據(jù)緩存并指定數(shù)據(jù)緩存路徑。默認(rèn)不啟用。您可以通過(guò)指定該選項(xiàng)來(lái)配置緩存路徑。 例如，您可以在掛載時(shí)添加-ouse_cache=path，則表示使用數(shù)據(jù)緩存且指定數(shù)據(jù)緩存路徑為path。其中path請(qǐng)根據(jù)實(shí)際路徑設(shè)置，例如/tmp/your_foldername。
  ensure_diskfree	控制預(yù)留磁盤空間大小。默認(rèn)不預(yù)留。您可以通過(guò)該選項(xiàng)設(shè)置保留的可用硬盤空間大小，避免磁盤寫滿影響其他應(yīng)用寫入，單位為MB。 例如，您需要設(shè)置ossfs保留1024 MB的可用磁盤空間，則可以在掛載時(shí)添加-oensure_diskfree=1024。
  del_cache	控制刪除本地緩存。默認(rèn)不刪除。您可以通過(guò)設(shè)置該選項(xiàng)來(lái)配置ossfs清理本地?cái)?shù)據(jù)緩存。 例如，您可以在掛載時(shí)添加-odel_cache選項(xiàng)，ossfs會(huì)在mount和umount時(shí)清理use_cache指定的文件夾下的緩存文件。
  max_dirty_data	當(dāng)寫文件大小超過(guò)這個(gè)值時(shí)，不用關(guān)閉文件就會(huì)提前上傳。默認(rèn)值為5120 MB。 例如，您需要設(shè)置寫文件超過(guò)2000 MB就提前上傳，則可以在掛載時(shí)添加-omax_dirty_data=2000。
  tmpdir	默認(rèn)情況下，數(shù)據(jù)會(huì)臨時(shí)緩存在系統(tǒng)盤/tmp目錄下，您可以通過(guò)指定該選項(xiàng)來(lái)配置默認(rèn)的臨時(shí)緩存路徑。該選項(xiàng)和use_cache選項(xiàng)不可同時(shí)使用。 例如，您可以在掛載時(shí)添加-otmpdir=path，配置默認(rèn)的臨時(shí)數(shù)據(jù)緩存路徑為path。其中path請(qǐng)根據(jù)實(shí)際路徑設(shè)置，例如/data/your_foldername。

• fuse選項(xiàng)列表

  選項(xiàng)名稱	描述
  allow_other	修改掛載點(diǎn)的權(quán)限，允許所有的用戶訪問(wèn)。該選擇默認(rèn)情況下只允許root用戶設(shè)置。該選項(xiàng)無(wú)選項(xiàng)值，使用時(shí)請(qǐng)直接添加-oallow_other選項(xiàng)。
  uid	指定文件夾歸屬用戶的用戶UID。
  gid	指定文件夾歸屬用戶的用戶GID。