Ошибка folder marker missing в Syncthing означает, что программа не находит служебную папку-маркер .stfolder внутри каталога синхронизации — и поэтому блокирует обмен файлами, чтобы случайно не записать данные не туда. Чаще всего проблема возникает после отключения внешнего диска, смены точки монтирования, переименования папки или её случайного удаления. Хорошая новость: сама по себе ошибка не удаляет ваши файлы, это защитный механизм.
Маркер .stfolder — это небольшой скрытый каталог, который Syncthing создаёт в корне каждой синхронизируемой папки. Он служит «якорем»: пока маркер на месте, программа уверена, что работает именно с тем каталогом, который вы указали в настройках. Если маркер пропал, Syncthing предполагает худшее — например, что диск не примонтирован, а путь указывает в пустое место на системном разделе.
Почему появляется ошибка folder marker missing
Причин несколько, и все они связаны с тем, что путь к папке остался прежним, а содержимое по этому пути изменилось. Определить конкретную причину важно до того, как что-либо исправлять — от этого зависит правильный способ решения.
- 🔌 Отключён внешний диск или флешка — Syncthing видит путь, но каталог фактически пуст, потому что том не смонтирован.
- 📁 Папка переименована или перемещена — вместе с ней «ушёл» и маркер, а по старому пути его нет.
- 🗑️ Случайное удаление — скрытая папка
.stfolderмогла быть удалена вручную или чистильщиком, который удаляет «пустые» скрытые каталоги. - 💽 Смена буквы диска в Windows — после подключения нового устройства буква тома изменилась, и старый путь ведёт в никуда.
- ⚙️ Проблемы с сетевым ресурсом — сетевая папка отвалилась до запуска Syncthing.
⚠️ Внимание: не нажимайте в панели Syncthing кнопки, предлагающие пересоздать или «исправить» папку, пока не убедитесь, что диск смонтирован и файлы на месте. Иначе программа может начать синхронизацию в пустой каталог и распространить удаления на другие устройства.
Как проверить, что именно произошло
Откройте веб-интерфейс Syncthing (обычно http://127.0.0.1:8384) и посмотрите на папку с ошибкой: рядом с её названием будет статус «Ошибка» или «Stopped» с текстом folder marker missing. Запомните точный путь, указанный в настройках папки.
Теперь откройте этот путь в файловом менеджере. Возможны три ситуации: путь существует и файлы на месте; путь существует, но папка пуста; пути вообще не существует. Первый случай самый простой — пропал только маркер. Второй и третий указывают на проблему с монтированием или перемещением данных.
На системах с командной строкой быстро проверить наличие маркера можно так:
ls -la /путь/к/папке/.stfolderЕсли команда возвращает «нет такого файла или каталога», маркер действительно отсутствует, и его нужно восстановить.
Способ 1: восстановить маркер .stfolder вручную
Если файлы на месте, а пропала только служебная папка, достаточно создать её заново. Маркер — это обычный пустой каталог с именем .stfolder в корне синхронизируемой папки. Никакого специального содержимого внутри не требуется.
В Windows создайте папку через проводник (имя .stfolder — с точкой в начале; если проводник не даёт, используйте командную строку). В Linux и macOS выполните:
mkdir /путь/к/папке/.stfolderПосле создания маркера вернитесь в веб-интерфейс Syncthing и нажмите «Возобновить» (Resume) для папки с ошибкой. Программа выполнит сканирование, сравнит локальное состояние с базой данных и продолжит синхронизацию.
☑️ Восстановление маркера .stfolder
⚠️ Внимание: если папка была пуста из-за непримонтированного диска, а вы создали маркер в пустом каталоге, Syncthing может решить, что все файлы удалены, и разослать удаления на другие устройства. Всегда сначала проверяйте содержимое каталога.
Способ 2: решить проблему с монтированием диска
Если папка находится на внешнем диске, сначала убедитесь, что он подключён и смонтирован до запуска Syncthing. В Windows проверьте букву диска в «Управлении дисками»: если она изменилась, либо верните прежнюю букву, либо обновите путь к папке в настройках Syncthing (папку придётся приостановить, изменить путь и возобновить).
В Linux надёжное решение — монтировать диск через /etc/fstab по UUID, а не по имени устройства вроде /dev/sdb1, которое может меняться между перезагрузками. Также полезно настроить автозапуск Syncthing после монтирования, а не сразу при входе в систему.
Способ 3: папка перемещена или переименована
Когда вы сознательно перенесли папку в другое место, правильный порядок действий такой: сначала приостановите папку в Syncthing, затем переместите данные, потом отредактируйте путь в настройках папки (иконка редактирования → поле «Путь к папке») и возобновите её. Маркер .stfolder переедет вместе с остальными файлами, так как это обычный каталог.
Если вы уже переместили папку, а ошибка появилась — просто укажите новый путь в настройках. Сканирование займёт время, но данные не пострадают, поскольку содержимое не менялось, изменилось только расположение.
Сравнение способов решения
| Ситуация | Действие | Риск потери данных |
|---|---|---|
| Пропал только маркер, файлы на месте | Создать пустой каталог .stfolder | Отсутствует |
| Диск не смонтирован | Подключить диск, проверить букву/точку монтирования | Отсутствует при правильном порядке |
| Папка переименована | Обновить путь в настройках Syncthing | Минимальный |
| Маркер создан в пустой папке по ошибке | Немедленно приостановить папку, вернуть данные | Высокий — возможна рассылка удалений |
Как предотвратить ошибку в будущем
Несколько простых мер заметно снижают вероятность повторения проблемы, особенно если синхронизируемые папки расположены на съёмных или сетевых носителях.
- 🧷 Исключите скрытые папки из чистильщиков — добавьте
.stfolderв исключения антивируса и программ очистки диска. - 🔡 Закрепите буквы дисков в Windows через «Управление дисками», чтобы они не менялись при подключении новых устройств.
- ⏱️ Настройте отложенный запуск Syncthing, чтобы диски успевали смонтироваться до старта программы.
- 🔄 Не переименовывайте папки «на лету» — сначала приостановите их в Syncthing, потом переименовывайте.
Что делать, если .stfolder создать не получается
Проверьте права доступа к папке — у пользователя, от имени которого работает Syncthing, должно быть право записи в корень каталога. В Linux выполните команду с нужными правами (например, через sudo, но затем верните владельца командой chown). В Windows проверьте, что папка не помечена как «только чтение» и не заблокирована политиками безопасности.
Частые вопросы
Удалятся ли мои файлы из-за ошибки folder marker missing?
Нет. Ошибка приостанавливает синхронизацию папки, но сами файлы остаются на диске. Риск появляется только если создать маркер в пустом каталоге и возобновить синхронизацию — тогда Syncthing может воспринять отсутствие файлов как удаление.
Можно ли просто удалить папку из Syncthing и добавить заново?
Можно, но это крайняя мера: программа заново просканирует все файлы и обменяется индексами с другими устройствами. Восстановление маркера .stfolder быстрее и безопаснее.
Почему папка .stfolder не видна в проводнике?
Имя начинается с точки, поэтому каталог считается скрытым. Включите отображение скрытых файлов в настройках файлового менеджера, чтобы увидеть его.
Ошибка появляется после каждой перезагрузки — что делать?
Скорее всего, Syncthing запускается раньше, чем монтируется диск с папкой. Настройте задержку автозапуска программы или привяжите старт службы к событию монтирования диска.
Чем .stfolder отличается от .stignore?
.stfolder — служебный маркер, подтверждающий корректность пути к папке. .stignore — текстовый файл с шаблонами исключений из синхронизации. Это разные механизмы, и удаление .stignore не вызывает ошибку маркера.