FSX 挂载参数说明--对象存储-火山引擎

文档中心

导航

FSX 挂载参数说明

最近更新时间：2025.01.16 14:22:38首次发布时间：2024.12.30 16:33:20

本文介绍使用 FSX 客户端时支持配置的详细挂载参数，具体包括基本参数、读缓存参数、写缓存参数等。

基本参数

参数	是否必选	说明
region	是	存储桶所在地域。
no_writeback_cache	是	不开启内核 page cache 回写功能，保证 write 请求是顺序写。
endpoint	是	TOS 的访问域名。如果没有指定协议，则默认使用 HTTPS 协议，完整格式为 `https://{host}:{port}`。
access_key_id	否	在挂载命令中指定密钥信息，关于获取 Access Key ID 和 Secret Access Key 的具体操作，请参见 Access Key（密钥）管理。说明请确保 Access Key ID 和 Secret Access Key 所属账号拥有存储桶的读写权限，如果权限不足，可能导致挂载点无法使用。在挂载命令中指定密钥信息和在挂载命令中指定包含鉴权信息的文件路径为二选一，您必须设置其中一项。仅使用临时访问凭证的情况下，需要设置 `security_token` 参数。
secret_access_key
security_token
credential_filepath	否	在挂载命令中指定包含鉴权信息的文件路径，文件扩展名必须为 `json`，格式如下： `{ "VOLC_ACCESSKEY": "<ak_string>", "VOLC_SECRETKEY": "<sk_string>", "VOLC_SECURITY_TOKEN": "<sts_string>" }`
credential_timeout_sec	否	FSX 客户端动态配置鉴权文件的时间，单位：秒。说明 `credential_timeout_sec` 和 `credential_filepath` 参数需要搭配使用。
num_meta_threads	否	元数据线程数量，默认为 32，建议不要小于默认值。
num_io_threads	否	读写线程数量，默认为 16，建议不要小于默认值。
storage_class	否	指定上传到 TOS 文件的存储类型。可选参数为： `STANDARD`：标准存储，默认值。 `IA`：低频访问存储。 `ARCHIVE_FR`：归档闪回存储。
enable_verify_ssl	否	配置是否开启 SSL 证书校验，默认开启，取值说明如下： `true`：开启 SSL 证书校验。 `false`：不开启 SSL 证书校验。
max_inode_num	否	单个挂载点最大的 inode 数量，默认值为 1000w，建议不要小于默认值。如果挂载点单目录下文件数超过 1000w，建议按照单目录下最大文件数设置。
rw	否	使用读写方式挂载文件系统，默认开启。
ro	否	使用只读方式挂载文件系统，默认关闭，可以通过指定挂载选项 `-o ro` 开启。
max_retry_count	否	请求失败最大重试次数，默认 3 次。
connection_timeout	否	建立连接超时时间，单位：毫秒，默认 10000 毫秒。
socket_timeout	否	请求超时时间，请求超时没有收到数据将会关闭连接，默认为 30000 毫秒。

预读参数

说明

您可以在挂载存储桶时设置预读参数，配置预读性能，关于预读性能的详细介绍，请参见预读性能。

参数	是否必选	说明
prefetch_buffer_size	否	预读的数据块大小，默认为 4MB，单位为 MB。
prefetch_cache_pool_limit	否	预读缓存内存占用最大空间，默认为 1024MB，单位为 MB。
prefetch_forward_buffer_count	否	单文件最大预读的数据块个数，默认为 32。
prefetch_backward_buffer_count	否	保留当前读请求偏移之前的数据块个数，默认为 1。
num_prefetch_threads	否	预读线程数量，默认为 32，建议不要小于默认值。

读缓存参数

参数	是否必选	说明
read_cache_dir	否	读缓存目录，默认为空，即不使用读缓存。
max_read_cache_size	否	读缓存占用最大空间，单位为 MB。默认为0，代表不使用读缓存。

写缓存参数

说明

您可以在挂载存储桶时设置写缓存参数，配置写性能，关于写性能的详细介绍，请参见写缓存性能。

参数	是否必选	说明
temp_dir	否	写缓存目录，默认为 `/tmp`。 FSX 客户端默认会先写入数据到本地临时文件目录，临时文件目录可以在挂载时指定 `temp_dir` 参数进行配置，默认在 `/tmp/` 下创建临时目录作为临时文件目录。如果您对性能敏感，可以在挂载时指定 `tmpfs` 作为写临时文件目录。关于写性能的详细介绍，请参见写缓存性能。
max_temp_parts	否	最大缓存脏段数目，默认为 10240，建议不要小于默认值。
num_bg_threads	否	上传多段数据的线程数量，默认为 32 ，建议不要小于默认值。
part_size	否	多段上传时的段大小，单位为 MB，默认为 8MB，取值范围为 [4，5120]。TOS 约束最多上传 10000 个段，可以通过调整段大小来调整上传的对象大小。说明需要设置为正整数。

访问权限

参数	是否必选	说明
uid	否	设置文件或目录属于某个用户时，需要填写的用户 uid。
gid	否	设置文件或目录属于某个用户组时，需要填写的用户 gid。
file_mode	否	用于设置挂载文件的权限，默认取值为 644。
dir_mode	否	用于设置目录的权限，默认取值为 755。