Lsyncd 项目命令行参数使用详解

Lsyncd 项目命令行参数使用详解

lsyncd 项目地址: https://gitcode.com/gh_mirrors/lsy/lsyncd

概述

Lsyncd 是一个轻量级的实时文件同步工具，它通过监控本地文件系统的变化，将这些变化实时同步到远程目标位置。本文将详细介绍 Lsyncd 的命令行调用方式及其参数含义，帮助用户更好地理解和使用这个强大的同步工具。

基本命令格式

Lsyncd 遵循 Unix 工具的传统命令行风格，支持两种帮助查询方式：

lsyncd --help
lsyncd -help

这两种写法效果完全相同，因为 Lsyncd 不使用单字母短选项，所以单连字符和双连字符没有区别。

版本查询

要查看当前安装的 Lsyncd 版本，可以使用：

lsyncd -version

配置文件模式

Lsyncd 2.1 及以上版本主要推荐使用配置文件进行详细配置：

lsyncd /path/to/configfile.lua

这种方式提供了最全面的配置选项，适合生产环境使用。

快速同步模式

对于简单场景或快速测试，Lsyncd 提供了命令行直接配置的快捷方式：

基本 rsync 同步

lsyncd -rsync /source/path /destination/path

目标路径可以是任何 rsync 支持的格式，包括远程主机：

lsyncd -rsync /source/path remotehost:/destination/path

多目标同步

通过重复 -rsync 参数可以实现一对多同步：

lsyncd -rsync /source host1:/dest -rsync /source host2:/dest

使用 rsyncssh 优化移动操作

普通 rsync 同步在处理文件移动时效率较低，因为它会删除原文件并重新传输。-rsyncssh 模式可以通过 SSH 在远程主机上直接执行移动操作：

lsyncd -rsyncssh /local/path remotehost /remote/path

远程主机可以包含用户名，如 user@remotehost。

调试模式

在测试配置时，-nodaemon 参数非常有用：

lsyncd -nodaemon /path/to/configfile

此模式下：

1. Lsyncd 不会转为守护进程
2. 所有日志信息会同时输出到控制台
3. 工作目录不会自动切换到 /（守护进程模式会切换）
4. 相对路径的处理方式与守护进程模式不同

单次同步模式 (2.3.0+)

如果只需要执行初始完整同步而不持续监控文件系统，可以使用：

lsyncd -onepass /path/to/configfile

日志控制

Lsyncd 的日志消息分为多个类别，默认输出较少。可以通过 -log 参数控制日志详细程度：

详细日志模式

lsyncd -log all /path/to/configfile

执行命令日志

特别有用的 "Exec" 类别会记录所有执行的命令：

lsyncd -log Exec /path/to/configfile

持续尝试模式

默认情况下，初始同步失败会导致 Lsyncd 终止。生产环境中，可以使用 -insist 参数让 Lsyncd 持续尝试：

lsyncd -insist -rsync /source remotehost:/dest

这个参数也可以在配置文件的 settings 块中设置。

路径处理注意事项

在守护进程模式下：

1. 源目录会被自动转换为绝对路径
2. 目标路径保持原样（因为可能是各种格式的远程目标）
3. 工作目录会切换到 /

而在非守护进程模式下：

1. 工作目录保持不变
2. 相对路径的目标（如 ./target）可以正常工作

总结

Lsyncd 提供了灵活的命令行选项，既支持简单的快速同步场景，也支持通过配置文件的复杂同步需求。理解这些参数的含义和使用场景，可以帮助用户根据实际需求选择合适的同步方式。对于生产环境，建议使用配置文件模式并启用 -insist 参数，以确保同步服务的稳定性。

lsyncd 项目地址: https://gitcode.com/gh_mirrors/lsy/lsyncd