Поиск
Ошибки

rsync error: unexplained error (code 255) — что делать

Код 255 rsync не придумывает сам — его возвращает ssh, через который rsync подключается к серверу. Значит, ssh не вошёл на сервер или его соединение оборвалось. Над последней строкой rsync есть строка ssh с причиной — её и нужно исправить.

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

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

  1. Найдите над строкой rsync error сообщение от ssh — что оно значит.
  2. Проверьте вход без rsync: ssh ivan@ВАШ_IP — с тем же пользователем, адресом и портом.
  3. Если 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 failuresssh перепробовал слишком много ключейразбор

Если строки 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.

Источники

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

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

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