RYSNC使用说明

维基百科链接： http://zh.wikipedia.org/wiki/Rsync

一、Rsync命令参数详解

 

    在对rsync 服务器配置结束以后，下一步就需要在客户端发出rsync 命令来实现将服务器端的文件备份到客户端来。rsync 是一个功能非常强大的工具，其命令也有很多功能特色选项，我们下面就对它的选项一一进行分析说明。

Rsync 的命令格式可以为以下六种：

rsync [OPTION]... SRC DEST 　　rsync [OPTION]... SRC [USER@]HOST:DEST 　　rsync [OPTION]... [USER@]HOST:SRC DEST 　　rsync [OPTION]... [USER@]HOST::SRC DEST 　　rsync [OPTION]... SRC [USER@]HOST::DEST 　　rsync [OPTION]... rsync://[USER@]HOST[:PORT]/SRC [DEST]

　　对应于以上六种命令格式，rsync 有六种不同的工作模式：

　　1) 拷贝本地文件。当SRC 和DES 路径信息都不包含有单个冒号":" 分隔符时就启动这种工作模式。如：rsync -a /data /backup

　　2) 使用一个远程shell 程序( 如rsh 、ssh) 来实现将本地机器的内容拷贝到远程机器。当DST 路径地址包含单个冒号":" 分隔符时启动该模式。如：rsync -avz *.c foo:src

　　3) 使用一个远程shell 程序( 如rsh 、ssh) 来实现将远程机器的内容拷贝到本地机器。当SRC 地址路径包含单个冒号":" 分隔符时启动该模式。如：rsync -avz foo:src/bar /data

　　4) 从远程rsync 服务器中拷贝文件到本地机。当SRC 路径信息包含"::" 分隔符时启动该模式。如：rsync -av root@172.16.78.192::www /databack

　　5) 从本地机器拷贝文件到远程rsync 服务器中。当DST 路径信息包含"::" 分隔符时启动该模式。如：rsync -av /databack root@172.16.78.192::www

　　6) 列远程机的文件列表。这类似于rsync 传输，不过只要在命令中省略掉本地机信息即可。如：rsync -v rsync://172.16.78.192/www

 

rsync 参数的具体解释如下：

 

-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 显示帮助信息

 

以下内容出自 “Wandering's Blog ” 博客，请务必保留此出处http://wandering.blog.51cto.com/467932/105113

二、RYSNC使用说明

   rysnc同步文件， rsync是一款非常优秀的文件同步管理软件，它也支持多种操作系统平台，在Unix环境中，rsync有着卓绝的功绩。希望这篇文档能对一些朋友有所帮助。

1. Install

[url]http://www.samba.org/rsync/[/url]

shell> tar zxvf rsync-x.x.x.tar.gz
shell> cd rsync-x.x.x
shell> ./configure && make && make install

目前大部分 Unix/Linux 默认即安装了 rsync。


2. /etc/rsyncd.conf
 
shell> touch /etc/rsyncd.conf
shell> vi /etc/rsyncd.conf


Edit /etc/rsyncd.conf as below:
 
uid = nobody
gid = nobody
use chroot = no
max connections = 5
pid file = /var/run/rsync.pid
lock file = /var/run/rsync.lock
log file = /var/log/rsync.log
 
[<dst-dir>]
path = <dst-dir-fullpath>
ignore errors
read only = no
list = yes
auth users = username
secrets file = /etc/rsyncd.secrets

3. /etc/rsync.secrets
 
shell> echo "jack:password" >> /etc/rsyncd.secrets
shell> chmod 600 /etc/rsyncd.secrets
 
*注：一定要把rsyncd.secrets的权限设为600，否则不能正常进行身份认证。
     包括--password-file指向的密码文件，也必须设成600权限。

    
4. Autorun

>>> Idea 1 - only linux <<<

shell> vi /etc/xinetd.d/rsync
 
set DISABLE to yes, the result looks like this:
service rsync
{
        disable         = no  <---------- change to yes
        socket_type     = stream
        wait            = no
        user            = root
        server          = /usr/bin/rsync
        server_args     = --daemon
        log_on_failure  += USERID
}


>>> Idea 2 - on openSUSE <<<

