rsync: protocol version mismatch -- is your shell clean? — что делать
Название сбивает с толку: дело не в версиях rsync. При подключении rsync на сервере первым делом сообщает номер своей версии. Если при входе на сервер что-то выводит текст — приветствие из ~/.bashrc, например, — rsync получает этот текст вместо номера и останавливается.
Содержание 9
Что сделать прямо сейчас
- Проверьте, выводит ли сервер текст при входе:
ssh ivan@ВАШ_IP /bin/true > out.dat. - Если файл не пустой — найдите строку в ~/.bashrc на сервере, которая его выводит.
- Перенесите её ниже блока
case $- inи запустите rsync снова.
Как выглядит ошибка
protocol version mismatch -- is your shell clean?
(see the rsync manpage for an explanation)
rsync error: protocol incompatibility (code 2) at compat.c(…) [sender=3.2.7]Первая строка — «версии протокола не совпадают — ваша оболочка чистая?». Вторая отправляет в справку rsync. Третья — итог с кодом 2.
В справке rsync, в разделе DIAGNOSTICS, сказано: эту ошибку вызывают файлы, которые оболочка сервера читает при входе, — они выводят лишний текст в канал, по которому rsync обменивается данными. «Оболочка чистая» — значит, при входе для команды ничего не выводится.
Как проверить
На своём компьютере выполните — вместо ivan и ВАШ_IP ваши пользователь и адрес сервера:
ssh ivan@ВАШ_IP /bin/trueКоманда /bin/true ничего не выводит. Если после неё на экране появился текст — это он мешает rsync. Чтобы увидеть точно, что приходит в канал rsync, сохраните вывод в файл, как советует справка:
ssh ivan@ВАШ_IP /bin/true > out.datwc -c out.datПервое число — размер файла в байтах. 0 — оболочка чистая, причина в другом: см. ниже. Больше 0 — посмотрите, что в файле:
cat out.datЭто и есть лишний текст. Файл после проверки удалите: rm out.dat.
Предупреждения ssh — например, о новом ключе сервера — в файл не попадают: ssh выводит их в отдельный поток, и rsync они не мешают.
Где искать лишний текст
Когда ssh выполняет команду, на Ubuntu оболочка bash читает файл ~/.bashrc в домашней папке пользователя на сервере. Подключитесь к серверу и откройте его:
nano ~/.bashrcИщите строки, которые печатают текст: echo, printf, запуск программ, которые что-то показывают при входе. Если вы входите под root, файл — /root/.bashrc. Как работать в nano — редактор nano.
Как исправить
В начале ~/.bashrc в Ubuntu есть блок, который останавливает чтение файла, когда команда пришла не от человека в терминале — как от rsync или scp:
case $- in
*i*) ;;
*) return;;
esacВсё, что ниже этого блока, при работе rsync не выполняется. Поэтому:
- Перенесите строку с
echoниже строкиesac. - Если блока в файле нет, оберните строку так — она будет работать, только когда вы сами вошли в терминал:
if [[ $- == *i* ]]; then
echo "Добро пожаловать"
fi- Сохраните файл и проверьте ещё раз:
ssh ivan@ВАШ_IP /bin/true > out.datиwc -c out.dat— должно быть 0.
Строки в ~/.bashrc выше блока case выполняются и для rsync. Так же ведёт себя общий файл /etc/bash.bashrc: в Ubuntu он останавливается на строке [ -z "$PS1" ] && return, и всё, что выше неё, выводится и для rsync.
Если файл пустой
Если out.dat пустой, а ошибка остаётся, проверьте rsync на сервере:
ssh ivan@ВАШ_IP rsync --versionВ Ubuntu 24.04 ответ начинается с rsync version 3.2.7 protocol version 31. Если пишет, что команды нет, — установите rsync на сервер. Если путь к rsync указан ключом --rsync-path, проверьте, что по этому пути лежит именно rsync.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
protocol version mismatch -- is your shell clean? | сервер выводит текст при входе | проверьте /bin/true > out.dat |
code 2 protocol incompatibility | то же | перенесите строку ниже esac |
| out.dat пустой, ошибка остаётся | на сервере не тот rsync | ssh … rsync --version |
| scp или команды по ssh тоже выводят лишний текст | та же строка в ~/.bashrc | как исправить |
connection unexpectedly closed и code 255 | ssh не подключился | код 255 |
Тексты сообщений сверены по исходному коду rsync 3.2.7 — эта версия стоит в Ubuntu 24.04, начало ~/.bashrc — по файлам /etc/skel/.bashrc и /etc/bash.bashrc в Ubuntu 24.04.
Источники
- Исходный код rsync 3.2.7 — на английском: сообщение protocol version mismatch в compat.c.
- Справка rsync для Ubuntu 24.04 — на английском: раздел DIAGNOSTICS с проверкой ssh remotehost /bin/true > out.dat.
- Пакет bash в Ubuntu 24.04 — в нём файлы /etc/skel/.bashrc и /etc/bash.bashrc.
Сверено 13 ноября 2026 года.
Что почитать дальше
- connection unexpectedly closedкогда rsync теряет связь с сервером.
- Редактор nanoкак открыть, поправить и сохранить файл на сервере.
- Ошибки rsyncвсе ошибки rsync на одной странице.