qrsync 是一个根据七牛云存储API实现的简易命令行辅助上传同步工具，支持断点续上传，增量同步，它可将用户本地的某目录的文件同步到七牛云存储中，同步或上传几百GB甚至上TB的文件毫无鸭梨。

注意事项：

被同步的文件名和路径必须是utf8编码

非utf8的文件名和路径将会同步失败。

使用方法：

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

> F:
> cd tools

先建立一个配置文件（JSON格式），比如叫conf.json，内容如下：

{

"src": "/home/your/sync_dir",

"dest": "qiniu:access_key=<AccessKey>

&secret_key=<SecretKey>

&bucket=<Bucket>

&key_prefix=<KeyPrefix>

&persistent_ops=<PersistentOps>

&persistent_pipeline=<PersistentPipeline>

&persistent_notify_url=<PersistentNotifyUrl>

&...

",

"debug_level": 1

}

其中，AccessKey 和 SecretKey 需要在七牛开发者平台上申请。步骤如下：

1.开通七牛开发者帐号。

2.登录七牛管理控制台，查看 Access Key 和 Secret Key。

注意：切勿将配置文件保存在被同步的目录中，否则会带来泄露SecretKey的风险。

可以在 七牛开发者平台 进行相应的域名绑定操作，域名绑定成功后，若您将 bucket 设为公用（public）属性，则可以用如下方式对上传的文件进行访问：

//<绑定域名>/<key>

key 即是 src 里边文件名或文件的相对路径，key 可以包含斜杠但不能以斜杠开头。比如 src 存在文件 a.txt 和 a/b/c.txt，且绑定的域名为 foo.qiniudn.com，那么即可用如下路径访问：

//foo.qiniudn.com/a.txt
//foo.qiniudn.com/a/b/c.txt

在建立完 conf.json 配置文件后，就可以运行 qrsync 程序进行同步。

Unix/Linux/MacOS 系统可以用如下命令行：

$ qrsync /path/to/your-conf.json

Windows用户进入到 qrsync.exe 所在目录后运行如下命令即可：

> qrsync.exe /path/to/your-conf.json

需要注意的是，qrsync 是增量同步的，如果你上一次同步成功后修改了部分文件，那么再次运行 qrsync 时只同步新增的和被修改的文件。当然，如果上一次同步过程出错了，也可以重新运行 qrsync 程序继续同步。