qshell

简介

qshell是利用七牛文档上公开的API实现的一个方便开发者测试和使用七牛API服务的命令行工具。该工具设计和开发的主要目的就是帮助开发者快速解决问题。目前该工具融合了七牛存储，CDN，以及其他的一些七牛服务中经常使用到的方法对应的便捷命令，比如b64decode，就是用来解码七牛的URL安全的Base64编码用的，所以这是一个面向开发者的工具，任何新的被认为适合加到该工具中的命令需求，都可以在ISSUE列表里面提出来，我们会尽快评估实现，以帮助大家更好地使用七牛服务。

下载

该工具使用Go语言编写而成，当然为了方便不熟悉Go或者急于使用工具来解决问题的开发者，我们提供了预先编译好的各主流操作系统平台的二进制文件供大家下载使用，由于平台的多样性，我们把这些二进制打包放到一个文件里面，请大家根据下面的说明各自选择合适的版本来使用。在文档中的例子里面，为了方便，我们统一使用qshell这个命令来做介绍。

安装

该工具由于是命令行工具，所以只需要从上面的下载链接下载zip包之后解压即可使用。其中文件名和对应系统关系如下：

Linux和Mac平台

（1）权限 如果在Linux或者Mac系统上遇到Permission Denied的错误，请使用命令chmod +x qshell来为文件添加可执行权限。这里的qshell是上面文件重命名之后的简写。

（2）任何位置运行 对于Linux或者Mac，如果希望能够在任何位置都可以执行，那么可以把qshell所在的目录加入到环境变量$PATH中去。假设qshell命令被解压到路径/home/jemy/tools目录下面，那么我们可以把如下的命令写入到你所使用的bash所对应的配置文件中，如果是/bin/bash，那么就是~/.bashrc文件，如果是/bin/zsh，那么就是~/.zshrc文件中。写入的内容为：

export PATH=$PATH:/home/jemy/tools

保存完毕之后，可以通过两种方式立即生效，其一为输入source ~/.zshrc或者source ~/.bashrc来使配置立即生效，或者完全关闭命令行，然后重新打开一个即可，接下来就可以在任何位置使用qshell命令了。

Windows平台

（1）闪退问题 本工具是一个命令行工具，在Windows下面请先打开命令行终端，然后输入工具名称执行，不要双击打开，否则会出现闪退现象。

（2）任何位置运行 如果你希望可以在任意目录下使用qshell，请将qshell工具可执行文件所在目录添加到系统的环境变量中。由于Windows系统是图形界面，所以方便一点。假设qshell.exe命令被解压到路径E:\jemy\tools目录下面，那么我们把这个目录放到系统的环境变量PATH里面。

密钥设置

该工具有两类命令，一类需要鉴权，另一类不需要。

需要鉴权的命令都需要依赖七牛账号下的 AccessKey 和 SecretKey。所以这类命令运行之前，需要使用 account 命令来设置下 AccessKey ，SecretKey 。

单用户模式：

$ qshell account ak sk

多用户模式：

$ qshell -m account ak sk

多用户模式

和其他的工具一样，本工具也会在使用的过程中，向本地磁盘写入一些文件，比如上面的account设置的 AccessKey 和 SecretKey 都是加密后保存在本地磁盘上的。另外还有qupload和qdownload功能也会向本地磁盘写入一些文件。

默认情况下，工具的使用模式是单用户模式，用户的所有信息写入到磁盘$HOME_DIR/.qshell下面。即如果你用account设置了新的密钥，那么这个新的密钥将覆盖旧的密钥。这个$HOME_DIR在Linux或者Mac下就是~所表示的目录。如果是Windows下则是C:\Users\jemy这样的路径。

但是有些情况下，我们可能拥有多个账号，比如同时拥有测试环境的账号和线上环境的账号，这种情况下，怎么让qshell同时支持多组AccessKey和SecretKey的设置呢？

为了解决这个问题，我们引入了选项-m。当在使用qshell的时候，指定该选项的话，就会切换到多用户模式下，在这种模式下，工具会把所有的临时文件都写到工具执行的目录。

基于上面的功能，我们可以创建一些专用的目录，用来切换到qshell的多用户模式运行。假设本地有如目录/Users/jemy/Temp/qshell/workdir，这个目录下分别有env_dev和env_prod两种环境的账号。

我们分别在目录env_dev和env_prod目录下，运行qshell -m account ak sk来设置不同账号的密钥对，结果如下：

$ tree -a

├── env_dev
│   └── .qshell
│       └── account.json
└── env_prod
    └── .qshell
        └── account.json

这样其他的依赖AccessKey和SecretKey的命令都可以使用-m选项在这个目录下执行命令，例如stat获取文件信息：

$ cd /Users/jemy/Temp/qshell/workdir/env_dev
$ qshell -m stat bucket key

命令选项

该工具还有一些有用的选项参数如下：

命令列表

项目编译

如果对项目编译感兴趣，请按照如下方式进行：

$ go get github.com/astaxie/beego/logs
$ go get github.com/fsnotify/fsnotify
$ go get github.com/syndtr/goleveldb/leveldb
$ go get github.com/yanunon/oss-go-api/oss
$ go get golang.org/x/text/encoding/simplifiedchinese
$ go get golang.org/x/sys/unix
$ ./build.sh

如果上面的 golang.org/x 下面的包因为被墙而无法下载，那么可以使用 git clone 分别将依赖的库下载到本地的GOPATH中：

git clone https://github.com/golang/sys.git  $GOPATH/src/golang.org/x/sys
git clone https://github.com/golang/text.git $GOPATH/src/golang.org/x/text

对于跨平台的编译脚本 cross-build-main.sh 编译出来的二进制文件存在的已知问题如下：

crontab下面引用qshell出错

问题反馈

如果您有任何问题，请写在ISSUE列表里面，我们会尽快回复您。

技术讨论

如果您希望和在工作中使用qshell的其他人进行交流，可以加入QQ群：343822521 。