002.Rsync详细配置项

一 相关参数

全局参数

在文件中[module]以前的全部参数都是全局参数，固然也能够在全局参数部分定义模块参数，这时候该参数的值就是全部模块的默认值。

port

指定后台程序使用的端口号，默认为873。

motd file

"motd file"参数用来指定一个消息文件，当客户链接服务器时该文件的内容显示给客户，默认是没有motd文件的。

log file

"log file"指定rsync的日志文件，而不将日志发送给syslog。好比可指定为“/var/log/rsyncd.log”。

pid file

指定rsync的pid文件，一般指定为“/var/run/rsyncd.pid”。

syslog facility

指定rsync发送日志消息给syslog时的消息级别，常见的消息级别是：uth, authpriv, cron, daemon, ftp, kern, lpr, mail, news, security, sys-log, user, uucp, local0, local1, local2, local3,local4, local5, local6和local7。默认值是daemon。

模块参数

主要是定义服务器哪一个目录要被同步。其格式必须为“[module]”形式，这个名字就是在rsync 客户端看到的名字，其实有点象Samba服务器提供的共享名。而服务器真正同步的数据是经过 path 来指定的。咱们能够根据本身的须要，来指定多个模块，模块中能够定义如下参数：

comment

给模块指定一个描述，该描述连同模块名在客户链接获得模块列表时显示给客户。默认没有描述定义。

path

指定该模块的供备份的目录树路径，该参数是必须指定的。

use chroot

如 果"use chroot"指定为true，那么rsync在传输文件之前首先chroot到path参数所指定的目录下。这样作的缘由是实现额外的安全防御，可是缺 点是须要以roots权限，而且不能备份指向外部的符号链接所指向的目录文件。默认状况下chroot值为true。

uid

该选项指定当该模块传输文件时守护进程应该具备的uid，配合gid选项使用能够肯定哪些能够访问怎么样的文件权限，默认值是"nobody"。

gid

该选项指定当该模块传输文件时守护进程应该具备的gid。默认值为"nobody"。

max connections

指定该模块的最大并发链接数量以保护服务器，超过限制的链接请求将被告知随后再试。默认值是0，也就是没有限制。

list

该选项设定当客户请求可使用的模块列表时，该模块是否应该被列出。若是设置该选项为false，能够建立隐藏的模块。默认值是true。

read only

该选项设定是否容许客户上载文件。若是为true那么任何上载请求都会失败，若是为false而且服务器目录读写权限容许那么上载是容许的。默认值为true。

exclude

用来指定多个由空格隔开的多个文件或目录(相对路径)，并将其添加到exclude列表中。这等同于在客户端命令中使用--exclude来指定模式，一个 模块只能指定一个exclude选项。可是须要注意的一点是该选项有必定的安全性问题，客户颇有可能绕过exclude列表，若是但愿确保特定的文件不能 被访问，那就最好结合uid/gid选项一块儿使用。

exclude from

指定一个包含exclude模式的定义的文件名，服务器从该文件中读取exclude列表定义。

include

用来指定不排除符合要求的文件或目录。这等同于在客户端命令中使用--include来指定模式，结合include和exclude能够定义复杂的exclude/include规则。

include from

指定一个包含include模式的定义的文件名，服务器从该文件中读取include列表定义。

auth users

该选项指定由空格或逗号分隔的用户名列表，只有这些用户才容许链接该模块。这里的用户和系统用户没有任何关系。若是"auth users"被设置，那么客户端发出对该模块的链接请求之后会被rsync请求challenged进行验证身份这里使用的 challenge/response认证协议。用户的名和密码以明文方式存放在"secrets file"选项指定的文件中。默认状况下无需密码就能够链接模块(也就是匿名方式)。

secrets file

该选项指定一个包含定义用户名:密码对的文件。只有在"auth users"被定义时，该文件才有做用。文件每行包含一个username:passwd对。通常来讲密码最好不要超过8个字符。没有默认的 secures file名，须要限式指定一个(例如：/etc/rsyncd.passwd)。注意：该文件的权限必定要是600，不然客户端将不能链接服务器。

strict modes

该选项指定是否监测密码文件的权限，若是该选项值为true那么密码文件只能被rsync服务器运行身份的用户访问，其余任何用户不能够访问该文件。默认值为true。

hosts allow

该选项指定哪些IP的客户容许链接该模块。客户模式定义能够是如下形式：

单个IP地址，例如：192.167.0.1

整个网段，例如：192.168.0.0/24，也能够是192.168.0.0/255.255.255.0

多个IP或网段须要用空格隔开，“*”则表示全部，默认是容许全部主机链接。

hosts deny

指定不容许链接rsync服务器的机器，可使用hosts allow的定义方式来进行定义。默认是没有hosts deny定义。

ignore errors

指定rsyncd在判断是否运行传输时的删除操做时忽略server上的IO错误，通常来讲rsync在出现IO错误时将将跳过--delete操做，以防止由于暂时的资源不足或其它IO错误致使的严重问题。

ignore nonreadable

指定rysnc服务器彻底忽略那些用户没有访问权限的文件。这对于在须要备份的目录中有些文件是不该该被备份者获得的状况是有意义的。

lock file

指定支持max connections参数的锁文件，默认值是/var/run/rsyncd.lock。

transfer logging

使rsync服务器使用ftp格式的文件来记录下载和上载操做在本身单独的日志中。

log format

经过该选项用户在使用transfer logging能够本身定制日志文件的字段。其格式是一个包含格式定义符的字符串，可使用的格式定义符以下所示：

%h 远程主机名

%a 远程IP地址

%l 文件长度字符数

%p 该次rsync会话的进程id

%o 操做类型："send"或"recv"

%f 文件名

%P 模块路径

%m 模块名

%t 当前时间

%u 认证的用户名(匿名时是null)

%b 实际传输的字节数

%c 当发送文件时，该字段记录该文件的校验码

默认log格式为："%o %h [%a] %m (%u) %f %l"，通常来讲,在每行的头上会添加"%t [%p] "。在源代码中同时发布有一个叫rsyncstats的perl脚本程序来统计这种格式的日志文件。

timeout

经过该选项能够覆盖客户指定的IP超时时间。经过该选项能够确保rsync服务器不会永远等待一个崩溃的客户端。超时单位为秒钟，0表示没有超时定义，这也是默认值。对于匿名rsync服务器来讲，一个理想的数字是600。

refuse options

经过该选项能够定义一些不容许客户对该模块使用的命令参数列表。这里必须使用命令全名，而不能是简称。但发生拒绝某个命令的状况时服务器将报告错误信息而后退出。若是要防止使用压缩，应该是："dont compress = *"。

dont compress

用来指定那些不进行压缩处理再传输的文件，默认值是*.gz *.tgz *.zip *.z *.rpm *.deb *.iso *.bz2 *.tbz

二 相关命令

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