全部文档
当前文档
最近更新时间：2025-11-16 16:40:11
登录文件存储KPFS控制台。
在文件系统列表页，单击创建按钮。
在创建页面，配置文件系统相关信息。
参数 | 说明 |
计费方式 | 文件系统计费方式，包括：包年包月、按量付费（按日月结）、试用。 更多信息，请参见计费说明。 |
地域 | 选择文件系统所在地域。
|
可用区 | 选择文件系统所在的可用区。
|
类型 | 文件系统存储类型，包括：
更多信息，请参见产品规格。 |
文件系统名称 | 输入文件系统的自定义名称。
|
所属项目 | 选择文件系统所属项目。
|
存储池 | 选择存储池Code，为集群的UUID。仅性能Ⅰ型、性能Ⅱ型支持。 |
条带块大小 | 选择文件系统的条带块大小，建议根据您业务的文件大小进行选择。仅性能Ⅰ型、性能Ⅱ型支持。
|
容量 | 设置文件系统的存储容量。
|
单击立即购买，完成文件系统创建。
进入文件系统详情，查看文件系统挂载方法。
在KPFS服务所在的相同地域中，创建云服务器KEC实例。
获取访问密钥
文件存储服务KPFS需使用您金山云账户的访问密钥作为访问凭证，支持主用户或子用户，获取方式如下：
子用户（推荐）
主用户
在IAM控制台Access Keys页，创建密钥并下载到本地保存。
若您禁用或更换密钥对，使用该访问密钥进行挂载的客户端将无法读写。
安装客户端
参考文件系统详情-挂载方法栏位
sudo curl -L http://198.19.28.45:8080/onpremise/juicefs -o /usr/local/bin/juicefs && sudo chmod +x /usr/local/bin/juicefs完成安装后，在命令行运行 juicefs --help，如果正常打印出帮助信息，表示客户端安装完成。如果报错 command not found，请检查系统环境变量设置，确保将 /usr/local/bin 加入 PATH。
挂载文件系统
参考文件系统详情-挂载方法栏位
sudo /usr/local/bin/juicefs mount $VOL_NAME $MOUNTPOINT$VOL_NAME输入文件系统名称，$MOUNTPOINT输入实际挂载的路径。
客户端挂载过程中，需输入文件系统的Token和访问密钥。
sudo /usr/local/bin/juicefs mount mytest /localfolder
Token for mytest：********
Secret ID for ks3 bucket 2000176024-mytest-snx187g2：********
Secret Key for ks3 bucket 2000176024-mytest-snx187g2：********通过juicefs bench命令对文件系统进行基础的性能和功能验证，确保文件系统能够正常访问且性能符合预期。
juicefs bench /localfolder运行 juicefs bench 命令以后会根据指定的并发度（默认为 1）往文件系统中写入及读取 N 个大文件（默认为 1）及 N 个小文件（默认为 100），并统计读写的吞吐和单次操作的延迟，以及访问元数据引擎的延迟。
mount 命令支持平滑重新挂载，只需编辑挂载选项并运行 juicefs mount 即可。
# 确认挂载点已经存在
$ df -h /localfolder
Filesystem Size Used Avail Use% Mounted on
JuiceFS:mytest 1.0T 11G 1014G 1% /test
# 修改挂载选项，重新挂载
# 如果忘记了当前的挂载命令，使用ps -ef | grep /usr/local/bin/juicefs命令获取原挂载命令
$ sudo /usr/local/bin/juicefs mount mytest /localfolder --buffer-size=300
OK, mytest is ready at /localfolder.
# 检查运行时配置文件，确认参数生效
grep -i buffer /jfs/.config文件系统挂载成功可以正常使用后，按需设置开机自动挂载。KPFS客户端内置了自动更新fstab的功能，将挂载信息写入 /etc/fstab，便能实现开机自动挂载。
# 需要 root 权限才能修改 /etc/fstab
$ sudo /usr/local/bin/juicefs mount --update-fstab $VOL_NAME $MOUNTPONT
$ grep $VOL_NAME /etc/fstab
<VOL_NAME> <MOUNTPONT> juicefs _netdev 0 0如果你有意自行控制，请注意：
需要创建一个从 /sbin/mount.juicefs 到 juicefs 可执行文件的软链接，操作系统解析 fstab 时会调用 /sbin/mount.juicefs 命令。
挂载命令所包含的各种参数，也需要在 fstab options 列加以声明，注意去掉 - 前缀，并将参数取值以 = 连接，举例说明：
$ sudo /usr/local/bin/juicefs mount --update-fstab $VOL_NAME $MOUNTPONT -b --max-uploads=1 --prefetch 2 --writeback mytest /localfolder -o max_read=3
# -o 是 FUSE options，在 fstab 中需特殊对待
$ grep $VOL_NAME /etc/fstab
<VOL_NAME> <MOUNTPONT> juicefs _netdev,background,max-uploads=1,max_read=3,prefetch=2,writeback 0 0使用 umount 命令卸载文件系统。
umount /localfolder如果命令行返回 umount: /localfolder: target is busy.，说明文件系统正在使用，可以使用 lsof $MOUNTPOINT 找到并结束相关应用的进程后再执行卸载。
对于 Linux 发行版，可以使用 -l 选项执行延迟卸载（立即卸载文件系统，已经打开的文件句柄释放之后，客户端才真正退出）。
umount -l /localfolder前提条件
已创建裸金属服务器，为避免出现兼容性问题，使用前务必确认计算节点满足KPFS客户端要求的OS版本、内核版本、网卡驱动版本
AMD机型，需关闭iommu
Linux下的/etc/default/grub需有下列参数
GRUB_CMDLINE_LINUX：需包含"split_lock_detect=off"
下载客户端
参考文件系统详情-挂载方法栏位
按照计算节点使用的OS版本、内核版本、网卡驱动选择客户端版本，不同内核需使用不同的安装包。如更换内核，需先卸载客户端后再更换内核，然后重新安装部署客户端
控制台展示为客户端内网下载链接。如需使用公网下载，可参考下方表格进行下载，若您是专属集群，请联系金山云获取。
下载指令参考如下：
wget https://nas-s-bj.ks3-cn-beijing.ksyuncs.com/posix-client/v412-91030/ofs-client-ubuntu22.04.3-5.15.0-88-generic-X86-MLX5.8_3.0-330000-000-UStor_ofs4.1.2_930_release_412c33989cea_20241030_093039-53-1.tar.xz地域 | 适配OS及内核 | 适配网卡驱动 | 公网下载地址 | 内网下载地址 |
华北1（北京） cn-beijing-6 | Ubuntu 22.04.3 内核：5.15.0-88-generic | 5.8-3.0.7.0-LTS | ||
Centos 7.9 内核：5.4.54-1.0.0 | 5.8-3.0.7.0-LTS | |||
Ubuntu 24.04.2 LTS 内核：6.8.0-55-generic | MLNX_OFED_SRC-debian-24.10-1.1.4.0 | |||
Ubuntu 22.04.3 LTS 内核：5.15.0-156-generic | MLNX_OFED_LINUX-24.10-3.2.5.0-LTS | |||
西北3区（宁夏） cn-northwest-3 可用区A cn-northwest-3a | Ubuntu 22.04.3 内核：5.15.0-88-generic | 5.8-3.0.7.0-LTS | ||
Ubuntu 24.04.2 LTS 内核：6.8.0-55-generic | MLNX_OFED_SRC-debian-24.10-1.1.4.0 | |||
Ubuntu 22.04.3 LTS 内核：5.15.0-156-generic | MLNX_OFED_LINUX-24.10-3.2.5.0-LTS | |||
西北4（海东） cn-northwest-4 可用区A：cn-northwest-4a | Ubuntu 22.04.3 内核：5.15.0-88-generic | 5.8-3.0.7.0-LTS | ||
Ubuntu 24.04.2 LTS 内核：6.8.0-55-generic | MLNX_OFED_SRC-debian-24.10-1.1.4.0 | |||
Ubuntu 22.04.3 LTS 内核：5.15.0-156-generic | MLNX_OFED_LINUX-24.10-3.2.5.0-LTS | |||
西北1（庆阳） cn-northwest-1 可用区A cn-northwest-1a | Ubuntu 22.04.3 内核：5.15.0-88-generic | 5.8_3.0.7.0-LTS | ||
Ubuntu 24.04.2 LTS 内核：6.8.0-55-generic | MLNX_OFED_SRC-debian-24.10-1.1.4.0 | |||
Ubuntu 22.04.3 LTS 内核：5.15.0-156-generic | MLNX_OFED_LINUX-24.10-3.2.5.0-LTS | |||
西北5（克拉玛依） cn-northwest-5 可用区A cn-northwest-5a | Ubuntu 22.04.3 内核：5.15.0-88-generic | 5.8-3.0.7.0-LTS | ||
Ubuntu 24.04.2 LTS 内核：6.8.0-55-generic | MLNX_OFED_SRC-debian-24.10-1.1.4.0 | |||
Ubuntu 22.04.3 LTS 内核：5.15.0-156-generic | MLNX_OFED_LINUX-24.10-3.2.5.0-LTS | |||
华东1（上海） cn-shanghai-2 可用区D： cn-shanghai-2d | Ubuntu 22.04.3 内核：5.15.0-88-generic | 5.8_3.0.7.0 LTS | ||
Ubuntu 24.04.2 LTS 内核：6.8.0-55-generic | MLNX_OFED_SRC-debian-24.10-1.1.4.0 | |||
Ubuntu 22.04.3 LTS 内核：5.15.0-156-generic | MLNX_OFED_LINUX-24.10-3.2.5.0-LTS |
使用tar指令对客户端解压缩
参考文件系统详情-挂载方法栏位
tar xvf ofs-client-ubuntu22.04.3-MLX5.8_3.0-202628-development_ofs4.0.2_lc_v3_release_682c67e0e707_20240305_220218-53-1.tar.xz安装客户端并挂载文件系统
4.1 自动挂载
cd client
./install.py --ips=xxxxx --force=1参数 | 是否必填 | 说明 |
--ips | 是 | 存储节点的数据网IP，前往 文件系统详情-挂载方法，获取挂载IP。 |
--historyloglocation | 否 | 可自行指定历史日志存放路径（安装时把这个路径作为源路径，创建一个到/var/log/backup的软链接，且卸载软件不会删除该软链接）；如不填，历史日志默认存放在/var/log/backup。 |
--force=1 | 否 | 检查存储版本和客户端版本是否一致，force=1 表示强制安装。 |
安装完成后，执行df -h，查看文件系统是否成功挂载。
4.2 手动挂载（可选）
cd client
./install.py --ips=xxxxx --force=1
mount -t storage -o sysname=xxxx -o fsname=xxxx -o async,user_xattr $sysname_fsname $mntname参数 | 说明 |
--ips | 存储节点的数据网IP，前往 文件系统详情-挂载方法，获取挂载IP。 |
-t storage | 文件存储类型。 |
sysname | 前往 控制台>文件系统详情 >基本信息，获取 存储池名称。 |
fsname | 文件系统名称。 |
sysname_fsname | 远端挂载点，由存储池名称及文件系统名称组成，两个名称中间使用下划线连接。 |
mntname | 本地挂载点，建议使用/mnt下的同名目录（与文件系统同名)。 |
挂载参数 sync/async | 同步/异步写，默认采用异步写以有效利用缓存来提升数据写入性能，但异步写入在节点断电时存在丢失缓存中数据的风险，若不能接受此风险，请选择同步写。 |
挂载参数 atime/noatime | 即仅访问、不修改文件内容时也更改文件的时间戳，开启此选项会影响集群性能，默认不跟踪访问文件的时间戳。 |
挂载参数 acl/no_acl | POSIX ACL，针对Unix系统的访问控制列表；默认关闭，文件/目录可设置owner、group、other的基本权限；若要为文件/目录设置其他指定用户/用户组的权限，可开启此选项后通过setfacl、getfacl进行设置。 |
挂载参数 user_xattr/no_user_xattr | 开启此选项以支持setfattr、getfattr操作，用户可以为文件/目录自定义添加自定义的key/value键值对属性，建议开启。 |
执行卸载脚本
/clistorage/uninstall.py请依照下方步骤加载存储所需的python环境变量：
#进入到安装包解压后的目录中，安装
cd ./client/ofs_external_lib/
./install.sh
source /opt/ofs/external_lib/env.sh Update node configuration fail,please make sure that:
1.This node has been authorized.
2.Storage service is OK.请至控制台，创建访问授权。
（1）安装客户端报错 “RenderError：Field ‘alloc_mem' is missing”
请依照下方步骤，先删除配置文件再安装即可：
rm -f /etc/storage_conf.xml（2）安装客户端报错 “client has been installed”
请依照以下步骤操作：
查询是否已经安装过客户端
方法1：查询版本：cat /proc/storage/storage_version
方法2：查询模块：lsmod | grep kingstorage
如果存在，说明已经安装过客户端，需要先卸载旧客户端。卸载命令如下：
/clistorage/uninstall.py --force=1运行完上述命令后 ls /etc/storage_conf.xml，如果该文件存在说明没卸载干净，请手动删除，命令如下：
rm -f /etc/storage_conf.xml重新安装新的客户端，命令如下：
./install.py --ips=<IP> --force=1（3）安装客户端报错 “is_force:True”
请依照下方步骤，先删除配置文件再使用“--force=true”安装：
rm -f /etc/storage_conf.xml #删除配置文件
cd client
./install.py --ips=xxxxx --force=true #重新安装
纯净模式