shell> echo "/usr/local/bin/rsync --daemon" >> /etc/init.d/boot.local


>>> Idea 3 <<<
 
shell> echo "/usr/local/bin/rsync --daemon" >> /etc/rc.local


5. Run daemon

shell> rsync --daemon
 
*注一：在rsync的man手册的 CONNECTING TO AN RSYNC SERVER 处有提到：
It is also possible to use rsync without a remote shell as the transport. In this case you will connect to a remote  rsync server running on TCP port 873.
 
*注二：在rsync的man手册的 --port=PORT 选项解释中有提到：
This specifies an alternate TCP port number to use rather than the default port 873.



6. rsync 命令实例

6.1 显示目录内容

命令
------
a) rsync <dst-dir>
b) rsync -r <dst-dir>
c) rsync jack@192.168.0.1::<dst-dir>
d) rsync ssh_user@192.168.0.1:<dst-dir>

命令说明
---------
a) 显示<dst-dir>目录 内容 (第一层)
b) 递归显示<dst-dir>目录 内容
c) 显示远程主机<dst-dir>目录内容
   *注1：端口模式, 基于rsync用户的身份验证
   *注2：rsync server上的目录必须具有xx7的权限.
d) 查看 远程 主机<dst-dir>目录 内容
   *注1：remote shell模式, 通过ssh连接的基于系统本地用户的身份验证
   *注2：这里只使用了一个冒号(:)，同时用户名是远 程主机 的ssh用户，密码也是ssh用户对应的密码。
   *注3：使用"<dst-dir>"，则列出<dst-dir>文件夹本身的信息。若要列出<dst-dir>文件夹内容，应使用"<dst-dir>/"。
  
参数说明
---------
-r          对目录进行递归操作

  
6.2 本地目录之间同步

命令
------
a) rsync -av  --progress <src-dir>/ <dst-dir>             *** 注意(/) ***
b) rsync -av  --progress <src-dir>  <dst-dir>
c) rsync -avu --progress --delete <src-dir>/  <dst-dir>
d) rsync -av  --progress --temp-dir=/tmp <src-dir>/ <dst-dir>

命令说明
---------
a) 同步src-dir目录下所有文件到dst-dir目录下
b) 同步src-dir目录下所有文件到dst-dir/src-dir目录下
c) 对src-dir目录内容向dst-dir目录下进行差异更新，有增加/更新则添加替换，有减少则对其删减
d) 比a)多了 --temp-dir=/tmp，即指定/tmp为临时交换区，这样可以避免因目标目录空间不够引起的无法同步文件的错误。

参数说明
---------
-a          相当于 -rlptgoD 的集合
-u          等同于 --update，在目标文件比源文件新的情况下不更新
-v          显示同步的文件
--progress  显示文件同步时的百分比进度、传输速率
--delete    删除目标目录中多于源目录的文件


6.3 异地主机之间同步

命令
------
a) rsync -avz  --progress <src-dir> jack@192.168.0.1::<dst-dir>/
b) rsync -avz  --progress <src-dir> jack@192.168.0.1::<dst-dir>/ --password-file=/home/jack/rsync.jack
c) rsync -avuz  --progress --delete <src-dir> jack@192.168.0.1::<dst-dir>/ --password-file=/home/jack/rsync.jack
d) rsync -avz  --progress jack@192.168.0.1::<dst-dir>/<src-dir> <dst-dir>

命令说明
---------
a) 同步本地<src-dir>目录的内容到远程主机192.168.0.1的<dst-dir>目录下，jack是rsync数据库用户(参见3. /etc/rsync.secrets)
b) 通过自动读取用户密码而实现非交互登录文件同步
c) 较b)多了-u和--delete
d) 同步远程主机内容到本地目录


参数说明
---------
-z                等同于 --compress，对传输的文件压缩，这对节约网络带宽或在网络资源紧张的情况下非常有用
--password-file   引用192.168.0.1上rsync用户jack口令的本地文件，创建方法如下
                  shell> echo "jackpwd" >> /home/jack/ rsync.jack
                  shell> chown jack:wheel /home/jack/ rsync.jack
                  shell> chmod 600 /home/jack/ rsync.jack