全域性引數

全域性引數的位置：在檔案中[module]之前的所有引數都是全域性引數，當然也可以在全域性引數部分定義模組引數，這時候該引數的值就是所有模組的預設值

address

在獨立執行時，用於指定的伺服器執行的 IP 地址。由 xinetd 執行時將忽略此引數，使用命令列上的 --address 選項替代（預設值為：所有IP地址）

motd filelog filesocket options

指定一個訊息檔案，當客戶連線伺服器時該檔案的內容顯示給客戶，預設是沒有motd檔案的指定rsync的日誌檔案，而不將日誌傳送給syslog
指定自定義 TCP 選項

pid fileport  埠號

rsync 的守護程序將其 PID寫入指定的檔案
指定 rsync 守護程序監聽的埠號。 由 xinetd 執行時將忽略此引數，使用命令列上的--port 選項替代

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]模組當中使用

comment

給模組指定一個描述，該描述連同模組名在客戶連線得到模組列表時顯示給客戶。預設沒有描述定義

path

指定該模組的供備份的目錄樹路徑，該引數是必須指定的

use chroot

如果"use chroot"指定為true，那麼rsync在傳輸檔案以前首先chroot到path引數所指定的目錄下。這樣做的原因是實現額外的安全防護，但是缺點是需要以roots許可權，並且不能備份指向外部的符號連線所指向的目錄檔案。預設情況下chroot值為true

max connections

指定該模組的最大併發連線數量以保護伺服器，超過限制的連線請求將被告知隨後再試。預設值是0，也就是沒有限制

lock file

指定支援max connections引數的鎖檔案，預設值是/var/run/rsyncd.lock

read only

該選項設定是否允許客戶上載檔案。如果為true那麼任何上載請求都會失敗，如果為false並且伺服器目錄讀寫許可權允許那麼上載是允許的。預設值為true

list

該選項設定當客戶請求可以使用的模組列表時，該模組是否應該被列出。如果設定該選項為false，可以建立隱藏的模組。預設值是true

uid

指定該模組以指定的 UID 傳輸檔案，配合gid選項使用可以確定哪些可以訪問怎麼樣的檔案許可權，預設值是"nobody"

gidwrite only

指定該模組以指定的 GID 傳輸檔案。預設值為"nobody"
指定是否允許客戶下載檔案。若為 true 則不允許下載；若為 false 並且伺服器目錄也具有讀許可權則允許下載（預設值為：false）

exclude

用來指定多個由空格隔開的多個模式列表，並將其新增到exclude列表中。這等同於在客戶端命令中使用--exclude來指定模式，不過配置檔案中指定的exlude模式不會傳遞給客戶端，而僅僅應用於伺服器。一個模組只能指定一個exlude選項，但是可以在模式前面使用"-"和"+"來指定是exclude還是include

注意的一點：該選項有一定的安全性問題，客戶很有可能繞過exclude列表，如果希望確保特定的檔案不能被訪問，那就最好結合uid/gid選項一起使用

exclude from

指定一個包含exclude模式的定義的檔名，伺服器從該檔案中讀取exlude列表定義

include

用來指定多個由空格隔開的多個rsync並應該exclude的模式列表。這等同於在客戶端命令中使用--include來指定模式，結合include和 exclude可以定義複雜的exclude/include規則 。一個模組只能指定一個include選項，但是可以在模式前面使用"-"和"+"來指定是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.secrets，同時rsyncd.secrets檔案的許可權建議設定為：0600)

strict modes

該選項指定是否監測密碼檔案的許可權，如果該選項值為true那麼密碼檔案只能被rsync伺服器執行身份的使用者訪問，其他任何使用者不可以訪問該檔案。預設值為true

hosts allow

該選項指定哪些IP的客戶允許連線該模組。客戶模式定義可以是以下形式：
xxx.xxx.xxx.xxx，客戶主機只有完全匹配該IP才允許訪問，例如：192.167.0.1

hosts deny

指定不允許連線rsync伺服器的機器，可以使用hosts allow的定義方式來進行定義。預設是沒有hosts deny定義

ignore errors

指定在 rsync 伺服器上執行delete 操作時是否忽略 I/O 錯誤。一般來說 rsync 在出現 I/O 錯誤時將將跳過--delete 操作，以防止因為暫時的資源不足或其它 I/O 錯誤導致的嚴重問題，預設值為true

ignore nonreadable

指定 rysnc 伺服器完全忽略那些使用者沒有訪問許可權的檔案。這對於在需要備份的目錄中有些不應該被備份者獲得的檔案時是有意義的，預設值為flase

transfer logging

使rsync伺服器使用ftp格式的檔案來記錄下載和上載操作在自己單獨的日誌中

log format

通過該選項使用者在使用transfer logging可以自己定製日誌檔案的欄位。其格式是一個包含格式定義符的字串，可以使用的格式定義符如下所示：

timeout

該選項可以覆蓋客戶指定的 IP 超時時間。從而確保 rsync 伺服器不會永遠等待一個崩潰的客戶端。對於匿名 rsync 伺服器來說，理想的數字是 600（單位為秒），預設值為0（無限制）

refuse options

通過該選項可以定義一些不允許客戶對該模組使用的命令引數列表。這裡必須使用命令全名，而不能是簡稱。但發生拒絕某個命令的情況時伺服器將報告錯誤資訊然後退出。如果要防止使用壓縮，應該是："dont compress = *"

dont compress

用來指定那些不進行壓縮處理再傳輸的檔案，預設值是： *.gz *.tgz *.zip *.z *.rpm *.deb *.iso *.bz2 *.tbz

