rsync使用简介

一、Linux下安装

1. 源码安装

• 删除linux原有的rsync
• 下载 rsync-3.1.2.tar.gz
• tar -xzvf rsync-3.1.2.tar.gz
• cd rsync-3.1.2
• ./configure --prefix=/usr/local/rsync
• make && make install
• ln -s /usr/local/rsync/bin/rsync /usr/bin/rsync

2. rsyncd.conf配置文件

# 用户（远端的命令使用rsync访问共享目录）
uid = rsync
# 用户组
gid = rsync
# 安全相关
use chroot = no
# 最大连接数
max connections = 200
# 超时时间
timeout = 300
# 进程对应的进程号文件
pid file = /var/run/rsyncd.pid
# 锁文件
lock file = /var/run/rsyncd.lock
# 日志文件
log file = /var/log/rsyncd.log
# 忽略错误
ignore errors
# 可写
read only = false
# 即使在uid为root的情况下,fake super给成true也会丢失文件属主、属组。所以这里给成false
fake super = yes
# 客户端请求显示模块列表时，该模块是否显示出来，设置为false则该模块为隐藏模块，默认true
list = false
# 同步时跳过没有权限的目录
ignore nonreadable = yes
# 传输时不压缩的文件
dont compress = *.gz *.tgz *.zip *.z *.Z *.rpm *.deb *.bz2
# 允许连接的服务器
hosts allow = *
# 指定不允许连接到该模块的服务器
##hosts deny = 0.0.0.0/32
# 指定连接到该模块的用户列表，只有列表里的用户才能连接到模块，用户名和密码保存在secrets file，这里使用的不是系统用户，而是虚拟用户。不设置时，默认所有用户都能连接，但使用的是匿名连接
auth users = rsync_backup
# 虚拟用户(auth users)对应的用户和密码文件，每行包含一个username:password
secrets file = /etc/rsync.password
# 模块名称
[backup_fs]
# 服务端提供访问的目录，目录所属必须设置为 uid:gid 所属的用户和组
path = /backup/fs
[backup_js]
path = /backup/js

• 服务端生成密码文件

• echo “rsync_backup:oldboy123” > /etc/rsync.password

• chmod 600 /etc/rsync.password # 必须设置为 600 权限

• Linux客户端生成密码文件

• echo “oldboy123” > /home/rsync/rsync.password

• chmod 600 /homd/rsync/rsync.password # 必须设置为 600 权限

3. 启动rsync

• rsync --config=/etc/rsyncd.conf --port=10086 --daemon

4. 关闭rsync

• pkill rsync

5. rsync工作模式

1. 拷贝本地文件 rsync -a /data /backup
2. 使用远程shell程序（如rsh、ssh）来实现将本地机器的内容拷贝到远程机器。当DST路径地址包含单个冒号”:”分隔符时启动该模式。如：rsync -avz *.zip [email protected]:10086/backup_js/zip
3. 使用远程shell程序（如rsh、ssh）来实现将远程机器的内容拷贝到本地机器。当SRC地址路径包含单个冒号”:”分隔符时启动该模式。如：rsync -avz [email protected]:10086/backup_fs/zip /data
4. 从远程rsync服务器中拷贝文件到本地机。当SRC路径信息包含”::”分隔符时启动该模式。如：rsync -av -p 10086 [email protected]::backup_fs/zip /databack
5. 从本地机器拷贝文件到远程rsync服务器中。当DST路径信息包含”::”分隔符时启动该模式。如：rsync -av -p 10086 /databack [email protected]::backup_js/zip

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

7. rsync常用配置

#################################################配置参数START#######################################################
默认：
1. archive              归档模式，表示以递归方式传输文件，并保持所有文件属性，等于-rlptgoD
2. verbose              详细模式输出
3. progress             显示备份过程

配置：
1. compress  			对备份的文件在传输时进行压缩处理
2. exclude   			指定排除不需要传输的文件模式，包括子目录模式
3. include   			指定不排除而需要传输的文件模式
4. bwlimit   			限制I/O带宽，KBytes per second
5. maxSize   			限制rsync传输的最大文件大小。可以使用单位后缀，还可以是一个小数值(例如："--max-size=1.5m")
6. minSize   			限制rsync传输的最小文件大小。这可以用于禁止传输小文件或那些垃圾文件
7. removeSourceFiles    删除源端已经成功传输的文件
#################################################配置参数END########################################################

