Поиск
Ошибки

rsync: protocol version mismatch -- is your shell clean? — что делать

Название сбивает с толку: дело не в версиях rsync. При подключении rsync на сервере первым делом сообщает номер своей версии. Если при входе на сервер что-то выводит текст — приветствие из ~/.bashrc, например, — rsync получает этот текст вместо номера и останавливается.

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

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

  1. Проверьте, выводит ли сервер текст при входе: ssh ivan@ВАШ_IP /bin/true > out.dat.
  2. Если файл не пустой — найдите строку в ~/.bashrc на сервере, которая его выводит.
  3. Перенесите её ниже блока 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.dat
wc -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 не выполняется. Поэтому:

  1. Перенесите строку с echo ниже строки esac.
  2. Если блока в файле нет, оберните строку так — она будет работать, только когда вы сами вошли в терминал:
if [[ $- == *i* ]]; then
    echo "Добро пожаловать"
fi
  1. Сохраните файл и проверьте ещё раз: 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 пустой, ошибка остаётсяна сервере не тот rsyncssh … rsync --version
scp или команды по ssh тоже выводят лишний текстта же строка в ~/.bashrcкак исправить
connection unexpectedly closed и code 255ssh не подключилсякод 255

Тексты сообщений сверены по исходному коду rsync 3.2.7 — эта версия стоит в Ubuntu 24.04, начало ~/.bashrc — по файлам /etc/skel/.bashrc и /etc/bash.bashrc в Ubuntu 24.04.

Источники

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

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

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