qshell

简介

qshell是基于七牛API文档实现的一个方便开发者测试和使用七牛API服务的命令行工具。

下载

版本 支持平台 链接 更新日志
qshell v1.4.9 Linux, Windows, Mac OSX 下载 查看

因为上面发布的zip包里面有支持不同平台的可执行文件,请根据系统平台选择合适的可执行文件,然后其他的都可以删除,再把可执行文件重命名为 qshell (Windows下面是 qshell.exe然后就可以使用了)

另外,由于本工具是一个命令行工具,在Windows下面请先打开命令行终端,然后输入工具名称执行,不要双击打开。如果你希望可以在任意目录下使用qshell,请将qshell工具可执行文件所在目录添加到系统的环境变量中。

使用方法

注意:Windows 系统用户在 开始 菜单栏选择 运行 输入 cmd 回车即可打开 DOS 命令行窗口,然后切换到 qshell_windows_amd64.exe 的所在磁盘路径。假设你的 qshell_windows_amd64.exe 存放在 F:\tools\qshell_windows_amd64.exe ,那么如下几行命令可以切换到 qshell_windows_amd64.exe 存放的目录:

> F:
> cd tools

如图:

image

我们知道调用七牛的API需要一对AccessKeySecretKey,这个可以从七牛的后台的账号设置->密钥获取。

首先要使用七牛的API,必须先设置AccessKeySecretKey。命令如下: qshell account ELUs327kxVPJrGCXqWae9yioc0xYZyrIpbM6Wh6o LVzZY2SqOQ_I_kM1n00ygACVBArDvOWtiLkDtKi_ 上面的ELUs327kxVPJrGCXqWae9yioc0xYZyrIpbM6Wh6o就是你的AccessKey,而LVzZY2SqOQ_I_kM1n00ygACVBArDvOWtiLkDtKi_就是你的SecretKey。如果你想查看当前的AccessKeySecretKey设置,使用命令:

qshell account

上面的命令会输出当前你设置好的AccessKeySecretKey。 接下来,我们就可以放心地使用七牛的API功能了。

使用详解

命令 描述 详细
account 设置或显示当前用户的AccessKey和SecretKey 文档
dircache 输出本地指定路径下所有的文件列表 文档
listbucket 列举七牛空间里面的所有文件 文档
alilistbucket 列举阿里OSS空间里面的所有文件 文档
prefop 查询七牛数据处理的结果 文档
fput 以文件表单的方式上传一个文件 文档
rput 以分片上传的方式上传一个文件 文档
qupload 同步数据到七牛空间, 带同步进度信息,和数据上传完整性检查 文档
qdownload 从七牛空间同步数据到本地,支持只同步某些前缀的文件,支持增量同步 文档
stat 查询七牛空间中一个文件的基本信息 文档
delete 删除七牛空间中的一个文件 文档
move 移动或重命名七牛空间中的一个文件 文档
copy 复制七牛空间中的一个文件 文档
chgm 修改七牛空间中的一个文件的MimeType 文档
fetch 从Internet上抓取一个资源到七牛空间中 文档
prefetch 更新七牛空间中从源站镜像过来的文件 文档
batchdelete 批量删除七牛空间中的文件,可以直接根据listbucket的结果来删除 文档
batchchgm 批量修改七牛空间中文件的MimeType 文档
batchcopy 批量复制七牛空间中的文件到另一个空间 文档
batchmove 批量移动七牛空间中的文件到另一个空间 文档
batchrename 批量重命名七牛空间中的文件 文档
checkqrsync 检查qrsync的同步结果,主要通过比对dircachelistbucket的结果 文档
b64encode base64编码工具,可选是否使用UrlSafe方式,默认UrlSafe 文档
b64decode base64解码工具,可选是否使用UrlSafe方式,默认UrlSafe 文档
urlencode url编码工具 文档
urldecode url解码工具 文档
ts2d 将timestamp(单位秒)转为UTC+8:00中国日期,主要用来检查上传策略的deadline参数 文档
tms2d 将timestamp(单位毫秒)转为UTC+8:00中国日期 文档
tns2d 将timestamp(单位100纳秒)转为UTC+8:00中国日期 文档
d2ts 将日期转为timestamp(单位秒) 文档
ip 根据淘宝的公开API查询ip地址的地理位置 文档
qetag 根据七牛的qetag算法来计算文件的hash 文档
unzip 解压zip文件,支持UTF-8编码和GBK编码 文档
privateurl 生成私有空间资源的访问外链 文档
saveas 实时处理的saveas链接快捷生成工具 文档
reqid 七牛自定义头部X-Reqid解码工具 文档
m3u8delete 根据流媒体播放列表文件删除七牛空间中的流媒体切片 文档
buckets 获取当前账号下所有的空间名称 文档
domains 获取指定空间的所有关联域名 文档

编译

  1. 如果是编译本地平台的可执行程序,使用src目录下面的build.sh脚本即可。
  2. 如果是编译跨平台的可执行程序,使用src目录下面的gox_build.sh脚本即可。该脚本使用了gox工具,请 使用go get github.com/mitchellh/gox安装。

如果有任何问题,请进入 七牛云存储问答社区 或者发送 工单 咨询