教程简介

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

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

安装操作步骤

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参数文档
使用该命令行前需要先进行登陆，登陆命令参考本教程第二部分安装操作步骤。

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

获取全部文件列表

    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