本文最后更新于 834 天前，其中的信息可能已经有所发展或是发生改变。
使用rsync备份数据
rsync 命令是一个远程数据同步工具，可通过 LAN/WAN 快速同步多台主机间的文件。rsync 使用 rsync算法 使本地和远程两个主机之间的文件达到同步，这个算法只传送两个文件的不同部分，而不是每次都整份传送，因此速度相当快。
使用方式
| 编号 | 含义解释 | 参数列表 |
|---|---|---|
| 1 | 本机内同步文件或目录 | rsync [OPTION] SRC DEST |
| 2 | 将本机同步到远程主机 | rsync [OPTION] SRC [USER@]host:DEST |
| 3 | 将远程主机同步到本机 | rsync [OPTION] [USER@]HOST:SRC DEST |
| 4 | 从 rsync 服务器中同步 | rsync [OPTION] [USER@]HOST::SRC DEST |
| 5 | 往 rsync 服务器中同步 | rsync [OPTION] SRC [USER@]HOST::DEST |
| 6 | 列出远程机的文件列表 | rsync [OPTION] rsync://[USER@]HOST[:PORT]/SRC [DEST] |
常用参数
文件同步属性参数
| 编号 | 参数列表 | 含义解释 |
|---|---|---|
| 1 | -a |
以递归方式并保持所有文件属性；等于 -rlptgoD |
| 2 | -r |
对子目录以递归模式处理 |
| 3 | -l |
保留软链接 |
| 4 | -L |
像对待常规文件一样对应软链接文件 |
| 5 | -p |
保持文件权限 |
| 6 | -t |
保持文件时间信息 |
| 7 | -g |
保持文件属组信息 |
| 8 | -o |
保持文件属主信息 |
| 9 | -D |
保持设备文件信息 |
| 10 | -u |
仅仅进行更新操作；不覆盖新的文件；等同于 --update |
| 11 | -P |
断点续传并显示备份过程；等同于 --partial --progress |
| 12 | -b |
创建备份；存在新文件或者目录会进行重命名；可以使用 --suffix 指定前缀；--backup |
同步模式相关参数
| 编号 | 参数列表 | 含义解释 |
|---|---|---|
| 1 | -v/--verbose |
详细模式输出 |
| 2 | -q/--quiet |
精简输出模式 |
| 3 | -b |
创建备份，对于目的已经存在有同样的文件名时重命名 |
| 4 | --delete |
删除那些 DST 中有而 SRC 没有的文件 |
| 5 | --progress |
显示备份过程 |
| 6 | --dry-run |
查看并显示哪些文件将被传输 |
| 7 | --backup-dir |
将备份文件存放在在目录下 |
| 8 | --exclude=PATTERN |
指定排除不需要传输的文件模式 |
| 9 | --port=PORT |
指定其他的 rsync 服务端口 |
| 10 | --password-file=FILE |
从 FILE 中得到密码，需要注意权限为 600 |
| 11 | -e/--rsh=COMMAND |
指定使用 rsh 或 ssh 方式进行数据同步 |
| 12 | --existing |
仅更新那些已经存在于 DST 的文件，而不备份那些新创建的文件 |
| 13 | --files-from |
指定需要同步的文件或者目录列表文件集合 |
| 14 | --usermap=STRING |
将属主为 apache 的文件映射为 nginx 属主 |
| 15 | --groupmap=STRING |
将属组为 apache 的文件映射为 nginx 属组 |
| 16 | --bwlitmit=(kb/s) |
限制传输文件的 I/O 带宽 |
| 17 | --config=FILE |
指定其他的配置文件；默认使用 rsyncd.conf 文件 |
| 18 | --partial |
断点续传；保留那些因故没有完成传输的文件用于加快随后的传输 |
所有参数
输入：rsync -h查看所有参数
-v, --verbose 详细模式输出。
-q, --quiet 精简输出模式。
-c, --checksum 打开校验开关，强制对文件传输进行校验。
-a, --archive 归档模式，表示以递归方式传输文件，并保持所有文件属性，等于-rlptgoD。
-r, --recursive 对子目录以递归模式处理。
-R, --relative 使用相对路径信息。
-b, --backup 创建备份，也就是对于目的已经存在有同样的文件名时，将老的文件重新命名为~filename。可以使用--suffix选项来指定不同的备份文件前缀。
--backup-dir 将备份文件(如~filename)存放在在目录下。
-suffix=SUFFIX 定义备份文件前缀。
-u, --update 仅仅进行更新，也就是跳过所有已经存在于DST，并且文件时间晚于要备份的文件，不覆盖更新的文件。
-l, --links 保留软链结。
-L, --copy-links 想对待常规文件一样处理软链结。
--copy-unsafe-links 仅仅拷贝指向SRC路径目录树以外的链结。
--safe-links 忽略指向SRC路径目录树以外的链结。
-H, --hard-links 保留硬链结。
-p, --perms 保持文件权限。
-o, --owner 保持文件属主信息。
-g, --group 保持文件属组信息。
-D, --devices 保持设备文件信息。
-t, --times 保持文件时间信息。
-S, --sparse 对稀疏文件进行特殊处理以节省DST的空间。
-n, --dry-run现实哪些文件将被传输。
-w, --whole-file 拷贝文件，不进行增量检测。
-x, --one-file-system 不要跨越文件系统边界。
-B, --block-size=SIZE 检验算法使用的块尺寸，默认是700字节。
-e, --rsh=command 指定使用rsh、ssh方式进行数据同步。
--rsync-path=PATH 指定远程服务器上的rsync命令所在路径信息。
-C, --cvs-exclude 使用和CVS一样的方法自动忽略文件，用来排除那些不希望传输的文件。
--existing 仅仅更新那些已经存在于DST的文件，而不备份那些新创建的文件。
--delete 删除那些DST中SRC没有的文件。
--delete-excluded 同样删除接收端那些被该选项指定排除的文件。
--delete-after 传输结束以后再删除。
--ignore-errors 及时出现IO错误也进行删除。
--max-delete=NUM 最多删除NUM个文件。
--partial 保留那些因故没有完全传输的文件，以是加快随后的再次传输。
--force 强制删除目录，即使不为空。
--numeric-ids 不将数字的用户和组id匹配为用户名和组名。
--timeout=time ip超时时间，单位为秒。
-I, --ignore-times 不跳过那些有同样的时间和长度的文件。
--size-only 当决定是否要备份文件时，仅仅察看文件大小而不考虑文件时间。
--modify-window=NUM 决定文件是否时间相同时使用的时间戳窗口，默认为0。
-T --temp-dir=DIR 在DIR中创建临时文件。
--compare-dest=DIR 同样比较DIR中的文件来决定是否需要备份。
-P 等同于 --partial。
--progress 显示备份过程。
-z, --compress 对备份的文件在传输时进行压缩处理。
--exclude=PATTERN 指定排除不需要传输的文件模式。
--include=PATTERN 指定不排除而需要传输的文件模式。
--exclude-from=FILE 排除FILE中指定模式的文件。
--include-from=FILE 不排除FILE指定模式匹配的文件。
--version 打印版本信息。
--address 绑定到特定的地址。
--config=FILE 指定其他的配置文件，不使用默认的rsyncd.conf文件。
--port=PORT 指定其他的rsync服务端口。
--blocking-io 对远程shell使用阻塞IO。
-stats 给出某些文件的传输状态。
--progress 在传输时现实传输过程。
--log-format=formAT 指定日志文件格式。
--password-file=FILE 从FILE中得到密码。
--bwlimit=KBPS 限制I/O带宽，KBytes per second。
-h, --help 显示帮助信息。
使用示例和注意事项
常用方式
rsync -avz --exclude=log root@10.80.210.56:/data/docker/emqx.bak /data/test/emqx/ --delete
SSH方式进行备份
rsync -av -e 'ssh -p 3322' --delete root@10.80.210.122:/etc/zabbix/ /data/zabbix/
对传输进行带宽限制
rsync -avz --bwlimit=10000 root@10.80.210.56:/data/docker/emqx.bak /data/test/emqx/ --delete
注意事项
同步方式
在我们日常生活中，同步文件有以下三种模式，分别是：
- 把源路径下文件，同步到目标路径
- 目标路径将自动创建多层目录存放
nginx.conf文件 rsync -aR /data/nginx/config/nginx.conf 192.168.1.100:/data
- 目标路径将自动创建多层目录存放
- 把源站某个目录，同步到目录路径
- 目标路径将自动创建多层目录存放
config目录 rsync -aR /data/nginx/config/ 192.168.1.100:/data
- 目标路径将自动创建多层目录存放
- 把源站某个文件，同步到目标文件
- 不会自动穿件多目录，只是传送
nginx.conf文件到目标文件 rsync -aR /data/nginx/config/nginx.conf 192.168.1.100:/data/backup/nginx/nginx.conf
- 不会自动穿件多目录，只是传送
前两种情况，目标路径最好事前创建好，不存在的话会自动创建的。第三种情况，
rsync只支持创建一层目录，也就是说可以允许nginx目录不存在，否则会报错的。而且需要重点注意的是，对应目标路径的/data不需事前存在，否则目录文件都无法创建和传送。
使用细节
- 要使
--delete参数生效，后面源目录(a)必须已/符号结尾，目标目录则无所谓 - 参数
--exclude可以使用绝对路径，也可以使用相对路径，且使用效果是一样的 - 如使用
--exclude=data则会排除源目录(a)和目标目录(b)下所有的data目录及其文件 - 如使用
--exclude=/data则会排除源目录(a)和目标目录(b)下第一层的data目录及其文件
参考：https://www.escapelife.site/posts/a207988d.html#toc-heading-5