rsync: link_stat "…" failed (2) и change_dir "…" failed — что делать
Число (2) в конце строки значит, что файла или папки по этому пути нет. rsync копирует то, что нашёл, а в конце пишет код 23. Ниже — как найти ошибку в пути и что делать, если нет папки, куда копируете.
Содержание 8
Что сделать прямо сейчас
- Скопируйте путь из кавычек в сообщении и проверьте его командой
ls -ld— на компьютере или на сервере. - Если пути нет — найдите, что в нём не так: причины.
- Если сообщение
mkdir "…" failed— создайте папку назначения.
Как выглядит ошибка
rsync: [sender] link_stat "/home/ivan/sajt" failed: … (2)
rsync error: some files/attrs were not transferred (see previous errors) (code 23) at main.c(…) [sender=3.2.7]или
rsync: [sender] change_dir "/home/ivan/sajt" failed: … (2)Вместо многоточия — короткий текст ошибки системы на английском, а (2) — её номер: нет такого файла или папки.
| Сообщение | Чего нет |
|---|---|
link_stat "…" failed | того, что вы копируете: последнего имени в пути |
change_dir "…" failed | папки, в которой оно лежит, — или самой папки, если путь кончается на / |
Например, папки /home/ivan/sajt нет. Команда rsync -av /home/ivan/sajt ... выдаст link_stat, а rsync -av /home/ivan/sajt/ ... — change_dir. Причина одна: пути нет.
Путь в кавычках rsync показывает полный: если вы написали путь без / в начале, он допишет к нему текущую папку.
Почему rsync не находит путь
| Что не так | Пример | Что сделать |
|---|---|---|
| опечатка в имени | /var/www/exmaple.com | посмотрите, как называется папка: ls /var/www/ |
путь без / в начале считается от текущей папки | rsync -av sajt/ … запущен не из той папки | узнайте текущую папку командой pwd или пишите полный путь |
знак ~ в кавычках | "~/sajt/" — в сообщении будет путь со знаком ~ внутри | пишите ~/sajt/ без кавычек или "$HOME/sajt/" |
| пробел в имени без кавычек | /home/ivan/Мой сайт/ | возьмите путь в кавычки: "/home/ivan/Мой сайт/" |
| путь на сервере написан как путь на компьютере | забыли ivan@ВАШ_IP: перед путём | путь на сервере пишется с ivan@ВАШ_IP: впереди |
| регистр букв | Sajt и sajt в Linux — разные папки | сверьте имя командой ls |
Путь на сервере без / в начале считается от домашней папки пользователя: ivan@ВАШ_IP:sajt/ — это /home/ivan/sajt/.
Как проверить путь
Если путь в сообщении — путь на вашем компьютере:
ls -ld /home/ivan/sajtЕсли это путь на сервере — тот, что в команде стоит после ivan@ВАШ_IP:, — проверьте его на сервере той же командой через ssh:
ssh ivan@ВАШ_IP ls -ld /var/www/example.comЕсли папка есть, ls покажет строку, которая начинается с d. Если нет — сообщение об ошибке; тогда проверьте папку уровнем выше, например ls /var/www/, и найдите правильное имя. Подробнее о путях и команде ls — команды Linux.
Если нет папки, куда копируете
rsync сам создаёт последнюю папку в пути назначения, но не папки выше неё. Если их нет, rsync останавливается:
rsync: [Receiver] mkdir "/home/ivan/backup/site" failed: … (2)
rsync error: error in file IO (code 11) at main.c(…) [Receiver=3.2.7]Здесь rsync не смог создать site, потому что нет папки /home/ivan/backup. Ниже могут быть ещё строки — это следствие. Что сделать:
Создайте папки на сервере — -p создаёт все папки пути сразу:
ssh ivan@ВАШ_IP mkdir -p /home/ivan/backupИли добавьте ключ --mkpath — rsync сам создаст недостающие папки:
rsync -av --mkpath sajt/ ivan@ВАШ_IP:/home/ivan/backup/site/Ключ --mkpath есть в rsync 3.2.7 из Ubuntu 24.04. Если на сервере rsync старее и не знает этот ключ, будет unknown option — тогда создайте папки командой mkdir. openrsync на Mac --mkpath тоже не знает.
Если копируете с сервера на свой компьютер, создайте папку у себя: mkdir -p ~/backup.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
link_stat "…" failed: … (2) | нет файла или папки, которую копируете | проверьте путь |
change_dir "…" failed: … (2) | нет папки из пути | проверьте путь |
в пути из сообщения есть ~ | ~ был в кавычках | ~ без кавычек или $HOME |
| в пути из сообщения лишняя папка спереди | путь без / в начале | полный путь или pwd |
mkdir "…" failed: … (2) и code 11 | нет папки выше папки назначения | mkdir -p или --mkpath |
Тексты сообщений сверены по исходному коду rsync 3.2.7 — эта версия стоит в Ubuntu 24.04.
Источники
- Исходный код rsync 3.2.7 — на английском: сообщения link_stat и change_dir в flist.c, mkdir папки назначения в main.c.
- Справка rsync для Ubuntu 24.04 — на английском: ключ --mkpath и раздел EXIT VALUES.
- Пакет rsync в Ubuntu 24.04 — версия rsync в Ubuntu 24.04.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Код 23 в rsyncкак найти строку с причиной.
- Команда rsyncчто меняет
/в конце пути. - Ошибки rsyncвсе ошибки rsync на одной странице.