rsync error: unexplained error (code 255) — что делать
Код 255 rsync не придумывает сам — его возвращает ssh, через который rsync подключается к серверу. Значит, ssh не вошёл на сервер или его соединение оборвалось. Над последней строкой rsync есть строка ssh с причиной — её и нужно исправить.
Содержание 8
Что сделать прямо сейчас
- Найдите над строкой
rsync errorсообщение от ssh — что оно значит. - Проверьте вход без rsync:
ssh ivan@ВАШ_IP— с тем же пользователем, адресом и портом. - Если ssh входит, а rsync нет — укажите для rsync порт и ключ.
Как выглядит ошибка
ivan@203.0.113.10: Permission denied (publickey).
rsync: connection unexpectedly closed (0 bytes received so far) [sender]
rsync error: unexplained error (code 255) at io.c(…) [sender=3.2.7]Первая строка — от ssh, две нижние — от rsync. По справке ssh, он завершается с кодом 255, когда случилась его собственная ошибка: не подключился, не вошёл, оборвалось соединение. rsync отдаёт этот код как свой, а пишет unexplained error — «необъяснённая ошибка», потому что кода 255 в его списке нет.
Что написал ssh
| Строка над ошибкой rsync | Что значит | Разбор |
|---|---|---|
ivan@…: Permission denied (publickey). | сервер не принял ключ | разбор |
Permission denied, please try again. | неверный пароль | разбор |
ssh: connect to host … port 22: и отказ в соединении | на этом порту SSH не отвечает: SSH на другом порту или не запущен | разбор |
ssh: connect to host … port 22: и истекло время ожидания | сервер не отвечает: неверный IP или порт закрыт | разбор |
ssh: Could not resolve hostname … | опечатка в имени сервера | разбор |
Host key verification failed. | ssh не может проверить ключ сервера | разбор |
WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! | ключ сервера сменился — например, после переустановки системы | разбор |
Too many authentication failures | ssh перепробовал слишком много ключей | разбор |
Если строки ssh нет, а rsync успел что-то передать — в скобках не 0 байт, — оборвалось соединение посреди копирования: что делать.
Как указать порт и ключ
rsync запускает ssh сам, поэтому порт и ключ передаются ему в ключе -e — целиком, в кавычках:
rsync -av -e "ssh -p 2222 -i $HOME/.ssh/server_key" sajt/ ivan@ВАШ_IP:/home/ivan/sajt/Вместо 2222 — ваш порт SSH, вместо server_key — имя файла ключа. Пишите $HOME, а не ~: внутри кавычек знак ~ не заменяется на домашнюю папку.
Удобнее один раз записать сервер в файл ~/.ssh/config на своём компьютере — тогда и ssh, и rsync возьмут адрес, пользователя, порт и ключ оттуда:
Host mysite
HostName 203.0.113.10
User ivan
Port 2222
IdentityFile ~/.ssh/server_keyВместо 203.0.113.10 — IP вашего сервера. Команда становится короче:
rsync -av sajt/ mysite:/home/ivan/sajt/Как устроен этот файл — config клиента SSH.
Если вручную работает, а в cron — нет
cron запускает команды без вас: ssh не может спросить пароль и не видит ключей, которые помнит ваша сессия.
| Что не так | Что сделать |
|---|---|
| ключ защищён паролем, в терминале его помнит ssh-agent | для задачи по расписанию заведите отдельный ключ без пароля и храните его только на этом компьютере |
задача добавлена через sudo crontab -e | она работает от root и берёт ключи из /root/.ssh, а не из вашей папки — добавьте задачу в crontab -e своего пользователя |
| под этим пользователем ssh ещё не подключался к серверу | ssh не знает ключ сервера и пишет Host key verification failed. — подключитесь один раз вручную тем же пользователем, сверьте отпечаток и ответьте yes |
Чтобы в задаче ssh не ждал ввода, а сразу завершался с ошибкой, добавьте -o BatchMode=yes:
rsync -a -e "ssh -o BatchMode=yes" /var/www/example.com/ backup@ВАШ_IP:/home/backup/site/Чтобы видеть ошибки задачи, допишите в конец строки в crontab >> /home/ivan/rsync.log 2>&1 — вывод rsync и ssh будет копиться в этом файле. Примеры расписаний — cron, готовая схема копий — резервные копии сайта.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
code 255 и выше Permission denied (publickey). | сервер не принял ключ | разбор |
code 255 и выше ssh: connect to host … port 22: | SSH на другом порту или сервер не отвечает | -e "ssh -p ПОРТ" |
code 255 только в cron | нет ключа или ssh ждёт ввода | ключ без пароля, свой crontab |
code 255 после части файлов | оборвалось SSH-соединение | повторите с -P |
code 127 remote command not found | на сервере нет rsync | установите rsync |
Тексты сообщений rsync сверены по исходному коду rsync 3.2.7 — эта версия стоит в Ubuntu 24.04, код выхода ssh — по справке ssh для Ubuntu 24.04.
Источники
- Справка ssh для Ubuntu 24.04 — на английском: код выхода 255, ключи -p, -i и -o.
- Исходный код rsync 3.2.7 — на английском: как rsync берёт код выхода ssh, в cleanup.c.
- Справка rsync для Ubuntu 24.04 — на английском: ключ -e и раздел EXIT VALUES.
Сверено 13 ноября 2026 года.
Что почитать дальше
- connection unexpectedly closedкоды 127, 12 и обрыв посреди копирования.
- Ошибки SSHвсе ошибки подключения по SSH.
- Ошибки rsyncвсе ошибки rsync на одной странице.