• 七牛开发者平台
• 七牛官网
• 七牛问答社区

• 简介
• 下载
• 使用方法
• 常见故障排查

简介

qrsync 是一个根据七牛云存储API实现的简易命令行辅助上传同步工具，支持断点续上传，增量同步，它可将用户本地的某目录的文件同步到七牛云存储中，同步或上传几百GB甚至上TB的文件毫无鸭梨。
注意：被同步的文件名和路径必须是utf8编码，非utf8的文件名和路径将会同步失败。

下载

qrsync 命令行辅助同步工具下载地址：

• Mac OS: http://devtools.qiniu.com/qiniu-devtools-darwin_amd64-current.tar.gz
• Linux 64bits: http://devtools.qiniu.com/qiniu-devtools-linux_amd64-current.tar.gz
• Linux 32bits: http://devtools.qiniu.com/qiniu-devtools-linux_386-current.tar.gz
• Linux ARMv6: http://devtools.qiniu.com/qiniu-devtools-linux_arm-current.tar.gz
• Windows 32bits: http://devtools.qiniu.com/qiniu-devtools-windows_386-current.zip
• Windows 64bits: http://devtools.qiniu.com/qiniu-devtools-windows_amd64-current.zip

使用方法

注意：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）属性，则可以用如下方式对上传的文件进行访问：

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

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

http://foo.qiniudn.com/a.txt
http://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 程序继续同步。

常见故障排查

配置文件<src>设置错误：

错误信息

# Windows下
[WARN][qbox.us/shell/qrsync] qrsync.go:70: qrsync.Run failed failed:
 ==> FindNextFile <src>: The system cannot find the file specified. ~ qrsync.Run failed

或

# Linux或者Mac下
[WARN] qbox.us/shell/qrsync-v2/qrsync.go:70: qrsync.Run failed failed:
 ==> stat <src>: no such file or directory ~ qrsync.Run failed
 ==> qbox.us/qrsync/v2/sync/sync.go:36: stat <src>: no such file or directory ~ sync.Run: src.ListAll failed

解决方案

• Windows下配置如下：

{
    "src": "C:/Users/Username/Desktop/Test_Directory",
    ...
}

主要需要关注目录分隔符为/，另外文件夹路径如果包含中文需要为UTF-8编码。

• Linux或者Mac下配置如下：

{
    "src": "/Users/Username/Documents/Test_Directory",
    ...
}

建议路径设置为待同步目录的绝对路径。