theorangeone/lsyncd

docker-lsyncd

镜像概述

docker-lsyncd是一个封装了lsyncd工具的Docker容器，用于实现文件系统的实时同步。容器启动时自动运行lsyncd服务，根据挂载的配置文件执行同步操作，适用于需要在本地与远程服务器间保持文件一致性的场景。

核心功能与特性

• 基于lsyncd：集成lsyncd工具，支持高效的文件实时同步
• 配置灵活：通过外部挂载配置文件（.lua格式）自定义同步规则
• SSH认证支持：默认使用SSH密钥进行远程同步认证，确保传输安全
• 容器化部署：简化lsyncd的部署流程，避免系统环境依赖问题

使用场景

• 本地目录与远程服务器目录的实时同步
• 多服务器间的静态资源（如网页文件、配置文件）一致性维护
• 开发环境与测试/生产环境的文件同步
• 需要自动化、后台运行的文件同步任务

使用方法与配置说明

基本启动

容器启动时会自动运行lsyncd，并加载默认配置文件/config/lsyncd.lua。需通过挂载卷提供配置文件：

bash
docker run -d \
  --name lsyncd \
  -v /本地配置目录:/config \
  realorangeone/lsyncd

配置文件

核心配置文件为lsyncd.lua，需放置在本地配置目录中，然后挂载到容器的/config目录。配置文件示例（同步本地目录到远程服务器）：

lua
settings {
  logfile = "/var/log/lsyncd/lsyncd.log",
  statusFile = "/var/log/lsyncd/lsyncd.status"
}

sync {
  default.rsyncssh,
  source = "/local/source/dir",
  host = "remote.server.com",
  targetdir = "/remote/target/dir",
  rsync = {
    archive = true,
    compress = true,
    verbose = true
  }
}

认证配置

SSH密钥认证（推荐）

1. 生成SSH密钥对（无需密码）：

   bash
   ssh-keygen -t rsa -N "" -f /本地配置目录/.ssh/id_rsa
   

2. 将公钥（id_rsa.pub）添加到远程服务器的~/.ssh/authorized_keys中

3. 确保密钥文件权限正确：

   bash
   chmod 700 /本地配置目录/.ssh
   chmod 600 /本地配置目录/.ssh/id_rsa
   chmod 644 /本地配置目录/.ssh/id_rsa.pub
   

4. 启动容器时挂载包含密钥的目录：

   bash
   docker run -d \
     --name lsyncd \
     -v /本地配置目录:/config \
     realorangeone/lsyncd
   

解决"Host key verification failed"错误

当首次连接远程服务器时，可能出现主机密钥验证失败。需在本地配置目录中创建known_hosts文件，包含远程服务器的主机密钥：

1. 在本地机器上执行：

   bash
   ssh-keyscan remote.server.com >> /本地配置目录/.ssh/known_hosts
   

2. 确保known_hosts文件权限正确：

   bash
   chmod 644 /本地配置目录/.ssh/known_hosts
   

3. 重新启动容器即可正常连接。