在编写ossfs 2.0配置文件时，您可以根据不同的挂载需求，灵活配置各项参数，生成符合特定场景的配置文件。通过该配置文件，您可以轻松实现对OSS Bucket的多样化文件系统挂载，满足不同业务场景的需求。
基础配置项
分类 | 配置项 | 是否必填 | 说明 | 默认值 |
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的并发程度。 若不配置此选项，默认会使用 | 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 |
相关文档
关于ossfs 2.0常用场景的配置文件示例，请参见配置ossfs 2.0。
ossfs 2.0挂载Bucket到本地系统。