文档中心

对象存储

请输入

常用命令

挂载存储桶为本地文件系统目录（mount）

您可以通过 mount 命令将存储桶挂载为本地文件系统目录，然后通过标准的 POSIX 协议访问。

注意事项

说明

FSX 工具具有强大的崩溃恢复能力，可以有效减少数据丢失和服务中断时间，提高系统的可靠性和安全性。强烈推荐使用 FSX 工具挂载存储桶。详细介绍，请参见概述。

某些 macOS 系统版本的 fusermount 命令由于存在协议实现的兼容性差异，可能在 write 操作出现问题。

仅支持在 Linux 和 macOS 系统执行该命令。

mount 命令依赖 fusermount 实现存储桶的挂载，执行挂载命令前，请确保本地已安装 fusermount。

当多个客户端挂载同一个 TOS 存储桶时，您需要自行协调各个客户端的行为。

支持的操作

挂载存储桶到本地后，本地系统可以通过兼容的 POSIX 文件接口管理桶内对象。由于只兼容部分 POSIX 语义，因此在本地系统对存储桶执行的操作受限。具体说明如下：

对于文件写操作，仅支持追加写，不支持修改写。

说明

文件写操作遵守 open-to-close 原则，没有执行 flush 操作前，文件可能不会写入到 TOS 服务端。

支持 lookup、getattr、setattr、readdir、read、mkdir、rmdir、create、open、write、flush、fsync、release、unlink、rename、statfs 相关的操作。

不支持 getxattr、setxattr、removexattr、listxattr、readlink、getlk、setlk、setlkw、link、symlink、allocate、lseek、copyfilerange 相关的操作。

前提条件

使用 mount 命令挂载存储桶前，请确保您已安装 Fuse 软件。

命令语法

参数说明

通用可选参数的说明，请参见通用可选参数。

