rsync: connection unexpectedly closed (0 bytes received so far) — что делать
rsync работает через SSH: на вашем компьютере запускается ssh, а на сервере — второй rsync, который принимает или отдаёт файлы. Сообщение connection unexpectedly closed значит, что связь между ними пропала. Причину подсказывает код в последней строке: 255 — ssh не подключился, 127 — на сервере нет rsync.
Содержание 9
Что сделать прямо сейчас
- Посмотрите код в последней строке
rsync error: … (code …)и найдите его в таблице. - Посмотрите строки выше: если там есть строка от ssh — она начинается с
ssh:или кончается на(publickey)., — ssh не подключился. - Проверьте вход без 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 error | ssh не подключился к серверу или его соединение оборвалось | проверьте ssh, подробно — код 255 |
127 remote command not found | на сервере нет программы rsync | установите rsync на сервер |
12 error in rsync protocol data stream | rsync на другой стороне завершился или связь закрылась без ошибки ssh | посмотрите строки выше |
2 protocol incompatibility | сервер при входе выводит текст, и он мешает rsync | protocol 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 updatesudo 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 255 | ssh не подключился | проверьте ssh |
то же и code 127 remote command not found | на сервере нет rsync | sudo apt install rsync на сервере |
то же и code 12 | rsync на другой стороне завершился | строки выше |
protocol version mismatch -- is your shell clean? | сервер выводит текст при входе | разбор |
connection unexpectedly closed с большим числом байт | обрыв посреди копирования | повторите команду, добавьте -P |
выше ssh: Could not resolve hostname … | ошибка в имени сервера | разбор |
Тексты сообщений и коды сверены по исходному коду rsync 3.2.7 — эта версия стоит в Ubuntu 24.04.
Источники
- Исходный код rsync 3.2.7 — на английском: сообщение об обрыве связи в io.c, тексты кодов в log.c, код выхода ssh в cleanup.c.
- Справка rsync для Ubuntu 24.04 — на английском: раздел EXIT VALUES, ключи -e, --rsync-path и --partial.
- Пакет rsync в Ubuntu 24.04 — версия rsync в Ubuntu 24.04.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Код 255 в rsyncкогда ssh не пускает rsync на сервер.
- Команда rsyncкак копировать файлы на сервер и обратно.
- Ошибки rsyncвсе ошибки rsync на одной странице.