最近更新时间: 2026-05-28 20:39:45

教程简介

本教程用于命令行初学者下载使用，且能够运行简单的命令测试能否正常使用。

本教程仅供示范，其他命令及详细操作请参考命令的 说明文档。

安装操作步骤

1. 在七牛开发者中心的 SDK & 工具中，选择合适的版本，下载到本地并解压 qshell文档。

   

2. 为了方便文件的使用，可以对解压后的文件重命名为 qshell.exe（如果显示时隐藏了后缀，修改为 qshell 即可），如果解压后的文件名已经是qshell，那么忽略此步骤，参考上图

3. 将qshell复制存放入D盘，或者其他的非系统盘

4. widowns通过菜单栏搜索cmd，单击打开cmd窗口

5. 由于此处我们的qshell存在在D盘，cmd进入D盘，输入 D: 切换D盘，切换后输入 qshell -v 有版本号输出后，表示qshell已经可用
   注意：如果没有对文件进行重命名，需要完整输入 qshell文件名 -v。如果报错无法识别的命令，请重新检查是否已经使用cmd进入了qshell.exe存放的真实目录

6. 使用 qshell 命令操作对应账号前需要进行登陆操作，登陆时需要 AK、SK 信息，获取密钥对 AK SK 可以在控制台复制，在个人中心 - 密钥管理中查看。

   

7. 登陆时使用命令(见下图)：

   qshell account 填写您的ak 填写您的sk name

8. 登录后，通过 qshell account 可以展示出账号信息，表示已经登录成功 到此时，表示qshell已经可以正式使用，下面可以在此目录执行qshell的各种命令

   注意：

   1. 如果 AK，SK，name 首字母是 "-"，需要使用命令 qshell account -- 填写您的ak填写您的sk name（如图），可以避免把该项识别成命令行选项。
   2. qshell account 登录只需要登录一次，会记住账号，无需每次使用重复登录

文件列表

listbucket2 命令用于获取文件列表，可以根据不同的需求拉取不同的文件列表 使用该命令行前需要先进行登陆，登陆命令参考本教程第二部分安装操作步骤。 这里只列举几种常见的获取文件列表的需求，更多参数叠加使用，参考listbucket2参数文档 注意：如果出现列举超时失败，建议先确认下本地网络情况，然后使用返回的marker标记重新执行列举命令即可。

marker的使用示例： 假如要列举的 bucket 名字为 "test-marker", marker 为"eyJjIjowLCJrIjoiMDkzOWM1ODU4ZmI1NGZiNzk3NTJmNjVkN2U4MWY4MmVfMTUzNTM3NzI2MDMxNV8xNTM1MzgwMjYyNDYxXzgzMjgyODAzOC0wMDAwMS5tcDQifQ=", 如果要接着这个 marker 位置继续列举，可以使用如下命令： qshell listbucket2 -m eyJjIjowLCJrIjoiMDkzOWM1ODU4ZmI1NGZiNzk3NTJmNjVkN2U4MWY4MmVfMTUzNTM3NzI2MDMxNV8xNTM1MzgwMjYyNDYxXzgzMjgyODAzOC0wMDAwMS5tcDQifQ= test-marker

• 获取全部文件列表
• 只获取文件名
• 获取指定前缀文件列表
• 获取指定时间范围内的文件列表
• 获取指定文件类型的文件列表

获取全部文件列表

    qshell listbucket2 空间名称 -o 列表存放的本地文件名.txt

只获取文件名

    qshell listbucket2 空间名称 --show-fields Key -o 列表存放的本地文件名.txt

获取指定前缀文件列表

比如想要获取前缀为 image文件夹的文件，通过 prefix

     qshell listbucket2 空间名称 --prefix "iamge/" -o 列表存放的本地文件名.txt

获取指定时间范围内的文件列表

比如想要获取 2018-10-30 ~ 2018-11-03 之间上传的文件列表

     qshell listbucket2 --start 2018-10-30 --end 2018-11-03 空间名称  -o 列表存放的本地文件名.txt

获取指定文件类型的文件列表

比如想要获取 空间内的低频文件列表 file-types参上个月：根据列举前缀列举整个空间，然后从中筛选出满足七牛存储类型的文件；配置多个存储类型时中间用逗号隔开（eg: 1,2,3）；0：普通存储，1：低频存储，2：归档存储，3：深度归档存储，4：归档直读存储。

     qshell listbucket2  空间名称 --file-types 2  -o 列表存放的本地文件名.txt

单文件上传

rput 命令用于上传大文件，命令参数详解参考 rput说明文档。

1. 使用该命令行前需要先进行登陆，登陆命令参考本教程第二部分安装操作步骤。
2. 执行命令：

   qshell rput bucket名 上传后文件名 本地文件的绝对路径或者相对路径(更简单的方式直接拖拽文件到cmd中)

   

批量上传

qupload2 命令用于批量上传本地或者主机服务器某个文件夹下的文件全部上传到存储，命令参数详解参考 qupload2说明文档。 使用该命令行前需要先进行登陆，登陆命令参考本教程第二部分安装操作步骤。

    qshell qupload2 --src-dir=本地文件夹相对路径或者绝对路径 --bucket=空间名称

批量下载

qdownload2 用于批量下载空间内文件，命令参数详解参考 qdownload2说明文档。 使用该命令行前需要先进行登陆，登陆命令参考本教程第二部分安装操作步骤。

批量下载空间内全部文件

1. 执行命令：

   qshell qdownload2 --dest-dir=本地文件夹相对路径或者绝对路径 --bucket=空间名称

   注意：配置文件参数在当前 cmd 命令行所在目录下时，可以直接输入文件名。如果非本目录下，需要输入完整路径，如 qshell qdownload2 --dest-dir=E:\qiniu-data\ --bucket=空间名称。

   

