Текущая версия от 19:54, 2 марта 2024

Установка rsync на QNAP NAS

Программа для UNIX-подобных систем, которая эффективно выполняет синхронизацию файлов и каталогов в двух местах с минимизированием трафика, используя кодирование данных при необходимости. Важным отличием rsync от многих других программ/протоколов является то, что зеркалирование осуществляется одним потоком в каждом направлении. rsync может копировать или отображать содержимое каталога и копировать файлы, опционально используя сжатие и рекурсию. rsync передаёт только изменения файлов, что отражается на производительности программы.

«Из коробки» на моем QNAP NAS TS-412 стоит старая версия rsync 3.0.7, поэтому пришлось устанавливать дополнительно из Entware (opkg).

Команда установки

 $> /opt/bin/opkg install rsync
 $> /opt/bin/opkg install rsyncd

rsync => это программа, которая позволяет копировать файлы на удаленные машины и с них почти так же, как rcp. Он имеет гораздо больше возможностей, чем rcp, и использует протокол удаленного обновления rsync для значительного ускорения передачи файлов, когда целевой файл уже существует. Протокол удаленного обновления rsync позволяет rsync передавать по сетевому каналу только различия между двумя наборами файлов.
rsyncd => это файл конфигурации и сценарий инициализации для использования rsync в качестве демона. Он использует тот же двоичный файл, что и rsync.

Скрипт для контроля версий

#!/bin/bash
### Rsync 
    if [ -L "/mnt/ext/usr/bin/rsync" ]; then
    echo "Файл уже ссылка!"
    else
        if [ -f "/mnt/ext/usr/bin/rsync3.0.7" ]; then
            rm /mnt/ext/usr/bin/rsync3.0.7
        fi
        mv /mnt/ext/usr/bin/rsync /mnt/ext/usr/bin/rsync3.0.7
        ln -s /opt/bin/rsync /mnt/ext/usr/bin/rsync
    fi

Синхронизация

Запускается через терминал или можно установить в cron:

Локально:

 $> rsync -auvq8 --delete --progress «ЧТО» «КУДА»

Между компьютерами и/или серверами

 $> rsync -auvq8 -e='ssh -p 99' --delete --progress «логин»@«адрес»:«ЧТО» «логин»@«адрес»:«КУДА»

Ключи

