金山云-文档中心-挂载选项说明

对象存储(KS3)

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

对象存储(KS3)

常用工具

工具汇总

ks3fs工具

挂载选项说明

最近更新时间：2025-12-30 21:04:54



您可以通过-h选项来查看ks3fs支持设置的参数。

命令格式

执行以下命令查看ks3fs支持设置的全部选项列表。

./ks3fs -h

ks3fs默认下载路径为：/usr/local/bin/，以实际安装环境为准。

配置选项

ks3fs基于fuse用户态文件系统实现，因此除了ks3fs自身的选项外，也支持fuse的选项。挂载存储空间时，您可以根据具体的业务场景设置不同的启动选项。选项格式如下：

-o option_name[=option_value]  或者  -ooption_name[=option_value]

必选配置项

分类	配置项名称	是否必选	说明
存储空间基础配置	url	是	用于指定存储空间的访问域名，格式为`url=endpoint`。示例： `-o url=http://ks3-cn-beijing.ksyuncs.com -o url=https://ks3-cn-beijing.ksyuncs.com`
访问凭证配置	passwd_file	条件必选	用于指定保存存储空间访问密钥的文件，默认为`/etc/passwd-ks3fs`，文件的权限必须正确设置。当密钥文件为`/etc/passwd-ks3fs`时：权限可设置为640。当密钥文件不为`/etc/passwd-ks3fs`时：权限需要设置为600。密钥文件内容的格式为：`${bucket}:${ak}:${sk}`或`${ak}:${sk}`。示例： #将密钥写入/etc/passwd-ks3fs文件并设置640权限 echo bucket_name:ak:sk > /etc/passwd-ks3fs chmod 640 /etc/passwd-ks3fs #将密钥写入/passwd-path/passwd-ks3fs文件并设置600权限 echo bucket_name:ak:sk > /passwd-path/passwd-ks3fs chmod 600 /passwd-path/passwd-ks3fs # 定义变量`opasswd_file`，其值为/passwd-path/passwd-ks3fs -opasswd_file=/passwd-path/passwd-ks3fs
public_bucket	条件必选	指定用户是否通过匿名方式访问存储空间，该选项仅对存储空间ACL为`public-read-write`时有效。可选参数为： 0（默认）：不使用匿名方式访问 1：使用匿名方式访问

分类

配置项名称

是否必选

说明

存储空间基础配置

url

是

用于指定存储空间的访问域名，格式为url=endpoint。

示例：

-o url=http://ks3-cn-beijing.ksyuncs.com
-o url=https://ks3-cn-beijing.ksyuncs.com

访问凭证配置

passwd_file

条件必选

用于指定保存存储空间访问密钥的文件，默认为/etc/passwd-ks3fs，文件的权限必须正确设置。

当密钥文件为/etc/passwd-ks3fs时：权限可设置为640。
当密钥文件不为/etc/passwd-ks3fs时：权限需要设置为600。
密钥文件内容的格式为：${bucket}:${ak}:${sk}或${ak}:${sk}。

示例：

#将密钥写入/etc/passwd-ks3fs文件并设置640权限
echo bucket_name:ak:sk > /etc/passwd-ks3fs
chmod 640 /etc/passwd-ks3fs

#将密钥写入/passwd-path/passwd-ks3fs文件并设置600权限
echo bucket_name:ak:sk > /passwd-path/passwd-ks3fs
chmod 600 /passwd-path/passwd-ks3fs

# 定义变量`opasswd_file`，其值为/passwd-path/passwd-ks3fs
-opasswd_file=/passwd-path/passwd-ks3fs

public_bucket

条件必选

指定用户是否通过匿名方式访问存储空间，该选项仅对存储空间ACL为public-read-write时有效。可选参数为：

0（默认）：不使用匿名方式访问
1：使用匿名方式访问

基础配置项

分类	配置项名称	说明	是否必选
对象属性	storage_class	指定文件写入KS3时的存储类型。可选参数有： STANDARD（默认）：标准存储 STANDARD_IA：低频存储 ARCHIVE：归档存储关于存储类型的更多详情请参见文档：存储类型介绍。	否
	default_acl	指定写入KS3文件的ACL。可选参数有： private（默认）：私密 public-read：公开读	否
	enable_content_md5	指定进行上传操作时，是否设置Content-MD5，默认不设置。如需设置Content-MD5，则增加`-o enable_content_md5`选项。	否
权限	allow_other	允许所有用户访问挂载目录。 1. 目录内文件权限需单独设置，个别文件修改权限使用`chmod`命令，全部文件修改为统一权限使用`umask`选项配置。 2. 该选项默认仅限root用户配置，无选项值，直接添加`-oallow_other`即可启用。	否
	uid	配置后，挂载点下所有文件和文件夹uid属性将变为配置值，若不指定，则默认为当前执行挂载用户的uid。	否
	gid	配置后，挂载点下所有文件和文件夹gid属性将变为配置值，若不指定，则默认为当前执行挂载用户的gid。	否
	umask	用来设定挂载点内文件/文件夹的权限掩码。 1. 文件的默认权限为0640，文件夹默认权限为0750。 2. 如需设置挂载点内文件/文件夹的权限为770，则增加`-oumask=007`；如需设置挂载点内文件/文件夹的权限为700，则增加`-oumask=077`。	否
