文档中心

弹性文件存储

FSX 客户端

挂载文件系统

挂载文件系统

本文以 CentOS 系统实例为例，介绍在 ECS 实例挂载文件系统的操作步骤。

注意事项

推荐您在 Linux 系统上通过 FSX 挂载文件系统，FSX 不支持在 Windows 和 macOS 环境使用。更多注意事项，请参见使用限制。

如果您挂载失败或在挂载中遇到任何问题，请提交工单联系技术支持。

前提条件

已创建文件系统，具体步骤，请参见创建文件系统。

已创建接入点，具体步骤，请参见创建接入点；如果接入点开启了 IAM 策略，还需要配置接入点策略，详细介绍，请参见配置接入点策略。

已安装 FSX 客户端，具体步骤，请参见安装 FSX 客户端。

已创建与接入点相同 VPC 的 ECS 实例，具体步骤，请参见购买云服务器。

说明

为了达到最优的性能体验，建议文件系统与 ECS 实例在同一可用区。

操作步骤

登录需要挂载文件系统的 ECS 实例，具体步骤，请参见登录 ECS 实例。

执行以下命令，创建挂载的目标路径。

mkdir <挂载目标目录>

本文中以 localdir 文件夹为例。

mkdir /localdir

（可选）配置账号的鉴权信息。

说明

如果接入点开启了 IAM 策略，并配置了接入点策略，则您需要执行此步骤指定火山引擎账号的 AK/SK 信息。

配置接入点策略后，如果需要变更（包括修改或新增）策略，变更后的策略约在 90s 后生效。

FSX 支持通过多种方式配置火山引擎账号的 AK/SK信息，如果您同时配置了多种鉴权方式，则鉴权方式优先级如下：

在挂载命令指定 AK/SK > 在挂载命令指定鉴权信息文件 > 在环境变量指定 AK/SK > 在环境变量指定鉴权信息文件 > 在用户 HOME 目录公共鉴权信息文件中增加 IAM 鉴权信息 > 在用户 HOME 目录 FSX 鉴权信息文件中增加 IAM 鉴权信息 > 在公共目录 FSX 鉴权信息文件中增加 IAM 鉴权信息

具体鉴权方式说明如下：

方式	说明
在挂载命令指定 AKSK	FSX 客户端挂载 NAS 接入点时需要获取账号鉴权信息，您可以在挂载命令中直接指定将账号的 AK/SK 信息，具体指定 AK/SK 的参数为 -o access_key_id=<ak_string>,secret_access_key=<sk_string>[,security_token=<sts_string>]。注意在挂载命令指定 AKSK的方式存在 AKSK 泄露风险，请谨慎使用。
在挂载命令指定鉴权信息文件	FSX 客户端挂载 NAS 接入点时需要获取账号鉴权信息，您可以在挂载命令中指定鉴权信息文件，具体指定鉴权信息文件的参数为 -o credential_filepath=/path/to/credentials。鉴权文件扩展名必须为 json，格式如下： { "VOLC_ACCESSKEY": "<ak_string>", "VOLC_SECRETKEY": "<sk_string>", "VOLC_SECURITY_TOKEN": "<sts_string>" } 说明参数VOLC_SECURITY_TOKEN为临时安全凭证。获取方法请参见基于实例IAM角色授权ECS访问其它云资源。
通过环境变量指定 AKSK	您可以在环境变量中配置 VOLC_ACCESSKEY、VOLC_SECRETKEY、VOLC_SECURITY_TOKEN 参数来指定 AK/SK 。
通过环境变量指定鉴权信息文件	您可以在环境变量中配置 VOLC_CREDENTIAL_FILE 指定鉴权信息文件路径。鉴权文件扩展名必须为 json，格式如下： { "VOLC_ACCESSKEY": "<ak_string>", "VOLC_SECRETKEY": "<sk_string>", "VOLC_SECURITY_TOKEN": "<sts_string>" }
在用户 HOME 目录公共鉴权信息文件中增加鉴权信息	在 ~/.volc/credentials 文件增加以下信息： "VOLC_ACCESSKEY": "<ak_string>", "VOLC_SECRETKEY": "<sk_string>", "VOLC_SECURITY_TOKEN": "<sts_string>"
在用户 HOME 目录 FSX 鉴权信息文件中增加鉴权信息	在 ~/.passwd-fsx 文件增加以下信息： "VOLC_ACCESSKEY": "<ak_string>", "VOLC_SECRETKEY": "<sk_string>", "VOLC_SECURITY_TOKEN": "<sts_string>"
在公共目录 FSX 鉴权信息文件中增加鉴权信息	在/etc/.passwd-fsx 文件增加以下信息： "VOLC_ACCESSKEY": "<ak_string>", "VOLC_SECRETKEY": "<sk_string>", "VOLC_SECURITY_TOKEN": "<sts_string>"

