Ошибки rsync: как по сообщению найти причину
rsync пишет об ошибке строкой, которая начинается с rsync:, а в самом конце подводит итог строкой rsync error с кодом. Итог говорит, чем кончилось копирование, а причина — в строках выше. Найдите слова из них в таблице ниже и откройте разбор.
Содержание 9
Что сделать прямо сейчас
- Найдите строку с причиной — она выше итоговой
rsync error: … (code …)— и слова из неё в таблице. - Если строки с причиной не видно, посмотрите код в последней строке.
- После исправления запустите ту же команду снова: 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 | — | всё скопировано |
| 1 | syntax or usage error | ошибка в команде — разбор |
| 2 | protocol incompatibility | сервер выводит текст при входе — разбор |
| 11 | error in file IO | не удалось записать: нет папки назначения или места — папка, место |
| 12 | error in rsync protocol data stream | rsync на другой стороне завершился — разбор |
| 20 | received SIGINT, SIGTERM, or SIGHUP | rsync остановили — разбор |
| 23 | some files/attrs were not transferred | часть файлов не передана — разбор |
| 24 | some files vanished before they could be transferred | файлы удалили во время копирования — разбор |
| 25 | the --max-delete limit stopped deletions | rsync удалил столько файлов, сколько разрешает --max-delete, и остановил удаление |
| 30 | timeout in data send/receive | сработал --timeout — разбор |
| 35 | timeout waiting for daemon connection | служба rsync по адресу rsync:// не ответила — разбор |
| 127 | remote command not found | на сервере нет rsync — разбор |
| 255 | unexplained 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.
Источники
- Исходный код rsync 3.2.7 — на английском: тексты всех сообщений, тексты кодов в log.c, выбор итогового кода в cleanup.c.
- Справка rsync для Ubuntu 24.04 — на английском: все ключи, разделы EXIT VALUES и DIAGNOSTICS.
- Пакет rsync в Ubuntu 24.04 — версия rsync в Ubuntu 24.04.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Команда rsyncкак копировать файлы на сервер и обратно.
- Команда scpкак скопировать несколько файлов одной командой.
- Ошибки SSHвсе ошибки подключения по SSH.
- Резервные копии сайтакак копировать сайт по расписанию.
- No space left on deviceкогда на диске кончилось место.