rsync 备份备忘

1. rsync 基本介绍

rsync 是类 unix 系统下的数据镜像备份工具,从软件的命名上就可以看出来了- remote sync。它的特性如下:

  • 可以镜像保存整个目录树和文件系统
  • 可以很容易做到保持原来文件的权限、时间、软硬链接等等
  • 无须特殊权限即可安装
  • 优化的流程,文件传输效率高
  • 可以使用 rsh、ssh 等方式来传输文件,当然也可以通过直接的socket连接
  • 支持匿名传输

在使用 rsync 进行远程同步时,可以使用两种方式: 远程 Shell 方式(用户验证由 ssh 负责)和 C/S 方式 (即客户连接远程 rsync 服务器,用户验证由 rsync 服务器负责)。


2. rsync 选项

Usage: rsync [OPTION]... SRC [SRC]... DEST
  or   rsync [OPTION]... SRC [SRC]... [USER@]HOST:DEST
  or   rsync [OPTION]... SRC [SRC]... [USER@]HOST::DEST
  or   rsync [OPTION]... SRC [SRC]... rsync://[USER@]HOST[:PORT]/DEST
  or   rsync [OPTION]... [USER@]HOST:SRC [DEST]
  or   rsync [OPTION]... [USER@]HOST::SRC [DEST]
  or   rsync [OPTION]... rsync://[USER@]HOST[:PORT]/SRC [DEST]
The ':' usages connect via remote shell, while '::' & 'rsync://' usages connect
to an rsync daemon, and require SRC or DEST to start with a module name.

注: 在指定复制源时,路径是否有最后的 "/" 有不同的含义,例如:

  • /data :表示将整个 /data 目录复制到目标目录
  • data :表示将 data 目录中的所有内容复制到目标目录

2.1. 常用选项

  • -v : Verbose (try -vv for more detailed information) # 详细模式显示
  • -e "ssh options" : specify the ssh as remote shell # 指定 ssh 作为远程 shell
  • -a : archive mode # 归档模式,表示以递归方式传输文件,并保持所有文件属性,等于 -rlptgoD
    • -r (–recursive) : 目录递归
    • -l (–links) :保留软链接
    • -p (–perms) :保留文件权限
    • -t (–times) :保留文件时间信息
    • -g (–group) :保留属组信息
    • -o (–owner) :保留文件属主信息
    • -D (–devices) :保留设备文件信息
  • -z : 压缩文件
  • -h : 以可读方式输出
  • -H : 复制硬链接
  • -X : 保留扩展属性
  • -A : 保留ACL属性
  • -n : 只测试输出而不正真执行命令,推荐使用,特别防止 --delete 误删除!
  • --stats : 输出文件传输的状态
  • --progress : 输出文件传输的进度
  • --exclude=PATTERN : 指定排除一个不需要传输的文件匹配模式
  • --exclude-from=FILE : 从 FILE 中读取排除规则
  • --include=PATTERN : 指定需要传输的文件匹配模式
  • --include-from=FILE : 从 FILE 中读取包含规则
  • --numeric-ids : 不映射 uid/gid 到 user/group 的名字
  • -S, --sparse : 对稀疏文件进行特殊处理以节省 DST 的空间
  • --delete : 删除 DST 中 SRC 没有的文件,也就是所谓的镜像 [mirror] 备份

3. 远程 Shell 方式

rsync [OPTION]... SRC [SRC]... [USER@]HOST:DEST # 执行“推”操作
or   rsync [OPTION]... [USER@]HOST:SRC [DEST]   # 执行“拉”操作

4. rsync C/S 方式

rsync [OPTION]... SRC [SRC]... [USER@]HOST::DEST                    # 执行“推”操作
or   rsync [OPTION]... SRC [SRC]... rsync://[USER@]HOST[:PORT]/DEST # 执行“推”操作
or   rsync [OPTION]... [USER@]HOST::SRC [DEST]                      # 执行“拉”操作
or   rsync [OPTION]... rsync://[USER@]HOST[:PORT]/SRC [DEST]        # 执行“拉”操作

C/S 方式需要配置服务端,下面是一个配置文件示例:

# /etc/rsyncd.conf

uid = root
gid = root
use chroot = yes

    path = /data/
    comment = data backup
    numeric ids = yes
    read only = yes
    list = no
    auth users = data
    filter = merge /etc/.data-filter  # 过滤规则
    secrets file = /etc/rsync-secret
    hosts allow =

    path = /home/
    comment = home backup
    numeric ids = yes
    read only = yes
    list = no
    auth users = home,test
    exclude = .svn .git
    secrets file = /etc/rsync-secret
    hosts allow =

密码文件和 filter 文件内容如下:

# cat /etc/rsync-secret
# chmod 600 /etc/rsync-secret
# cat /etc/.data-filter     # 关于 filter 的规则文件需要多测试才能彻底明白
+ mysql56/***
- *
# 以上规则表示匹配所有 mysql56 目录下的内容,其它都不同步



The daemon has its own filter chain that determines what files it will let the client access. This chain is not sent to the client and is independent of any filters the client may have specified. Files excluded by the daemon filter chain (daemon-excluded files) are treated as non-existent if the client tries to pull them, are skipped with an error message if the client tries to push them (triggering exit code 23), and are never deleted from the module. You can use daemon filters to prevent clients from downloading or tampering with private administrative files, such as files you may add to support uid/gid name translations.

The daemon filter chain is built from the "filter", "include from", "include", "exclude from", and "exclude" parameters, in that order of priority. Anchored patterns are anchored at the root of the module. To prevent access to an entire subtree, for example, "/secret", you must exclude everything in the subtree; the easiest way to do this is with a triple-star pattern like "/secret/***".

The "filter" parameter takes a space-separated list of daemon filter rules, though it is smart enough to know not to split a token at an internal space in a rule (e.g. "- /foo - /bar" is parsed as two rules). You may specify one or more merge-file rules using the normal syntax. Only one "filter" parameter can apply to a given module in the config file, so put all the rules you want in a single parameter. Note that per-directory merge-file rules do not provide as much protection as global rules, but they can be used to make –delete work better during a client download operation if the per-dir merge files are included in the transfer and the client requests that they be used.

5. 一些命令

5.1. 常用命令

RSYNC_PASSWORD=123321 rsync -havAEHXi -n --numeric-ids --delete --stats --progress [SRC] [DEST]

注: 如果有稀疏文件,则添加 -S 选项可以提升传输性能。

5.2. ssh 端口非默认 22 同步

使用 ssh 方式传输时如果连接服务器 ssh 端口非标准,则需要通过 -e 选项指定:

RSYNC_PASSWORD=123321 rsync -havAEHXi -n --numeric-ids --delete --stats --progress -e "ssh -p 22222" [USER@]HOST:SRC [DEST]

5.3. 查看服务器同步资源

RSYNC_PASSWORD=123321 rsync --list-only data@


RSYNC_PASSWORD=123321 rsync --list-only rsync://data@

6. 参考文档

Kumu / 2015-01-09 Fri 00:00Emacs 28.2 (Org mode 9.5.5)