rsync [OPTION]... SRC [SRC]... DEST

拷貝本地檔案；當SRC和DES路徑資訊都不包含有單個冒號":"分隔符時就啟動該工作模式

rsync [OPTION]... SRC [SRC]... [[email protected]]HOST:DEST

使用一個遠端shell程式（如rsh、ssh）來實現將本地機器的內容拷貝到遠端機器。當DST路徑地址包含單個冒號":"分隔符時啟動該模式

rsync [OPTION]... [[email protected]]HOST:SRC DEST

使用一個遠端shell程式（如rsh、ssh）來實現將遠端機器的內容拷貝到本地機器。當SRC地址路徑包含單個冒號":"分隔符時啟動該模式

rsync [OPTION]... [[email protected]]HOST::SRC [DEST]

從遠端rsync伺服器中拷貝檔案到本地機。當SRC路徑資訊包含"::"分隔符時啟動該模式

rsync [OPTION]... SRC [SRC]... [[email protected]]HOST::DEST

從本地機器拷貝檔案到遠端rsync伺服器中。當DST路徑資訊包含"::"分隔符時啟動該模式

rsync://[[email protected]]HOST[:PORT]/SRC [DEST]

列遠端機的檔案列表。這類似於rsync傳輸，不過只要在命令中省略掉本地機資訊即可
rsync [OPTION]...

選項說明

-v, --verbose

詳細模式輸出

-q, --quiet

精簡輸出模式

-c, --checksum

開啟校驗開關，強制對檔案傳輸進行校驗

-a, --archive

歸檔模式，表示以遞迴方式傳輸檔案，並保持所有檔案屬性，等於-rlptgoD（注意：不包括-H）

-r, --recursive

對子目錄以遞迴模式處理

-R, --relative

使用相對路徑資訊

例如：rsync foo/bar/foo.c remote:/tmp/

則在/tmp目錄下建立foo.c檔案，而如果使用-R引數

例如：rsync -R foo/bar/foo.c remote:/tmp/

則會建立檔案/tmp/foo/bar/foo.c，也就是會保持完全路徑資訊

-b, --backup

將接收方與傳送方的資料進行比較，但它們不同時，那麼對目標目錄（接收方）中的舊版檔案進行備份，同時還可以使用--suffix選項來指定不同的備份檔案字首

--backup-dir=DIR

與 -b 結合使用，將舊版本的備份檔案存到 DIR 目錄中

-suffix=SUFFIX

定義備份檔案字首

-u, --update

僅僅進行更新，也就是跳過所有已經存在於DST，並且檔案時間晚於要備份的檔案。(不覆蓋更新的檔案)

-l, --links

保留軟鏈結

-L, --copy-links

想對待常規檔案一樣處理軟鏈結

--copy-unsafe-links

僅僅拷貝指向SRC路徑目錄樹以外的鏈結

--safe-links

忽略指向SRC路徑目錄樹以外的鏈結（預設）

-H, --hard-links

保留硬鏈結

-p, --perms

保持檔案許可權

-o, --owner

保持檔案屬主資訊（注意：使用該選項，需root使用者來執行rsync指令）

-g, --group

保持檔案屬組資訊

-D, --devices

保持裝置檔案資訊（注意：使用該選項，需root使用者來執行rsync指令）

-t, --times

保持檔案時間資訊

-S, --sparse

對稀疏檔案進行特殊處理以節省DST的空間

-n, --dry-run

顯示哪些檔案將被傳輸

-W, --whole-file

拷貝檔案，不進行增量檢測

-x, --one-file-system

不要跨越檔案系統邊界

-B, --block-size=SIZE

檢驗演算法使用的塊尺寸，預設是700位元組

-e, --rsh=COMMAND

指定替代rsh的shell程式

--rsync-path=PATH

指定遠端伺服器上的rsync命令所在路徑資訊

-C, --cvs-exclude

使用和CVS一樣的方法自動忽略檔案，用來排除那些不希望傳輸的檔案

--existing

僅僅更新那些已經存在於DST（接收端）的檔案，而不備份那些新建立的檔案

--delete

刪除那些接收端還有而傳送端已經不存在的檔案

--delete-excluded

同樣刪除接收端（DST）那些被該選項指定排除的檔案

--delete-after
--daemon

接收者在傳輸之後進行刪除操作
表示以守護程序方式執行

--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

指定排除不需要傳輸的檔案模式匹配（例如：ex*）

--include=PATTERN

指定不排除而需要傳輸的檔案模式匹配（例如：in*）

--exclude-from=FILE

從 FILE 中讀取排除規則

--include-from=FILE

從 FILE 中讀取包含規則

--version

列印版本資訊

--address=IPADRESS

繫結到特定的地址

--config=FILE

指定其他的配置檔案，不使用預設的/etc/rsyncd.conf檔案

--port=PORT

指定特殊的監聽埠，預設為 873 埠

--blocking-io

對遠端shell使用阻塞IO

-stats

給出某些檔案的傳輸狀態

--progress

在傳輸時現實傳輸過程

--log-format=format

指定日誌檔案格式

--password-file=FILE

從FILE中得到密碼（注意：FILE檔案只能放置密碼，而不參放置使用者名稱，且許可權建議設定為0600）

--bwlimit=KBPS

限制I/O頻寬，單位為KB/s

-h, --help
-4, IPV4
-6, IPV6

--sockopts=OPTIONS

顯示幫助資訊
使用IPV4
使用IPV6
指定自定義 TCP 選項