rsyncd.conf 詳細配置

-、全局參數

在文件中[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

3.2 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 [email protected]::www /databack

  5)從本地機器拷貝文件到遠程rsync服務器中。當DST路徑信息包含"::"分隔符時啓動該模式。如:rsync -av /databack [email protected]::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顯示幫助信息


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章