本文介绍使用 FSX 客户端时支持配置的详细挂载参数，具体包括基本参数、读缓存参数、写缓存参数等。 ## 基本参数 |**参数** |**是否必选** |**说明** | |---|---|---| |region |是 |存储桶所在地域。 | |no_writeback_cache |是 |不开启内核 page cache 回写功能，保证 write 请求是顺序写。 | |endpoint |是 |TOS 的访问域名，仅支持 TOS 域名，暂不支持 S3 域名。如果没有指定协议，则默认使用 HTTPS 协议，完整格式为 `https://{host}:{port}`。 | |access_key_id |否 |在挂载命令中指定密钥信息，关于获取 Access Key ID 和 Secret Access Key 的具体操作，请参见 [Access Key（密钥）管理](https://www.volcengine.com/docs/6291/65568)。|\ | | |:::tip|\ | | ||\ | | |* 请确保 Access Key ID 和 Secret Access Key 所属账号拥有存储桶的读写权限，如果权限不足，可能导致挂载点无法使用。|\ | | |* 在挂载命令中指定密钥信息和在挂载命令中指定包含鉴权信息的文件路径为二选一，您必须设置其中一项。|\ | | |* 仅使用临时访问凭证的情况下，需要设置 `security_token` 参数。|\ | | ||\ | | |:::| |secret_access_key |^^|^^| |security_token |^^|^^| |credential_filepath |否 |指定鉴权凭证文件的绝对路径，以加载访问所需的认证信息。您需要自行创建鉴权凭证文件，且该文件扩展名必须为 `json`，包含内容如下：|\ | | |```Bash|\ | | |{|\ | | | "VOLC_ACCESSKEY": "",|\ | | | "VOLC_SECRETKEY": "",|\ | | | "VOLC_SECURITY_TOKEN": ""|\ | | |}|\ | | |```|\ | | | | |credential_timeout_sec |否 |FSX 客户端动态配置鉴权文件的时间，单位：秒。|\ | | |:::tip|\ | | |`credential_timeout_sec` 和 `credential_filepath` 参数需要搭配使用。|\ | | ||\ | | |:::| |num_meta_threads |否 |元数据线程数量，默认为 32，建议不要小于默认值。 | |num_io_threads |否 |读线程数量，默认为 16，建议不要小于默认值。 | |num_write_threads |否 |写线程数量，当未指定 `num_write_threads` 时，系统自动将其默认值设置为 `num_io_threads` 的值。|\ | | |:::tip|\ | | |仅 1.2.7.530 及以上版本的 FSX 工具支持 `num_write_threads` 参数。|\ | | ||\ | | |:::| |storage_class |否 |指定上传到 TOS 文件的存储类型。可选参数为：|\ | | ||\ | | |* `STANDARD`：标准存储，默认值。|\ | | |* `IA`：低频访问存储。|\ | | |* `ARCHIVE_FR`：归档闪回存储。 | |enable_verify_ssl |否 |配置是否开启 SSL 证书校验，默认开启，取值说明如下：|\ | | ||\ | | |* `true`：开启 SSL 证书校验。|\ | | |* `false`：不开启 SSL 证书校验。 | |max_inode_num |否 |当前挂载点最大的 inode 数量，最大值为 18446744073709551615，默认值为 1000w，一般不建议修改该值。如果挂载点下文件和目录总数超过 1000w，建议按照实际的使用数量调大该值。 | |max_file_num |否 |当前挂载点支持同时打开的句柄数量，通常操作系统会首先限制用户能打开的文件句柄数量。在操作系统限制放开时，还需要关注该参数值是否够用。参数默认值是65535。调大该参数值时，会增加TOS FSx的内存占用量，默认情况下，为发放句柄准备的内存占用约50MB内存，调大参数时，内存随着参数值线性增加。 | |rw |否 |使用读写方式挂载文件系统，默认开启。 | |ro |否 |使用只读方式挂载文件系统，默认关闭，可以通过指定挂载选项 `-o ro` 开启。 | |max_retry_count |否 |请求失败最大重试次数，默认 3 次。 | |connection_timeout |否 |建立连接超时时间，单位：毫秒，默认 10000 毫秒。 | |socket_timeout |否 |请求超时时间，请求超时没有收到数据将会关闭连接，默认num_io_threads为 30000 毫秒。 | |persist_dir |否 |系统运行时的状态文件存放目录，默认值为 `/opt/tmp/fsx`。该目录占用空间大小与 `max_inode_num` 和 `max_file_num` 参数的值有关。建议预留 2GiB 磁盘空间。 | |tos_is_custom_domain |否 |当前域名是否为自定义域名，默认为 false。 | |tos_incremental_upload |否 |是否开启追加写，默认为 false。 | |tos_allow_delete |否 |是否允许删除文件，默认为 false。 | |tos_create_empty_file |否 |创建新文件场景，在 open 时是否创建 0 字节文件到 TOS 桶中，用于保证可见性，默认为 true。 | |tos_sse |否 |设置目标对象的加密方式，完成挂载后，上传的对象默认会使用该服务端加密方式，取值说明如下：|\ | | ||\ | | |* `AES256`：使用 SSE\-TOS 加密方式，并采用 AES256 加密算法。|\ | | |* `kms`：使用 SSE\-KMS 加密方式，并采用 AES256 加密算法。|\ | | ||\ | | |关于 SSE\-TOS、 SSE\-KMS 加密方式详细说明，请参见[加密方式](/docs/6349/105525#.5Yqg5a-G5pa55byP)。|\ | | |:::warning|\ | | |使用 SSE\-TOS 或 SSE\-KMS 服务端加密时，暂不支持 SM4 加密算法。|\ | | ||\ | | |:::| |tos_sse_kms_key_id |否 |KMS 主密钥的 TRN，用于指定 SSE\-KMS 加密目标对象使用的主密钥。格式为 `trn:kms:::keyrings//keys/`，其中 `region` 为密钥所属 Region ID，`accountID` 为密钥所属账号的 ID，`keyring` 为密钥环别名，`key` 为主密钥别名。|\ | | |:::tip|\ | | |您可以登录 [KMS 控制台](https://console.volcengine.com/kms/region:kms+cn-beijing/primary?)，在**用户主密钥**页面单击目标密钥环，在**密钥环详情**页面，目标密钥的**密钥 TRN 及别名**列获取密钥 TRN。|\ | | ||\ | | |:::| ## 预读参数 :::tip 您可以在挂载存储桶时设置预读参数，配置预读性能，关于预读性能的详细介绍，请参见[预读性能](/docs/6349/1404638#65d6bdc6)。 ::: |**参数** |**是否必选** |**说明** | |---|---|---| |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 |否 |读缓存目录，默认为空，即不使用读缓存。|\ | | |:::tip|\ | | |如果您需要使用读缓存功能，建议为读缓存配置独立的数据盘或独立分区的文件系统，避免与系统的其它应用互相抢占磁盘空间。您可以为读缓存和写缓存配置相同的文件系统分区，区分不同目录即可。若读缓存和写缓存合用一个分区，建议为读缓存和写缓存预留总计 120GiB 的磁盘空间。|\ | | ||\ | | |:::| |max_read_cache_size |否 |读缓存占用最大空间，单位为 MB。默认为0，代表不使用读缓存。 | ## 写缓存参数 :::tip 写缓存默认开启，且不支持关闭。您可以在挂载存储桶时设置写缓存参数，配置写性能，关于写性能的详细介绍，请参见[写缓存性能](/docs/6349/1404638#ebcd14ca)。 ::: |**参数** |**是否必选** |**说明** | |---|---|---| |temp_dir |否 |写缓存目录，默认为 `/tmp`。|\ | | |FSX 客户端默认会先写入数据到本地临时文件目录，临时文件目录可以在挂载时指定 `temp_dir` 参数进行配置，默认在 `/tmp/` 下创建临时目录作为临时文件目录。如果您对性能敏感，可以在挂载时指定 `tmpfs` 作为写临时文件目录。关于写性能的详细介绍，请参见[写缓存性能](/docs/6349/1404638#ebcd14ca)。|\ | | |:::tip|\ | | ||\ | | |* 如果您需要使用写缓存功能，建议为写缓存配置独立的数据盘或独立分区的文件系统，避免与系统的其它应用互相抢占磁盘空间。您可以为读缓存和写缓存配置相同的文件系统分区，区分不同目录即可。写缓存最少需要 80GiB的磁盘空间，若读缓存和写缓存合用一个分区，建议为读缓存和写缓存预留总计 120GiB 的磁盘空间。|\ | | |* 写缓冲区占用的最大空间为 `max_temp_parts` 与 `part_size` 的乘积，因此 temp_dir 目录的可用存储空间必须大于 `max_temp_parts` 与 `part_size` 的乘积，否则使用 FSX 挂载存储桶会失败。|\ | | ||\ | | |:::| |num_bg_threads |否 |上传多段数据的线程数量，默认为 32 ，建议不要小于默认值。 | |part_size |否 |多段上传时的段大小，单位为 MiB，默认为 8MiB，取值范围为 [4，5120]。TOS 约束最多上传 10000 个段，可以通过调整段大小来调整上传的对象大小。具体使用方式，请参见[上传大文件](/docs/6349/1756985)。|\ | | |:::tip|\ | | |`part_size` 的值必须为正整数。|\ | | ||\ | | |:::| |max_temp_capacity |否 |最大写缓存占用磁盘空间，单位为 GiB，默认为 10GiB，建议不要小于默认值。|\ | | |:::tip|\ | | |仅 1.2.7.530 及以上版本的 FSX 工具支持 `max_temp_capacity` 参数。|\ | | ||\ | | |:::| ## 访问权限 |**参数** |**是否必选** |**说明** | |---|---|---| |uid |否 |设置文件或目录属于某个用户时，需要填写的用户 uid。 | |gid |否 |设置文件或目录属于某个用户组时，需要填写的用户 gid。 | |file_mode |否 |用于设置挂载文件的权限，默认取值为 644。 | |dir_mode |否 |用于设置目录的权限，默认取值为 755。 | ## 挂载方式 |**参数** |**是否必选** |**说明** | |---|---|---| |native_fuse |否 |是否使用 Linux 原生 Fuse 工具挂载 TOS，取值说明如下：|\ | | ||\ | | |* `true`：使用 Linux 原生 Fuse 工具挂载 TOS。|\ | | |* `false`：使用 FSX 工具挂载 TOS。|\ | | ||\ | | |默认为 false。|\ | | |:::warning|\ | | |使用 Linux 原生 Fuse 工具挂载 TOS 后，需要注意以下事项：|\ | | ||\ | | |* 不支持无损升级，即升级客户端后，无法自动恢复业务，需要重新挂载后手动恢复相关业务。|\ | | |* 不支持自动清理临时文件，即重启进程后，写缓存目录`temp_dir`下的临时文件不会被自动清除。为避免磁盘空间占用，您需要定期手动清理临时文件。|\ | | ||\ | | |:::|

对象存储