8. rsync java 示例 （使用rsync4j）

public class RsyncTest {

    public static void main(String[] args) throws InterruptedException {
        ThreadPoolHelper.executeTask(new RsyncTask());
        Thread.currentThread().join();
    }
}

public class RsyncTask implements Runnable {

    @Override
    public void run() {
        int i = 0;
        while (true) {
            startRever();
            i++;
            if (i > 10000) {
                break;
            }
        }
    }

    private void test() {
        try {
            RSync rsync = new RSync()
                    .source("D:/backup/send/zip/")
                    .destination("rsync://[email protected]:10086/backup_js/zip")
                    .passwordFile("C:\\Users\\xxx\\rsync4j\\bin\\rsync.password")
                    .dryRun(true)
                    .outputCommandline(true);
            ConsoleOutputProcessOutput output = new ConsoleOutputProcessOutput();
            output.monitor(rsync.builder());
            TimeUnit.SECONDS.sleep(5);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    private void start() {
        try {
            List<String> sources = new ArrayList<>();
            sources.add("D:/backup/send/zip/");
            String destination = "rsync://[email protected]:10086/backup_js/zip";
            //String destination = "[email protected]::backup_js";
            RSync rsync = new RSync()
                    .sources(sources)
                    .destination(destination)
                    //.port(10086)
                    .passwordFile("C:\\Users\\xxx\\rsync4j\\bin\\rsync.password")
                    // 归档模式，表示以递归方式传输文件，并保持所有文件属性，等于-rlptgoD
                    .archive(true)
                    // 详细模式输出（无用）
                    .verbose(true)
                    // 显示备份过程
                    .progress(true)
                    // 保留那些因故没有完全传输的文件，以是加快随后的再次传输
                    .partial(true)
                    // 对备份的文件在传输时进行压缩处理
                    .compress(true)
                    // 输出文件大小使用易读的单位（如，K，M等）
                    .humanReadable(true)
                    // 显示哪些文件将被传输，仅测试传输，而不实际传输
                    //.dryRun(true)
                    // 仅仅列出文件而不进行复制
                    //.listOnly(true)
                    // 指定排除不需要传输的文件模式，包括子目录模式
                    .exclude("css/")
                    // 指定不排除而需要传输的文件模式
                    .include("html/")
                    // 限制I/O速度，KBytes per second
                    .bwlimit("10")
                    // 限制rsync传输的最大文件大小。可以使用单位后缀，还可以是一个小数值(例如："--max-size=1.5m")
                    .maxSize("10G")
                    // 限制rsync传输的最小文件大小。这可以用于禁止传输小文件或那些垃圾文件。
                    //.minSize("0M")
                    //.blockSize("1024")
                    // 仅在源mtime比目标已存在文件的mtime新时才拷贝。注意，该选项是接收端判断的，不会影响删除行为
                    //.update(true)
                    // 删除那些DST中有SRC中没有的文件
                    //.delete(true)
                    // 要求删除源端已经成功传输的文件（与 delete 二选一）
                    .removeSourceFiles(true)
                    .outputCommandline(true);

            //StreamingProcessOutput output = new StreamingProcessOutput(new OutPut());

            //ConsoleOutputProcessOutput output = new ConsoleOutputProcessOutput();
            //output.monitor(rsync.builder());

            CollectingProcessOutput output = rsync.execute();
            if (output.getExitCode() > 0) {
                System.out.println(output.getStdErr());
            } else {
                System.out.println(output.getStdOut());
            }

            TimeUnit.SECONDS.sleep(10);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    private void startRever() {
        try {
            List<String> sources = new ArrayList<>();
            sources.add("[email protected]::backup_fs/zip/");
            String destination = "D:/backup/receive/zip";
            RSync rsync = new RSync()
                    .port(10086)
                    .sources(sources)
                    .destination(destination)
                    .passwordFile("C:\\Users\\xxx\\rsync4j\\bin\\rsync.password")
                    .archive(true)
                    .verbose(true)
                    .progress(true)
                    .partial(true)
                    .compress(true)
                    .humanReadable(true)
                    .exclude("*.zip.*")
                    .removeSourceFiles(true)
                    .outputCommandline(true);

            ConsoleOutputProcessOutput output = new ConsoleOutputProcessOutput();
            output.monitor(rsync.builder());

            TimeUnit.SECONDS.sleep(10);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}