对象存储

  • 命令行辅助工具(qrsctl)

    最近更新时间:2017-10-26 17:40:21

    qrsctl

    简介

    qrsctl 是根据七牛云存储API实现的一个简易命令行辅助工具。覆盖七牛云存储开发者网站包含的大部分甚至更高级的功能。开发者在对七牛云存储 API 有基本了解的情况下,此工具将会非常适用。

    下载

    qrsctl 命令行辅助工具下载地址:

    使用方法

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

    > F:
    > cd tools
    > cd test1
    

    如图:

    image

    qrsctl 各个指令的用法可以在命令行直接输入 qrsctl 不带参数来获得。

    登录

    qrsctl login <User> <Passwd>
    
    参数 说明
    User 用户名,一般为注册邮箱。
    Passwd 登录密码

    用您的开发者帐号登录七牛云存储,登录成功后,才能进行接下来所有其他指令操作。

    登录成功后,会话的有效期是 3600 秒(一个小时),一个小时后需要重新登录。

    账号管理

    查看帐号信息

    qrsctl info
    

    返回账号信息

    查看密钥(AccessKey/SecretKey)

    qrsctl appinfo <AppName>
    
    参数 说明
    AppName 应用名称,网站上默认使用的应用名称是:default

    空间管理

    创建空间(Bucket)

    qrsctl mkbucket2 <Bucket>
    
    参数 说明
    Bucket 空间名称,字母数字下划线组合。

    将空间设置为公开

    qrsctl private <Bucket> 0
    

    将空间设置为私有

    qrsctl private <Bucket> 1
    

    列出所有空间(Buckets)

    qrsctl buckets
    

    查看指定空间(Bucket)信息

    qrsctl bucketinfo <Bucket>
    

    空间授权

    qrsctl share  <Bucket> <Uid> <Permission>
    
    参数 说明
    Bucket 指定将要授权的存储空间
    Uid 将要被授权的用户uid
    Permission 指定被授权用户的权限,1(只读),2(读写), -1(取消授权)

    设置镜像存储(源站加速)

    qrsctl img <Bucket> <SrcUrl>[,<SrcUrl2>,...] [SrcHost]
    
    参数 说明
    Bucket 指定用于托管源站资源的存储空间名称,必填。
    SrcUrl 源站地址,必填,可设置多个,当第一个源返回500时去带二个源拉取资源。格式:http://domain:port/ 或者 http://ip:port/,其中 port 可选。
    SrcHost 源站域名,可选。

    取消镜像存储

    qrsctl unimg <Bucket>
    

    设置镜像存储回源容错属性

    qrsctl imgsft <Bucket> <imgsft>
    

    说明:

    • 开启该属性时,如果 url 的后缀是典型的图片、音视频文件,比如 *.jpg *.jpeg *.png *.gif *.mp3 *.mp4等,然后源站返回的 mimeTypetextml,则认为源站有可能出错,不缓存该文件。
    • 如果 url 的后缀是典型的图片、音视频文件,比如 *.jpg *.jpeg *.png *.gif *.mp3 *.mp4等, 当返回码是200并且content-length=0的时候,不要返回200,因为客户端会缓存,改为返回 478,然后 errorzero content from source
    • <imgsft>为0表示不启用镜像存储回源容错属性,为1表示启用镜像存储回源容错属性。

    清除cdn缓存

    qrsctl cdn/refresh <Url1> <Url2>...<UrlN>
    

    注意:最多指定10个 Url

    数据处理

    设置API规格别名

    qrsctl style <Bucket> <aliasName> <fop>
    
    参数 说明
    Bucket 存储空间名称
    aliasName 别名名称
    fop API规格定义,可使用图片处理接口、音视频处理接口等。

    友好URL访问形式:

    http://<Domain>/<Key><Sep><Name>
    

    取消API规格别名

    qrsctl unstyle <Bucket> <Name>
    

    设置友好URL分隔符

    qrsctl separator <Bucket> <Sep>
    

    设置原文件/图保护

    qrsctl protected <Bucket> <Protected>
    
    参数 说明
    Protected 可选值为 0 或者 10表示不开启保护,1表示开启保护。

    文件操作

    上传文件

    qrsctl put <Bucket> <Key> <SrcFile>
    

    上传一个大文件(超过 4MB)

    qrsctl put -c <Bucket> <Key> <SrcFile>
    

    加上选项 c 会启用切片并行上传一个大文件。(超过 4MB)

    下载文件

    qrsctl get <Bucket> <Key> <DestFile>
    

    查看文件

    qrsctl stat <Bucket> <Key>
    

    复制文件

    Bucket1 中的 KeySrc 复制到 Bucket2 并命名为 KeyDest, Bucket1Bucket2 可以是同一个。

    qrsctl cp <Bucket1:KeySrc> <Bucket2:KeyDest>
    

    移动文件

    Bucket1 中的 KeyOld 移动到 Bucket2 并命名为 KeyNew, Bucket1Bucket2 可以是同一个。

    qrsctl mv <Bucket1:KeyOld> <Bucket2:KeyNew>
    

    删除文件

    qrsctl del <Bucket> <Key>
    

    使用技巧

    qrsctl 遵循标准Linux工作方式,无出错则无提示,只打印必要的操作信息。
    如想知道执行过程是否出错,可以使用下列技巧:

    qrsctl command [arguments] && echo "OK"
    

    如执行过程中无错误,则会在屏幕上输出OK字样。

    以上内容是否对您有帮助?
  • 提交工单