七牛的qrsbox命令行工具使用 for osx

1、简介

qrsbox命令行工具是同步上传客户端工具（单向同步），即只支持本地仓库同步到七牛服务器，不会将在服务器删除操作数据同步至本地仓库，详细简介请参阅((官方文档)[http://developer.qiniu.com/code/v6/tool/qrsbox.html]

2、准备工作

本次例子以mac osx系统环境来说明
首先下载qrsbox命令行工具，然后随便在磁盘上新建一个Hexo文件夹，将下载好的qrsbox命令行工具更命为qrsboxcli并存放在Hexo文件夹下，Hexo文件夹下再新建一个子文件夹blog，而blog就是我们同步的目录文件夹。
现在打开osx终端窗口，输入cd空格，然后将Hexo文件夹拖放到终端窗口下，此时Hexo文件夹的绝对路径就显示出来了。

zhoujianwendeMacBook-Air:Hexo zhoujianwen.cn$ cd /Users/zhoujianwen.cn/works/Hexo

回车之后，再输入ls -la，此时Hexo文件目录下所有文件都显示出来

zhoujianwendeMacBook-Air:Hexo zhoujianwen.cn$ ls -la
total 22016
drwxr-xr-x  5 zhoujianwen.cn  staff       170  8 31 19:39 .
drwxr-xr-x  6 zhoujianwen.cn  staff       204  9  3 10:45 ..
-rw-r--r--@ 1 zhoujianwen.cn  staff      6148  8 31 19:39 .DS_Store
drwxr-xr-x  4 zhoujianwen.cn  staff       136  8 31 19:32 blog
-rwxrwxrwx@ 1 zhoujianwen.cn  staff  11262864  8 31 17:09 qrsboxcli
zhoujianwendeMacBook-Air:Hexo zhoujianwen.cn$

现在准备要执行qrsboxcli命令行工具，初次执行可能会提示：

zhoujianwendeMacBook-Air:hexo zhoujianwen.cn$ ./qrsboxcli -bash: ./qrsboxcli: Permission denied

这是因为权限的原因，你需先执行一下以下命令再试。

chmod 777 qrsboxcli

3、同步目录初始化

执行以下命令进行初始化：

./qrsboxcli init <AccessKey> <SecretKey> <SyncDir> <Bucket> [<KeyPrefix>]

其中Bucket是你在七牛上创建存储空间的名字的，
KeyPrefix是文件前缀，可选。如果设置了该参数，那么上传的文件名前都会加上前缀。这个前缀主要用于在空间中区分不同上传来源的文件。例如我的域名的是http://www.zhoujianwen.cn/，网站需要用到的cdn资源都是存放到七牛的存储空间上。假设我是这样设置同步目录的

zhoujianwendeMacBook-Air:Hexo zhoujianwen.cn$ ./qrsboxcli init AccessKey SecretKey blog zhoujianwen blog/

其中，AccessKey 和 SecretKey 需要在七牛开发者平台上申请。这两个key都是在七牛帐号->个人面板->个人中心->密钥管理中找到。

4、文件同步

最后，用户可以使用以下命令开始文件同步：
./qrsboxcli sync &
现在只要往blog添加任何一张jpg图片，qrsboxcli都会将文件同步至七牛存储空间上。例如我在已经设置的同步目录blog文件夹下新建一个image文件夹并在里面再存放一张图。此时你用域名+blog/image/图片.jpg就可以访问到该资源了。

5、qrsbox客户工具使用

刚才输入的命令使用了&符号，即使你将终端窗口关闭了，同步客户端进程也会一直运行在后台。如果想退出终端后令同步客户端进程中断，请使用以下命令代替：

nohup ./qrsboxcli sync >/dev/null 2>&1 &

用户可以通过以下命令查看同步过程:

./qrsboxcli log ```

如果需要停止后台运行的 qrsboxcli，可以使用如下命令:
```git ./qrsboxcli stop

如果想修改前面初始化参数设置好的同步目录，可以再次执行前面初始化步骤，然后再次启动同步程序，qrsboxcli会立刻按新的配置将新目录的文件同步至七牛云存储。

初始化成功之后，会生成一个.qrsbox配置文件存储在/Users/你的用户名下，然而osx将这些文件都隐藏了，通过以下命令可以查询这些文件内容。也可以试试这个链接操作，不过我试过没成功。

cd /Users/你的用户名   回车
ls -la  回车
open .qrsboxcli 回车

6、ignore 文件与规则

qrsbox 和 qrsboxcli 支持使用 ignore 文件来忽略某些不需要上传的文件，详见ignore 规则。