qshell

简介

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

下载

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

更新日志 查看

安装

该工具由于是命令行工具，所以只需要从上面的下载之后即可使用。

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 里面。

qshell 使用

1. 添加密钥和账户名称

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

需要鉴权的命令都需要依赖七牛账号下的 AccessKey, SecretKey和 Name。所以这类命令运行之前，需要使用 account 命令来添加 AccessKey ，SecretKey 和 Name 。 Name 是用户可以自定义的字符串，用来唯一表示 AccessKey/SecretKey 账户，qshell 会对添加的每一个账户信息加密保存，可以使用自命令 user 进行切换，切换账户的时候，需要使用账户唯一标识 Name。

$ qshell account <Your AccessKey> <Your SecretKey> <Your Name>

其中 name 表示该账号的名称, 如果 ak, sk, name 首字母是"-", 需要使用如下的方式添加账号, 这样避免把该项识别成命令行选项:

$ qshell account -- <Your AccessKey> <Your SecretKey> <Your Name>

可以连续使用 qshell account 添加账号 ak, sk, name 信息，qshell 会保存这些账号的信息， 可以使用 qshell user 命令列举账号信息，在各个账号之间切换, 删除账号等。 如果使用的 2.3.0 之前的版本 account 命令记录的账户信息，需要先使用 qshell user clean 清楚保存的账户信息，然后使用 qshell account 命令重新记录账户信息。

也可以使用 qshell 的配置文件添加 access_key和secret_key 信息，具体配置方法参考下面配置文件一节。

2. 添加完账户后，就可以使用 qshell 上传，下载文件了

注：

• v2.7.0 到 v2.9.2 不支持取消过期时间配置（expire 和 batchexpire 命令），如果过期天数配置为 0 会立即删除文件。 v2.10.0 开始，过期天数配置为 0 时为取消过期时间配置。

账户管理

qshell 支持多种方式的账户管理：

1. 使用 qshell account 记录账户信息到本地的数据库
2. 使用 qshell -C 配置文件的方式来设置账户信息
3. 有的 qshell 子命令支持通过 --access-key， --secret-key 选项来设置 ak/sk 信息

那么有可能上面三种方式都提供了账户的信息，因此这三种方式有个优先级（从高到低): 3 > 2 > 1

也就是说，如果命令行提供了ak/sk那么使用命令行的信息；如果没有提供就使用配置文件中的信息，如果配置文件没有提供ak/sk, 那么会去本地数据库查找当前的用户。

使用 qshell user 子命令可以用来管理记录的多账户信息。

1. qshell user ls 可以列举账户下所有的账户信息
2. qshell user cu 可以用来切换账户
3. qshell user cu 不携带 的话会切换到最近的上个账户；比如我在 A 账户做完操作后，使用 qshell user cu B 到了 B 账户，那么使用 qshell user cu 可以切回到 A 账户.
4. qshell user lookup 查找用户是否在本地数据库中

是使用 qshell account 记录的时候的 名字，这个名字可以任意指定。

开启命令的自动补全

linux上，使用bash

在 centos 上，需要安装 bash-completion 包，默认该包没有安装

$ yum install bash-completion -y

给当前的 bash 加入自动补全， 运行命令

$ source <(qshell completion bash)

也可以把这个配置加入 bash 的启动文件中，这样到 bash 启动的时候，会自动加载 qshell 的补全配置：

$ echo "source <(qshell completion bash)" >> ~/.bashrc

Mac上，使用zsh 把如下代码加入 zsh 的启动文件中 ~/.zshrc, 然后 source ~/.zshrc

if [ $commands[qshell] ]; then
  source <(qshell completion zsh)
fi

命令选项

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

配置文件

1. 配置文件格式支持 json，用户可按需进行配置，配置文件分两层：

• 全局配置：需要在家目录下创建文件名为 .qshell.json 的 json 文件，此配置对 qshell 中的所有账号生效（qshell 当前账号可以通过 qshell user cu 命令进行切换）。
• 账号配置：在 qshell 用户目录下（ ${家目录}/.qshell/users/${qshell 账号名}/ ）创建文件名为 .qshell.json 的 json 文件，此配置仅对当前目录所属的 qshell 账号生效；账号配置优先级大于全局配置。

2. 配置文件可以配置 use_https 和 host 相关信息：

• use_https：qshell 请求是否使用 https。
• host 配置：如 io host, up host, uc host, api host, rs host, rsf host；除 uc host 外，其他 host 要么不配置，要么全配置。
  • 公有云可以不配置 host；
  • 私有云：如果私有云支持 uc 查询 bucket 所在区域信息（/query api），那么仅配置 uc host 即可；如果不支持则必须配置所有 host。

注： qshell 某些命令的配置和文件的配置会有重合，此时优先级如下：

qshell 命令配置 > 账号配置 > 全局配置

通过 -C/-L 选项指定配置文件，实际是指定账号配置。

配置例子：

1. 默认官方的列举空间的文件使用的是 rsf.qiniu.com 域名，如果因为某种原因，比如私有存储，需要替换使用 rs-test.qiniu.com 这个域名的话，那么只需要 在家目录下创建文件名字为 .qshell.json 的配置文件，文件内容为

{
    "hosts": {
        "rsf": "rs-test.qiniu.com"
    }
}

如果想要更改io host为io-test.qiniu.com 的话，只需要继续在上面的 hosts 中添加，如下：

{
    "hosts": {
        "rs": "rs-test.qiniu.com",
        "io": "io-test.qiniu.com"
    }
}

同理如果全部修改的话

{
    "use_https": false,
    "hosts": {
        "rs": "rs-test.qiniu.com",
        "io": "io-test.qiniu.com",
        "uc": "uc-test.qiniu.com",
        "api": "api-test.qiniu.com",
        "up": "up-test.qiniu.com",
        "rsf": "rsf-test.qiniu.com"
    }
}

2. 如果不想使用 qshell account ak sk name 的方式记录密钥信息，也可以在配置文件中指定 ak, sk

{
   "access_key": "",
   "secret_key": ""
}

这样 qshell 会优先使用配置文件中配置的 ak/sk 信息，如果在这个配置文件中没有找到密钥信息，那么会去 qshell account 记录的本地数据库寻找.

命令列表

• v2.7.0 及以上版本，命令列表及命令使用详细文档说明，支持直接使用 qshell 自助查看。
  • qshell -h，显示支持命令列表
  • qshell <子命令> --doc 查看详细命令使用说明
• 查看工具版本号请使用命令 qshell -v

账号设置命令

存储相关命令

CDN 相关的命令

工具类命令

音视频处理相关命令

签名类命令

其他存储类工具

问题反馈

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