2. 运行结果，保存路径不变的情况下会进行增量下载，详细日志信息可以在输出的 log 路径查看。

   

批量下载空间内指定目录的文件

比如想要下载 image 目录的文件, 通过设置 prefix 内容即可

 qshell qdownload2 --dest-dir=本地文件夹相对路径或者绝对路径 --bucket=空间名称 --prefix="image/"

批量删除

文件一旦删除，无法恢复，请务必慎重处理！ batchdelete 用于批量下删除空间内的文件，需要先获对应的文件列表，然后基于列表删除，batchdelete说明文档。 使用该命令行前需要先进行登陆，登陆命令参考本教程第二部分安装操作步骤。

批量删除空间内全部文件

1. 执行命令，获取空间内全部文件：

   qshell listbucket2 空间名称 --show-fields Key -o todelete.txt

2. 等待1执行完毕后，基于1的todelete.txt做文件批量删除

   qshell batchdelete 空间名称 -i todelete.txt

批量删除指定时间内的文件

比如想要删除2024年6月之前上传的文件

1. 执行命令，获取指定时间内的文件列表名称：

   qshell listbucket2 空间名称 --show-fields Key --start 2010-01-01 --end 2024-05-31 -o todelete.txt

2. 等待1执行完毕后，基于1的todelete.txt做文件批量删除

   qshell batchdelete 空间名称 -i todelete.txt

批量修改历史文件生成周期

空间的生命周期删除后，删除后上传的文件没有生命周期，但是删除前上传的生命周期默认不会消失！ batchchlifecycle 用于批量修改文件生命周期，需要先获对应的文件列表，然后基于列表批量修改，batchchlifecycle说明文档。 使用该命令行前需要先进行登陆，登陆命令参考本教程第二部分安装操作步骤。

--to-ia-after-days：指定文件上传后并在设置的时间后转换到 低频存储类型；值范围为 -1 或者大于 0，设置为 -1 表示取消已设置的转 低频存储 的生命周期规则，单位：天【可选】

--to-archive-ir-after-days：指定文件上传后并在设置的时间后转换到 归档直读存储类型；值范围为 -1 或者大于 0，设置为 -1 表示取消已设置的转 归档直读存储 的生命周期规则，单位：天【可选】

--to-archive-after-days：指定文件上传后并在设置的时间后转换到 归档存储类型；值范围为 -1 或者大于 0，设置为 -1 表示取消已设置的转 归档存储 的生命周期规则，单位：天【可选】

--to-deep-archive-after-days：指定文件上传后并在设置的时间后转换到 深度归档存储类型；值范围为 -1 或者大于 0，设置为 -1 表示取消已设置的转 深度归档存储 的生命周期规则，单位：天【可选】

--delete-after-days：指定文件上传后并在设置的时间后进行 过期删除，删除后不可恢复；值范围为 -1 或者大于 0，设置为 -1 表示取消已设置的 过期删除 的生命周期规则，单位：天【可选】

取消历史文件全部的生成周期

1. 执行命令，获取空间内全部文件：

   qshell listbucket2 空间名称 --show-fields Key -o releaselifecycle.txt

2. 等待1执行完毕后，基于1的releaselifecycle.txt，批量取消生命周期

   qshell batchchlifecycle if-pbl -i releaselifecycle.txt
   --to-ia-after-days -1 \
   --to-archive-ir-after-days -1 \
   --to-archive-after-days -1 \
   --to-deep-archive-after-days -1 \
   --delete-after-days -1

对历史文件设置生成周期，30天后自动删除

1. 执行命令，获取空间内全部文件：

   qshell listbucket2 空间名称 --show-fields Key -o releaselifecycle.txt

2. 等待1执行完毕后，基于1的releaselifecycle.txt做文件批量修改生命周期

   qshell batchchlifecycle 空间名称 -i releaselifecycle.txt --delete-after-days 30

批量解冻归档文件

1. 执行命令，获取空间内的归档文件列表 qshell listbucket2 空间名称 --file-types 2 --show-fields Key -o releaselifecycle.txt

2. 等待1执行完毕后，基于1的releaselifecycle.txt做归档文件批量解冻操作，比如解冻5天 qshell batchrestorear 空间名称 5 -i releaselifecycle.txt

批量解冻深度归档文件

1. 执行命令，获取空间内的深度归档文件列表 qshell listbucket2 空间名称 --file-types 3 --show-fields Key -o releaselifecycle.txt

2. 等待1执行完毕后，基于1的releaselifecycle.txt做深度归档文件批量解冻操作，比如解冻5天 qshell batchrestorear 空间名称 5 -i releaselifecycle.txt

批量修改存储类型

1. 归档或深度归档存储文件，转换前需要先做解冻操作，解冻完成后才能进行存储类型修改，解冻参考上述【批量解冻深度归档文件】和【批量解冻归档文件】步骤
2. 标准存储、归档直读、低频存储和智能分层存储类型可以直接转换
3. 转换命令示例 A、先列举出需要转换的文件名列表，参考上述【文件列表】步骤 B、在 列表存放的本地文件名.txt 文件中添加目标存储类型，0:标准存储 1:低频存储 2:归档存储 3:深度归档 4:归档直读存储 5:智能分层存储；处理命令示例 awk '{print $1"\t0"}' 列表存放的本地文件名.txt > 新的列表存放的本地文件名.txt C、批量修改存储类型 qshell batchchtype 空间名 新的列表存放的本地文件名.txt