Поиск
Ошибки

Ошибки rsync: как по сообщению найти причину

rsync пишет об ошибке строкой, которая начинается с rsync:, а в самом конце подводит итог строкой rsync error с кодом. Итог говорит, чем кончилось копирование, а причина — в строках выше. Найдите слова из них в таблице ниже и откройте разбор.

≈ 8 мин чтения
Содержание 9

Что сделать прямо сейчас

  1. Найдите строку с причиной — она выше итоговой rsync error: … (code …) — и слова из неё в таблице.
  2. Если строки с причиной не видно, посмотрите код в последней строке.
  3. После исправления запустите ту же команду снова: rsync передаст только то, что не успел.

Найдите свою ошибку

Таблицы разбиты по тому, что случилось. Найдите слова из сообщения в левой колонке и откройте разбор.

Связь с сервером

Слова в сообщенииЧто случилосьЧто делать
connection unexpectedly closed (0 bytes received so far)связь с rsync на сервере пропала в самом началеРазбор
unexplained error (code 255)ssh не подключился к серверуРазбор
Permission denied (publickey). над ошибкой rsyncсервер не принял ключ SSHРазбор
remote command not found (code 127)на сервере нет rsyncРазбор
connection unexpectedly closed с большим числом байтсвязь оборвалась посреди копированияРазбор
protocol version mismatch -- is your shell clean?сервер выводит текст при входеРазбор
io timeout after … seconds -- exitingданных не было дольше --timeoutРазбор
received SIGINT, SIGTERM, or SIGHUP (code 20)rsync остановили: Ctrl+C, закрытое окно, killРазбор

Файлы и папки

Слова в сообщенииЧто случилосьЧто делать
some files/attrs were not transferred (see previous errors) (code 23)часть файлов не передана, причина — вышеРазбор
link_stat "…" failed: … (2) или change_dir "…" failed: … (2)нет файла или папки по этому путиРазбор
mkdir "…" failed: … (2) и code 11нет папки выше папки назначенияРазбор
send_files failed to open "…": … (13) или opendir "…" failed: … (13)нет права читать файл или папкуРазбор
mkstemp "…" failed: … (13) или recv_generator: mkdir "…" failed: … (13)нет права писать в папкуРазбор
failed to set times on "…": … (1)время папки меняет только её владелецРазбор
failed to set permissions on "…": … (1)права меняет только владелецРазбор
write failed on "…": … (28)на диске кончилось местоРазбор
file has vanished: "…" и code 24файл удалили во время копированияРазбор
IO error encountered -- skipping file deletionиз-за ошибок чтения --delete ничего не удалилРазбор

Ошибки в команде

Слова в сообщенииЧто случилосьЧто делать
syntax or usage error (code 1)rsync не понял командуРазбор
--ключ: unknown optionтакого ключа нетРазбор
on remote machine: --ключ: unknown optionключ не знает rsync на сервереРазбор
ERROR: destination path is not a directoryпуть назначения — файл, а не папкаРазбор
The source and destination cannot both be remote.оба пути на серверахРазбор
Unexpected local arg: …пробел в пути без кавычекРазбор

Как читать сообщение rsync

rsync: [sender] send_files failed to open "/var/www/example.com/wp-config.php": … (13)
rsync error: some files/attrs were not transferred (see previous errors) (code 23) at main.c(…) [generator=3.2.7]
ЧастьЧто значит
rsync: в началесообщение от rsync — на вашем компьютере или на сервере
[sender]какая часть rsync пишет: sender читает и отправляет файлы, receiver и generator принимают и записывают
send_files failed to open "…"что не получилось и с каким файлом
… (13)короткий текст ошибки системы на английском и её номер — что значит число
rsync error: …итог: чем кончилось копирование
(code 23)код выхода — таблица кодов
at main.c(…)место в коде rsync, для вас не важно
[generator=3.2.7]какая часть rsync написала итог и её версия

Строки, которые начинаются с ssh: или кончаются на (publickey)., пишет не rsync, а ssh, через который rsync подключается к серверу: ошибки SSH.

Число в скобках в конце строки

ЧислоЧто значитРазбор
(1)операция не разрешена: время и права меняет только владелецfailed to set times
(2)нет такого файла или папкиlink_stat и change_dir
(13)нет прав на чтение или записьошибка 13
(28)на диске кончилось местоошибка 28

Коды выхода rsync

Код — число в конце последней строки, (code …). Узнать его можно и после команды: echo $? покажет код последней команды (echo).

КодТекст в итоговой строкеЧто значит
0—всё скопировано
1syntax or usage errorошибка в команде — разбор
2protocol incompatibilityсервер выводит текст при входе — разбор
11error in file IOне удалось записать: нет папки назначения или места — папка, место
12error in rsync protocol data streamrsync на другой стороне завершился — разбор
20received SIGINT, SIGTERM, or SIGHUPrsync остановили — разбор
23some files/attrs were not transferredчасть файлов не передана — разбор
24some files vanished before they could be transferredфайлы удалили во время копирования — разбор
25the --max-delete limit stopped deletionsrsync удалил столько файлов, сколько разрешает --max-delete, и остановил удаление
30timeout in data send/receiveсработал --timeout — разбор
35timeout waiting for daemon connectionслужба rsync по адресу rsync:// не ответила — разбор
127remote command not foundна сервере нет rsync — разбор
255unexplained errorкод вернул ssh: не подключился или потерял связь — разбор

Если ssh завершился с кодом больше, чем у rsync, rsync отдаёт код ssh. Поэтому при ошибке подключения код — 255.

Если rsync на Mac

На Mac команда rsync — это openrsync: проверьте командой rsync --version, в ответе будет openrsync: protocol version 29. Это другая программа: основные ключи те же, а тексты ошибок другие — строка начинается с rsync(, номера процесса и слова error:. Ключа --mkpath openrsync не знает.

rsync 3.2.7 на сервере с Ubuntu 24.04 работает с openrsync: копирование с Mac на сервер и обратно идёт. Таблицы на этой странице — для сообщений rsync 3.2.7, их пишет rsync на сервере и на компьютерах с Linux.

Если rsync на виртуальном хостинге

rsync работает, если хостинг даёт вход по SSH и на сервере установлен rsync — это указано в панели или справке хостинга. Без SSH rsync к хостингу не подключится: файлы заливайте через FTP или файловый менеджер панели.

Тексты сообщений и коды сверены по исходному коду rsync 3.2.7 — эта версия стоит в Ubuntu 24.04.

Источники

Сверено 13 ноября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше