金山云-文档中心-下载分享文件（share-cp）

对象存储(KS3)

查看更多结果

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

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

对象存储(KS3)

常用工具

工具汇总

KS3Util命令行工具

对象操作

分享文件夹

下载分享文件（share-cp）

最近更新时间：2025-10-15 11:38:30



您可以通过 share-cp 命令，使用提取码将分享的文件下载到本地。

命令格式

直接通过分享链接下载对象

./ks3util share-cp authorization_code file_url
[--prefix <value>]
[--key <value>]
[--access-code <value>]
[-f, --force] 
[-u, --update]
[--bigfile-threshold <value>]
[--part-size <value>]
[--only-current-dir]
[--include <value>]
[--exclude <value>]
[--time-range <value>]
[-j, --jobs <value>]
[--parallel <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]
[--bigfile-threshold <value>]
[--part-size <value>]
[--only-current-dir]
[--include <value>]
[--exclude <value>]
[--time-range <value>]
[-j, --jobs <value>]
[--parallel <value>]
[--checkpoint-dir <value>]
[--disable-crc64]
[--dry-run]
[--disable-temp-file]
[--list-parallel <value>]
[--list-depth <value>]

参数说明

参数名称	说明
authorization_code	携带授权码的文件分享链接。
file://authorization_code_file_url	存放分享链接的文件具体位置。必须以`file://`开头，后接分享链接存放文件的绝对或相对路径，KS3 Util将会自动从文件中读取链接。
--prefix	下载指定前缀下的文件。若不指定则表示下载链接内的全部文件。
--key	下载指定单个对象。示例：`prefix1/prefix2/a.txt` 该选项不支持与`--prefix`选项同时使用。
--access-code	提取码，下载文件必须输入提取码。 1. 字符长度必须是6位，支持任意数字或字母组合，区分大小写。 2. 不指定该参数时会以交互模式提示输入提取码。
-f, --force	存在同名文件时直接覆盖不进行提示。
-u, --update	只有当目标文件不存在或源文件的最后修改时间晚于目标文件时，KS3 Util才会执行下载操作，否则会跳过该文件。
--bigfile-threshold	开启大文件分块操作的阈值，大于等于该值的文件会进行分块。格式：值+单位默认值：100MB（104857600）默认单位：B（Byte）可选单位：B、KB、MB、GB、TB。
--part-size	分块大小，默认情况下KS3 Util将根据文件大小自动计算合适的值。格式为：值+单位默认单位：B（Byte）取值范围：5MB-5GB（5242880-5368709120） 1. 如果有特殊需求或需要性能调优，可以设置该值。 2. 可选单位：B、KB、MB、GB、TB。
--only-current-dir	表示仅下载当前目录下的文件，忽略子目录及子目录内的文件。
--include	包含对象匹配模式，满足匹配规则的文件将会被选中。示例：`*.jpg` 该选项可以出现多次，多个`--include`规则取并集。
--exclude	不包含对象匹配模式，满足匹配规则的文件将会被排除。示例：`*.txt` 该选项可以出现多次，多个--exclude规则取并集。
--time-range	时间段匹配模式，仅匹配最后修改时间在该时间段内的文件。格式：time1-time2 1. time1、time2需要填写UTC时间，格式为：`yyyyMMddHHmmss`。 2. 详情请参见文档：通用选项&过滤规则。
-j, --jobs	多文件操作时的并发数。默认值：5 取值范围：1-10000 1. 该参数决定有多少个文件并行上传。 2. 批量操作文件时适合调整该参数。 3. Util V2.9.0之前版本默认值为3，Util V2.9.0及之后版本默认值为5。
--parallel	单文件内部操作的并发任务数。取值范围：1-10000。 1. 默认KS3 Util会根据操作类型和文件大小自动决定，自动取值范围为1-12。 2. 该参数决定单个文件有多少个块并行上传。 3. 操作单个大文件时适合调整该参数。 4. 总并发数= jobs * parallel。
--checkpoint-dir	checkpoint目录的路径。默认值：`.ks3util_checkpoint` 1. 断点续传时，操作失败KS3 Util会自动创建该目录，并在该目录下记录checkpoint信息，操作成功会删除该目录。 2. 如果指定了该选项，请确保所指定的目录可以被删除。
--disable-crc64	关闭CRC64数据校验。默认情况下，KS3 Util进行数据传输时会开启CRC64校验。
--dry-run	测试模式运行，不执行实际下载操作，用于验证流程的正确性。
--disable-temp-file	下载文件时，将不再生成带 .temp 后缀的临时文件，而是直接创建并写入目标文件。该参数适用于将大量小文件（KB 级别）下载至 NAS 网络存储时 TPS（每秒完成数）较低的场景。 1. 启用该参数后，若任务中断或文件下载失败，会产生不完整的文件。 2. 启用该参数后，使用 `-u` 进行增量下载时，将始终基于 CRC64 校验已下载的文件内容。 3. 若关闭此参数并使用增量下载，将会依据最后修改时间跳过这些不完整的文件，因此请避免这样操作。
--list-parallel	扫描文件的并发数，默认值：1，取值范围：1-100。
--list-depth	并行扫描的最大深度，超过此深度的目录将不再并行扫描，默认值：1，取值范围：1-100。假设源目录为prefix/，而该目录存在以下结构： prefix/aa/ prefix/aa/1/、prefix/aa/2/ prefix/bb/ prefix/bb/1/、prefix/bb/2/ 值为 1 代表使用 delimiter=/ 扫描顶层（prefix/），获取到 prefix/aa/，prefix/bb/后，二者不再使用 delimiter=/ 进行扫描。值为 2 代表获取到 prefix/aa/，prefix/bb/ 后，二者仍使用 delimiter=/ 进行扫描，再得到的结果不再使用 delimiter=/ 进行扫描。