参数名	参数类型	描述
bucket	String	存储桶名。
prefix	String	对象名前缀。
mount_point	String	待挂载的本地文件系统目录路径。
-sc	Enum	写入被挂载桶内对象的存储类型，取值说明如下： STANDARD：标准存储，默认值。 IA：低频访问存储。 ARCHIVE_FR：归档闪回存储。 ARCHIVE：归档存储。 COLD_ARCHIVE：冷归档存储。 DEEP_COLD_ARCHIVE：深度冷归档存储。
-fg	Bool	使用前台进程模式执行挂载。
-ro	Bool	将本地文件系统目录挂载为 Read-Only 模式。
-ad	Bool	允许在挂载的本地文件系统目录上执行删除操作。
-adr	Bool	允许递归删除目录。说明 -adr 参数仅支持 FNS 桶，关于 FNS 桶详细介绍，请参见存储桶类型。
-aow	Bool	允许在挂载的本地文件系统目录上执行覆盖操作。
-ar	Bool	允许在挂载的本地文件系统目录上执行重命名（移动）操作。
-ac	Bool	允许对已存在文件执行追加写操作。说明 -ac 参数仅支持 FNS 桶，关于 FNS 桶详细介绍，请参见存储桶类型。
-ao	Bool	允许其他操作系统用户访问挂载的本地文件系统目录。
-dau	Bool	关闭进程退出时自动卸挂载机制。
-dbcbr	Bool	关闭通过 readdir 操作来构建文件元数据本地缓存机制。
-vchecksum	Bool	在顺序读写场景校验数据一致性。
-dm	Integer	挂载的本地文件系统的目录权限，默认为 0755。
-fm	Integer	挂载的本地文件系统的文件权限，默认为 0644。
-uid	Integer	挂载的本地文件系统目录的 uid，默认为当前用户的 uid。
-gid	Integer	挂载的本地文件系统目录的 gid，默认为当前用户的 gid。
-pprof	Bool	开启或关闭 pprof 服务，默认为开启。
-pport	Integer	开启 pprof 服务时使用的端口号，默认为 18888。
-bgt	Integer	允许操作系统 fuse 命令异步执行的最大请求数，默认为 16。
-etmout	Integer	挂载的本地文件系统目录的 Entry-Timeout，单位：秒，默认为 1 秒。
-atmout	Integer	挂载的本地文件系统目录的 Attribute-Timeout，单位：秒，默认为 1 秒。
-ntmout	Integer	挂载的本地文件系统目录的 Negative-Timeout，单位：秒。
-rconcurrency	Integer	从桶内读取数据的最大并发数，默认为 100000。
-wconcurrency	Integer	向桶内写入数据的最大并发数，默认为 100000。
-oconcurrency	Integer	在桶上执行非读写操作的最大并发数，默认为 1000。
-rl	Integer/String	读写数据的最大带宽（吞吐），单位：字节，默认为 1GB。说明支持带容量单位配置，例如，配置 1MB 代表 1048576 字节。
-debug	Bool	开启 fuse 命令的 Debug 日志。
-dld	String	写入 Debug 日志的本地文件目录。
-mpt	Integer	读取单个文件时，最大的预取任务数，默认为 1。
-spt	Integer	读取文件时，可共享的预取任务数，不设置时，与读写数据的最大带宽（吞吐）成正比。
-rbs	Integer/String	读取数据的缓存块大小，默认为 1MB，最大值为 10MB。说明支持带容量单位配置，例如，配置 1MB 代表 1048576 字节。
-rps	Integer/String	读取数据时的最大分片大小，默认为 8MB，如果未设置则由读请求的对象大小决定。说明支持带容量单位配置，例如，配置 1MB 代表 1048576 字节。
-ups	Integer/String	写入数据时的分片大小，默认为 8MB。说明支持带容量单位配置，例如，配置 1MB 代表 1048576 字节。
-mrbs	Integer/String	读取单个文件数据时单个预取任务可用的最大内存，默认为 100MB。说明支持带容量单位配置，例如，配置 1MB 代表 1048576 字节。
-mwbs	Integer/String	写入单个文件数据时可用的最大内存（不使用本地临时文件场景），默认为 50MB。说明支持带容量单位配置，例如，配置 1MB 代表 1048576 字节。
-mlh	Integer/String	读写数据时，内存占用的阈值，默认为系统总内存的 70%。说明支持带容量单位配置，例如，配置 1MB 代表 1048576 字节。 -mlh 参数模糊控制内存占用大小，非精确控制内存占用大小。例如配置为 50 MB，实际读写数据时可使用的内存大约为 50MB。
-tfd	String	写入数据时使用的本地临时文件的目录，当分片大小大于 20MB 时，会使用本地临时文件。
-futf	Bool	写入数据时，强制使用本地临时文件不论分片大小。
-cctf	Bool	写入数据时，是否计算本地临时文件的 CRC64 值，保证异步上传时的数据一致性，取值说明如下： true（默认）：写入数据时，计算本地临时文件的 CRC64 值。 false：写入数据时，不计算本地临时文件的 CRC64 值。
-mts	Integer/String	写入数据时，限制本地临时文件的目录大小，默认为 1TB。说明支持带容量单位配置，例如，配置 1MB 代表 1048576 字节。
-rlft	Integer/String	执行 rename 操作时的大文件阈值。说明支持带容量单位配置，例如，配置 1MB 代表 1048576 字节。
-cfd	String	读取数据时使用的本地缓存文件的目录，未设置该值则代表不开启本地缓存。
-mcs	Integer/String	开启本地缓存后，本地缓存文件的存储容量上限，默认为 1TB。说明支持带容量单位配置，例如，配置 1MB 代表 1048576 字节。
-ce	Integer	开启本地缓存后，本地缓存的有效期，单位：秒，默认为 3600 秒。
-rfdl	Integer	最大可打开的读描述符个数，默认为 10000。
-wfdl	Integer	最大可打开的写描述符个数，默认为 10000。
-nftr	Bool	执行打开文件描述符（fd）的 flush 操作时，数据不会立即写入存储桶，而是要到资源释放（release）时才会触发写入存储桶内。
-ntfc	Bool	创建新文件时，是否使用 truncate 参数。取值说明如下： true：创建新文件时，不使用 truncate 参数。 false（默认）：创建新文件时，使用 truncate 参数。

使用示例

执行命令挂载桶为标准的本地文件系统目录，并配置支持覆盖、删除、移动。示例如下：

命令

验证

挂载完成后，您可以通过df -h <mount_point> 命令，查看存储桶是否挂载成功。例如本例中执行以下命令：

返回如下，表示挂载成功。

说明

挂载完成后，如果您想要取消挂载存储桶，您可以使用系统自带的 umount <mount_point> 命令。特别注意，执行该命令时，无需添加 ./tosutil 前缀。

最近更新时间：2026.01.21 16:58:52

这个页面对您有帮助吗？

有用

无用