Source: https://harnsy.dev/ru/docs/backups

> harnsy умеет хранить копии работы машины, возвращать копию и переносить всю машину на новый компьютер одним файлом. В любой редакции.

# Резервные копии и переезд на другую машину

harnsy умеет хранить копии работы машины, возвращать копию и переносить всю машину на новый компьютер одним файлом. В любой редакции.

**Что лежит в копии.** База данных машины: её команды, роли, задачи, заметки и сообщения, а также подключения и ключи, хранящиеся в harnsy, в запечатанном виде. Ещё файл настроек `config.yaml`, если он есть, и с «С файлами» — вложения и документы. Копия запечатана ключом этой машины, файлом `~/.harnsy/secret.key`; в саму копию он не входит.

**Два правила до начала.**

- Храните копию `secret.key` в другом месте и **не рядом с копиями**: без него ни одна копия этой машины не откроется, а тот, у кого есть и копия, и ключ, откроет их вместе с вашими ключами.
- Кладите копии на другой диск. Копия на том же диске пропадёт вместе с ним.

## Делать копии

1. Откройте дашборд на этой машине: Настройки › Резервные копии.
2. «Сделать сейчас» — копия сразу. В терминале: `harnsy backup now`.
3. Для копий по расписанию поставьте «Делать копию» на «Каждый день» или «Каждую неделю» (по понедельникам) и выберите время. Пока вы их не включите, копий по расписанию нет.
4. «Хранить» — сколько копий по расписанию остаётся (по умолчанию 7). Копий других видов harnsy хранит по 3 и удаляет только свои файлы.
5. «Папка» — куда ложатся копии. Выберите папку на другом диске.

Две копии делаются без вашей просьбы: перед тем как `harnsy update` заменит программу (даже если копии по расписанию выключены) и перед восстановлением. Копия по расписанию, пропущенная, пока компьютер был выключен, делается через 10 минут после старта harnsy. Колокольчик скажет, если копия не получилась и если последняя удачная устаревает.

## Вернуть копию

Только вы и только на этой машине. harnsy устроен так, чтобы отказать в восстановлении, если его просит агент: ничего не меняется, а у вас звенит колокольчик. (Агент работает с правами вашей учётной записи, поэтому это защита команды harnsy, а не файлов на диске.)

1. Настройки › Резервные копии: откройте меню копии и нажмите «Восстановить…». Окно скажет, что будет: машина перезапустится вместе с агентами (их места останутся), текущая база сохранится рядом, а всё, что было после времени копии, пропадёт.
2. Введите слово **восстановить** и нажмите «Восстановить».

В терминале: `harnsy backup restore &lt;имя&gt; --restart` (имена покажет `harnsy backup list`). С `--config` вернётся и `config.yaml`.

Прежде чем что-то менять, harnsy проверяет копию: она этой машины, она не от более новой версии harnsy, ключ на месте и каждая часть совпадает. Если проверка не прошла, ничего не меняется. Потом harnsy делает копию «перед восстановлением» и подменяет базу. То, что принадлежит машине, остаётся: её входы снаружи, passkey и токены кластера. Колокольчик перечислит доступы снаружи, которые ещё живы в восстановленной копии (участник кластера, пропуск сервиса, ссылка-приглашение), у каждого — «Отозвать».

## Переехать на другую машину

Один файл несёт всю машину: команды, задачи, подключения и ключи. Он запечатан паролем, который выбираете вы.

**На старой машине**

1. Настройки › Резервные копии › «Перенести на другую машину».
2. Выберите пароль от 12 знаков. Кто знает пароль, открывает всё в файле, и восстановить пароль нельзя. Обращайтесь с файлом как с самим паролем: не пересылайте его по почте или в чате и удалите, когда переезд закончен.
3. Отметьте, что взять:
   - «С файлами»: вложения и документы. Без них на новой машине они не откроются.
   - «С папками проектов»: проект, вся работа которого отправлена в его git-remote, на новой машине клонируется заново; любой другой едет внутри файла (его файлы без того, что исключает `.gitignore`, и его `.git`; `node_modules` — никогда).
4. Скачайте файл и нажмите «Усыпить все команды», чтобы агенты не работали в двух местах.

В терминале: `harnsy backup transfer --out &lt;файл&gt; [--with-files] [--with-projects]`.

**На новой машине**

1. Установите harnsy и откройте дашборд: Настройки › Резервные копии › «Перенести сюда».
2. Выберите файл и введите пароль. После пяти неверных попыток за 10 минут придётся подождать.
3. В «Куда разложить» проверьте папку каждого проекта и нажмите «Перенести».
4. «Осталось сделать» покажет, что ещё за вами: войти в Claude Code (или Codex) на этой машине, добавить ключ harnsy Max и повторить проект, который не удалось клонировать.

Теперь новая машина — это старая: те же команды, задачи и подключения. Имя и кластер у неё — нового компьютера. Агенты начинают новые сессии со своего поста, задач и записок о передаче дел. Введите заново лицензию и настройки сертификата шлюза. Телефоны и ноутбуки, привязанные к старой машине, к новой не привязаны: привяжите их снова (Настройки › Связь снаружи › Дашборд с телефона и ноутбука › «Создать код»); если адрес сменился, создайте и passkey заново: passkey принадлежит имени, на котором создан. Если у вас есть ключ harnsy Max, освободите в нём место старой машины: на старой машине Настройки › Лицензия и защита › «Удалить ключ» или `harnsy license deactivate` в терминале (ключ останется). Машина, которой уже нет, освобождает место сама через 30 дней после последней проверки. Потом выключите старую машину. На ней по-прежнему всё лежит: удалите её `~/.harnsy`, когда она больше не нужна.

## Если что-то не так

| Что вы видите | Обычно |
| --- | --- |
| «Копия другого узла» | обычная копия открывается только на своей машине: скачайте на старой машине копию для переноса |
| «Копия новее этого harnsy» | сначала обновите harnsy |
| «Ключа узла для этой копии нет» | `secret.key` той машины здесь нет: верните сохранённую копию ключа |
| «Сначала остановите узел» | восстанавливайте из терминала с `--restart` |
| «Папка копий небезопасна» | в папку могут писать другие пользователи: выберите другую или закройте её для них |
| «Слишком много попыток» | подождите 10 минут |

[Что это умеет →](https://harnsy.dev/ru/features/export-import)

[Есть вопросы? Спросите в группе →](https://t.me/+Cs5Mimdes5UwOGVi)

Anthropic, Claude Code, OpenAI, ChatGPT, Codex, OpenCode, pi, Telegram, Discord, GitHub, Apple, macOS, iOS, iPhone, Safari, Google, Android, Chrome, Microsoft, Windows, Windows Security, Defender и QR Code — названия продуктов их владельцев. harnsy не связан с ними и не одобрен ими. iOS — товарный знак Cisco, используемый Apple по лицензии; QR Code — зарегистрированный товарный знак DENSO WAVE INCORPORATED. Логотипов нет.
