Поиск
Ошибки

rsync error: syntax or usage error (code 1) — ошибка в команде

Код 1 значит, что rsync не понял команду и ничего не скопировал. Причина — в строке выше итоговой: неизвестный ключ, лишний пробел, путь не на своём месте. Найдите эту строку в таблице ниже — там сказано, что поправить в команде.

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

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

  1. Прочитайте строку над rsync error: syntax or usage error и найдите её в таблице.
  2. Проверьте ключи: rsync --help покажет все ключи, которые знает ваш rsync.
  3. Возьмите в кавычки пути с пробелами и значение ключа -e.

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

rsync: --dryrun: unknown option
rsync error: syntax or usage error (code 1) at main.c(…) [client=3.2.7]

Первая строка — причина: «--dryrun: неизвестный ключ». Вторая — итог: «ошибка в записи или использовании», код 1. [client=3.2.7] — ошибку нашёл rsync на вашем компьютере; если вместо этого [server=…], ошибку нашёл rsync на сервере.

Что написано строкой выше

Строка над итогомЧто не такЧто поправить
rsync: --ключ: unknown optionтакого ключа нет — опечатка или ключ из другой программысверьте с rsync --help: например, правильно --dry-run или -n, а не --dryrun
rsync: on remote machine: --ключ: unknown optionключ знает ваш rsync, но не знает rsync на сервереключ и rsync на сервере
ERROR: destination path is not a directoryкопируете несколько файлов или путь назначения кончается на /, а по этому пути лежит файлукажите папку, а не файл
Empty destination arg specified (use "." or see --old-args).путь назначения пустой — например, пустая переменная в кавычках "$PAPKA"проверьте переменную
The source and destination cannot both be remote.и откуда, и куда — на серверахкопирование с сервера на сервер
Unexpected local arg: … и подсказка про двоеточиеисточник на сервере, а следом — путь без ivan@ВАШ_IP:, например, из-за пробела без кавычеквозьмите путь в кавычки или допишите к нему :
Unexpected remote arg: …среди источников и путь на компьютере, и путь на серверекопируйте за один раз только с компьютера или только с сервера

Если ключ не знает rsync на сервере

rsync: on remote machine: --mkpath: unknown option

on remote machine — «на удалённой машине»: ваш rsync передал ключ rsync на сервере, а тот его не знает. Так бывает, если на сервере rsync старее, чем у вас. Проверьте версию:

ssh ivan@ВАШ_IP rsync --version

В Ubuntu 24.04 ответ начинается с rsync version 3.2.7 protocol version 31, и --mkpath эта версия знает. Что сделать:

  • обновите rsync на сервере: sudo apt update, затем sudo apt install rsync;
  • или обойдитесь без этого ключа: вместо --mkpath создайте папку заранее — ssh ivan@ВАШ_IP mkdir -p /home/ivan/backup (подробнее).

Если ошибка в -e

Ключ -e задаёт, как подключаться к серверу. Порт и другие ключи ssh пишутся вместе с ним в кавычках:

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

Без кавычек — -e ssh -p 2222 — rsync возьмёт для -e только ssh, -p примет за свой ключ (сохранять права), а 2222 — за файл, который надо скопировать. Тогда подключение пойдёт на порт 22, а rsync будет искать у вас файл 2222. Подробнее о порте и ключе — код 255.

Если путь в переменной

В скрипте путь бывает записан в переменной: rsync -av sajt/ "$PAPKA". Если переменная пустая, rsync получит пустой путь назначения. Проверьте её перед запуском:

echo "$PAPKA"

Если ответ — пустая строка, переменная не задана или задана в другом месте скрипта. Как устроена команда echo — echo.

Если копируете с сервера на сервер

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

rsync -av /var/www/example.com/ ivan@203.0.113.20:/var/www/example.com/

Вместо 203.0.113.20 — адрес второго сервера. С первого сервера на второй тоже нужен вход по SSH — как подключиться по SSH. Долгое копирование запускайте в tmux.

Если rsync ничего не скопировал и не написал ошибку

Если в команде только один путь — источник без назначения, — rsync не копирует, а показывает список файлов, как ls. Код выхода — 0. Допишите путь, куда копировать.

Если rsync на Mac

На Mac команда rsync — это openrsync. Неизвестный ключ он тоже не принимает: пишет об этом, показывает строку usage: со списком ключей и завершается с кодом 1. Ключа --mkpath openrsync не знает.

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

Что видитеПричинаЧто делать
unknown option и code 1опечатка в ключеrsync --help
on remote machine: … unknown optionстарый rsync на сервереобновите или уберите ключ
ERROR: destination path is not a directoryназначение — файлукажите папку
Empty destination arg specifiedпустой путь назначенияecho "$PAPKA"
The source and destination cannot both be remote.два удалённых путизапустите rsync на одном из серверов
Unexpected local arg: …пробел в пути без кавычеквозьмите путь в кавычки
ошибка про файл 2222 или подключение на порт 22-e ssh -p 2222 без кавычек-e "ssh -p 2222"

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

Источники

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

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

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