执行以下命令，挂载 NAS 文件系统。

您可以登录文件存储 NAS 控制台，在接入点页面，查看并复制相应挂载命令。复制挂载命令后，您需要在命令末尾输入 / <挂载目录>，例如本文中的挂载地址为 /localdir，则您需要在命令末尾输入 /localdir。具体步骤，请参见查看接入点挂载命令。

注意

请勿将文件系统挂载到 /tmp 目录，部分操作系统中存在自动清理机制，会自动清理 /tmp 目录内的数据，导致文件丢失。

mount -t fsx /nas/ap-add014a0.cncq6a772736e012.2gctm5rzca3uo50ztyz****.cn-beijing.nas.ivolces.com:/ <挂载目录>

示例命令如下：

mount -t fsx /nas/ap-add014a0.cncq6a772736e012.2gctm5rzca3uo50ztyz****.cn-beijing.nas.ivolces.com:/ /localdir

挂载命令支持 -o 参数，您可以在挂载命令中通过 -o 参数修改挂载配置，示例命令如下：

mount -t fsx -o rw /nas/ap-add014a0.cncq6a772736e012.2gctm5rzca3uo50ztyz****.cn-beijing.nas.ivolces.com:/ <挂载目录>

-o 参数的选项说明如下：

挂载选项	说明
persist_dir	FSX 客户端需要一定的磁盘空间存放 inode map，用于客户端崩溃后的恢复流程，默认存储在 /opt/tmp/fsx 目录下。存储 inode map 需要的磁盘空间大小和客户端内存大小成正比，1TB 内存的客户端极端情况下需要 45GB 的磁盘空间。您可以通过指定挂载选项 -o persist_dir=/persist_dir，更换 inode map 存储的磁盘目录。
enable_xattr	FSX 客户端在挂载 NAS 文件系统时，会默认关闭支持 xattr 的能力。您可以指定挂载选项-o enable_xattr=true，开启支持 xattr 的能力。注意在开启支持 xattr 的能力后，性能会下降大约 30%，请您根据实际需求开启。
rw	使用读写方式挂载文件系统，默认开启。
ro	使用只读方式挂载文件系统，默认关闭，可以通过 -o ro 开启。
access_key_id	在挂载命令中指定密钥信息，关于获取 Access Key ID 和 Secret Access Key 的具体操作，请参见 Access Key（密钥）管理。
secret_access_key
security_token
credential_filepath	在挂载命令中指定包含鉴权信息的文件路径，文件扩展名必须为 json，格式如下： { "VOLC_ACCESSKEY": "<ak_string>", "VOLC_SECRETKEY": "<sk_string>", "VOLC_SECURITY_TOKEN": "<sts_string>" }

执行以下命令，查看挂载的文件系统信息。

df -h

相关操作

卸载挂载点

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

最近更新时间：2026.07.03 11:42:42

这个页面对您有帮助吗？

有用

有用

无用

无用