七牛云中带前缀的路径斜杆是怎么写的_qrsync(已废弃）

简介

由于 qrsync 无法支持并发，上传速度较慢，推荐您使用七牛的 qshell命令行工具 进行数据同步。该工具将不再维护，请使用 qshell 工具。

qrsync 是基于七牛云 API 实现的简易命令行辅助上传同步工具。注意：被同步的文件名和路径必须是utf8编码，非utf8的文件名和路径将会同步失败。

下载

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

使用方法

注意：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=&secret_key=&bucket=&key_prefix=&persistent_ops=&persistent_pipeline=&persistent_notify_url=&...",

"debug_level": 1

}

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

参数名称

必填

说明

src

是

● 本地源目录路径

是本地需要同步上传目录的完整的绝对路径。这个目录中的所有内容会被同步到指定的 bucket 中。

注意：Windows 平台上路径的表示格式为：盘符:/目录 ，比如 E 盘下的目录 data 表示为：e:/data 。

Bucket

是

● 目标空间

是你在七牛云存储上希望保存数据的Bucket名称，选择一个合适的名字即可，要求是只能由字母、数字、下划线等组成。

可以先在七牛开发者平台上创建。

KeyPrefix

否

● 文件上传到七牛云存储后给key添加的前缀。

例如，如果将 key_prefix 设为 abc/ ，在 src 中存在一个文件 a.txt， 则上传到七牛云存储后，此资源的key为 abc/a.txt 。

PersistentOps

否

资源成功上传后执行的持久化指令列表,每个指令是一个API规格字符串，多个指令用 ; 分隔。

同时添加 PersistentPipeline 字段，使用专用队列处理,请参考 PersistentPipeline 字段说明。

PersistentPipeline

否

转码队列名,资源上传成功后，触发转码时指定独立的队列进行转码。建议使用专用队列。

PersistentNotifyUrl

否

接收预转持久化结果通知的URL。

必须是公网上可以正常进行POST请求并能响应 HTTP/1.1 200 OK 的有效URL。

该URL获取的内容和[持久化处理状态查询]/dora/api/persistent-processing-status-query-prefop)的处理结果一致。

发送body格式为 Content-Type 为 "application/json" 的POST请求，需要按照读取流的形式读取请求的body才能获取。

debug_level

是

● 日志输出等级，取值0和1。

通常设置1，只输出必要的日志。

当上传过程发生问题时，设置0可以得到详细日志。

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

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

http:///

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 程序继续同步。

故障排查

配置文件设置错误：

错误信息

# Windows下

[WARN][qbox.us/shell/qrsync] qrsync.go:70: qrsync.Run failed failed:

==> FindNextFile : 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 : no such file or directory ~ qrsync.Run failed

==> qbox.us/qrsync/v2/sync/sync.go:36: stat : 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",

...

}

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