全部文档
当前文档
最近更新时间：2026-07-17 15:05:41
ks3fs自V1.3.0版本开始支持配置文件挂载，挂载参数统一写入配置文件，无需在命令行逐个配置。同时支持配置热更新，修改后部分参数无需卸载挂载即可实时生效。
ks3fs同样支持通过命令行方式挂载，即挂载时在命令行中指定具体参数。详情请参见文档：命令行挂载。
通过-o config=<配置文件路径>指定配置文件进行挂载：
ks3fs <bucket> <mountpoint> -o config=/etc/ks3fs/ks3fs.conf示例1：仅使用配置文件挂载：
# 仅使用配置文件挂载
ks3fs my-bucket /mnt/ks3 -o config=/etc/ks3fs/ks3fs.conf示例二：同时使用配置文件与命令行方式挂载
# 同时使用配置文件与命令行方式挂载（存在相同参数时命令行参数优先级更高）
ks3fs my-bucket /mnt/ks3 -o config=/etc/ks3fs/ks3fs.conf -o dbglevel=debug
当命令行与配置文件存在相同参数时，命令行生效，配置文件不生效。
未通过-o config=显式指定配置文件时，ks3fs将按以下顺序检索，加载首个找到的配置文件：
优先级 | 查找位置 | 说明 |
|---|---|---|
1 |
| 命令行显式指定 |
2 |
| 通过环境变量指定路径 |
3 |
| 用户家目录下的配置文件 |
4 |
| 系统级配置文件 |
如果通过-o config=指定的是相对路径，ks3fs会自动转换为绝对路径。
配置文件采用行格式，每行一个参数：
键值参数：参数名=参数值。
开关参数：直接写参数名，不需要写=true或=false。
以#开头的行为注释，空行会被忽略。
# 键值参数
url=http://ks3-cn-beijing.ksyuncs.com
dbglevel=info
passwd_file=/etc/passwd-ks3fs
# 开关参数（不要写 =true）
allow_other
sigv4以下是一个完整的配置文件示例，包含常用参数：
# ks3fs 配置文件
#=== 基础配置 ===
#url=http://ks3-cn-beijing.ksyuncs.com
#region=BEIJING
#sigv4
#passwd_file=/etc/passwd-ks3fs
#logfile=/var/log/ks3fs.log
#dbglevel=info
#=== 性能配置 ===
#performance
#upload_concurrency=100
#prefetch_concurrency=100
#multipart_size=10
#prefetch_chunk_size=10
#parallel_count=20
#prefetch_chunks=3
#enable_content_crc64
#=== 内存配置 ===
#memory_limit=4096
#=== 缓存配置 ===
#stat_cache_expire=900
#max_stat_cache_size=100000
#ensure_diskfree=5120
#=== 超时配置 ===
#connect_timeout=300
#readwrite_timeout=120
#retries=3
#=== 挂载选项 ===
#allow_other
#umask=022
#nonempty
#=== 对象属性 ===
#default_acl=private
#storage_class=STANDARD以上参数的详细说明请参见文档：ks3fs挂载选项说明。
ks3fs配置文件支持热更新，修改配置文件可动态生效，无需卸载挂载。程序每5秒轮询检测配置变更，一旦发现更新，自动加载并应用新配置。
根据生效方式的不同，参数分为以下三类：
类型 | 说明 |
|---|---|
实时生效 | 修改并保存文件后5秒内生效 |
任务触发生效 | 修改后下一次文件读写请求时生效 |
禁止热更新 | 不支持热更新，需卸载后重新挂载生效 |
参数 | 说明 |
|---|---|
| 日志级别 |
| curl 调试日志开关 |
| 全局上传并发数 |
| 全局预读并发数 |
| 请求重试次数 |
| 连接超时（秒） |
| 读写超时（秒） |
| stat 缓存过期时间（秒） |
| stat 缓存最大条目数 |
| 密码文件路径 |
| 服务端点 URL |
| 区域 |
| 存储类型 |
| 默认 ACL |
参数 | 说明 |
|---|---|
| 分片上传大小（MB） |
| 分片拷贝大小（MB） |
| 单文件上传并行数 |
| 预取块大小（MB） |
| 文件属主 UID |
| 文件属组 GID |
| 文件权限掩码 |
| 内存限制（MB） |
| 保证磁盘剩余空间（MB） |
| 开启CRC64校验 |
参数 | 说明 |
|---|---|
| 允许非空目录挂载 |
| 允许其他用户访问 |
| 不校验 SSL 证书 |
| 卸载时删除缓存 |
| 临时文件目录 |
| 本地缓存目录 |
| 日志文件路径 |
1. 命令行指定的参数在热更新时不会被覆盖，始终以命令行为准。
2. 从配置文件中删除某个参数后，该参数会恢复为默认值。
您可以使用以下命令，卸载已挂载到本地的KS3文件系统。例如，卸载挂载在/tmp/ks3fs路径下的文件系统。
umount /tmp/ks3fs纯净模式