Поиск
Ошибки

rsync: connection unexpectedly closed (0 bytes received so far) — что делать

rsync работает через SSH: на вашем компьютере запускается ssh, а на сервере — второй rsync, который принимает или отдаёт файлы. Сообщение connection unexpectedly closed значит, что связь между ними пропала. Причину подсказывает код в последней строке: 255 — ssh не подключился, 127 — на сервере нет rsync.

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

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

  1. Посмотрите код в последней строке rsync error: … (code …) и найдите его в таблице.
  2. Посмотрите строки выше: если там есть строка от ssh — она начинается с ssh: или кончается на (publickey)., — ssh не подключился.
  3. Проверьте вход без rsync: ssh ivan@ВАШ_IP — с тем же пользователем и адресом, что в команде rsync.

Как выглядит ошибка

rsync: connection unexpectedly closed (0 bytes received so far) [sender]
rsync error: unexplained error (code 255) at io.c(…) [sender=3.2.7]
ЧастьЧто значит
connection unexpectedly closedсвязь с rsync на сервере неожиданно закрылась
(0 bytes received so far)сколько байт rsync успел получить: 0 — обмен даже не начался, большое число — связь оборвалась посреди копирования
[sender]какой rsync пишет: sender отправляет файлы; при скачивании с сервера будет Receiver или generator — тот rsync, что принимает
(code 255)код выхода — по нему видно причину
at io.c(…)место в коде rsync, для вас не важно
[sender=3.2.7]какой rsync написал строку и его версия

Что значит код в последней строке

Код и текстЧто случилосьЧто делать
255 unexplained errorssh не подключился к серверу или его соединение оборвалосьпроверьте ssh, подробно — код 255
127 remote command not foundна сервере нет программы rsyncустановите rsync на сервер
12 error in rsync protocol data streamrsync на другой стороне завершился или связь закрылась без ошибки sshпосмотрите строки выше
2 protocol incompatibilityсервер при входе выводит текст, и он мешает rsyncprotocol version mismatch

Код 255 rsync берёт у ssh: когда ssh завершается с ошибкой, rsync отдаёт его код как свой и пишет unexplained error — «необъяснённая ошибка», потому что такого кода нет в его списке.

Если на сервере нет rsync

rsync: connection unexpectedly closed (0 bytes received so far) [sender]
rsync error: remote command not found (code 127) at io.c(…) [sender=3.2.7]

Над этими строками — сообщение оболочки сервера о том, что команда rsync не найдена. rsync нужен на обоих компьютерах: на вашем и на сервере. Подключитесь к серверу по SSH (как) и проверьте:

rsync --version

В Ubuntu 24.04 первая строка ответа — rsync version 3.2.7 protocol version 31. Если вместо неё сообщение, что команда не найдена, установите rsync:

sudo apt update
sudo apt install rsync

Если rsync на сервере есть, но лежит в своей папке, которую оболочка не находит, укажите путь к нему ключом --rsync-path:

rsync -av --rsync-path=/usr/local/bin/rsync sajt/ ivan@ВАШ_IP:/home/ivan/sajt/

Где лежит программа, покажет which rsync на сервере — команда which.

Если ssh не подключается

Код 255 значит, что ssh не смог войти на сервер. Проверьте вход отдельно, с теми же пользователем, адресом и портом:

ssh ivan@ВАШ_IP

Если ssh не входит, сначала исправьте его ошибку — она та же, что над строками rsync: ошибки SSH.

Если SSH на сервере работает не на 22 порту, укажите порт для rsync ключом -e, в кавычках:

rsync -av -e "ssh -p 2222" sajt/ ivan@ВАШ_IP:/home/ivan/sajt/

Вместо 2222 — ваш порт. Без кавычек rsync примет -p за свой ключ, а 2222 — за файл, который надо скопировать. Как указать ещё и ключ SSH — код 255.

Если связь оборвалась посреди копирования

Если в скобках не 0, а большое число байт, rsync успел передать часть файлов, а потом связь пропала. Что могло случиться:

Что видно вышеПричинаЧто делать
строка rsync: с числом (28) в концена диске, куда пишутся файлы, кончилось местоошибка 28
строка rsync: с другим текстомrsync на другой стороне завершился с ошибкойнайдите эту строку в таблице ошибок rsync
ничего или строка ssh об обрыве соединенияоборвалась сеть, компьютер уснул, закрыли окнозапустите команду ещё раз

Повторный запуск не копирует всё заново: rsync сравнит файлы и передаст только те, что не успел. Для больших файлов добавьте -P — тогда недокачанный файл не удаляется, и при повторе rsync использует уже переданную часть:

rsync -avP sajt/ ivan@ВАШ_IP:/home/ivan/sajt/

Если связь обрывается каждый раз после нескольких минут без вывода — включите проверку связи в ssh: обрыв SSH-сессии. Если rsync запускаете на сервере в SSH-сессии — например, копируете с сервера на сервер, — запускайте его внутри tmux: тогда обрыв вашей сессии не остановит копирование (tmux).

Ошибки и как их исправить

Что видитеПричинаЧто делать
connection unexpectedly closed (0 bytes received so far) и code 255ssh не подключилсяпроверьте ssh
то же и code 127 remote command not foundна сервере нет rsyncsudo apt install rsync на сервере
то же и code 12rsync на другой стороне завершилсястроки выше
protocol version mismatch -- is your shell clean?сервер выводит текст при входеразбор
connection unexpectedly closed с большим числом байтобрыв посреди копированияповторите команду, добавьте -P
выше ssh: Could not resolve hostname …ошибка в имени сервераразбор

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

Источники

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

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

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