-a => Режим архивирования, когда сохраняются все атрибуты оригинальных файлов;
-u => Не перезаписывать более новые файлы;
-v => Выводить подробную информацию о процессе копирования;
-q => Минимум информации;
-8 => Это говорит rsync оставлять все старшие разрядные символы в выводе неэкранированными, вместо того, чтобы пытаться проверить их, допустимы ли они в текущей локали, и экранировать недопустимые. Все управляющие символы (но не символы табуляции) всегда экранируются, независимо от настройки этой опции. Идиома экранирования, появившаяся в версии 2.6.7, заключается в выводе буквальной обратной косой черты (\) и решетки (#), за которыми следуют ровно 3 восьмеричные цифры. . Например, новая строка будет выводиться как «\#012». Буквальная обратная косая черта в имени файла не экранируется, если за ней не следует хеш и 3 цифры (0–9).
-e='ssh -p 22' => Использовать другой транспорт, например, ssh;
--delete => Удалять файлы которых нет в источнике; (Использовать с осторожностью, могут быть нежелательные последствия)
--progress => Выводить прогресс передачи файла;

Есть и другие ключи, «ТЫндекс» вам в помощь.

Файл конфигурации сервера rsync

На удаленных компьютера/серверах нужно обязательно настроить SSH (Как настроить: ssh macOS или ssh на QNAP) А так же следует отредактировать файл конфигурации rsync, который находится:

 $> /etc/rsyncd.conf

Пример содержимого файла:

pid file = /var/run/rsyncd.pid
lock file = /var/run/rsync.lock
log file = /var/log/rsync.log
[share]
path = /tmp/share/
hosts allow = 192.168.56.1
hosts deny = *
list = true
uid = root
gid = root
read only = false

(После редактирования файла следует перезапустить службу или перезагрузить компьютер)

Ключи rsync

Параметры

--verbose, -v увеличить подробность
--info=FLAGS подробная информационная информация
--debug=ФЛАГИ детальной подробной отладки
--stderr=e|a|c изменить режим вывода stderr (по умолчанию: ошибки)
--quiet, -q подавлять сообщения, не содержащие ошибок
--no-motd подавлять MOTD в режиме демона
--checksum, -c пропуск на основе контрольной суммы, а не времени и размера модификации
--archive, -a режим архивирования — -rlptgoD (без -A,-X,-U,-N,-H)
--no-OPTION отключить подразумеваемую ОПЦИЮ (например, --no-D)
--recursive, -r рекурсивно обращаться к каталогам
--relative, -R использовать относительные имена путей
--no-implied-dirs не отправлять подразумеваемые каталоги с --relative
--backup, -b создавать резервные копии (см. --suffix и --backup-dir)
--backup-dir=DIR создавать иерархию резервных копий на основе DIR
--suffix=суффикс резервной копии SUFFIX (по умолчанию ~ без --backup-dir)
--update, -u пропускать более новые файлы на получателе
--inplace обновить файлы назначения на месте
--append добавить данные в более короткие файлы
--append-verify --append со старыми данными в контрольной сумме файла
--dirs, -d перенести каталоги без рекурсии
--old-dirs, --old-d работает как --dirs при разговоре со старым rsync
--mkpath создать недостающие компоненты пути пункта назначения
--links, -l копировать символические ссылки как символические ссылки
--copy-links, -L преобразовать символическую ссылку в ссылочный файл/каталог
--copy-unsafe-links преобразуются только «небезопасные» символические ссылки
--safe-links игнорировать символические ссылки, указывающие за пределы дерева
--munge-links уничтожает символические ссылки, чтобы сделать их безопасными и непригодными для использования
--copy-dirlinks, -k преобразовать символическую ссылку в каталог в референтный каталог
--keep-dirlinks, -K рассматривать каталог с символической ссылкой на получателе как каталог
--hard-links, -H сохранить жесткие ссылки
--perms, -p сохранить разрешения
--fileflags сохранить флаги файлов (также известные как chflags)
--executability, -E сохранить исполняемость
--chmod=CHMOD влияет на права доступа к файлам и/или каталогам
--acls, -A сохранить списки ACL (подразумевается --perms)
--xattrs, -X сохранить расширенные атрибуты
--owner, -o сохранить владельца (только для суперпользователя)
--group, -g сохранить группу
--devices сохраняет файлы устройств (только для суперпользователей)
--copy-devices копировать содержимое устройства как обычный файл
--write-devices записывает на устройства в виде файлов (подразумевается --inplace)
--specials сохраняет специальные файлы
-D то же, что --devices --specials
--times, -t сохранить время модификации
--atimes, -U сохранить время доступа (использования)
--open-noatime избежать изменения времени открытых файлов
--crtimes, -N сохранить время создания (новизна)
--omit-dir-times, -O исключить каталоги из --times
--omit-link-times, -J исключить символические ссылки из --times
--super получатель пытается выполнить действия суперпользователя
--fake-super сохранить/восстановить привилегированные атрибуты с помощью xattrs
--sparse, -S превращает последовательности нулей в разреженные блоки
--preallocate выделять файлы назначения перед их записью
--dry-run, -n выполнить пробный запуск без внесения изменений
--whole-file, -W копировать файлы целиком (без алгоритма delta-xfer)
--checksum-choice=STR выбрать алгоритм контрольной суммы (он же --cc)
--one-file-system, -x не пересекать границы файловой системы
--block-size=РАЗМЕР, -B принудительно установить фиксированный размер блока контрольной суммы
--rsh=КОМАНДА, -e указать используемую удаленную оболочку
--rsync-path=ПРОГРАММА указать rsync для запуска на удаленном компьютере
--existing пропустить создание новых файлов на получателе
--ignore-existing пропустить обновление файлов, существующих на получателе
--remove-source-files отправитель удаляет синхронизированные файлы (не из каталога)
--del псевдоним для --delete-during
--delete удалить посторонние файлы из каталогов назначения
--delete-before получатель удаляет до xfer, а не во время
--delete-during получатель удаляет во время передачи
--delete-delay найти удаления во время, удалить после
--delete-after получатель удаляет после передачи, а не во время
--delete-excluded также удалить исключенные файлы из целевых каталогов
--ignore-missing-args игнорировать отсутствующие исходные аргументы без ошибок
--delete-missing-args удалить отсутствующие исходные аргументы из места назначения
--ignore-errors удалить, даже если есть ошибки ввода-вывода
--force-delete принудительно удалить каталоги, даже если они не пустые
--force-change влияет на неизменяемые пользователем/системой файлы/каталоги
--force-uchange влияет на неизменяемые пользователем файлы/каталоги
--force-schange влияет на неизменяемые файлы/каталоги системы
--max-delete=ЧИСЛО не удалять более ЧИСЛА файлов
--max-size=РАЗМЕР не передавать файлы размером больше РАЗМЕРА
--min-size=РАЗМЕР не передавать файлы размером меньше РАЗМЕРА
--max-alloc=РАЗМЕР изменить ограничение, связанное с выделением памяти
--partial сохранить частично переданные файлы
--partial-dir=DIR поместить частично перенесенный файл в DIR
--delay-updates в конце помещает все обновленные файлы на место
--prune-empty-dirs, -m удалить пустые цепочки каталогов из списка файлов
--numeric-ids не сопоставляет значения uid/gid по имени пользователя/группы
--usermap=STRING пользовательское сопоставление имен пользователей
--groupmap=Сопоставление имени пользовательской группы STRING
--chown=USER:GROUP простое сопоставление имени пользователя и имени группы
--timeout=СЕКУНДЫ установить тайм-аут ввода-вывода в секундах
--contimeout=СЕКУНДЫ установить таймаут подключения демона в секундах
--ignore-times, -Я не пропускаю файлы, размер и время которых совпадают
--size-only пропускать файлы, совпадающие по размеру
--modify-window=NUM, -@ установить точность для сравнения времени изменения
--temp-dir=КАТАЛОГ, -T создать временные файлы в каталоге DIR
--fuzzy, -y найти аналогичный файл для базы, если нет целевого файла
--compare-dest=DIR также сравнивает файлы назначения относительно DIR
--copy-dest=DIR ... и включить копии неизмененных файлов
--link-dest=DIR жесткая ссылка на файлы в DIR, если они не изменены
--compress, -z сжимать данные файла во время передачи
--compress-choice=STR выберите алгоритм сжатия (он же --zc)
--compress-level=ЧИСЛО явно устанавливает уровень сжатия (он же --zl)
--skip-compress=СПИСОК пропустить сжатие файлов с суффиксом в списке СПИСОК
--cvs-exclude, -C автоматически игнорировать файлы так же, как это делает CVS
--filter=ПРАВИЛО, -f добавить ПРАВИЛО фильтрации файлов
-F то же, что --filter='dir-merge /.rsync-filter'
                          повторено: --filter='- .rsync-filter'
--exclude=ШАБЛОН исключить файлы, соответствующие ШАБЛОНУ
--exclude-from=FILE прочитать шаблоны исключения из FILE
--include=ШАБЛОН не исключать файлы, соответствующие ШАБЛОНУ
--include-from=FILE прочитать включаемые шаблоны из FILE
--files-from=ФАЙЛ прочитать список имен исходных файлов из ФАЙЛА
--from0, -0 все файлы *-from/filter разделяются нулями
--old-args отключить современную идиому защиты arg
--secluded-args, -s использовать протокол для безопасной отправки аргументов
--trust-sender доверять списку файлов удаленного отправителя
--copy-as=USER[:GROUP] указать пользователя и дополнительную группу для копии
--address=АДРЕС адрес привязки исходящего сокета к демону
--port=PORT указать альтернативный номер порта через двойные двоеточия
--sockopts=ОПЦИИ указать пользовательские параметры TCP
--blocking-io использовать блокировку ввода-вывода для удаленной оболочки
--outbuf=N|L|B установить для буферизации значение «Нет», «Линия» или «Блок».
--stats выдает некоторую статистику передачи файлов
--8-bit-output, -8 оставлять старшие битовые символы неэкранированными в выводе
--human-readable, -h выводить числа в удобочитаемом формате
--progress показать прогресс во время передачи
-P то же, что --partial --progress
--itemize-changes, -i вывести сводку изменений для всех обновлений
--remote-option=OPT, -M отправить OPTION только на удаленную сторону
--out-format=ФОРМАТ обновляет выходные данные с использованием указанного ФОРМАТА
--log-file=ФАЙЛ регистрировать, что мы делаем с указанным ФАЙЛОМ
--log-file-format=Обновления журнала FMT с использованием указанного FMT
--password-file=ФАЙЛ прочитать пароль доступа демона из ФАЙЛА
--early-input=ФАЙЛ использовать ФАЙЛ для ввода данных раннего выполнения демона
--list-only выводить список файлов вместо их копирования
--bwlimit=RATE ограничить пропускную способность сокета ввода-вывода
--stop-after=MINS Остановить rsync по истечении MINS минут
--stop-at=y-m-dTh:m Остановить rsync в указанный момент времени
--fsync синхронизировать каждый записанный файл
--write-batch=FILE записать пакетное обновление в FILE
--only-write-batch=ФАЙЛ похож на --write-batch, но без обновления адресата
--read-batch=FILE прочитать пакетное обновление из FILE
--protocol=ЧИСЛО принудительно использовать более старую версию протокола
--icv=CONVERT_SPEC запросить преобразование кодировки имен файлов
--checksum-seed=ЧИСЛО установить начальное значение контрольной суммы блока/файла (дополнительно)
--ipv4, -4 предпочитают IPv4
--ipv6, -6 предпочитают IPv6
--version, -V вывести версию + другую информацию и выйти
--help, -h (*) показать эту справку (* -h является справкой только сама по себе)