全部文档
当前文档
最近更新时间：2025-04-25 15:54:39
KS3Util的配置文件默认生成在~/.ks3utilconfig 路径下，您也可以通过执行config命令，查看默认配置文件实际的生成路径。以下为配置文件参数说明：
表1 参数说明
参数名 | 说明 |
|---|---|
accessKeyID | 访问ks3使用的AccessKeyID，默认值：无。 |
accessKeySecret | 访问ks3使用的AccessKeySecret，默认值：无。  若accessKeyID和accessKeySecret都为空，则使用匿名方式请求，此时需要存储桶有公开访问的权限。 |
endpoint | 设置Bucket所在地域的域名信息，支持HTTP和HTTPS访问，默认值：ks3-cn-beijing.ksyuncs.com。 填写内容示例：
|
language | 设置ks3util工具的语言，默认值：跟随系统语言设置。 可选值：
|
loglevel | 输出日志级别，默认值：info。 可选值：
|
logPath | 日志输出的目录，默认值：logs（工具当前执行目录的logs目录下）。 |
proxy | 指定代理服务器，默认值：无。 配置值可以为以下几种：
配置这些环境变量后，将代理服务器选项的值设置为 |
retryTimes | 请求失败时的重试次数，默认值：10。取值范围：1-500。 |
readTimeout | 客户端读超时的时间，默认值：60，单位：秒。 |
connectTimeout | 客户端连接超时的时间，默认值：60，单位：秒。 |
outputDir | 批量操作时清单文件输出的目录，默认值：ks3util_output（工具当前执行目录的ks3util_output目录下）。 |
outputItem | 批量操作时清单文件输出项，默认值：failed（表示只输出失败文件清单）。可填写多个值，以英文逗号分隔，例如：succeeded,failed,skipped。 可选值：
|
checkpoint | 断点续传文件保存的目录，默认值：.ks3util_checkpoint（工具当前执行目录的.ks3util_checkpoint目录下）。 |
bigfileThreshold | 开启大文件分块操作的阈值，大于等于该值的文件会进行分块，并且支持断点续传，默认值：100MB。 |
partSize | 分块大小，默认情况下根据文件大小自行计算合适的值，取值范围：5MB-5GB。 |
readable | 统计文件结果以更友好的可读性输出信息，文件大小自适应合适的单位显示，默认值：false。 可选值：
|
shortFormat | 列举文件结果显示精简格式，默认值：false。 可选值：
|
disableEndpointRedirect | 禁用endpoint自动重定向，不会自动重定向到桶所在region对应的endpoint，始终使用配置中的endpoint，默认值：false。 可选值：
|
disableTempFile | 下载文件时不创建临时文件，而是直接下载为目标文件，默认值：false。 可选值：
|
disableCrc64 | 关闭crc64校验。默认值：false。 可选值：
|
createPathDir | 创建路径目录对象，默认值：false。 可选值：
|
pathMatching | 开启路径匹配，默认值：false。 可选值：
|
enableRegex | 开启正则匹配，默认值：false。 可选值：
|
enableSymlinkDir | 允许上传软链接子目录，默认值：false。 可选值：
|
cycleSymlinkCheck | 进行软链接指向循环检查，默认值：false。 可选值：
|
pbOutputMode | 进度条输出方式，默认值：refresh。 可选值：
|
pbOutputInterval | 进度条输出间隔时间，默认值：1，单位：秒，取值范围：1-60。 |
纯净模式