日志	dbglevel	设置日志信息的级别，支持日志信息级别如下： info（默认） critical error warn debug	否
	logfile	日志文件存储路径。若不设置，CentOS系统默认保存在`/var/log/messages`中，Ubuntu系统默认保存在`/var/log/syslog`中。	否
	curldbg	打开libcurl的日志信息，默认不打开。如果需要输出libcurl日志，则需要增加`-o curldbg`选项。	否
并发控制	parallel_count	控制批量HEAD、分块上传、分块下载、分块复制的专属线程池大小。默认值：20	否
并发控制	max_thread_count	统一控制GET、LIST、HEAD等非批量操作的共享线程池大小。默认值：20	否
运行模式	f	是否使用前台运行模式，该模式下日志将输出在前台，可通过挂载时设置`-f`开启，默认不开启。	否
挂载非空目录	nonempty	ks3fs默认要求挂载目录为空，如需挂载至非空目录，可添加 `-o nonempty` 选项。请勿挂载系统关键目录（如 `/`、`/etc`、`/usr`、`/var` 等），否则可能导致操作系统功能异常或数据丢失。	否
证书校验	no_check_certificate	对服务端的证书不做校验，仅在使用HTTPS协议时有效，默认开启证书校验。	否

高级配置项

分类	配置项名称	说明	是否必选
元数据缓存	max_stat_cache_size	指定缓存空间可以缓存的最大文件元数据数量，单位为个。默认值 100000 若挂载目录下文件较多，调整该参数可加快ls操作的响应速度。将参数设为0表示关闭元数据缓存。	否
	stat_cache_expire	指定文件元数据缓存的失效时间，单位为秒。默认值：900	否
	disable_readdirplus	控制是否开启缓存优化，默认不开启。开启后ks3fs在ls时不会发送`HEAD Object`请求去获取文件的gid、uid等元数据信息，只有访问的文件大小为0时才发送`HEAD Object`请求。如需开启缓存优化，您可以在挂载时添加`-o disable_readdirplus`。	否
数据缓存	use_cache	开启数据缓存并指定数据缓存路径，默认不启用。您可以通过指定该选项来配置缓存路径。您可以在挂载时添加`-o use_cache=path`，则表示开启数据缓存且指定数据缓存路径为path。其中path请根据实际路径设置，例如`/tmp/your_foldername`。	否
	del_cache	控制清理本地缓存，默认不清理。您可以通过设置该选项来配置ks3fs清理本地数据缓存。挂载时添加`-o del_cache`选项，ks3fs会在mount和umount时清理`use_cache`指定文件夹下的缓存文件。	否
	tmpdir	默认情况下，数据会临时缓存在系统盘`/tmp`目录下，您可以通过指定该选项来配置默认的临时缓存路径。 1. 该选项和use_cache选项不可同时使用。 2. 您可以在挂载时添加`-o tmpdir=path`，配置默认的临时数据缓存路径为`path`，其中`path`请根据实际路径设置，例如：`/data/your_foldername`。	否
	ensure_diskfree	控制预留磁盘空间大小。默认不预留。您可以通过该选项设置保留的可用硬盘空间大小，避免磁盘写满影响其他应用写入，单位为MB。 1. 该选项不可与free_space_ratio选项同时使用。 2. 如您需要设置ks3fs保留1024MB的可用磁盘空间，则设置`-o ensure_diskfree=1024`。	否
	free_space_ratio	控制使用缓存后的磁盘最小剩余空间比例。 1. 该选项不可与ensure_diskfree选项同时使用。 2. 当磁盘空间为50GB时，如果配置为`-ofree_space_ratio=20`，则保留`50GB * 20% = 10GB`的空间。	否
	max_dirty_data	当写文件大小超过这个值时，不用关闭文件就会提前上传中间临时文件，单位为MB。默认值：5120 如果需要设置写文件超过2000MB就提前上传，则可以在挂载时添加`-o max_dirty_data=2000`。	否
重试策略	retries	指定请求失败后的重试次数。默认值：5	否
超时	connect_timeout	指定连接的超时时间，单位为秒。默认值：300	否
超时	readwrite_timeout	指定读或写请求的超时时间，单位为秒。默认值：120	否
分块	multipart_size	分块上传文件时单块的大小，单位是MB。默认值：10 该参数会影响最大支持的文件大小，分块上传时最大仅支持10000块，默认值下，最大支持的文件为100GB。如果需要支持更大的文件，请根据需求调整该值。	否

文档导读

上一篇：挂载存储空间

下一篇：工作原理

纯净模式常规模式

纯净模式

点击可全屏预览文档内容