文档中心

对象存储

请输入

FSX

FSX 配置与挂载

本文介绍挂载存储桶的注意事项、操作步骤等内容。

前提条件

已安装 FSX 客户端。具体操作，请参见下载与安装 FSX。

权限说明

挂载存储桶所需要的权限

使用 IAM 用户挂载存储桶，并执行相应操作时，需要拥有对应的权限，否则挂载会失败，具体权限说明如下：

挂载存储桶时，需要拥有 ListBucket 和 HeadBucket 权限。

读取挂载的存储桶内对象时，需要拥有 GetObject 权限。

在挂载的存储桶写入文件时，需要拥有 PutObject 和 AbortMultipartUpload 权限。

在挂载的存储桶删除文件时，需要拥有 DeleteObject 权限。

对于开启服务器端加密 (SSE-KMS)的存储桶，则在读取或写入对象时需要额外的 KMS 操作权限。使用 SSE-KMS 上传加密对象，您需要具备该密钥的 kms:GenerateDataKey 权限；若要下载 SSE-KMS 加密对象，您需要具备该密钥的 kms:Decrypt 权限。关于服务端加密的更多信息，请参见服务端加密概述。

以下是一个最小权限策略举例：

您还可以根据实际情况在以上权限策略的基础上增加更多动作，使得 IAM 用户拥有更多权限。关于 IAM 策略支持动作，请参见 IAM 策略概述。

确认需要授予的权限策略后，您需要在 IAM 控制台使用权限策略创建自定义策略，然后授予 IAM 用户该策略，具体操作，请参见配置 IAM 策略和添加授权。

FSX 访问权限

默认情况，FSX 客户端进程的 UID 和 GID 拥有挂载的系统内所有的文件和目录权限，文件默认权限为 644，目录默认权限为 755，这些信息支持通过 chown 和 chmod 命令修改，您可以在挂载存储桶时通过 uid、gid、file_mode 和 dir_mode 参数来修改默认值。

参数说明：

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

配置示例：

允许所有用户访问，即权限为 777。

密钥挂载

密钥挂载指使用 Access Key ID 和 Secret Access Key 作为身份凭证，通过 FSX 将存储桶挂载到 Linux 系统。密钥挂载不依赖特定的云基础设施环境，支持将存储桶挂载到各种 Linux 系统，详细介绍，请参见运行环境。

进入 Linux 操作系统，执行以下命令，创建挂载点。

mkdir /mnt/point

挂载存储桶
挂载指定目录

挂载存储桶的命令如下：

mount -t fsx /tos/<挂载的存储桶名> <挂载点> -o region="<地域>",endpoint="<访问域名>",credential_filepath="<鉴权凭证文件的绝对路径>",no_writeback_cache

示例如下：

mount -t fsx /tos/bucketname /mnt/point -o region="cn-beijing",endpoint="https://tos-cn-beijing.volces.com",credential_filepath="/root/credential.json",no_writeback_cache

参数说明如下：

说明

以下介绍使用 FSX 客户端挂载存储桶的基本参数，您还可以在挂载存储桶时设置预热、读缓存等参数，详细介绍，请参见 FSX 挂载参数说明。

参数	是否必选	说明
region	是	存储桶所在地域。
no_writeback_cache	是	不开启内核 page cache 回写功能，保证 write 请求是顺序写。
endpoint	是	TOS 的访问域名，仅支持 TOS 域名，暂不支持 S3 域名。如果没有指定协议，则默认使用 HTTPS 协议，完整格式为 https://{host}:{port}。
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 参数需要搭配使用。
part_size	否	多片上传时的段大小，单位为 MB，默认为 8MB，取值范围为 [4，5120]。TOS 约束最多上传 10000 个段，可以通过调整段大小来调整上传的对象大小。具体使用方式，请参见上传大文件。说明 part_size 的值必须为正整数。

执行以下命令，查看存储桶挂载情况。

df -h

在返回内容中看到挂载点、挂载存储桶名，说明挂载成功。

Filesystem Size Used Avail Use% Mounted on
BFA281845F:tos-fuse-test 8.0E 0 8.0E 0% /mnt/fuse_shm

免密挂载

免密挂载指通过 FSX 挂载存储桶时，无需指定密钥，而是通过安全令牌服务（STS）提供的临时安全凭证验证身份，完成挂载。该方式无需透露长期 AccessKey，可以保证账号下的密钥安全。

FSX 将存储桶挂载到 ECS

为 ECS 实例绑定 IAM 角色，并获取角色 TRN。具体操作，请参见基于实例IAM角色授权ECS访问其它云资源。

进入 Linux 操作系统，执行以下命令，创建挂载点。

mkdir /mnt/point