使用示例

示例一：通过分享链接下载全部文件

./ks3util share-cp https://ks3.console.ksyun.com/doc-share.html?token=xxxxxxxxxxxx local_dir

输出示例

请输入提取码:
xxxxxx
Parallel:      auto                Jobs:          5
Threshold:     100.00MB            PartSize:      auto
DisableCrc64:  false
CheckpointDir: /home/user/util/.ks3util_checkpoint
OutputDir:     /home/user/util/ks3util_output

[---------------------------------------------------------------] 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

示例二：通过分享链接存放的文件路径下载全部对象，文件路径为当前目录下的`code.txt`文件（相对路径）

./ks3util share-cp file://code.txt local_dir

输出示例

请输入提取码:
xxxxxx
Parallel:      auto                Jobs:          5
Threshold:     100.00MB            PartSize:      auto
DisableCrc64:  false
CheckpointDir: /home/user/util/.ks3util_checkpoint
OutputDir:     /home/user/util/ks3util_output

[---------------------------------------------------------------] 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

示例三：通过分享链接存放的文件路径下载全部对象，文件路径为`/home/user/code.txt`（绝对路径）

./ks3util share-cp file:///home/user/code.txt local_dir

输出示例

请输入提取码:
xxxxxx
Parallel:      auto                Jobs:          5
Threshold:     100.00MB            PartSize:      auto
DisableCrc64:  false
CheckpointDir: /home/user/util/.ks3util_checkpoint
OutputDir:     /home/user/util/ks3util_output

[---------------------------------------------------------------] 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

输出示例

Parallel:      auto                Jobs:          5
Threshold:     100.00MB            PartSize:      auto
DisableCrc64:  false
CheckpointDir: /home/user/util/.ks3util_checkpoint
OutputDir:     /home/user/util/ks3util_output

[---------------------------------------------------------------] 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

示例五：通过分享链接下载指定前缀下的文件

使用--prefix选项指定下载前缀为share-prefix/part1/的对象。

./ks3util share-cp https://ks3.console.ksyun.com/doc-share.html?token=xxxxxxxxxxxx local_dir --prefix share-prefix/part1/

输出示例

Parallel:      auto                Jobs:          5
Threshold:     100.00MB            PartSize:      auto
DisableCrc64:  false
CheckpointDir: /home/user/util/.ks3util_checkpoint
OutputDir:     /home/user/util/ks3util_output

[---------------------------------------------------------------] 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
Parallel:      auto                Jobs:          5
Threshold:     100.00MB            PartSize:      auto
DisableCrc64:  false
CheckpointDir: /home/user/util/.ks3util_checkpoint
OutputDir:     /home/user/util/ks3util_output

[----------------------------------------------------------------] 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

示例七：通过授权码下载分享前缀下的全部对象，设置扫描并发数为5，最大并发扫描深度为1。

./ks3util share-cp xxxxxxxxxxxx local_dir --list-parallel 5 --list-depth 1

输出示例

请输入提取码:
xxxxxx
Parallel:      auto                Jobs:          5
Threshold:     100.00MB            PartSize:      auto
DisableCrc64:  false
CheckpointDir: /home/user/util/.ks3util_checkpoint
OutputDir:     /home/user/util/ks3util_output

[---------------------------------------------------------------] 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-ls）

下一篇：辅助命令

纯净模式常规模式

纯净模式

点击可全屏预览文档内容