lsyncd配置文件詳細說明

目錄

• 一、幾大實時同步工具比較
  • 1.1 inotify + rsync
  • 1.2 sersync
  • 1.3 lsyncd
• 二、使用lsyncd本地目錄實時備份
  • 2.1 安裝lsyncd
  • 2.2 lsyncd配置文件
    • 2.2.1 lsyncd同步配置
    • 2.2.2 lsyncd.conf配置選項說明
  • 2.3 啟動lsyncd
  • 2.4 lsyncd.conf其他模式示例

一、幾大實時同步工具比較

1.1 inotify + rsync

最近一直在尋求生產服務服務器上的同步替代方案，原先使用的是inotify + rsync，但隨着文件數量的增大到100W+，目錄下的文件列表就達20M，在網絡狀況不佳或者限速的情況下，變更的文件可能10來個才幾M，卻因此要發送的文件列表就達20M，嚴重減低的帶寬的使用效率以及同步效率；更為要緊的是，加入inotifywait在5s內監控到10個小文件發生變化，便會觸發10個rsync同步操作，結果就是真正需要傳輸的才2-3M的文件，比對的文件列表就達200M。使用這兩個組合的好處在於，它們都是最基本的軟件，可以通過不同選項做到很精確的控制，比如排除同步的目錄，同步多個模塊或同步到多個主機。

1.2 sersync

后來聽同事說 sersync 這么個工具可以提高同步的性能，也解決了同步大文件時出現異常的問題，所以就嘗試了一下。sersync是國內的一個開發者開源出來的，使用c++編寫，采用多線程的方式進行同步，失敗后還有重傳機制，對臨時文件過濾，自帶crontab定時同步功能。網上看到有人說性能還不錯，說一下我的觀點：

• 國產開源，文檔不是很全，在2011年之后就沒更新了（googlecode都要快關閉了，其實可以轉交其他人維護），網上關於它的使用和討論都止於10年了
• 采用xml配置文件的方式，可讀性比較好，但是有些原生的有些功能沒有實現就沒法使用了
• 無法實現多目錄同步，只能通過多個配置文件啟動多個進程
• 文件排除功能太弱。這個要看需求，不是每個人都需要排除子目錄。而對於我的環境中，這個功能很重要，而且排除的規則較多
• 雖然提供插件的功能，但很雞肋，因為軟件本身沒有持續更新，也沒有看到貢獻有其它插件出現（可能是我知識面不夠，還用不到里面的refreshCDN plugin）。

雖然不懂c++，但大致看了下源碼 FileSynchronize，拼接rsync命令大概在273行左右，最后一個函數就是排除選項，簡單一點可以將--exclude=改成--eclude-from來靈活控制。有機會再改吧。

另外，在作者的文章 Sersync服務器同步程序 項目簡介與設計框架 評論中，說能解決上面 rsync + inotify中所描述的問題。閱讀了下源碼，這個應該是沒有解決，因為在拼接rsync命令時，后面的目的地址始終是針對module的，只要執行rsync命令，就會對整個目錄進行遍歷，發送要比對的文件列表，然后再發送變化的文件。sersync只是減少了監聽的事件，減少了rsync的次數——這已經是很大的改進，但每次rsync沒辦法改變。（如有其它看法可與我討論）

其實我們也不能要求每一個軟件功能都十分健全，關鍵是看能否滿足我們當下的特定的需求。所謂好的架構不是設計出來的，而是進化來的。目前使用sersync2沒什么問題，而且看了它的設計思路應該是比較科學的，特別是過濾隊列的設計。雙向同步看起來也是可以實現。

1.3 lsyncd

廢話說這么多，本文就是介紹它了。有些博客說lsyncd是谷歌開源的，實際不是了，只是托管在了googlecode上而已，幸運的是已經遷移到github了：https://github.com/axkibe/lsyncd 。

Lysncd 實際上是lua語言封裝了 inotify 和 rsync 工具，采用了 Linux 內核（2.6.13 及以后）里的 inotify 觸發機制，然后通過rsync去差異同步，達到實時的效果。我認為它最令人稱道的特性是，完美解決了 inotify + rsync海量文件同步帶來的文件頻繁發送文件列表的問題 —— 通過時間延遲或累計觸發事件次數實現。另外，它的配置方式很簡單，lua本身就是一種配置語言，可讀性非常強。lsyncd也有多種工作模式可以選擇，本地目錄cp，本地目錄rsync，遠程目錄rsyncssh。