挂载存储桶
挂载指定目录

挂载命令如下：

mount -t fsx /tos/<挂载的桶名> <挂载点> -o region="<地域>",endpoint="<访问域名>",tos_auth_role_trn=<角色 TRN>,tos_auth_type=IMDS,no_writeback_cache

示例如下：

mount -t fsx /tos/bucketname /mnt/point -o region="cn-beijing",endpoint="https://tos-cn-beijing.volces.com",tos_auth_role_trn=trn:iam::210671****:role/fsx_role2,tos_auth_type=IMDS,no_writeback_cache

参数说明如下：

说明

以下介绍使用 FSX 客户端挂载存储桶的基本参数，您还可以在挂载存储桶时设置预热、读缓存等参数，详细介绍，请参见 FSX 挂载参数说明。

参数	是否必选	说明
region	是	存储桶所在地域。
endpoint	是	TOS 的访问域名，仅支持 TOS 域名，暂不支持 S3 域名。如果没有指定协议，则默认使用 HTTPS 协议，完整格式为 https://{host}:{port}。
tos_auth_role_trn	是	临时访问凭证，即步骤一中获取的角色 TRN。
tos_auth_type	是	免密类型，在 ECS 场景下，取值仅为 IMDS。
no_writeback_cache	是	不开启内核 page cache 回写功能，保证 write 请求是顺序写。
part_size	否	多片上传时的段大小，单位为 MB，默认为 8MB，取值范围为 [4, 5120]。TOS 约束最多上传 10000 个段，可以通过调整段大小来调整上传的对象大小。具体使用方式，请参见上传大文件。说明 part_size 的值必须为正整数。

执行以下命令，查看存储桶挂载情况。

df -h

在返回内容中看到挂载点、挂载存储桶名，说明挂载成功。

Filesystem Size Used Avail Use% Mounted on
BFAACBA3B3:bucketname 8.0E 0 8.0E 0% /mnt/point

FSX 将存储桶挂载到 VKE

注意

集群创建完成后才支持开启 IRSA 鉴权。如需要使用 csi-fsx 组件的 IRSA 鉴权能力，创建集群时请不要安装该组件。

csi-fsx 组件的 IRSA 鉴权开启后不支持修改，如果存量组件想要修改鉴权方式，需要卸载重装。

IRSA OIDC 未开启的时候不允许使用 IRSA 鉴权。

IAM 角色仅支持选择 OIDC 身份提供商类型，且已绑定本组件服务账号的信任关系的角色。

csi-fsx 组件安装完成后，暂不支持修改鉴权方式，仅可修改 IAM 角色，且仅对新增的存储卷生效（已有存量储卷不受影响）。同时，修改 IAM 角色会触发组件短暂重启，请在业务低峰期操作。

登录容器服务控制台并创建集群。具体操作请参见创建集群。

开启 IRSA 能力并创建 OIDC 身份提供商类型的 IAM 角色。具体操作请参见集群中使用 IRSA 能力。

使用 IRSA 实现存储挂载鉴权。

完成 IAM 角色信任并安装 csi-fsx 组件后，集群中的存储卷即可根据实际情况配置访问密钥鉴权。如您无需独立的访问密钥鉴权，需要免密挂载，则使用 IRSA 鉴权。

存储卷创建完成后，您可以在创建工作负载时添加对应的卷，在 Pod 中挂载存储使用。

查看日志

默认日志打印在/var/log/fsx 路径下：

进入到 /var/log/fsx/fusedaemon/tos/fusedaemon ，可以查看 FSX 客户端日志。

进入到 /var/log/fsx/fusedaemon/tos/tos-fuse ，可以查看 TOS 服务端交互日志。

为了查看服务运行过程中的详细信息，定位问题，您可能需要开启调试日志，此时可以使用以下命令：

调整 FSX 客户端日志级别为调试级别。

cd /opt/fsx/bin && ./fusetool flags set --instance tos --flag v --value 20 --force

调整 TOS 服务端交互日志级别为调试级别。

cd /opt/fsx/bin && ./fusetool flags set --instance tos --flag tosfuse_log_level --value 1 --force

卸载挂载点

执行 umount <挂载目录> 命令，可以在 Linux 系统中卸载挂载点。

异常处理

如果您在使用 FSX 过程中出现异常情况，建议您先运行 /opt/fsx/tools/sysinfo_collector.sh 脚本。该脚本会自动收集系统基本信息、挂载点信息、系统日志等内容，并默认会在脚本所在目录生成一个 system_info_****_****.tar.gz 压缩文件。您可以提交工单将该压缩文件发送给我们，我们将协助您解决问题。

最近更新时间：2026.02.03 11:46:44

这个页面对您有帮助吗？

有用

无用