Двусторонняя синхронизация папки с Яндекс Диском
Держите папку на компьютере и папку на Яндекс Диске одинаковыми в обе стороны, а удаленные файлы сохраняются.
Работайте с файлами в своих программах, а на Яндекс Диске они обновятся сами. Зеркало держит папку на компьютере и папку на Диске одинаковыми в обе стороны. Правите файл в редакторе, и следующая синхронизация отправит его на Диск. Меняете его на Диске, с телефона или в браузере, и синхронизация скачает изменение. Удаленный файл попадает в корзину, а не пропадает, и версия, которую заменяет синхронизация, сохраняется, с любой стороны. Файл, измененный с обеих сторон, без вас не перезаписывается.
Зеркало пригодится, если вы работаете с файлами своими инструментами, например в редакторе, скриптом или через агента, и хотите, чтобы они были и на Диске, без приложения Яндекс Диска. Файлы остаются как есть: PDF остается PDF, заметка остается файлом Markdown.
На этой странице:
- Подключите папку
- Первая синхронизация
- Синхронизация каждый день
- Файл изменен с обеих сторон
- Удален или только пропал
- Куда попадают удаленные файлы
- Прежние версии файла
- Папку заменили
- Синхронизация в фоне
- Что может агент
- Что не синхронизируется
Подключите папку
Сначала укажите папку на Диске, потом папку на компьютере:
ydisk personal mirrors add /Notes ~/notesИнструмент проверяет, что обе папки существуют, и сохраняет пару. Пока он ничего не копирует. mirrors list
показывает ваши зеркала с их id. Команды на этой странице принимают id, когда зеркал больше одного.
Некоторые папки не синхронизируются никогда, потому что синхронизация отправила бы на Диск каждый файл в них: папки с
ключами и паролями, такие как ~/.ssh, ~/.gnupg и связки ключей, профили браузеров, папки приложений WireCat и любая
папка, где лежат собственные настройки или состояние ydisk. files upload отказывается от тех же мест.
Зеркало принадлежит аккаунту, в который был выполнен вход в профиле, когда вы его добавили. Синхронизация под другим аккаунтом отклоняется.
Первая синхронизация
ydisk personal mirrors preview
ydisk personal mirrors syncmirrors preview читает папку на Диске и показывает, что сделает синхронизация, ничего не меняя. mirrors sync --dry-run показывает разрешения, которые проверит синхронизация, без обращения к Диску.
При первой синхронизации:
- Файл, который есть только с одной стороны, копируется на другую.
- Файл с одинаковым содержимым с обеих сторон считается уже синхронизированным. Ничего не копируется.
- Файл с разным содержимым с двух сторон считается конфликтом. Ни одна копия не меняется, см. файл изменен с обеих сторон.
- Ничего не удаляется.
Синхронизация каждый день
Каждая синхронизация сравнивает каждый файл в трех видах: какой он здесь сейчас, какой он на Диске сейчас и каким был при прошлой синхронизации. Файл, измененный с одной стороны, копируется на другую. Файл, измененный с обеих сторон одинаково, остается как есть. Файлы сравниваются по хешу SHA-256, поэтому файл, у которого поменялась только дата, а содержимое то же, повторно не отправляется.
mirrors status показывает, какие локальные файлы следующая синхронизация отправит на Диск или удалит там. Он не
обращается к Диску, поэтому работает без интернета.
Файл изменен с обеих сторон
Если файл изменили и здесь, и на Диске после прошлой синхронизации, синхронизация не трогает обе копии и сообщает о
файле в conflicts, с временем и размером каждой стороны. Затем синхронизация завершается с ошибкой, чтобы скрипт это
заметил. Решите конфликты следующим запуском:
| Команда | Что происходит |
|---|---|
mirrors sync --keep local | Ваша копия заменяет копию на Диске. Копия с Диска сохраняется как прежняя версия. |
mirrors sync --keep disk | Копия с Диска заменяет вашу. Ваша сохраняется как прежняя версия. |
mirrors sync --keep both | Копия с Диска скачивается рядом с вашей как name (conflict 2026-11-19 disk).ext, и обе попадают на Диск. |
Файл, удаленный с одной стороны и измененный с другой, тоже считается конфликтом. --keep решает его так же.
Удален или только пропал
Синхронизация удаляет файл с одной стороны, только если может доказать, что вы удалили его с другой. Файл считается удаленным, только если выполнено все это:
- Прошлая синхронизация видела файл.
- Сторона, где его нет, прочитана полностью. Папка на Диске, которую токен не может прочитать, больше 10 000 файлов или Диск, который меняется во время чтения, оставляют список неполным. Если на Диске что-то поменялось во время чтения, список читается заново, до трех раз.
- Папка этой стороны осталась той же папкой: у папки на Диске тот же id, что и при первой синхронизации, а локальная папка существует, это та же папка и она не пуста. Пустая локальная папка может оказаться неподключенным диском.
Файл, который просто пропал по любой другой причине, попадает в unknown, и ничего для него не удаляется. Если папки
на Диске нет, зеркало останавливается с ошибкой целиком, и ничего не удаляется.
Синхронизация останавливается, ничего не меняя, если удалила бы больше 50 файлов или больше четверти файлов (начиная с
3 файлов). Проверьте список через mirrors preview, затем разрешите это число:
ydisk personal mirrors sync 1a2b3c4d --allow-deletions 60Файл, переименованный или перемещенный на Диске, переименовывается и здесь: Диск сохраняет id файла при перемещении. Файл, переименованный здесь, отправляется как новый, а старое имя уходит в корзину Диска.
Куда попадают удаленные файлы
| Где удален | Куда синхронизация переносит копию с другой стороны | Как вернуть |
|---|---|---|
| На вашем компьютере | В корзину Диска | ydisk personal files restore trash:/name.ext или корзина в веб-версии Диска |
| На Диске | В .wirecat-trash/YYYY-MM-DD/ внутри локальной папки | Переместите файл обратно, следующая синхронизация отправит его |
Диск отказывает в удалении, если его копия изменилась после того, как синхронизация прочитала список, поэтому файл, который кто-то только что правил, никогда не удаляется: о нем сообщается как о конфликте. Локальная папка корзины скрыта, поэтому она никогда не синхронизируется.
Прежние версии файла
Прежде чем заменить или удалить файл на вашем компьютере или заменить файл на Диске, синхронизация сохраняет его содержимое в папке состояния профиля, вне синхронизируемой папки. Старое содержимое с Диска сначала скачивается. Если сохранить его нельзя или оно изменилось после чтения списка, этот файл не заменяется. Файл, удаленный на Диске, лежит в корзине Диска. Синхронизация также записывает в журнал каждое изменение, которое делает, в обе стороны.
ydisk personal mirrors versions list 1a2b3c4d notes/plan.md
ydisk personal mirrors versions restore 1a2b3c4d notes/plan.md <sha256>versions list показывает каждое изменение, от старых к новым: когда, в какую сторону, хеш содержимого до (old) и
после (new) и с какой стороны пришло старое содержимое (from: local или remote для Диска). available
говорит, сохранено ли еще это содержимое. Если старое содержимое с Диска не сохранено, потому что файл ушел в корзину
Диска, old_in равен remote-trash: верните его из корзины Диска. versions restore возвращает сохраненную версию в
локальную папку, а файл, который лежит там сейчас, сначала сохраняется. Следующая синхронизация отправит
восстановленный файл на Диск.
Версия хранится 30 дней. Последняя версия удаленного файла хранится всегда. Версия с Диска тоже восстанавливается в локальную папку, и следующая синхронизация отправит ее обратно.
Папку заменили
Если папку на Диске удалили и создали заново или локальная папка теперь другая (новый диск, папка из резервной копии),
синхронизация останавливается с confirmation_required и называет --repin. Если новая папка правильная:
ydisk personal mirrors sync 1a2b3c4d --repinСинхронизация запоминает новую папку и проходит как первая: одинаковые файлы принимаются, файлы с одной стороны копируются, а разные файлы становятся конфликтами. Этот запуск ничего не удаляет.
Синхронизация в фоне
ydisk personal mirrors watchwatch синхронизирует при запуске, затем снова через несколько секунд после того, как вы сохранили файл, и когда
изменился Диск. Он спрашивает у Диска его ревизию каждые 60 секунд (--every, чтобы изменить, не меньше 10 s): это
один небольшой запрос, а папка читается заново, только если ревизия сдвинулась. Остановите его через Ctrl-C или задайте
--timeout.
Замена или удаление сначала запрашивает files.delete. watch, оставленный работать без терминала, не
сможет ответить, поэтому запускайте его с --yes или разрешите files.delete для профиля.
Что может агент
Каждая запись при синхронизации проверяет собственное разрешение команды, mirrors.sync или mirrors.watch, а также:
files.uploadдля каждого файла, который она кладет на Диск;files.deleteдля каждого файла, который она заменяет или переносит в корзину, с любой стороны. По умолчанию в терминале она спрашивает, один раз за запуск.
Если files.delete стоит в deny, синхронизация все равно отправляет и скачивает новые файлы и перечисляет в errors
каждую замену или удаление, которые пропустила. YDISK_READ_ONLY=1 запрещает синхронизацию, а mirrors preview и
mirrors status продолжают работать.
По MCP агент может запускать mirrors list, mirrors status, mirrors preview и mirrors sync, но не
--allow-deletions или --repin. По MCP никто не может ответить на вопрос, поэтому уровень ask пропускает запись:
поставьте files.delete в deny агенту, который не должен заменять или удалять файлы. Добавить или убрать зеркало,
versions и watch можете только вы. См. подключите агента.
Что не синхронизируется
- Скрытые файлы и папки (имя начинается с
.),node_modulesи остатки редакторов (~$name, имена, которые заканчиваются на~,.swpили.tmp), с обеих сторон. Такая папка на Диске даже не читается. - Символические ссылки. Файл внутри ссылки никогда не удаляется из-за нее.
- Зеркало больше чем из 10 000 файлов.
- Пустые папки.
mirrors remove <id> забывает пару. Ничего на Диске и в локальной папке не меняется, а сохраненные версии остаются.
Если добавить пару снова, она начнет с первой синхронизации.
Дальше: запросы, которые стоит попробовать.