Частые проблемы
На этой странице собраны самые частые сообщения и проблемы. Каждый заголовок повторяет то, что пишет Frost, или то, что вы замечаете.
#«Frost isn't set up yet, run frost init»
Frost не находит config.toml. Выполните frost init. Если вы используете --config-dir или FROST_CONFIG_DIR, проверьте, что они указывают на нужную папку.
#«no key on this machine»
Файла ключа нет. Если на этом компьютере хранилище уже настроено, выполните frost key import и введите фразу восстановления. Иначе выполните frost init.
#«a backup or restore operation is already in progress»
Ваши копии использует другой процесс Frost, обычно копирование по расписанию. В этом случае Frost сообщает "a scheduled backup is already running" и когда оно началось. Дождитесь его завершения и попробуйте снова. Удаление файла блокировки Frost не остановит другой процесс.
#«the local encryption key does not match»
В хранилище лежат копии, сделанные другим ключом. Выполните frost key verify и введите записанную фразу, чтобы понять, какой это ключ. Если ключ тот, что нужен, выполните с ним frost key import.
#Frost не находит копии
Сообщения вроде «has no Frost repository» значат, что копий нет там, где их ищет Frost. В ошибке указано, где их открывали в последний раз и как к ним вернуться. Подробнее в разделе Перенос резервных копий.
Если копии пропали из Permafrost, а ключ доступа по-прежнему работает, скорее всего, их удалили с помощью этого ключа. Сразу напишите на [email protected]. Если ваш ключ может быть у кого-то ещё, получите новый на getfro.st/perma/recover.
#Мастер не может подключиться
Мастер объясняет проблему и возвращает вас к ответу, который скорее всего в ней виноват.
| Сообщение мастера | Что проверить |
|---|---|
| Access key ID not recognized | Что вы скопировали идентификатор ключа доступа целиком |
| The secret key does not match the access key ID | Что вы скопировали секретный ключ целиком и что он относится к этому идентификатору |
| No bucket found with that name | Имя бакета, или сначала создайте бакет |
| The provided key lacks necessary bucket permissions | Что ключ может читать, перечислять, записывать и удалять объекты в бакете |
| The bucket is located in a different region | Регион или эндпоинт |
| Cannot resolve ... | Адрес и подключение к интернету |
| No response from that address | Адрес и порт |
| The server's TLS certificate is not valid for that address | Адрес и то, что сертификат сервера к нему подходит |
| the storage host timed out | Подключение к интернету, затем попробуйте снова |
| cannot reach Permafrost | Подключение к интернету, затем попробуйте снова |
| Cannot locate the server | SSH-адрес и вашу сеть |
| The server did not respond | SSH-адрес и то, что сервер включён |
| That server does not support SFTP | Включён ли SFTP в настройках SSH или файловых служб сервера |
| server returned text before opening SFTP subsystem | Не выводит ли что-нибудь сценарий входа на сервере, например .bashrc. Пусть он выводит текст только в интерактивных оболочках |
| There's no folder ... on ... | Путь к папке. Папка, в которой она лежит, должна существовать |
| The server denied write access to that folder | Права на папку для учётной записи, под которой входит Frost |
| ... not found. Connect the required drive and try again | Подключён ли диск и верен ли путь |
| Unable to write to that folder | Права на папку. В macOS смотрите раздел Разрешения macOS |
| Symbolic links and directory junctions are not supported for backup folders | Используйте настоящий путь к папке |
| That drive is read-only | Используйте диск, на который можно записывать |
#«This storage provider does not support conditional writes»
Ваше хранилище не поддерживает функцию, без которой Frost не может уберечь компьютеры от перезаписи служебных записей копий друг друга. Другие ключи или настройки не помогут. Выберите другое хранилище. Подробнее в разделе Выбор хранилища.
Собственный сервер или диск сообщает об этом иначе. Сервер «cannot create hard links», или папка находится «on an unsupported filesystem». Используйте папку на файловой системе вроде ext4, Btrfs, XFS, ZFS, APFS или NTFS.
#«the server didn't accept Frost's SSH key»
Ваш собственный сервер отверг ключ Frost, например после того, как ключ удалили из authorized_keys. Выполните frost init и добавьте ключ снова. Подробнее в разделе Собственный сервер.
#«the server's SSH host key has changed»
Frost отказывается подключаться, когда меняется идентичность сервера, так же как ssh. Если вы переустановили сервер или у него новый адрес, удалите его старый ключ командой ssh-keygen -R <host> и снова выполните frost init. В остальных случаях сначала выясните, почему ключ изменился, и только потом подключайтесь.
#«... not found. Connect the required drive and try again»
Ваши копии лежат на диске, который не подключён, или изменился путь к папке. Подключите диск. Если Windows назначила ему другую букву, смотрите раздел Локальный диск.
#«the Permafrost access key was rejected»
Дальше в сообщении идёт причина от Permafrost: ключ неверный, его заменил более новый ключ или учётная запись закрыта. Используйте самый новый ключ или получите новый. Подробнее в разделе Permafrost.
#«uploads are paused»
Permafrost сейчас не принимает новые резервные копии для вашей учётной записи. В сообщении сказано, почему и до какого срока, а восстановление продолжает работать. Подробнее в разделе Permafrost.
#Копия не может прочитать папку
В macOS дело обычно в разрешениях конфиденциальности. В ошибке сказано, что нужно разрешить. Подробнее в разделе Разрешения macOS. В других системах проверьте, что у вашего пользователя есть право читать папку.
#Файлы с пометкой «couldn't be read»
Frost пропустил эти файлы и сохранил остальное. Обычные причины: нет прав на чтение, файлы удалили во время копирования, а в macOS ещё и файлы, которые iCloud хранит только в облаке.
#Файлы, которые «continued changing while being read»
Во время копирования какая-то программа писала в эти файлы, поэтому снимок сохранил их прежнюю копию. Закройте программу и сделайте копию снова или дождитесь следующей копии.
#Папка помечена «not found»
Папки из списка не оказалось на месте, поэтому Frost скопировал остальное. Снова подключите диск или, если папка переехала, обновите список через frost init.
#«config.toml changed, but updating the scheduled job failed»
Вы отредактировали config.toml, но Frost не смог обновить задание по расписанию под новые настройки. Причина указана в остальной части сообщения. Если там названа настройка, исправьте её в config.toml. Frost пробует снова при каждой команде, пока не получится.
#«config.toml changed where backups go»
Вы изменили в config.toml, куда сохраняются копии, и Frost нашёл проблему с новым местом, когда впервые его использовал. Какую, сказано в остальной части сообщения. Подробнее в разделе Перенос резервных копий.
#«scheduled job is missing»
Задание по расписанию удалили или выключили. Верните его командой frost config set schedule.enabled true.
#Копирование по расписанию не запускается
- Посмотрите строку «next backup» в
frost status. - В macOS проверьте переключатель Frost в разделе «Системные настройки > Основные > Объекты входа и расширения» (System Settings > General > Login Items & Extensions). Он называется Node.js Foundation.
- В Windows для копирования по расписанию нужно войти в систему. При работе от батареи оно не запускается.
- Если
schedule.catch_upравноfalse, копия, назначенная на время, когда компьютер был выключен или спал, пропускается. - Загляните в журнал. Подробнее в разделе Автоматическое резервное копирование.
#«verification failed»
Выборочная проверка нашла в хранилище недостающие или повреждённые данные. Подробнее в разделе Проверка резервных копий.
#«cannot restore alongside original files»
Папку рядом с оригиналами использовать нельзя, часто потому, что снимок сделан на другом компьютере. Используйте вместо этого --to <dir>. Подробнее в разделе Восстановление файлов.
#«cannot overwrite original files»
Снимок сделан на компьютере другого типа, или путь к оригиналам проходит через ссылку, которой Frost не доверяет. Используйте вместо этого --beside или --to <dir>.
#При восстановлении появляется сообщение «changed after it was checked» или «has more than one link»
Frost обнаружил, что уже проверенный файл изменился или что у файла, восстановление которого ещё не завершено, есть жёсткая ссылка с другим именем. Закройте программы, которые изменяют папку восстановления, и попробуйте снова. Если у файла, восстановление которого ещё не завершено, есть жёсткая ссылка, восстановите файлы в новую пустую папку.
#Frost не находит нужный снимок
| Что пишет Frost | Что попробовать |
|---|---|
| no snapshot at or before ... | Более позднее время. В сообщении указан самый старый снимок |
| "maple" matches 2 snapshots; provide additional ID characters | Больше символов идентификатора, например maple-absurd |
| cannot parse "..." as a snapshot ID or timestamp | Кавычки вокруг времени с пробелами, например "3 days ago" |
#Frost не может обновиться сам
В папку Frost нельзя писать, или Frost собран из исходного кода. Подробнее в разделе Обновление Frost.
#Установщик останавливается
| Что пишет установщик | Что сделать |
|---|---|
| need OpenSSH 8.1+ to verify the Frost release signature | Установите или обновите OpenSSH. В Windows воспользуйтесь установщиком для PowerShell |
| checksums.txt signature does not match official Frost release key; installation aborted | Не устанавливайте. Попробуйте позже и сообщите о проблеме, если она повторяется |
| runtime inside ... lacks valid OpenJS Foundation signature; installation aborted | Не устанавливайте. Попробуйте позже и сообщите о проблеме, если она повторяется |
| checksum mismatch | Загрузка повреждена. Запустите установщик снова |
| 32-bit ARM isn't supported by the bundled runtime | Для этого компьютера пакета Frost нет |
| installing Frost requires Node.js v22 or newer | Обновите Node.js или используйте установщик вместо npm и pnpm |
#После установки frost не находится
Откройте новый терминал. Терминалы, которые были открыты во время установки Frost, не видят новый PATH. Если вы пользуетесь pnpm, один раз выполните pnpm setup, а затем откройте новый терминал.