全部文档
当前文档
最近更新时间：2026-08-05 16:34:24
您可以通过 share-cp 命令，使用提取码将分享的文件下载到本地。
./ks3util share-cp authorization_code file_url
[--prefix <value>]
[--key <value>]
[--access-code <value>]
[-f, --force]
[-u, --update]
[--update-rule <value>]
[--bigfile-threshold <value>]
[--part-size <value>]
[--only-current-dir]
[--include <value>]
[--exclude <value>]
[--time-range <value>]
[-j, --jobs <value>]
[--parallel <value>]
[--bandwidth-limit <value>]
[--checkpoint-dir <value>]
[--disable-crc64]
[--dry-run]
[--disable-temp-file]
[--list-parallel <value>]
[--list-depth <value>]./ks3util share-cp file://authorization_code_file_url file_url
[--prefix <value>]
[--key <value>]
[--access-code <value>]
[-f, --force]
[-u, --update]
[--update-rule <value>]
[--bigfile-threshold <value>]
[--part-size <value>]
[--only-current-dir]
[--include <value>]
[--exclude <value>]
[--time-range <value>]
[-j, --jobs <value>]
[--parallel <value>]
[--bandwidth-limit <value>]
[--checkpoint-dir <value>]
[--disable-crc64]
[--dry-run]
[--disable-temp-file]
[--list-parallel <value>]
[--list-depth <value>]参数名称 | 说明 |
authorization_code | 需提取码的分享链接或直接分享链接。 |
file://authorization_code_file_url | 存放分享链接的文件的具体位置。  必须以 |
--prefix | 下载指定前缀下的文件。若不指定则表示下载链接内的全部文件。 |
--key | 下载指定的单个对象。
该选项不支持与 |
--access-code | 分享链接的提取码，生成时未设置则无需指定。 1. 字符长度必须是6位，支持任意数字或字母组合，区分大小写。 2. 不指定该参数时会以交互模式提示输入提取码。 |
-f, --force | 强制操作，不进行询问提示。当目标文件已存在，且没有使用-u选项时，会覆盖目标文件（即所有文件重传）。 |
-u, --update | 更新操作，只有当目标文件不存在，或源文件的最后修改时间晚于目标文件时，KS3Util才会执行下载操作，否则会跳过该文件。 |
--update-rule | 使用 可选值： 1：目标文件不存在则更新。 2：目标文件不存在或大小不相等则更新。 3：目标文件不存在或时间戳更旧则更新。 4：目标文件不存在或时间戳更旧或大小不相等则更新。 5：目标文件不存在或CRC64不一致则更新。 |
--bigfile-threshold | 开启大文件分块操作的阈值，大于等于该值的文件会进行分块。
可选单位：B、KB、MB、GB、TB。 |
--part-size | 分块大小，默认情况下将根据文件大小自动计算合适的值。
1. 可选单位：B、KB、MB、GB。 2. 如果有特殊需求或需要性能调优，可以设置该值。 |
--only-current-dir | 表示仅下载当前目录下的文件，忽略子目录及子目录内的文件。 |
--include | 包含对象匹配模式，满足匹配规则的文件将会被选中。
该选项可以出现多次，多个 |
--exclude | 不包含对象匹配模式，满足匹配规则的文件将会被排除。
该选项可以出现多次，多个--exclude规则取并集。 |
--time-range | 时间段匹配模式，仅匹配最后修改时间在该时间段内的文件。
1. time1、time2需要填写UTC时间，格式为： 2. 详情请参见文档：通用选项&过滤规则。 |
-j, --jobs | 多文件操作时的并发数，表示有多少个文件并行传输。
|
--parallel | 单文件内部操作的并发任务数，表示单个大文件有多少个块并行传输。
|
--bandwidth-limit | 客户端带宽限速，用于限制下载文件的速度。例如：100MB 表示限速 100MB/s。
可选单位：B、KB、MB、GB。 |
--checkpoint-dir | 断点续传信息存储目录，默认值为当前工作目录下的 .ks3util_checkpoint，大文件分块传输中断后可从中断点续传。 |
--disable-crc64 | 关闭 CRC64 数据校验。默认情况下数据传输时自动开启 CRC64 校验以确保完整性。 |
--dry-run | 测试模式运行，不执行实际下载操作，用于验证流程的正确性。 |
--disable-temp-file | 下载文件时，将不再生成带 .temp 后缀的临时文件，而是直接创建并写入目标文件。该参数适用于将大量小文件（KB 级别）下载至 NAS 时 TPS（每秒完成数）较低的场景。 1. 启用该参数后，若任务中断或文件下载失败，会产生不完整的文件。 2. 启用该参数后，使用 3. 若关闭此参数并使用增量下载，将会依据最后修改时间跳过这些不完整的文件，因此请避免这样操作。 |
--list-parallel | 扫描文件的并发数，默认值：1，取值范围：1-100。 |
--list-depth | 并行扫描的最大目录深度，默认值：1，取值范围：1-100。该值影响扫描策略，值越大并行扫描的目录层级越深，但不影响最终扫描到的文件总数。 |
通过需提取码的分享链接下载全部文件。
./ks3util share-cp https://ks3.console.ksyun.com/doc-share.html?token=xxxxxxxxxxxx local_dir输出示例
请输入提取码:
xxxxxx
[---------------------------------------------------------------] 100.00% tps:1.37 速度:13.74KB/s 完成数:2/2 完成大小:20.00KB/20.00KB 1.456s
Succeed count: 2 Failed count: 0
Succeed bytes: 20.00KB
Task id: 6d666e02-dea6-4574-826d-15e1b96424b6
平均速度：13.77KB/s
3.900162(s) elapsed通过直接分享链接下载全部文件。
./ks3util share-cp http://samplebucket.ks3-cn-beijing.ksyuncs.com/?Expires=xxxxxx&KSSAccessKeyId=xxxxxx&Signature=xxxxxx&X-Kss-Policy=xxxxxx local_dir输出示例
[---------------------------------------------------------------] 100.00% tps:1.37 速度:13.74KB/s 完成数:2/2 完成大小:20.00KB/20.00KB 1.456s
Succeed count: 2 Failed count: 0
Succeed bytes: 20.00KB
Task id: 6d666e02-dea6-4574-826d-15e1b96424b6
平均速度：13.77KB/s
3.900162(s) elapsed通过存放分享链接的文件路径下载全部文件，所在位置为当前目录下的result.txt文件（相对路径）。
./ks3util share-cp file://result.txt local_dir假设文件的绝对路径为/home/user/result.txt，路径格式需写为file:///home/user/result.txt。
输出示例
请输入提取码:
xxxxxx
[---------------------------------------------------------------] 100.00% tps:1.37 速度:13.74KB/s 完成数:2/2 完成大小:20.00KB/20.00KB 1.456s
Succeed count: 2 Failed count: 0
Succeed bytes: 20.00KB
Task id: 6d666e02-dea6-4574-826d-15e1b96424b6
平均速度：13.77KB/s
3.900162(s) elapsed通过分享链接下载全部文件，并使用--access-code指定提取码。
此时不会再通过交互模式提示输入提取码。
./ks3util share-cp https://ks3.console.ksyun.com/doc-share.html?token=xxxxxxxxxxxx local_dir --access-code xxxxxx输出示例
[---------------------------------------------------------------] 100.00% tps:1.37 速度:13.74KB/s 完成数:2/2 完成大小:20.00KB/20.00KB 1.456s
Succeed count: 2 Failed count: 0
Succeed bytes: 20.00KB
Task id: 6d666e02-dea6-4574-826d-15e1b96424b6
平均速度：13.77KB/s
3.900162(s) elapsed通过分享链接下载share-prefix/part1/前缀下的文件。
使用--prefix选项指定下载的前缀。
./ks3util share-cp https://ks3.console.ksyun.com/doc-share.html?token=xxxxxxxxxxxx local_dir --prefix share-prefix/part1/输出示例
请输入提取码:
xxxxxx
[---------------------------------------------------------------] 100.00% tps:1.37 速度:13.74KB/s 完成数:2/2 完成大小:20.00KB/20.00KB 1.456s
Succeed count: 2 Failed count: 0
Succeed bytes: 20.00KB
Task id: 6d666e02-dea6-4574-826d-15e1b96424b6
平均速度：13.77KB/s
3.900162(s) elapsed通过分享链接下载单个文件。
使用--key选项指定下载文件的key。
./ks3util share-cp https://ks3.console.ksyun.com/doc-share.html?token=xxxxxxxxxxxx local_dir --key share-prefix/part1/file00001输出示例
请输入提取码:
xxxxxx
[----------------------------------------------------------------] 100.00% tps:0.75 速度:7.47KB/s 完成数:1/1 完成大小:10.00KB/10.00KB 1.339s
Succeed count: 1 Failed count: 0
Succeed bytes: 10.00KB
平均速度：7.47KB/s
3.951919(s) elapsed纯净模式