實現簡單高效的本地目錄同步備份（網絡存儲掛載也當作本地目錄），一個命令搞定。

二、使用lsyncd本地目錄實時備份

這一節實現的功能是，本地目錄source實時同步到另一個目錄target，而在source下有大量的文件，並且有部分目錄和臨時文件不需要同步。

2.1 安裝lsyncd

安裝lsyncd極為簡單，一條yum命令即可！

$ yum install epel-release -y    
# 因為這個rpm包在epel源中，所以需要先安裝epel源 
$ yum install lsyncd -y
# 安裝

2.2 lsyncd配置文件

2.2.1 lsyncd同步配置

$ vim /etc/lsyncd.conf
settings {
        logfile ="/var/log/lsyncd/lsyncd.log",
        statusFile ="/var/log/lsyncd/lsyncd.status",
        inotifyMode = "CloseWrite",
        maxProcesses = 7,
        -- nodaemon =true,
       }
sync {
      default.rsync,
      source = "/tmp/src",
      target = "/tmp/dest",
      -- excludeFrom = "/etc/rsyncd.d/rsync_exclude.lst",
      rsync = {
             binary = "/usr/bin/rsync",
             archive = true,
             compress = true,
             verbose = true
      }
}

到這啟動 lsycnd 就可以完成實時同步了，默認的許多參數可以滿足絕大部分需求，非常簡單。

2.2.2 lsyncd.conf配置選項說明

1、settings

里面是全局設置，--開頭表示注釋，下面是幾個常用選項說明：

• logfile 定義日志文件；
• stausFile 定義狀態文件；
• nodaemon=true 表示不啟用守護模式，默認；
• statusInterval 將lsyncd的狀態寫入上面的statusFile的間隔，默認10秒；
• inotifyMode 指定inotify監控的事件，默認是CloseWrite，還可以是Modify或CloseWrite or Modify；
• maxProcesses 同步進程的最大個數。假如同時有20個文件需要同步，而maxProcesses = 8，則最大能看到有8個rysnc進程；
• maxDelays 累計到多少所監控的事件激活一次同步，即使后面的delay延遲時間還未到；

2、sync

里面是定義同步參數，可以繼續使用maxDelays來重寫settings的全局變量。一般第一個參數指定lsyncd以什么模式運行：

• rsync、rsyncssh、direct三種模式：
  • default.rsync ：本地目錄間同步，使用rsync，也可以達到使用ssh形式的遠程rsync效果，或daemon方式連接遠程rsyncd進程；
  • default.direct ：本地目錄間同步，使用cp、rm等命令完成差異文件備份；
  • default.rsyncssh ：同步到遠程主機目錄，rsync的ssh模式，需要使用key來認證；
• source 同步的源目錄，使用絕對路徑；
• target 定義目的地址.對應不同的模式有幾種寫法：
  • /tmp/dest ：本地目錄同步，可用於direct和rsync模式；
  • 10.4.7.10:/tmp/dest ：同步到遠程服務器目錄，可用於rsync和rsyncssh模式，拼接的命令類似於/usr/bin/rsync -ltsd --delete --include-from=- --exclude=* SOURCE TARGET，剩下的就是rsync的內容了，比如指定username，免密碼同步；
  • 10.4.7.10::module ：同步到遠程服務器目錄，用於rsync模式；
• init 這是一個優化選項，當init = false，只同步進程啟動以后發生改動事件的文件，原有的目錄即使有差異也不會同步。默認是true；
• delay 累計事件，等待rsync同步延時時間，默認15秒（最大累計到1000個不可合並的事件）。也就是15s內監控目錄下發生的改動，會累積到一次rsync同步，避免過於頻繁的同步。（可合並的意思是，15s內兩次修改了同一文件，最后只同步最新的文件）；
• excludeFrom 排除選項，后面指定排除的列表文件，如excludeFrom = "/etc/lsyncd.exclude"，如果是簡單的排除，可以使用exclude = LIST。這里的排除規則寫法與原生rsync有點不同，更為簡單：
  • 監控路徑里的任何部分匹配到一個文本，都會被排除，例如/bin/foo/bar可以匹配規則foo
  • 如果規則以斜線/開頭，則從頭開始要匹配全部
  • 如果規則以/結尾，則要匹配監控路徑的末尾
  • ?匹配任何字符，但不包括/
  • *匹配0或多個字符，但不包括/
  • **匹配0或多個字符，可以是/
