QRSBox是七牛云存儲提供的同步上傳客戶端工具，可以用于Linux、Mac OS X、Windows等操作系統(tǒng)。 使用QRSBox，可將用戶本地某個目錄的所有文件同步上傳到七牛云存儲中，同時監(jiān)控目錄變化，將目錄中新增的文件也上傳至七牛云存儲。 配合操作系統(tǒng)已有的強大文件管理功能（分級存放、按指定項目排序、查找匹配指定條件的文件等），即可輕松優(yōu)雅地完成繁復的文件管理事務(wù)。

功能介紹

1、支持配置文件；

2、支持大文件上傳；

3、支持增量部分同步更新；

4、支持在后臺運行、監(jiān)控。

QRSBox使用方法

QRSBox包含 Windows GUI 和 命令行工具兩部分。前者可在 Windows中使用，由于擁有GUI界面，使用更加方便。后者適合 Linux/OS X 等類 Unix 操作系統(tǒng)使用。當然，命令行工具也有 Windows 版，可在 Windows 的命令行使用。

Windows圖形工具的使用方法

首先，下載 QRSBox 的 Windows GUI，并解壓。

然后，在資源管理器中，進入解壓后的文件，雙擊qrsbox.exe，彈出如下圖所求的界面：

其中，access_key 和 secret_key 在七牛云存儲平臺上申請。步驟如下：

開通七牛開發(fā)者帳號

登錄七牛開發(fā)者自助平臺，查看 Access Key 和 Secret Key

同步源目錄 是本地需要上傳的目錄，絕對路徑完整表示。這個目錄中的所有內(nèi)容會被同步到指定的 bucket 上。注意：Windows 平臺上路徑的表示格式為：盤符:/目錄，比如 E 盤下的目錄 data 表示為：e:/data 。

空間名(bucket) 是你在七牛云存儲上希望保存數(shù)據(jù)的 Bucket 名（類似于數(shù)據(jù)庫的表），這個自己選擇一個合適的就可以，要求是只能由字母、數(shù)字、下劃線等組成。

完成這些設(shè)置后，點擊確認，QRSBox 便會開始進行初始化。初始化完成后，就開始文件的同步。用戶可以在qrsbox的界面上看到同步的進程，大致如下圖所示：

隨著文件同步的進行，用戶可以在開發(fā)者平臺的空間管理中看到已上傳的文件。

QRSBox 啟動后會常駐內(nèi)存，在 Windows 的任務(wù)欄中顯示托盤 

如果用戶需要修改同步目錄，AccessKey/SecretKey，或其他參數(shù)，可以右鍵單擊qrsbox的托盤，選擇“配置”菜單項，打開配置界面，重新配置。

命令行工具使用方法

首先，下載 QRSBox 命令行工具，并解壓。

然后，在解壓后的文件夾中執(zhí)行以下命令，進行初始化：

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

其中，<AccessKey> 和 <SecretKey> 在七牛云存儲平臺上申請。步驟如下：

開通七牛開發(fā)者帳號

登錄七牛開發(fā)者自助平臺，查看 Access Key 和 Secret Key

<SyncDir> 是本地的同步目錄，該目錄下的文件會隨時同步上傳值七牛云存儲。

<Bucket> 是保存同步文件的資源空間名。

<KeyPrefix> 是文件前綴，可選。如果設(shè)置了該參數(shù)，那么上傳的文件名前都會加上前綴。這個前綴主要用于在空間中區(qū)分不同上傳來源的文件。

最后，用戶可以使用以下命令開始文件同步：

./qrsboxcli sync &

這里使用了 & 符號，讓同步客戶端進程運行在后臺。如果退出終端后程序中斷，請使用以下命令代替：

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

用戶可以通過以下命令查看同步過程：

./qrsboxcli log

如果需要停止后臺運行的qrsboxcli，可以使用如下命令：

./qrsboxcli stop

如果希望改變同步的目錄、bucket等運行參數(shù)，需要先用 stop 命令停止 qrsboxcli 的后臺程序，重新用新的參數(shù)運行初始化命令，然后再次啟動同步程序，qrsboxcli會立刻按新的配置將新目錄的文件同步至七牛云存儲。

配置文件

命令行工具的配置文件通常保存在用戶主目錄的.qrsbox下，執(zhí)行init命令時會將具體目錄路徑輸出到屏幕上。 

tasks字段指定監(jiān)控任務(wù)：

src字段指定受監(jiān)控的文件目錄；

dest字段指定上傳目標參數(shù)，如空間名（

）和文件前綴（KeyPrefix），多個參數(shù)須以&符號分隔；

skipsym字段指定是否跳過鏈接文件，0表示不跳過，1表示跳過；

syncdur字段指定監(jiān)控檢測周期，單位為秒，0表示使用默認值（0.5秒）。

access_key字段指定AccessKey值；

secret_key字段指定SecretKey值；

debug_level字段指定日志信息輸出等級，默認值為0，即輸出Debug信息。