ossfs 2.0挂载选项说明

分类

配置项

是否必填

说明

默认值

Bucket基本配置

oss_endpoint

是

Bucket访问域名。

无

oss_bucket

是

Bucket名称。

无

访问凭证配置

oss_access_key_id

是

访问密钥ID。

无

oss_access_key_secret

是

访问密钥。

无

分类

配置项

是否必填

说明

默认值

Bucket配置

oss_bucket_prefix

否

挂载存储空间中指定的文件目录。

空

oss_region

否

存储空间的region id，用于OSS V4签名算法。若不指定，则使用OSS V1签名算法。

空

缓存配置

attr_timeout

否

文件元数据缓存失效时间（秒）。

60

negative_timeout

否

无效目录项缓存失效时间（秒）。

0

日志配置

log_level

否

日志输出的等级，可选info、debug。

info

log_dir

否

日志文件存储目录。

/tmp/ossfs2

运行模式

f

否

是否使用前台运行模式。

false

d

否

是否使用前台运行模式并开启fuse调试日志。

false

挂载模式

ro

否

使用只读的方式进行挂载。

false

分类

配置项

是否必填

说明

默认值

上传配置

upload_buffer_size

否

分片上传缓冲区大小（Bytes），即分片大小。该参数决定了能够写入文件最终大小，计算方式为upload_buffer_size * 10000。

8388608

upload_concurrency

否

分片上传并发度。

64

sync_upload

否

开启后，关闭文件时会等待文件上传完毕后返回。

true

下载/预取配置

prefetch_concurrency

否

全局下载预取的并发度。单个文件的预取并发度为min(64, prefetch_concurrency)。

256

prefetch_chunk_size

否

预取的chunk大小（Bytes）。

8388608

prefetch_chunks

否

预取的chunk数量，不设置默认为prefetch_concurrency的3倍。

0（根据prefetch_concurrency自动配置）

内存管理配置

total_mem_limit

否

总使用内存限制（Bytes），设置后会根据内存限制自适应调整upload和prefetch的并发程度。

若不配置此选项，默认会使用prefetch_chunk_size * prefetch_chunks大小的内存作为数据读取预取缓冲区，使用upload_buffer_size * upload_concurrency大小的内存作为数据写入缓冲区，读写操作最大会分配约8 GB 内存。请确保您的设备有足够的内存资源，以避免潜在的OOM（内存不足）问题。

0

文件校验/元数据配置

enable_crc64

否

是否开启文件写入CRC（循环冗余校验）校验。

true

close_to_open

否

支持close-to-open语义，开启该选项后，打开文件时会发送GetObjectMeta请求获取OSS中的文件信息，保证元数据信息的实时性。

默认为关闭，此时打开文件时根据文件的元数据缓存过期时间，决定是否发送请求到OSS以获取最新的文件属性。开启此选项后，由于每次打开文件时都会强制发送请求到OSS，在大量读取小文件的场景下会显著增加访问时延。

false

文件操作配置

rename_dir_limit

否

单次重命名操作中，源目录下所有子孙文件与目录数量的上限总和。一旦实际数量超过该上限，重命名操作便会报错。

2000000

enable_appendable_object

否

开启后，写入文件使用AppendObject接口，该模式下可以支持对一个文件边写边读。

false

appenable_object_autoswitch_threshold

否

在enable_appendable_object开启后，小于等于该参数大小（Bytes）的OSS中非Appendable对象，追加写入时支持自动转换成Appendable对象。

0

请求超时配置

oss_request_timeout_ms

否

发送至OSS的请求超时时间（毫秒）。

60000