• delete 為了保持target與souce完全同步，Lsyncd默認會delete = true來允許同步刪除。它除了false，還有startup、running值，請參考lsyncd官方文檔

3、rsync

（提示一下，delete和exclude本來都是rsync的選項，上面是配置在sync中的，我想這樣做的原因是為了減少rsync的開銷）

• bwlimit 限速，單位kb/s，與rsync相同（這么重要的選項在文檔里竟然沒有標出）；
• compress 壓縮傳輸默認為true。在帶寬與cpu負載之間權衡，本地目錄同步可以考慮把它設為false；
• perms 默認保留文件權限；
• 其它rsync的選項；

其它還有rsyncssh模式獨有的配置項，如host、targetdir、rsync_path、password_file，見后文示例。rsyncOps={"-avz","--delete"}這樣的寫法在2.1.*版本已經不支持。

lsyncd.conf可以有多個sync，各自的source，各自的target，各自的模式，互不影響。

2.3 啟動lsyncd

使用命令加載配置文件，啟動守護進程，自動同步目錄操作。

$ systemctl start lsyncd
$ systemctl status lsyncd   # 確保狀態是active (running)
# 自行查看source   target是否同步成功
$ systemctl enable lsyncd

2.4 lsyncd.conf其他模式示例

以下配置本人都已經過驗證可行，必須根據實際需要裁剪配置：

settings {
       logfile = "/var/log/lsyncd/lsyncd.log",
       statusFile = "/var/log/lsyncd/lsyncd.status",
       inotifyMode = "CloseWrite",
       maxProcesses = 8,
       }
# I. 本地目錄同步directcp/rm/mv 適用500+萬文件變動不大
sync {
     default.direct,
     source = "/tmp/src",
     target = "/tmp/dest",
     delay = 1
     maxProcesses = 1
     }
# II. 本地目錄同步rsync模式rsync
sync {
     default.rsync,
     source = "/tmp/src",
     target = "/tmp/dest1",
     excludeFrom = "/etc/rsyncd.d/rsync_exclude.lst",
     rsync = {
             binary = "/usr/bin/rsync",
             archive = true,
             compress = true,
             bwlimit = 2000
             }
     }
# III. 遠程目錄同步rsync模式 + rsyncd daemon
sync {
     default.rsync,
     source = "/tmp/src",
     target = "syncuser@10.4.7.10::module1",
     delete="running",
     exclude = { ".*", ".tmp" },
     delay = 30,
     init = false,
     rsync = {
             binary = "/usr/bin/rsync",
             archive = true,
             compress = true,
             verbose = true,
             password_file = "/etc/rsyncd.d/rsync.pwd",
             _extra = {"--bwlimit=200"}
             }
     }
# IV. 遠程目錄同步rsync模式 + ssh shell
sync {
     default.rsync,
     source = "/tmp/src",
     target = "10.4.7.10:/tmp/dest",
     # target = "root@10.4.7.10:/remote/dest",
     # 上面target注意如果是普通用戶必須擁有寫權限
     maxDelays = 5,
     delay = 30,
     # init = true,
     rsync = {
             binary = "/usr/bin/rsync",
             archive = true,
             compress = true,
             bwlimit = 2000
             # rsh = "/usr/bin/ssh -p 22 -o StrictHostKeyChecking=no"
             # 如果要指定其它端口請用上面的rsh
     }
}
# V. 遠程目錄同步rsync模式 + rsyncssh效果與上面相同
sync {
     default.rsyncssh,
     source = "/tmp/src2",
     host = "10.4.7.10",
     targetdir = "/remote/dir",
     excludeFrom = "/etc/rsyncd.d/rsync_exclude.lst",
     # maxDelays = 5,
     delay = 0,
     # init = false,
     rsync = {
             binary = "/usr/bin/rsync",
             archive = true,
             compress = true,
             verbose = true,
             _extra = {"--bwlimit=2000"},
     },
     ssh = {
            port = 1234
     }
}

上面的內容幾乎涵蓋了所有同步的模式，其中第III個要求像rsync一樣配置rsyncd服務端，見本文開頭。第IV、V配置ssh方式同步，達到的效果相同，但實際同步時你會發現每次同步都會提示輸入ssh的密碼，配置免密登錄即可！
配置示例可參考博文：https://www.cnblogs.com/lvzhenjiang/p/14198841.html
原文鏈接