# lsyncd

{% embed url="<https://axkibe.github.io/lsyncd/>" %}

## Установка

{% tabs %}
{% tab title="Bash" %}

```bash
apt instal lsyncd
```

{% endtab %}
{% endtabs %}

## Папки

{% tabs %}
{% tab title="Bash" %}

```bash
mkdir -p /etc/lsyncd && mkdir -p /var/log/lsyncd && mkdir -p /etc/lsyncd/conf.d/
```

{% endtab %}
{% endtabs %}

## Конфиг

{% tabs %}
{% tab title="Bash" %}

```bash
vi /etc/lsyncd/lsyncd.conf.lua
```

{% endtab %}
{% endtabs %}

Для синка в обе стороны, обязательный параметр "**temp\_dir**"

**ssh** - указывать не обязательно, если настройки стандартны

{% tabs %}
{% tab title="Lua" %}

```lua
settings {
      logfile    = "/var/log/lsyncd/lsyncd.log",
      statusFile = "/var/log/lsyncd/lsyncd_status.log",
      statusInterval = 20,
      nodaemon   = false
}
sync {
      default.rsyncssh,
      source="/path/to/dir",
      host="new_server",
      targetdir="/path/to/dir/new_server",
      excludeFrom="/etc/lsyncd/linux_notes.exclude",
      delay=10,
      delete = true,
      rsync = {
               archive = true,
               compress = false,
               whole_file = false,
               sparse = true,
               update = true,
               temp_dir="/tmp/",
               links = true,
               times = true,
               protect_args = false,
               acls = true,
               verbose = true
              },
      ssh = {
        port = 22,
        _extra = {"/usr/bin/ssh -l user -p 22 -i /home/user/.ssh/id_rsa -o StrictHostKeyChecking=no"}
    } 
}
```

{% endtab %}
{% endtabs %}

### Синк одного файла

{% tabs %}
{% tab title="Lua" %}

```lua
sync {
      default.rsyncssh,
      source="/etc/security",
      host="new_server",
      targetdir="/etc/security",
      delay=10,
      delete=false,
      rsync = {
               archive = true,
               compress = false,
               whole_file = false,
               sparse = true,
               update = true,
               temp_dir="/tmp/",
               links = true,
               times = true,
               protect_args = false,
               acls = true,
               verbose = true,
               _extra = {
                    "--include=limits.conf",
                    "--exclude=*"
               }
      },
      ssh = {
        port = 22
      }
}
```

{% endtab %}
{% endtabs %}

## Исключения

{% tabs %}
{% tab title="Bash" %}

```bash
vi /etc/lsyncd/linux_notes.exclude
```

{% endtab %}
{% endtabs %}

```
.git/*
.*
```

## **Настройки ядра**

У **inotify** есть три параметра (см. ls /proc/sys/fs/inotify/):&#x20;

**max\_queued\_events** — максимальное число событий в очереди; **default** = 16384;&#x20;

**max\_user\_instances** — сколько инстансов inotify может запустить один пользоваетль; **default** = 128;&#x20;

**max\_user\_watches** — сколько файлов может отслеживать один пользоваль; **default** = 8192.

{% tabs %}
{% tab title="Bash" %}

```bash
echo "
fs.inotify.max_user_watches = 16777216
fs.inotify.max_queued_events = 65536
" >> /etc/sysctl.conf
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Bash" %}

```bash
sysctl -p
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Bash" %}

```bash
echo 16777216 > /proc/sys/fs/inotify/max_user_watches
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Bash" %}

```bash
echo 65536 > /proc/sys/fs/inotify/max_queued_events
```

{% endtab %}
{% endtabs %}

## Example

### Синк на несколько серверов

{% tabs %}
{% tab title="Lua" %}

```lua
settings = {
   delay        = 1,
   maxProcesses = 3,
   logfile = "/var/log/lsyncd/lsyncd.log",
   statusFile = "/var/log/lsyncd/lsyncd.stat",
}

targetlist = {
 "1.0.0.2:/var/www/html", 
 "1.0.0.3:/var/www/html"
}

for _, server in ipairs(targetlist) do
  sync{ default.rsync,
    source="/var/www/html",
	rsyncOps="-rltvupgo"
    target=server
  }
end
```

{% endtab %}
{% endtabs %}

### Отдельный файл для каждого sync

{% tabs %}
{% tab title="Lua" %}

```lua
local confdir = '/etc/lsyncd/conf.d/'
local entries = readdir( confdir )

for name, isdir in pairs( entries ) do
    if not isdir then
        dofile( confdir .. name )
    end
end
```

{% endtab %}
{% endtabs %}

<https://github.com/axkibe/lsyncd/issues/441#issuecomment-293287126>

## Start/stop

```
systemctl restart lsyncd
systemctl enable lsyncd
```

## Errors

### ssh\_exchange\_identification: read: Connection reset by peer

при большом количестве файлов для синхронизации, правим в файле **/etc/ssh/sshd\_config** на сервере приемнике правим:

```bash
MaxSessions 100
MaxStartups 100:30:1000
```

**MaxSessions** Задает максимальное количество открытых сеансов, разрешенных для одного сетевого подключения. По умолчанию 10.

**MaxStartups**. Запись параметра имеет форму "**start:rate:full**". В нашем случае она означает отключение с вероятностью 30% при наличии 100 неаутентифицированных связей, с линейным ростом вероятности до 100% при достижении 1000.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://agrat.gitbook.io/admin/utility/lsyncd.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.