帮你快速理解、总结文档立即下载
文档中心>对象存储

挂载存储桶

最近更新时间：2025-12-26 17:43:51
我的收藏

本页目录：

用户下载解压 COSFS2 安装包以后，需要先创建 COS 存储桶，完成 COSFS2 参数配置，然后挂载 COS 存储桶到本地目录，运行业务。

前提条件

请确保已经 创建 COS 存储桶、获取到待挂载目标 COS 存储桶的 secret id、secret key 等。
请确保已经成功 下载安装 COSFS2工具，完成 COSFS2参数配置。

配置 COSFS2

我们推荐使用 COSFS2 配置文件来完成挂载前的准备工作，在 COSFS2 的安装包中，提供了一个简单的配置文件样例，您可以根据需要修改或添加配置项。部分配置项支持热加载，其他配置项则需要重新挂载后生效。具体参数说明请参见 配置说明。
如下是一个 COSFS2 配置文件示例，以版本 cosfs2_1.1.0.51 为例，配置文件存放位置在 /data/cosfs2-1.1.0.51/conf/cosfs2.yaml。
app-name: "cosfs2"
cos:
  secret-id: "****"
  secret-key: "****"
logging:
  file-path: "/data/cosfs2-1.1.0.51/log/cosfs2.log"
  format: text
  severity: error
file-cache:
  cache-dir: "/data/cosfs2-1.1.0.51/cachedir"
  max-size-mb: 20480
file-system:
  temp-dir: "/data/cosfs2-1.1.0.51/tmp"
  fuse-options: "allow_other"
foreground: false

挂载 COS 桶到本地目录

完成配置后，您可以通过命令挂载 COS 桶到本地目录。
如下是一个典型的 COSFS2 挂载示例。

[root@k8s-node1 cosfs2-1.1.0.51]# mkdir -p /mnt/test
[root@k8s-node1 cosfs2-1.1.0.51]# cd bin/
[root@k8s-node1 bin]# ls -l
total 83428
-rwxr-xr-x 1 root root 85428758 Dec  5 19:13 cosfs2
[root@k8s-node1 bin]# /data/cosfs2-1.1.0.51/bin/cosfs2 --config-file=/data/cosfs2-1.1.0.51/conf/cosfs2.yaml \\
cos://example-1250000000.cos.ap-guangzhou.myqcloud.com /mnt/test
注意：
示例命令解释：/data/cosfs2-1.1.0.51/bin/cosfs2 --config-file=/data/cosfs2-1.1.0.51/conf/cosfs2.yaml cos://example-1250000000.cos.ap-guangzhou.myqcloud.com /mnt/test 该命令会挂载 ap-guangzhou 园区 COS 桶 example-1250000000.cos.ap-guangzhou.myqcloud.com 到本地 /mnt/test 目录。COSFS2 可执行程序路径为 /data/cosfs2-1.1.0.51/bin/cosfs2。
执行挂载命令时，需要替换为自己的 COS 桶。

检查 COSFS2 挂载是否成功

方式一：前台执行挂载命令，检查命令输出

挂载命令执行成功后，命令行会打印提示信息 "File system has been successfully mounted."。

[root@k8s-node1 bin]# /data/cosfs2-1.1.0.51/bin/cosfs2 \\
--config-file=/data/cosfs2-1.1.0.51/conf/cosfs2.yaml \\
cos://example-1250000000.cos.ap-guangzhou.myqcloud.com /mnt/test
time="18/12/2025 17:39:59.153027" severity=INFO message="Start cosfs2/1.1.0.51 (714bfdfae6388d6bac0899475fad6fe539ad1cb1) (Go version go1.23.11) for app \\"cosfs2\\" using mount point: /mnt/cosfs2\\n"
time="18/12/2025 17:39:59.417277" severity=INFO message="File system has been successfully mounted."

方式二：后台执行挂载命令，检查本地挂载点

通过命令 mount | grep cosfs2 检查本地挂载点是否存在，从而确认挂载 COS 桶是否成功。

[root@k8s-node1 bin]# nohup /data/cosfs2-1.1.0.51/bin/cosfs2 \\
--config-file=/data/cosfs2-1.1.0.51/conf/cosfs2.yaml \\
cos://example-1250000000.cos.ap-guangzhou.myqcloud.com /mnt/test 2>&1 &
[root@k8s-node1 bin]# mount | grep cosfs2 
cos://example-1250000000.cos.ap-guangzhou.myqcloud.com on /mnt/test type fuse.cosfs2 (rw,nosuid,nodev,relatime,user_id=0,group_id=0,default_permissions)

解除 COSFS2 挂载

通过命令 umount 解除本地 COSFS2 挂载。
[root@k8s-node1 bin]# mount | grep cosfs2 
cos://example-1250000000.cos.ap-guangzhou.myqcloud.com on /mnt/test type fuse.cosfs2 (rw,nosuid,nodev,relatime,user_id=0,group_id=0,default_permissions)
[root@k8s-node1 bin]# umount /mnt/test
[root@k8s-node1 bin]
注意：
umount 卸载目录前，请确保您已经停止向本地 COSFS2 挂载目录写入数据。
中国站