Статья 136 из 141
Гайды
rsync между серверами по SSH: копирование, синхронизация и простой ежедневный бэкап
rsync копирует файлы между папками и серверами. При повторном запуске он передаёт только то, что изменилось. Поэтому им удобно переносить сайт на новый VPS, синхронизировать папки и делать простые бэкапы. Передача идёт по SSH, отдельный сервис на сервере не нужен.
Примеры проверены на Ubuntu 24.04 с rsync 3.2.7: между двумя локальными папками и по SSH на отдельного пользователя.
Установка
Заголовок раздела «Установка»rsync должен стоять на обоих серверах:
apt install -y rsyncrsync --version | head -1rsync version 3.2.7 protocol version 31Для работы по SSH настройте вход по ключу: SSH-ключи. Иначе пароль будут спрашивать при каждом запуске, и cron не сработает.
Основной синтаксис
Заголовок раздела «Основной синтаксис»rsync [опции] ИСТОЧНИК ПРИЁМНИК| Флаг | Что делает |
|---|---|
-a |
архивный режим: рекурсивно, с правами, владельцами, датами и ссылками |
-v |
выводить имена файлов |
-z |
сжимать при передаче (полезно по сети, бесполезно для архивов и видео) |
-h |
размеры в понятном виде |
-n, --dry-run |
пробный запуск, ничего не меняет |
-i |
показать, что и почему меняется |
-P |
то же, что --partial --progress |
--delete |
удалять в приёмнике файлы, которых нет в источнике |
--mkpath |
создать недостающие папки пути в приёмнике |
--exclude |
исключить по шаблону |
--bwlimit |
ограничить скорость |
Слеш в конце источника
Заголовок раздела «Слеш в конце источника»Это главная ловушка. Слеш в конце означает «содержимое папки», без слеша копируется сама папка:
rsync -a src/site dst/a/ # получится dst/a/site/index.htmlrsync -a src/site/ dst/b/ # получится dst/b/index.htmlУ приёмника слеш на результат не влияет. Привыкайте всегда писать источник со слешем и явно указывать конечную папку.
Копирование по SSH
Заголовок раздела «Копирование по SSH»На другой сервер:
rsync -avz /var/www/site/ backup@203.0.113.10:/home/backup/site/С сервера к себе:
rsync -avz backup@203.0.113.10:/home/backup/site/ /var/www/site/Нестандартный порт или ключ задаются через -e:
rsync -avz -e "ssh -p 2222 -i /root/.ssh/id_backup" /var/www/site/ backup@203.0.113.10:site/Если родительской папки на приёмнике нет, rsync падает:
rsync: [Receiver] mkdir "/home/backup/backup/site" failed: No such file or directory (2)rsync error: error in file IO (code 11) at main.c(800) [Receiver=3.2.7]Добавьте --mkpath, и rsync создаст путь сам: created 1 directory for backup/site.
Повторный запуск передаёт только изменения. Вывод --stats после правки одного файла:
Number of files: 7 (reg: 4, dir: 3)Number of regular files transferred: 1Total transferred file size: 4 bytestotal size is 3,000,018 speedup is 9,708.80–delete и пробный запуск
Заголовок раздела «–delete и пробный запуск»--delete делает приёмник точной копией источника: всё лишнее удаляется. Перед запуском с --delete всегда смотрите, что будет удалено:
rsync -av --delete --dry-run src/site/ dst/c/sending incremental file listdeleting only-in-dst.txtdeleting app.log
sent 181 bytes received 51 bytes 464.00 bytes/sectotal size is 3,000,014 speedup is 12,931.09 (DRY RUN)Чем это опасно:
- Ошибка в пути источника. Если источник пустой (диск не примонтирован, опечатка, пустая переменная в скрипте), rsync удалит в приёмнике всё. На тесте с пустой папкой пробный запуск показал удаление каждого файла.
- Перепутали источник и приёмник. Свежие данные будут заменены старыми.
- Бэкап с
--deleteне защищает от удаления. Удалили файл на сервере, следующий запуск удалил его и в копии.
Если нужна копия удаляемых и изменённых файлов, добавьте --backup --backup-dir:
rsync -a --delete --backup --backup-dir=../changed-$(date +%F) src/site/ backup@203.0.113.10:backup/site/Старые версии файлов окажутся в backup/changed-2026-11-18/.
Исключения
Заголовок раздела «Исключения»rsync -av --exclude 'cache/' --exclude '*.log' /var/www/site/ dst/Много шаблонов удобнее держать в файле:
cache/*.log*.tmpnode_modules/.git/rsync -av --exclude-from=/root/rsync-excludes.txt /var/www/site/ dst/Шаблон со слешем в конце (cache/) совпадает только с папками. Шаблон с ведущим слешем (/cache/) совпадает только в корне источника.
Ограничение скорости и докачка
Заголовок раздела «Ограничение скорости и докачка»--bwlimit ограничивает скорость, чтобы бэкап не забивал канал сайту. Значение в КиБ/с или с суффиксом:
rsync -a --bwlimit=5M bigfile.tar.gz backup@203.0.113.10:backup/По умолчанию прерванная передача файла удаляется. С --partial недокачанная часть остаётся, и при следующем запуске rsync продолжит с неё. Проверено на файле 60 МБ: передачу оборвали через 3 секунды, на приёмнике остался кусок 14,5 МБ, повторный запуск с --partial докачал файл, и cmp подтвердил совпадение.
rsync -a --partial --info=progress2 bigfile.tar.gz backup@203.0.113.10:backup/--info=progress2 показывает общий прогресс, а не каждый файл.
Ежедневный бэкап со снимками
Заголовок раздела «Ежедневный бэкап со снимками»Скрипт ниже каждый день создаёт новую папку с датой. Неизменённые файлы не копируются заново, а становятся жёсткими ссылками на вчерашние (--link-dest). Каждая папка выглядит как полная копия, а место занимают только изменения. Старше 14 дней папки удаляются.
На сервере бэкапов создайте пользователя backup и добавьте ему ваш публичный ключ. Скрипт /usr/local/bin/rsync-backup.sh на рабочем сервере:
#!/bin/bashset -euo pipefail
SRC="/var/www/site/"DEST_HOST="backup@203.0.113.10"DEST_DIR="backup/daily"KEEP_DAYS=14SSH="ssh -i /root/.ssh/id_backup -o BatchMode=yes"
TODAY=$(date +%F_%H%M%S)
rsync -a --delete --mkpath \ --exclude-from=/root/rsync-excludes.txt \ --link-dest="../latest" \ -e "$SSH" \ "$SRC" "$DEST_HOST:$DEST_DIR/$TODAY/"
$SSH "$DEST_HOST" "cd $DEST_DIR && ln -sfn $TODAY latest && find . -maxdepth 1 -type d -name '20*' -mtime +$KEEP_DAYS -exec rm -rf {} +"echo "backup $TODAY done"chmod 700 /usr/local/bin/rsync-backup.sh/usr/local/bin/rsync-backup.shПри первом запуске rsync предупредит --link-dest arg does not exist: ../latest и сделает полную копию. Так и должно быть. Результат двух запусков на тесте:
2.9M backup/daily/2026-11-18_16343712K backup/daily/2026-11-18_1634392.9M backup/daily/Вторая копия заняла 12 КБ: большой файл в ней жёсткая ссылка на первый (счётчик ссылок 2).
Расписание в /etc/cron.d/rsync-backup:
30 3 * * * root /usr/local/bin/rsync-backup.sh >> /var/log/rsync-backup.log 2>&1Базы данных копируйте через дамп, а не файлами: MySQL, PostgreSQL. Если нужны шифрование и хранение в S3, используйте restic. Общий подход к копиям: бэкапы.
Частые проблемы
Заголовок раздела «Частые проблемы»| Симптом | Причина и решение |
|---|---|
| Внутри приёмника появилась лишняя вложенная папка | Нет слеша в конце источника. Пишите src/site/. |
mkdir ... failed: No such file or directory |
Нет родительской папки. Добавьте --mkpath или создайте её. |
rsync: command not found на удалённой стороне |
rsync не установлен на втором сервере. |
Permission denied (publickey) |
Ключ не добавлен или указан не тот. Проверьте ssh -i ключ пользователь@хост. |
| Файлы копируются заново каждый раз | Не сохраняются даты: нет -a или файловая система приёмника их не поддерживает. |
| cron не выполняет скрипт, вручную работает | В cron другой PATH и нет агента SSH. Указывайте ключ через -i и полные пути. |
| Бэкап удалил нужные файлы | Запуск с --delete от пустого источника. Сначала --dry-run, храните снимки по датам. |