七牛云使用手册

由于在markdown中撰写博客文档，时常要涉及图片插入的问题。为了在多平台发布文章，则有必要借助云存储来用于图片存储。本文讲主要介绍，如何使用七牛云来实现这个需求。

七牛云使用手册

入门

1.创建空间

进入主界面后，打开空间创建列表创建空间 ，进入界面:

选择左侧对象存储，进入新建存储空间页面，选择新建存储空间。

空间创建完成后，点击内容管理，可实现上传、下载、访问、修改资源等操作。

2.上传文件

点击上传文件，开始文件上传。

3.下载或删除文件

点击对应文件名后...标识，下载或删除文件。

4.删除空间

选择要删除的空间，点击空间设置删除相应的空间。

开发者工具

在官方七牛开发者中心,找到开发者工具。官方给出了qshell、qwest、qfetch、QsunSync、qrsctl、qdoractl等6种开发者工具。接下来我将介绍qshell的使用方法。

qshell

qshell是利用七牛文档上公开的API实现的一个方便开发者测试和使用七牛API服务的命令行工具。该工具设计和开发的主要目的就是帮助开发者快速解决问题。

1.下载

你可以根据自己计算机的操作系统，在官方中选择合适的qshell安装包进行下载，该博客的演示环境为Windows操作系统。Windows(64位)安装包为qshell v2.1.5。

2.安装

在windows平台中，安装包名称为qshell-windows-x64.exe,并将文件名修改为qshell.exe，切勿双击下载的安装包，会出现闪退的情况，可以按照下面的方式操作。

• 1.现将文件放置在合适的文件夹下，例如我的放置在C:\Program Files (x86)\tools\qshell目录下。
• 2.把该目录放到系统环境变量PATH里面。

3.注意

• 1.windows平台下文件路径应写为\\
• 2.在使用命令和配置时，需使用""双引号，而不能使用单引号。

4.密钥设置

个人面板，密钥管理中找到密钥，通过下面指令来设置本地账号密码。

• 单用户模式：

  $ qshell account ak sk
  

• 多用户模式：

  $ qshell -m account ak sk
  

5.主要命令列表介绍

• qupload

同步数据到七牛云。

参照github:qupload的要求，需要配置相应功能，现将下面内容复制黏贴至新建的文件up.txt中。

{
   "src_dir"            :   "<LocalPath>",
   "bucket"             :   "<Bucket>",
   "file_list"          :   "<FileList>",
   "key_prefix"         :   "<Key Prefix>",
   "up_host"            :   "<Upload Host>",
   "ignore_dir"         :   false,
   "overwrite"          :   false,
   "check_exists"       :   false,
   "check_hash"         :   false,
   "check_size"         :   false,
   "rescan_local"       :   true,
   "skip_file_prefixes" :   "test,demo,",
   "skip_path_prefixes" :   "hello/,temp/",
   "skip_fixed_strings" :   ".svn,.git",
   "skip_suffixes"      :   ".DS_Store,.exe",
   "log_file"           :   "upload.log",
   "log_level"          :   "info",
   "log_rotate"         :   1,
   "log_stdout"         :   false,
   "file_type"          :   0
}

并修改对应参数，如<LocalPath>表示本地图片路径，注意路径为反斜杠。<Bucket>表示对应空间名称，如本文中为云端空间名称为blog。之后，将未设置的内容删除，如下:

{
   "src_dir"            :   "<LocalPath>",
   "bucket"             :   "<Bucket>"
}

之后执行命令:

$ qshell qupload [<ThreadCount>] <LocalUploadConfig>

最后，上传该up.txt文件进行配置。

$ qshell qupload 1 C:\xx\xx\up.txt

从而实现指定路径<LocalPath>下文件的上传至空间blog，复制外链，满足需求。

• qircahe

导出指定文件夹内所以文件名称的列表

qshell dircache <文件夹> <导出的文件名>

• listbucket

获取七牛云空间内的文件列表

qshell listbucket <空间内文件夹名> <导出的文件名>

6.视频教程

• 视频教程–命令行工具使用