rsync error: syntax or usage error (code 1) — ошибка в команде
Код 1 значит, что rsync не понял команду и ничего не скопировал. Причина — в строке выше итоговой: неизвестный ключ, лишний пробел, путь не на своём месте. Найдите эту строку в таблице ниже — там сказано, что поправить в команде.
Содержание 12
Что сделать прямо сейчас
- Прочитайте строку над
rsync error: syntax or usage errorи найдите её в таблице. - Проверьте ключи:
rsync --helpпокажет все ключи, которые знает ваш rsync. - Возьмите в кавычки пути с пробелами и значение ключа
-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 optionon 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.
Источники
- Исходный код rsync 3.2.7 — на английском: проверки аргументов в main.c, сообщение unknown option в options.c.
- Справка rsync для Ubuntu 24.04 — на английском: ключи -e, --dry-run, --mkpath и --old-args, источник без назначения.
- Пакет rsync в Ubuntu 24.04 — версия rsync в Ubuntu 24.04.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Команда rsyncкак правильно записать команду и ключи.
- Код 255 в rsyncкак указать порт и ключ SSH.
- Ошибки rsyncвсе ошибки rsync на одной странице.