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
如图:
我们知道调用七牛的API需要一对AccessKey
和SecretKey
,这个可以从七牛的后台的账号设置->密钥获取。
首先要使用七牛的API,必须先设置AccessKey
和SecretKey
。命令如下:
qshell account ELUs327kxVPJrGCXqWae9yioc0xYZyrIpbM6Wh6o LVzZY2SqOQ_I_kM1n00ygACVBArDvOWtiLkDtKi_
上面的ELUs327kxVPJrGCXqWae9yioc0xYZyrIpbM6Wh6o
就是你的AccessKey
,而LVzZY2SqOQ_I_kM1n00ygACVBArDvOWtiLkDtKi_
就是你的SecretKey
。如果你想查看当前的AccessKey
和SecretKey
设置,使用命令:
qshell account
上面的命令会输出当前你设置好的AccessKey
和SecretKey
。
接下来,我们就可以放心地使用七牛的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的同步结果,主要通过比对dircache 和listbucket 的结果 |
文档 |
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 | 获取指定空间的所有关联域名 | 文档 |
编译
- 如果是编译本地平台的可执行程序,使用
src
目录下面的build.sh
脚本即可。 - 如果是编译跨平台的可执行程序,使用
src
目录下面的gox_build.sh
脚本即可。该脚本使用了gox工具,请 使用go get github.com/mitchellh/gox
安装。
如果有任何问题,请进入 七牛云存储问答社区 或者发送 工单 咨询