qrsync 是一個(gè)根據(jù)七牛云存儲(chǔ)API實(shí)現(xiàn)的簡(jiǎn)易命令行輔助上傳同步工具，支持?jǐn)帱c(diǎn)續(xù)上傳，增量同步，它可將用戶本地的某目錄的文件同步到七牛云存儲(chǔ)中，同步或上傳幾百GB甚至上TB的文件毫無(wú)鴨梨。

注意事項(xiàng)：

被同步的文件名和路徑必須是utf8編碼

非utf8的文件名和路徑將會(huì)同步失敗。

使用方法：

Windows 系統(tǒng)用戶在 [開始] 菜單欄選擇 [運(yùn)行] 輸入 cmd 回車即可打開 DOS 命令行窗口，然后切換到 qrsync.exe 的所在磁盤路徑。假設(shè)你的 qrsync.exe 存放在 F:\tools\qrsync.exe，那么如下幾行命令可以切換到 qrsync.exe 存放的目錄：

> F:
> cd tools

先建立一個(gè)配置文件（JSON格式），比如叫conf.json，內(nèi)容如下：

{

"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 需要在七牛開發(fā)者平臺(tái)上申請(qǐng)。步驟如下：

1.開通七牛開發(fā)者帳號(hào)。

2.登錄七牛管理控制臺(tái)，查看 Access Key 和 Secret Key。

注意：切勿將配置文件保存在被同步的目錄中，否則會(huì)帶來(lái)泄露SecretKey的風(fēng)險(xiǎn)。

可以在 七牛開發(fā)者平臺(tái) 進(jìn)行相應(yīng)的域名綁定操作，域名綁定成功后，若您將 bucket 設(shè)為公用（public）屬性，則可以用如下方式對(duì)上傳的文件進(jìn)行訪問(wèn)：

http://<綁定域名>/<key>

key 即是 src 里邊文件名或文件的相對(duì)路徑，key 可以包含斜杠但不能以斜杠開頭。比如 src 存在文件 a.txt 和 a/b/c.txt，且綁定的域名為 foo.qiniudn.com，那么即可用如下路徑訪問(wèn)：

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

在建立完 conf.json 配置文件后，就可以運(yùn)行 qrsync 程序進(jìn)行同步。

Unix/Linux/MacOS 系統(tǒng)可以用如下命令行：

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

Windows用戶進(jìn)入到 qrsync.exe 所在目錄后運(yùn)行如下命令即可：

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

需要注意的是，qrsync 是增量同步的，如果你上一次同步成功后修改了部分文件，那么再次運(yùn)行 qrsync 時(shí)只同步新增的和被修改的文件。當(dāng)然，如果上一次同步過(guò)程出錯(cuò)了，也可以重新運(yùn)行 qrsync 程序繼續(xù)同步。