Внешние копии и восстановление¶
После перестройки внешние копии ждут
Когда аварийный мастер или Найти резервные копии перестраивают записи без прежних настроек, внешние копии этих разделов ждут, пока вы не примете их копии как копии этого сервера. См. После перестройки.
Локальные копии защищают от потерянного контейнера или неудачного обновления. Внешние копии и проверенный набор для восстановления защищают от потери всего сервера, вымогателя или пожара. Эта страница охватывает места назначения и внешние копии, защиту копии от вмешательства, доказательство того, что вы умеете восстанавливать, сопряжение нескольких серверов и возврат всего, когда самого BombVault больше нет.
Внешние копии¶
Сохраните быструю локальную копию и добавьте одно или несколько мест назначения вне вашего помещения. BombVault копирует туда новые снимки через restic copy по возможности, так что сбой во внешнем месте никогда не проваливает локальную копию. В такой схеме каждый раздел сначала пишет в собственную папку, а внешний репозиторий — это копия. Собственная папка не обязана лежать на этом сервере: о том, как держать её в месте назначения вроде S3 или rest-server, см. Собственная папка раздела.
- Несколько мест назначения для раздела. Каждый раздел (контейнеры, виртуальные машины, flash, автобэкап, папки и наборы данных ZFS) может копировать сразу в несколько внешних мест назначения, так что можно, например, параллельно держать rest-server на машине друга и бакет S3. Карточка Места назначения по разделам на странице мест назначения включает и выключает каждую линию от раздела к месту.
- Когда идут копии. Карточка Копировать места задаёт Когда копировать: После каждой копии или по собственному плану, который собирает снимки и копирует в назначенное время. В Настройки, Расписание, Внешние копии по разделам кнопка Исключение даёт одному разделу собственный план копирования.
- Карточка «Внешние копии». В Настройки, Места назначения у каждого раздела с внешней копией есть строка в Внешние копии с кнопками Проверить соединение, Реплицировать сейчас для запуска копирования по требованию и Настроить или Изменить. Остальные настройки копирования раздела открываются оттуда в его окне.
- Хранение задаётся для каждого места назначения в Как долго хранить, так что внешние копии можно хранить дольше как архив. Копия в поле внешнего хранения раздела следует ему, как и любая другая копия, а раздел может держать собственные значения в Правила по разделам. Все нули никогда не обрезают внешние снимки. См. Как долго хранить.
- Ограничения полосы (Внешняя пропускная способность в Настройки, Места назначения или карточка места Копировать) ограничивают скорость отдачи и загрузки restic, чтобы копии не забивали ваш WAN. Они вводятся в KiB/s, единице, которую принимает restic, а каждое поле во время ввода показывает ту же скорость в МБ/с и Мбит/с: 2048 читается как примерно 2,0 МБ/с (16,8 Мбит/с).
- Сжатие бывает Выкл., Автоматически (по умолчанию в restic) или Максимально, задаётся для каждого места назначения и для одного раздела в его правилах там. Копии, копирование и очистка пишут с ним, а набор для восстановления называет его, чтобы обычный restic мог продолжать писать так же.
- Сначала трансляция. Пока медиасервер вроде Plex, Jellyfin или Emby транслирует, копии отдаются с пониженным лимитом и возвращаются к обычному через несколько минут после конца трансляции. В карточке Стриминг на странице мест назначения есть Замедлять внешние копии во время стриминга, Медиасерверы (контейнеры с Plex, Jellyfin или Emby в имени образа, пока вы не выберете), Стриминг выше (Mbit/s), Лимит отдачи при стриминге (KiB/s) и Возврат к обычному через (мин). BombVault читает трафик из Docker, поэтому медиасервер в сети хоста измерить нельзя. REST, S3, B2, Azure, Google Cloud, Swift и rclone по HTTP замедляются посреди копирования. SFTP и локальные или смонтированные папки принимают меньший лимит на следующем шаге копирования.
- Холодное хранение (S3). Место назначения S3 может использовать более дешёвый Класс хранения, который restic всё ещё читает сразу, такой как Standard-IA, One Zone-IA, Intelligent-Tiering или Glacier Instant Retrieval. Glacier Flexible Retrieval и Deep Archive исключены, потому что restic не может из них восстанавливать. Удалённый ресурс rclone задаёт свой класс в конфигурации rclone.
- Одновременные подключения. У места назначения S3, B2, Azure, Google Cloud, Swift, rest-server, SFTP или rclone поле Одновременные подключения в карточке Подключение задаёт, сколько подключений restic открывает сразу, от 1 до 32. Если оставить его пустым, restic использует своё значение по умолчанию, 5. Больше подключений может ускорить работу по дальней или медленной линии, меньше бережёт провайдера, который ограничивает скорость. Им пользуются резервные копии, копирование, проверки, очистка и восстановление в этом месте, а экспорт настроек его переносит. У локальной или смонтированной папки такой настройки нет.
- Бюджет роста. Бюджет роста (ГБ, 0 = выкл.) в окне копирования раздела поднимает тревогу, когда репозиторий вырастает больше этого размера. Он ничего не удаляет, поэтому подходит для копии append-only, которую отсюда ничто не очищает.
- Пока идёт копирование, строка состояния обзора пишет Идёт копирование во внешнее место назначения. Это индикатор активности, а не полоса процентов, потому что
restic copyне отдаёт машиночитаемого хода выполнения.
Восстановление откуда угодно
Каждая запись перечисляет свои копии одной временной шкалой по всем местам, где лежит копия, на своей вкладке Резервные копии. Копия, скопированная в B2, появляется один раз с отметкой каждого места, которое её хранит. Восстановление берёт первое место, до которого достаёт, начиная с репозитория, в который пишется запись, и для каждого снимка можно выбрать другое место. Внешние места назначения читаются, только когда вы нажимаете Проверка, потому что перечисление облачного хранилища занимает время. Удаление в одном месте сначала проверяет остальные и сообщает, была ли это последняя копия. См. Восстановление.
Места назначения¶
Место назначения — это место, куда идут копии: локальная папка, общий ресурс, ваш собственный сервер или облачная служба. Оно настраивается один раз и затем обслуживает каждый раздел. Откройте Места назначения с её плитки настроек или включите там Показывать также в боковой панели, чтобы закрепить.

Добавить место назначения открывает окно из четырёх шагов:
- Провайдер. Каждая служба перечислена со своим логотипом, с поиском справа вверху окна, по группам: Локально для диска или общего ресурса, подключённого к этому серверу, NAS или сервер (rest-server, Hetzner Storage Box, SFTP, SMB, WebDAV и другие), Сервис S3 (Backblaze B2, Wasabi, Cloudflare R2, Hetzner Object Storage, Amazon S3 и другие), ваш собственный сервер S3 (Garage, SeaweedFS, RustFS, Silo, Ceph, JuiceFS, Versity S3 Gateway), Облачное хранилище (OneDrive, Google Drive, Dropbox, pCloud, Nextcloud и остальное, что поддерживает rclone) и Из вашей группы, принимающие серверы вашей группы. Каждая говорит, насколько хорошо подходит для копий: облачные диски замедляются при множестве запросов, поэтому первая копия и очистка там идут дольше. Для службы, которую не покрывает ни одна плитка, плитка Rclone в Своя конфигурация rclone принимает удалённые ресурсы, вставленные из rclone.conf.
- Вход. Поля зависят от службы: ключ доступа для S3, пользователь и пароль для WebDAV и SMB, пароль приложения там, где двухфакторный вход блокирует обычный, открытый ключ SSH BombVault для SFTP и Storage Box или токен для служб, где входят через браузер. Для них окно показывает команду
rclone authorize, которую нужно выполнить на компьютере с браузером, а выведенный ею токен вставляется в поле. Там, где у вас уже есть сохранённые учётные данные для службы, Сохранённые учётные данные выбирает их вместо Новые ключи. Проверить соединение проверяет вход, прежде чем что-либо сохранено. Затем окно перечисляет папки в месте назначения с кнопкой Новая папка, чтобы создать новую, и свободным местом там, где служба его сообщает. Безопаснее всего пустая папка. BombVault кладёт в неё по одной папке на раздел. - Защита. Окно прямо говорит, что служба умеет. Rest-server в режиме append-only отказывает в удалении, и тест на подделку это проверяет. Бакет S3 может хранить старые версии через версионирование и object lock, что BombVault пока проверить не может. Облачный диск вообще не умеет отказывать в удалении: кто попадает на сервер, попадает и в эту копию. Включайте Защита от удаления (append-only) только там, где дальняя сторона действительно отказывает в удалении. Тогда BombVault никогда не очищает там. На случай аварии говорит, что набор для восстановления хранит для этого места.
- Для каких разделов. Выберите разделы, которые копируют сюда. Первая копия приносит с собой всю историю. Записи, выбравшие собственные места назначения, новое сами не получают, и окно их называет.


Некоторые службы просят на шаге входа чуть больше:
- SFTP и Storage Box. Добавить ключ кладёт открытый ключ BombVault на сервер с помощью Пароль учётной записи, который используется для этого одного входа и нигде не сохраняется. Ниже показана команда для ручного выполнения. Проверка показывает Ключ сервера с его отпечатком. BombVault запоминает его и отказывается от сервера, если позже тот покажет другой.
- Ключи S3 для одного бакета, такие как токен объекта Cloudflare R2 или ограниченный ключ AWS, могут не перечислять другие бакеты. Введите бакет в Бакет, и проверка и список папок откроют именно его.
- Регионы и адреса S3. Регион читается из конечной точки, которая его называет (AWS, Backblaze B2, Hetzner, Scaleway, OVH, Wasabi), Garage начинает со своего региона по умолчанию, а IDrive e2 просит конечную точку, которую показывает его панель. Адрес, вставленный вместе с бакетом, как его показывает панель R2, заполняет сервер и бакет. Бакет, созданный в обзоре папок, попадает в регион, названный в форме.
- Класс хранения. Выбор предлагает только классы, которые принимает служба, а Дополнительные настройки показывают только параметры, формирующие новый бакет.
- Google Drive и OneDrive. Очищенные данные удаляются насовсем, а не уходят в корзину, где они всё ещё учитывались бы в квоте. Общий диск Google лежит в Дополнительные настройки.
- Серверы SMB, которые не перечисляют свои ресурсы, принимают имя одного в Сетевой ресурс, и проверка открывает этот ресурс напрямую.
- FTP спрашивает своё Шифрование: Нет, Явный TLS (FTPES) или Неявный TLS (FTPS, порт 990).
- OneDrive и Zoho WorkDrive. Когда вход открывает несколько дисков или рабочих пространств, окно спрашивает, в какое идут копии.
- Rest-server с самоподписанным сертификатом. Положите сертификат как файл PEM в папку
certsв папке данных BombVault (/config/certsв контейнере,appdata/bombvault/certsв Unraid). Копии, копирование и тест защиты от удаления доверяют ему без перезапуска.
Службы S3 работают через собственный бэкенд S3 в restic, и именно благодаря этому действуют класс хранения и object lock. До rest-server restic достаёт напрямую. Любая другая служба работает через rclone, который поставляет BombVault, а её раздел конфигурации rclone виден в карточке rclone.conf на странице места со скрытыми секретами. Экспорт настроек несёт места назначения, а с включёнными учётными данными и их учётные данные тоже.
Сохранение места назначения, в котором уже есть копии контейнеров, виртуальных машин или папок, например места, которое вы удалили и добавляете снова, добавляет его в эти разделы как неотмеченную копию. Туда ничего не копируется, пока вы её не отметите, но Восстановить сразу предлагает старые копии.
Папка на этом сервере везде называется Локально: на страницах хранилища, в схеме, на записи и в «Восстановление». Если на этом сервере несколько папок, каждая носит своё имя. Место назначения, которое настраивает поле внешнего хранения раздела, называется по своему расположению, последней папке его адреса или, если её нет, по серверу, и получает номер, если место с таким названием уже есть. Любое место можно переименовать в поле Название его карточки Подключение, в том числе папку бакета, общую для нескольких разделов, и копию, которую описывает поле внешнего хранения раздела, а заданное вами имя сохраняется. Там, где рядом стоят два места с одним названием, каждое несёт свой сервер или папку.
Страница места назначения¶
У каждого места назначения своя страница. Она показывает только те карточки, которые к нему относятся, в таком порядке:

- Собственные папки: разделы, которые сначала пишут свои копии сюда. На них действуют вход, защита и лимиты этого места. Использовать как собственную папку переносит сюда собственную папку ещё нескольких разделов, а Изменить переносит одну обратно. См. Собственная папка раздела.
- Сохраняется прямо сюда: каждый раздел, записи которого копируют прямо в это место, а не в свою собственную папку, и сколько записей это делают. Такой прямой репозиторий берёт все настройки у этого места. Тот, в который больше ничего не копирует, об этом говорит, а Удалить убирает его из списка. Копии в его месте остаются. См. Прямые репозитории.
- Подключение: Название, переключатель Доступен (выключен означает, что BombVault больше не пишет сюда, а записи, которые копируют сюда, завершаются понятным сообщением, а не попадают куда-то ещё), папка, Сжатие, Класс хранения, Одновременные подключения и Вне помещения. У места Локально она перечисляет папку каждого раздела в Собственные папки здесь. Изменить подключение проверяет и сохраняет новый адрес или вход. Когда другие места входят с теми же сохранёнными учётными данными, окно об этом говорит, а изменение здесь даёт этому месту собственные учётные данные, а не переписывает общие.
- Учётные данные: какие сохранённые учётные данные оно использует (Входит с), какие другие места тоже их используют (Также используют) и Изменить, что открывает окно учётных данных. См. Учётные данные.
- rclone.conf: раздел конфигурации rclone этого места, для места, работающего через rclone.
- Защита от удаления с Защита от удаления (append-only), Принять без защиты от удаления, Проверить защиту от удаления сейчас и Кто очищает, что говорит, очищает ли BombVault здесь копию и собственные папки, по карточке Как долго хранить этого места или по собственным значениям раздела в Правила по разделам, или оставляет это дальней стороне. Локальная папка показывает эту карточку, только если у неё есть защита, которую можно выключить. См. Защита от удаления.
- Копировать: Когда копировать, а также Лимит отдачи (KiB/s) и Лимит загрузки (KiB/s). Место, которое хранит только собственные папки и не хранит копий, показывает лимиты в карточке Пропускная способность.
- Как долго хранить: Коротко, Средне, Долго или Свои значения со временной шкалой того, какие копии правило сохраняет. См. Как долго хранить.
- Уже под этим местом назначения: разделы, чей введённый вручную адрес лежит в папке этого места. Если взять один, репозиторий остаётся где был. Вход, класс хранения и защита от удаления тогда берутся из места. BombVault сначала проверяет, что вход места открывает репозиторий, и отказывается ставить репозиторий append-only под место без append-only.
- Правила по разделам: собственный репозиторий, хранение или сжатие одного раздела в этом месте. Изменить правила открывает их, а Вернуть настройки места назначения возвращает раздел. Вход, пропускная способность и время копирования всегда берутся из места.
- Сосуд, показывающий, насколько заполнено место, с отметкой, где оно заполнится, и сколько недель осталось при росте последних недель. Место, которое не сообщает размер, пишет Размер неизвестен.
Переместить и Удалить место назначения стоят среди действий страницы, описанных в разделе Перенос и удаление.
Удалённое место назначения, где были копии и вдруг не оказалось репозитория, например rest-server, чей диск не смонтировался, не получает новый пустой сам. Его страница сообщает об этом, как только копия или копирование находит репозиторий исчезнувшим. Смонтируйте диск снова. Если вы намеренно опустошили старый репозиторий, Создать здесь новый репозиторий начинает заново сразу для каждого раздела места и его репозиториев. Эта защита касается места назначения, которое осталось прежним. Место назначения, которое вы добавляете, или раздел, который вы в нём отмечаете, начинают с чистого листа: если по этому адресу репозитория нет, первая копия его создаёт, даже если там был репозиторий у места, удалённого раньше.
Два отказа называют, что нужно исправить, в запуске копирования и на странице места назначения. Этого бакета нет на сервере появляется, как только сервер S3 так отвечает, и BombVault ничего там не создаёт, так что опечатка в имени бакета остаётся видна. Сервер, который вообще не отвечает, это другой случай: restic повторяет попытки около 15 минут на каждый вызов, на случай если сервер вернётся. Здесь уже есть репозиторий restic, и ключ этого экземпляра его не открывает означает, что копии там принадлежат другому APP_KEY.
Принимающий сервер, который запускает другой экземпляр вашей группы, появляется среди провайдеров как Из вашей группы. См. Принимающий сервер.
BombVault проверяет свои места назначения при каждом запуске. Он исправляет то, для чего не нужно ваше решение, например ссылку на исчезнувшую копию или репозиторий, копию в собственную папку раздела или прямой репозиторий, чья копия исчезла, и пишет в журнал строку про каждое исправление. То, для чего нет безопасного исправления, только записывается.

Как долго хранить¶
Как долго копии хранятся, задаётся для каждого места назначения в его карточке Как долго хранить. Правило охватывает копии в этом месте и лежащие там собственные папки, включая место Локально. Раздел может держать собственные значения в одном месте в Правила по разделам, и они главнее карточки места для этого раздела.
Правило хранит по одной копии на день, неделю, месяц и год так далеко назад, как вы задали, а остальное чистит после каждой копии или копирования:
| Набор | Последние копии | Дни | Недели | Месяцы | Годы |
|---|---|---|---|---|---|
| Коротко | 0 | 7 | 4 | 3 | 0 |
| Средне | 0 | 7 | 4 | 6 | 2 |
| Долго | 0 | 14 | 8 | 12 | 3 |
Свои значения задают пять счётчиков вручную. 0 отключает этот счётчик, а правило со всеми нулями хранит всё. Точки в карточке показывают, какие из 40 образцов копий правило сохраняет, самая новая справа. Образец одинаков для каждого места, потому что картинка рисуется до того, как BombVault прочитал копии там. Отсчёт идёт назад от сегодняшнего дня, поэтому то, сколько точек остаётся, зависит от даты.
Папка на этом хосте и удалённая папка, введённая вручную, тоже получают собственную карточку, которая охватывает собственные папки в этой папке и никакие другие. Пока вы её не сохраните, для такой папки действует правило, которое у BombVault для неё уже было.
Спрашивать перед сокращением хранения по умолчанию включено и спрашивает перед сохранением изменения, которое хранит меньше копий, и говорит, сколько из 40 образцов копий новое правило удаляет. Это относится к каждому месту назначения. Вернуть настройки места назначения в Правила по разделам задаёт тот же вопрос.
Место с защитой от удаления с этого сервера никогда не очищается. Его дальняя сторона сохраняет или отбрасывает старые копии по своим правилам. Пока у записи открыта критическая аномалия о потерянных данных, хранение сохраняет старые копии этой записи, пока вы её не подтвердите. См. Аномалии.
Копия, в которой меньше, чем должно быть, никогда не вытесняет предыдущие по сроку хранения. Это копия, которая не прочитала ни одного файла там, где в прежних копиях файлы были, пропустила выбранную папку или не смогла прочитать часть файлов. Её запуск заканчивается предупреждением, которое называет, чего не хватает, и говорит, что старые копии сохранены. То же сообщение приходит в ваши каналы уведомлений. Пока не пройдёт полная копия, никакая очистка не трогает старые копии этой записи, ни в её собственной папке, ни в её копиях. Первая копия и выбранная папка, которая всегда была пустой, считаются полными.
Чтобы увидеть, что следующий запуск действительно удалит, откройте Предпросмотр в Настройки, Места назначения. Он перечисляет Что удалит следующий запуск для собственной папки раздела и для каждой из её копий, по каждому репозиторию и каждой записи с названными точками восстановления. Он не берёт блокировку и ничего не меняет.

Пример: что хранит режим «Средне»¶
Контейнер копируется каждую ночь в 03:00 с 1 октября 2024 года, так что в среду 4 ноября 2026 года у него 765 копий. Его место назначения задано как Средне: 7 дней, 4 недели, 6 месяцев и 2 года.
Каждый счётчик хранит самую новую копию своего дня, недели, месяца или года, а копия, которую выбирают несколько счётчиков, хранится один раз. Недели идут с понедельника по воскресенье:
| Правило | Копии, которые оно выбирает | Новые, которые оно добавляет |
|---|---|---|
| 7 дней | 4 ноя, 3 ноя, 2 ноя, 1 ноя, 31 окт, 30 окт, 29 окт | все 7 |
| 4 недели | 4 ноя, 1 ноя, 25 окт, 18 окт | 25 окт, 18 окт |
| 6 месяцев | 4 ноя, 31 окт, 30 сен, 31 авг, 31 июл, 30 июн | 30 сен, 31 авг, 31 июл, 30 июн |
| 2 года | 4 ноя, 31 дек 2025 | 31 дек 2025 |
Остаётся 14 копий из 765. Самая старая от 31 декабря 2025 года, так что сегодня назад можно вернуться немного больше чем на десять месяцев. Благодаря дедупликации они занимают немногим больше места, чем одна полная копия плюс то, что изменилось между ними.
Годы стоит рассмотреть внимательнее. Он считает календарные годы, в которых есть копия, начиная с текущего, а самая новая копия этого года сделана сегодня. Так что первый год ничего не добавляет к другим счётчикам, а второй добавляет последнюю копию предыдущего года. Поэтому глубина хранения по правилу меняется в течение года. Те же копии при каждом наборе:
| Набор | Хранимых копий сегодня | Самая старая копия сегодня | Глубина хранения в течение года |
|---|---|---|---|
| Коротко | 10 | 30 сентября 2026 | от 1 до 2 месяцев |
| Средне | 14 | 31 декабря 2025 | ранней весной около 4 месяцев, 31 декабря целый год |
| Долго | 30 | 31 декабря 2024 | 1 января 1 год, 31 декабря 2 года |
Переход со Средне на Коротко сначала спрашивает из-за Спрашивать перед сокращением хранения. В вопросе сказано, сколько из 40 копий на картинке убирает новое правило. Это число берётся из образца, поэтому оно меняется с датой и не считает ваши собственные копии. Из копий в этом примере пропали бы 31 августа, 31 июля, 30 июня и 31 декабря 2025 года. Всё равно сохранить применяет правило, и следующая очистка навсегда удаляет их из этого места.
Чтобы хранить контейнеры дольше остальных в этом месте, нажмите Изменить правила в Правила по разделам, выберите Контейнеры и задайте Свои значения в Правила для Контейнеры, например 14 дней, 8 недель, 12 месяцев и 2 года. Остальные разделы продолжают следовать карточке места, а Вернуть настройки места назначения возвращает «Контейнеры».
Учётные данные¶
Учётные данные — это ключ или пароль, которые BombVault использует для службы S3 или rest-server. Учётные данные образуют один список, карточку Учётные данные в Настройки, Места назначения, и в каждой строке сказано, какие места назначения их используют (Используется).
- Сохраняются при добавлении места. «Добавить место назначения» сохраняет введённые вами ключи как учётные данные. Следующее место в той же службе может выбрать их в Сохранённые учётные данные вместо Новые ключи, а позднее изменение применяется ко всем местам, которые их используют.
- По умолчанию. Звёздочка отмечает учётные данные по умолчанию. Они используются везде, где ничего не выбрано, например для адреса, введённого вручную, или восстановления на чистой установке. Источник для подтягивания их не заимствует. Сделать по умолчанию передаёт звёздочку другим.
- Изменить и проверить. Изменить здесь или в карточке Учётные данные места открывает одно окно для учётных данных. Проверить входит в каждое место, которое их использует, с тем, что вы ввели, прежде чем что-либо сохранено. Сохранить сохраняет.
- Удаление. Учётные данные можно удалить, только когда их не использует ни одно место назначения, источник для подтягивания или принятый репозиторий и они не нужны старым копиям, а учётные данные по умолчанию уходят только последними. Старым копиям они нужны, когда собственная папка переехала из места, которое входит с этими учётными данными, и оставила копии там. BombVault тогда говорит, какое это место.
- Изменение подключения места никогда не переписывает учётные данные, общие с другими местами. Место получает вместо них собственные, а окно заранее говорит, что его учётные данные общие. Чтобы изменить общие везде, измените их в карточке Учётные данные.

Папке на этом сервере вход не нужен. SMB, WebDAV, SFTP, Storage Box и облачные диски хранят свои данные в конфигурации rclone, которую показывает карточка места rclone.conf, поэтому в этом списке они не появляются.
SMB, WebDAV и другие удалённые ресурсы rclone¶
Общий ресурс Windows или Samba и сервер WebDAV (Nextcloud, ownCloud, SharePoint или любой другой) — плитки провайдеров в Добавить место назначения в разделе NAS или сервер. Заполните хост и ресурс (SMB) или адрес и тип сервера (WebDAV), пользователя и пароль, и BombVault запишет раздел rclone за вас. rclone скрывает пароль, прежде чем его сохранить.
Для службы, которую не покрывает ни одна плитка, плитка Rclone в Своя конфигурация rclone принимает удалённые ресурсы, вставленные из rclone.conf. Они добавляются к уже имеющимся у BombVault и никогда их не заменяют, а хранятся они в зашифрованном виде. Чтобы копировать раздел в один из них, введите rclone:<remote>:<folder> как внешний репозиторий этого раздела, например rclone:nas:backups/bombvault. Ресурс или бакет — это первый сегмент пути, а не часть имени.
Это лучший путь, чем монтировать ресурс в Unraid: restic не советует держать репозиторий на смонтированном ресурсе CIFS, а здесь ничего не монтируется. Для NFS плитки нет, потому что ни у restic, ни у rclone нет бэкенда NFS. Для NFS смонтируйте экспорт на хосте и используйте его как локальную папку.
Перенос и удаление¶
- Переместить переносит копию одного раздела в другое место назначения вместе со всей историей. Всё остаётся на старом месте. BombVault ничего там не удаляет. Перенос идёт в фоне и может быть долгим: около 9 минут на 100 ГБ между локальными дисками, часы по медленной линии. Обзор показывает его, пока он идёт.
- Удалить место назначения предлагает два пути. Удалить место назначения, оставить копии прекращает запись туда и оставляет копии на месте. Позже вы сможете прочитать их в Восстановление, Из старой папки с копиями. Удалить место назначения и стереть резервные копии там сначала читает, что там хранится, и перечисляет это: какие копии уйдут, какие из них нигде больше не лежат и какие репозитории остаются, потому что защита от удаления отказывает, записи ещё копируют прямо в них, другое место или раздел хранит там свои копии либо их не удалось прочитать. Записи, которые потеряли бы свою единственную копию, перечислены отдельно и сохраняются, если вы не включите Стереть и эти. Вы подтверждаете вводом названия места, а удаление идёт в фоне.
- Это работает для любого вида места назначения: того, что используют несколько разделов, цели, настроенной для одного раздела, репозитория, который вы настроили, и папки, в которую раздел пишет собственные копии. Записи, которые копируют в удалённый репозиторий, снова следуют своему разделу, как и значение раздела по умолчанию, указывавшее туда. Папка раздела не может просто пропасть, потому что она нужна каждому разделу. Окно спрашивает папку, в которую разделы переезжают, и каждый раздел сохраняет под ней своё имя папки.
- Удаление копий в месте назначения работает и без пароля для входа. Если пароль задан, нужен вход на самом экземпляре.
Пример: внешняя копия на Backblaze B2¶
Контейнеры и автобэкап должны лежать ещё и в Backblaze B2, чтобы погибший сервер не унёс их с собой. Те же шаги подходят для Wasabi, Hetzner Object Storage и большинства других служб S3.
- В B2 создайте частный бакет, например
tower-backups, в ближайшем к вам регионе. В Application Keys создайте ключ с правом чтения и записи, ограниченный этим бакетом, и запишите его ID и ключ приложения. B2 показывает ключ приложения один раз. Настройте жизненный цикл бакета так, чтобы хранилась только последняя версия, иначе B2 держит очищенные данные как скрытые версии и выставляет вам за них счёт. - Провайдер. В BombVault откройте Места назначения, нажмите Добавить место назначения и выберите Backblaze B2 в Сервис S3.
- Вход. Введите ID ключа как ID ключа доступа и ключ приложения как Секретный ключ доступа. Введите конечную точку бакета в Конечная точка, например
s3.eu-central-003.backblazeb2.com, и BombVault прочитает из неё регион. Введитеtower-backupsв Бакет, потому что этот ключ открывает только один бакет. - Проверить соединение. Оно должно написать Соединение установлено и перечислить папки бакета. Нажмите Новая папка и назовите её
bombvault. BombVault кладёт в неё по одной папке на раздел, напримерbombvault/containers. - Защита. Окно объясняет, что B2 может хранить старые версии через object lock и что BombVault не может это проверить. Оставьте Защита от удаления (append-only) выключенной, если бакет действительно не отказывает в удалении, чтобы BombVault мог очищать по правилам хранения места.
- Для каких разделов. Отметьте Контейнеры и Автобэкап. Автобэкап несёт ваши настройки, так что новая установка сможет их вернуть. Окно говорит, сколько записей и, где известно, сколько истории принесёт первая копия.
- Нажмите Сохранить место назначения.
Первая копия идёт после следующей копии. Чтобы запустить её сейчас, откройте Настройки, Места назначения и нажмите Реплицировать сейчас в строке раздела в Внешние копии. Строка состояния пишет Идёт копирование во внешнее место назначения. Первая копия приносит всю историю, поэтому 200 ГБ по исходящей линии 100 Мбит/с занимают около четырёх с половиной часов. Последующие копии отправляют только новое.
Чтобы не загружать линию, откройте страницу места и задайте Лимит отдачи (KiB/s) в карточке Копировать, например 5120, что читается как около 5,0 МБ/с (41,9 Мбит/с). Заодно проверьте Как долго хранить на той же странице.
Чтобы убедиться, что получилось, посмотрите на Состояние защиты в обзоре, где Внешнее меняется на копия актуальна, и на вкладку контейнера Резервные копии, где его снимки теперь называют tower-backups вторым местом. Затем снова нажмите Скачать набор для восстановления в Настройки, Восстановление, потому что набор перечисляет новое место и его вход.
Cloudflare R2 работает так же, с токеном объекта вместо ключа. Вставьте адрес S3, который показывает панель R2, вместе с бакетом, и BombVault заполнит сервер и бакет.
Пример: rest-server на вашем собственном сервере¶
Rest-server в режиме append-only отказывает в удалении, поэтому копия на нём переживёт, даже если кто-то завладеет вашим сервером. Достаточно второй машины у друга или в гараже. Сопряжённый BombVault может настроить это за вас, см. Принимающий сервер. Чтобы запустить вручную на любом хосте Docker:
docker run -d --name rest-server --restart unless-stopped \
-p 8000:8000 \
-v /mnt/user/backups/rest-server:/data \
-e OPTIONS="--append-only --private-repos" \
restic/rest-server
docker exec -it rest-server create_user bombvault
Последняя строка просит пароль и записывает пользователя в файл .htpasswd в папке данных.
- В BombVault нажмите Добавить место назначения и выберите rest-server в NAS или сервер.
- Введите адрес с пользователем как папкой, например
http://192.168.2.20:8000/bombvault, а также Имя пользователя и Пароль. Нажмите Проверить соединение. - В Защита включите Защита от удаления (append-only). Тогда BombVault никогда не очищает там и оставляет это дальней стороне.
- Отметьте разделы и нажмите Сохранить место назначения.
- Когда первая копия на месте, откройте страницу места и нажмите Проверить защиту от удаления сейчас. BombVault пробует удалить тестовый объект. Карточка должна написать Последняя: удаление отклонено, а Защита от удаления в обзоре меняется на проверено. Если написано Последняя: удаление не отклонено, значит, нет
--append-only.
Поскольку эту копию отсюда ничто не очищает, задайте Бюджет роста (ГБ, 0 = выкл.) в окне раздела, которое открывается через Изменить в его строке в Внешние копии, чтобы узнать об этом, прежде чем диск заполнится. О самоподписанном сертификате см. заметку о certs выше.
Собственная папка раздела¶
У каждого раздела есть собственная папка: репозиторий, в который его копии пишутся в первую очередь. Копии в другие места назначения уходят оттуда. Новая установка держит собственные папки на этом сервере, ниже /mnt/user/bombvault, и вместе они образуют место назначения Локально.
Собственная папка может лежать и в уже имеющемся у вас месте назначения, например NAS, rest-server или бакете S3. Тогда раздел копирует туда напрямую, без промежуточной локальной копии, а собственная папка следует входу, защите от удаления и лимитам пропускной способности этого места. BombVault очищает её после каждой копии по карточке Как долго хранить этого места, а собственные значения раздела в Правила по разделам важнее карточки. Место перечисляет раздел в своей карточке Собственные папки, а Места назначения по разделам показывает место как дом раздела.
Перенос собственной папки¶
- Откройте место назначения, которое должно хранить собственную папку, и выберите Использовать как собственную папку или Добавить разделы в его карточке Собственные папки. Чтобы перенести сразу несколько разделов, выберите Перенести собственные папки рядом с Собственные папки здесь в карточке Подключение места «Локально».
- Выберите разделы в Разделы и место в Перенести в. Другое место принимает папку на этом хосте или введённый вручную адрес удалённого репозитория с входом из ваших сохранённых учётных данных.
- Прочитайте Что произойдёт. Для каждого раздела там написано, куда пойдут новые копии, становится ли собственной папкой копия, которая уже лежит на новом месте, и какие копии сначала копируются.
- Скопировать уже сделанные резервные копии включено по умолчанию. Если выключить, старые копии остаются где были, но запись их больше не перечисляет. Из старой папки с копиями на странице «Восстановление» по-прежнему читает их по адресу папки и, для удалённой папки, с её данными для входа.
- Выберите Переключить. Когда карточка Как долго хранить нового места хранит меньше, чем сейчас правило раздела, BombVault сначала спрашивает Хранить меньше? Там Сохранить текущие значения для этого раздела в разделе Правила по разделам переносит текущие значения с собой, Всё равно сохранить идёт дальше, а Назад оставляет всё как было. Когда копии нужно сначала скопировать, BombVault копирует их и затем переключает собственную папку. Когда они уже на месте, он проверяет их перед переключением.
После переноса новые копии идут в перенесённую собственную папку, в том числе у раздела, у которого было выключено Локально и который копировал прямо в копию. Копия, которая уже лежала на новом месте, становится собственной папкой, и копирование туда прекращается. Там, где в этой копии хранились копии дольше, чем по правилам хранения раздела, раздел сохраняет всё, что сохраняет любое из правил, так что ни одна не теряется.
Когда перенос не может пройти, окно говорит почему в блоке под Что произойдёт. Когда мешает только копирование старых копий, выключение Скопировать уже сделанные резервные копии позволяет собственной папке переехать без них.
Разделу всегда нужна собственная папка. Удаление места назначения, где она лежит, спрашивает папку, в которую раздел переезжает, см. Перенос и удаление. Собственная папка, мимо которой идут новые копии, потому что раздел копирует прямо в копию, помечается как (выкл.) там, где место перечисляет, кто его использует.

Пример: контейнеры переезжают на NAS¶
Пул кэша заполняется, а у вас есть место назначения nas, общий ресурс SMB на второй машине. В разделе «Контейнеры» 61 копия в его собственной папке на этом сервере, и он копирует в Backblaze B2.
- Откройте Места назначения, затем
nasи нажмите Использовать как собственную папку. - Отметьте Контейнеры в Разделы.
- Прочитайте Что произойдёт. Там сказано, что новые копии «Контейнеры» идут в папку на
nas, что 61 копия в «Локально» сначала копируется туда, что копии продолжают идти в Backblaze B2 и что защита, лимиты пропускной способности и сигнал о росте берутся изnas. - Оставьте Скопировать уже сделанные резервные копии включённым и нажмите Переключить.
BombVault копирует копии в фоне и затем переключает собственную папку. Страница nas перечисляет «Контейнеры» в Собственные папки, запись, следующая своему разделу, называет nas своим домом, а следующая копия ложится туда, и копия в B2 уходит уже из nas. Отныне папку очищает карточка Как долго хранить места nas. Старая папка на этом сервере остаётся где была, и BombVault ничего там не удаляет.
Ввод удалённого адреса вручную¶
Карточка Подключение места «Локально» по-прежнему принимает удалённый адрес для собственной папки раздела: Изменить рядом с разделом открывает окно с переключателем Локально / Удалённо. Удалённо принимает адрес restic вроде s3:..., rest:http://host:8000/repo, sftp:user@host:/repo или rclone:remote:bucket/path, а Настройки безопасности удалённого основного репозитория добавляют проверку соединения, лимиты отдачи и загрузки, защиту append-only с тем же тестом на подделку, что и у внешнего места, и сигнал бюджета роста.
Такой адрес входит с учётными данными по умолчанию. Когда он в точности совпадает с папкой, которую имеющееся у вас место назначения держит для этого раздела, он сам следует за этим местом, вместе с карточкой места и его переключателем Доступен, если только он не входит иначе и не работает в режиме append-only там, где место назначения так не работает. Правило, которое до этого очищало папку, остаётся собственным правилом раздела в Правила по разделам. Когда он лежит в другой папке этого места, страница этого места перечисляет раздел в Уже под этим местом назначения, а если его взять, он получает вход, класс хранения и защиту от удаления места. Перенести собственную папку в место назначения через Использовать как собственную папку проще, потому что окно проверяет уже сделанные копии, прежде чем что-либо изменится.
Размещение для отдельной записи¶
В карточке Расписание и место назначения на вкладке записи «Настройки» есть ряд кнопок: Локально и по одной кнопке на каждое внешнее место назначения раздела. Подсвеченные кнопки получают копии записи.
- Когда Локально подсвечено, запись пишется в репозиторий, показанный в Сохранено на, и копируется в каждое другое подсвеченное место. Затемните место, и оно ничего нового от этой записи не получит. Одно «Локально» никуда не копирует, что подходит для данных, у которых уже есть вторая копия, например общего ресурса, живущего на NAS.
- Когда Локально затемнено, запись пишется прямо в прямой репозиторий первого подсвеченного места и копируется оттуда в другие подсвеченные. В первый раз окно создаёт этот прямой репозиторий.
- Одна кнопка остаётся подсвеченной, потому что копии нужно куда-то идти. Чтобы исключить запись из копирования, используйте Не копировать.
BombVault никогда не переносит копии между репозиториями. Запись, которая следует своему разделу, переходит вместе с ним, когда меняется значение раздела по умолчанию: её следующая копия ложится на новое место, а уже имеющиеся копии остаются где были. Место, выбранное на самой записи, остаётся фиксированным с первой копии. Карточка Репозиторий на вкладке «Настройки» называет его. Копии можно менять в любой момент. Место, которое больше не получает запись, сохраняет свои копии и обрезает их по собственному хранению при следующем внешнем запуске раздела. Из мест append-only удалять нельзя.
Место, которое запись покинула, сохраняет свои копии. На вкладке записи Резервные копии и в Восстановление оно стоит как Только прежние резервные копии, восстановление по-прежнему может из него читать, а очистка там эти копии не трогает.
Следовать умолчанию возвращает запись с собственным выбором в её раздел. Сначала он спрашивает, говорит, куда пойдут новые копии, и называет, что перестанет получать каждое место и что загрузил бы следующий запуск.
Под рядом карточка говорит, куда идёт запись и что там на самом деле есть: сколько площадок её хранят, когда каждое место видели в последний раз и выполнено ли 3-2-1. Площадка — это сервер с исходными данными, каждое внешнее место назначения и каждый репозиторий с пометкой Вне помещения. BombVault проверяет копии и площадки. Часть про «два носителя» из 3-2-1 он не проверяет.
Значения по умолчанию для разделов¶
Карточка Места назначения по разделам на странице мест назначения рисует значение каждого раздела по умолчанию как схему 3-2-1. Каждая линия от раздела к месту назначения — переключатель, Локально тоже, для каждого раздела, в том числе флешки, наборов данных ZFS и автобэкапа. Щелчок по линии или точке переключает её сразу, а пунктирные линии выключены. Только выключение Локально у раздела сначала спрашивает, в том же окне, что и карточка значения по умолчанию, потому что тогда раздел копирует прямо в копию. Отмена оставляет всё как было. Граф / Переключатели показывает то же рядами кнопок. Переключатель решает, куда идут новые копии. Записи без собственного выбора и папки проектов стеков Compose следуют сразу, так что их следующая копия идёт в новые места. Уже сохранённые копии остаются где были и по-прежнему доступны для восстановления. Флешка, наборы данных ZFS и автобэкап копируются в свою локальную папку и копируют вне сервера уже из этой копии. Их линию к Локально тоже можно выключить. Тогда их копии идут прямо в их внешние места, а запись ZFS с репликой и вообще без места назначения только отправляет свою реплику.
Если Локально выключено, а включены только внешние места, раздел копирует прямо в них, и репозиторий там BombVault выбирает сам. Контейнеры, виртуальные машины и наборы папок идут в прямой репозиторий первого включённого места, описанный ниже, и копируются оттуда в другие. Флешка, наборы данных ZFS и автобэкап записывают каждую копию в каждое включённое место, и каждое место хранит их по своему хранению.
Раздел со всеми выключенными линиями пишет Без резервной копии. Его записи не получают копий и считаются незащищёнными.
Записи, выбравшие собственные места назначения на своей странице, сохраняют их. Схема говорит, сколько их в разделе, например 2 записи отличаются, и ведёт к ним: на вкладку записи «Настройки», если она одна, к списку с тем, куда копирует каждая, если их несколько. Следовать умолчанию там возвращает запись обратно.
Новое внешнее место получает каждую запись, не заданную как «Локально». Окно, которое его добавляет, говорит, сколько это записей и, где известно, сколько истории.
Прямые репозитории¶
Прямой репозиторий — место, где записи копируют прямо во внешнее место назначения. BombVault кладёт его рядом с папкой места с добавлением -direct к имени или, когда место лежит в корне своего бакета, своего remote или пользователя rest-server, в папку внутри него с названием раздела, например containers-direct. В схеме на странице мест назначения он создаётся без вопроса. Выключение «Локально» для одной записи, из-за чего домом становится место без прямого репозитория, открывает окно с предложенным расположением, например s3:https://s3.eu-central-003.backblazeb2.com/bucket/containers-direct, и проверкой соединения, которая ничего не создаёт. Создать и использовать создаёт репозиторий и направляет на него запись. У прямого репозитория нет собственных настроек. Он следует переключателю, входу, классу хранения, лимитам, настройке append-only и хранению своего места и меняется вместе с ними. Страница места перечисляет его в Сохраняется прямо сюда с каждым разделом, который копирует прямо в него, и числом записей. Тот, в который больше ничего не копирует, там об этом говорит и его можно удалить, а копии в его месте остаются. Когда новый ключ места не может его открыть, прямой репозиторий сохраняет прежний ключ, и сохранение об этом сообщает. Запись в прямом репозитории копируется оттуда в другие включённые места, но никогда в место, которому принадлежит репозиторий. Его снимки несут тег bv:direct, и каждый другой проход хранения их сохраняет, так что прямой репозиторий, потерявший связь со своим местом, никогда не стареет по локальным правилам. B2 достигается через его конечную точку S3 с ID ключа и ключом приложения, введёнными как ключи S3. Ключ, ограниченный собственной папкой места, не достаёт до папки рядом с ней, поэтому ограничьте ключ папкой выше.
Вне помещения¶
Место назначения или репозиторий можно пометить как Вне помещения. Удалённые помечены с самого начала. Выключите для rest-server в том же здании. Пометка только учитывает площадки и 3-2-1 на карточках. Она не меняет ни одну копию.
Реплика ZFS — копия вне помещения, но не резервная копия с историей. Она хранит только заданные вами снимки, а старые версии и отдельные файлы по-прежнему берутся из копий. Она идёт с одного сервера ZFS прямо на другой, по SSH на сервер ZFS или на принимающую конечную точку сопряжённого экземпляра. Группа сопряжения несёт только запрос. См. Реплика.
После перестройки¶
Выбор копирования хранится в собственных настройках BombVault. После перестройки через Найти резервные копии или аварийный мастер без восстановленных настроек он пропадает, а копирование всего снова отправило бы в B2 записи, которые вы исключили. То же самое происходит, когда раздел, который ещё ни разу не делал внешних копий из этой базы данных, находит собственные копии в месте назначения или более старые в своей собственной папке, например после того, как место назначения добавили поверх копий прежней установки с тем же APP_KEY. Внешние копии этого раздела тогда ждут вашего решения.
Требует внимания в обзоре и страница каждого места назначения, куда копирует раздел, спрашивают, являются ли эти копии копиями этого сервера. Принять как резервные копии этого сервера подтверждает значение раздела по умолчанию, и его копирование возобновляется со следующего прохода. Сначала проверить правила ведёт к строке раздела в Места назначения по разделам, где видно, куда идёт каждая запись, а потерянное правило можно снова задать на странице записи. Копирование ждёт там, пока вы не нажмёте Принять как резервные копии этого сервера. Эта кнопка сначала показывает, что скопирует следующий запуск, и имена в копиях без записи, которые можно исключить. Самая новая копия каждой ожидающей записи сообщает об этом в своём запуске со ссылкой на решение, а если уведомления включены, приходит уведомление. Импорт файла настроек возвращает правила и значения по умолчанию, но решения за вас не принимает.

Защита от удаления (append-only)¶
Включите защиту от удаления для внешнего места назначения, чтобы вымогатель или скомпрометированный хост не могли удалить или переписать ваши копии. Обеспечивает её дальняя сторона (restic/rest-server, запущенный в режиме --append-only). BombVault лишь проверяет её и никогда не показывает зелёное только по заявлению в конфигурации. Папка на этом сервере не может отказать в удалении, потому что тот, кто управляет BombVault, управляет и папкой, поэтому локальные места этот переключатель не предлагают.
Переключатель принадлежит месту назначения: раздел, который копирует туда, берёт его у места, поэтому включайте его на странице места в Места назначения. Плановая Проверять защиту от удаления работает, только пока какой-нибудь раздел копирует в место с включённым переключателем. Дальнюю сторону нужно запускать с --append-only. В образе restic/rest-server и в TrueNAS, и на любом другом хосте Docker это задаётся в переменной OPTIONS.
Некоторые места вообще не умеют отказывать в удалении, например облачный диск вроде OneDrive. Если вы намеренно храните там копии, включите Принять без защиты от удаления на странице места. Обзор тогда показывает отсутствующую защиту от удаления у раздела, который копирует только в принятые места, как принятый риск, серым кольцом вместо янтарной точки, а цвет раздела определяют его остальные проверки. Больше ничего не меняется: копии там по-прежнему можно удалить, BombVault по-прежнему очищает их по правилам хранения места, а переключатель исчезает, когда включена защита от удаления. Копия, которая переезжает в другое место, теряет принятие. Включение защиты от удаления тоже его снимает.
Самый быстрый путь к копии append-only — сопряжённый BombVault с принимающим сервером: он сам запускает для вас rest-server в режиме append-only.
В общем репозитории это верно для участников, но не для его владельца. Владелец обращается к папке напрямую, забывает там копии и очищает репозиторий.
Успешное удаление в /locks/ — это нормально
Append-only не означает, что ничего нельзя удалить. restic должен брать и снимать собственные блокировки, поэтому /locks/ по замыслу остаётся доступным для записи и удаления. Снимки и данные за ними, за которыми и пришёл бы вымогатель, удалить нельзя. Если вы сами проверяете дальнюю сторону, успешное удаление в /locks/ — правильное поведение, а не дыра в защите.
Репозитории append-only никогда не очищаются с этого сервера
Место append-only никогда не очищает отсюда старые снимки. Очистка — дело дальней стороны. Задайте для него сигнал бюджета роста, чтобы вас предупредили, прежде чем размер репозитория вырастет безудержно.
Тест на подделку¶
BombVault периодически доказывает гарантию append-only, действительно пытаясь удалить что-то во внешнем репозитории, нацелившись на несуществующий объект. Проверить защиту от удаления сейчас на странице места запускает его по требованию, а Проверять защиту от удаления в Настройки, Проверка, Автоматические проверки запускает его по расписанию.
Выключение Проверять защиту от удаления не скрывает пробел. Место с защитой от удаления, которое ни разу не проверяли, тогда читается как «не доказано, его проверка выключена», а место без защиты от удаления читается как «нет» в обоих случаях.
Выключенная копия не проверяется, и место об этом говорит. Проверка соединения на ней всё равно идёт, потому что она только читает, так что копию можно проверить до того, как её включат.
- Отказано означает защищено.
- Принято означает не защищено.
- Неубедительный результат (сервер недоступен, ошибка аутентификации) никогда не переворачивает сохранённый вердикт.
Настоящий переход из защищённого в незащищённое вызывает одно оповещение.
DR-проверки¶
BombVault предлагает два уровня доказательства того, что ваши копии действительно можно восстановить, а не просто что они есть.
- Проверки восстановления (локальные). BombVault периодически запускает
restic check --read-data-subset(ограниченный, никогда не полное восстановление, забивающее диск). Частота лежит в Настройки, Проверка, Автоматические проверки, а карточка Проверить резервные копии на той же плитке показывает результат. - Пробное восстановление (внешнее). BombVault восстанавливает настоящую цель из внешнего репозитория в изолированную песочницу, сверяет её файл за файлом и байт за байтом, затем убирает за собой. Это доказывает, что вы можете восстановиться из внешней копии, а не просто что репозиторий отвечает.
Карточка Состояние защиты в обзоре сводит это по разделам в четыре проверки: актуальная копия на этом сервере, внешняя копия, защита от удаления там и пробное восстановление оттуда. Щелчок по разделу показывает подробности, а карточка зеленеет только по проверенным фактам. Место, которое вы приняли без защиты от удаления, считается там принятым риском, а не предупреждением.
Сопряжение экземпляров¶
Несколько BombVault работают вместе как одна группа: они показывают друг другу состояние защиты, берут друг для друга роли и могут хранить ключ друг друга. Экземпляр вступает в группу с помощью двенадцати слов.

На первом экземпляре откройте Настройки, Сопряжение и нажмите Сгенерировать фразу. Три карточки шагов показывают, как это идёт. Двенадцать слов появляются в окне с кнопкой Копировать. На каждом другом экземпляре откройте то же место, нажмите Ввести фразу и вставьте или наберите их либо нажмите Вставить в этом окне. Слово, которого нет в списке, называется с его позицией по мере набора, а последнее слово несёт контрольную сумму, так что ошибочное или переставленное слово ловится, прежде чем что-либо сопрягается. Генерируйте фразу только на одном экземпляре: два экземпляра, оба сгенерировавшие фразу, образуют две отдельные группы. Если минуту никто не появляется, карточка подсказывает ввести слова там, а Показать фразу снова выводит их на экран. Ещё карточка предлагает вместо этого ввести слова другого экземпляра. Сопряжение работает без пароля для входа, но задайте его: без него любой, кто может открыть веб-интерфейс, может прочитать слова и через группу запрашивать роли, которые выдают пароль restic экземпляров в ней. Карточка сопряжения об этом пишет, пока пароль не задан. С паролем повторный показ фразы его требует. Покинуть выводит экземпляр сразу из группы и из крепости. Под карточкой фразы участники стоят в тех же карточках, что и на странице «Экземпляры», а пока никто ещё не пришёл, строка сообщает, что экземпляр ждёт другой с этой фразой. Картина того, кто что для кого делает, находится на странице «Экземпляры».
Одни только слова никого не впускают. Новый экземпляр или телефон находится в карточке Ожидает одобрения, пока вы не нажмёте Одобрить на экземпляре, который уже состоит в группе, и ваше решение доходит до каждого доступного экземпляра. Сравните ключ, показанный рядом, с тем, который новый экземпляр показывает на своей странице сопряжения. Отклонить отказывает ему навсегда. Когда сопрягаются два новых экземпляра, каждый показывает другой как ожидающий, поэтому одобрите его на обоих. Участники, сопряжённые раньше, остаются одобренными. И всё же относитесь к словам как к паролю: тот, у кого они есть, может попросить о вступлении.
Как участники достают друг до друга. Каждый экземпляр узнаёт свой адрес в сети от вашего браузера в момент входа. В одной сети участники объявляют этот адрес по multicast и разговаривают напрямую, а там, где multicast не может пересечь сеть контейнера, как в сети bridge Docker по умолчанию, экземпляр вместо этого ищет остальных в своей подсети подписанным вызовом, на который может ответить только участник группы, так что сопряжение всё равно завершается за секунды без ретранслятора. Сопряжение всегда идёт по двенадцати словам, и поля для адреса нет. Экземпляры в разных сетях идут через ретранслятор, выбираемый в одном ряду из четырёх в карточке Relay на той же странице. К каждому варианту есть картинка:
- Relay проекта (по умолчанию):
parleyport.halleluja.design, ретранслятор, который использует и KnightLoader. Настраивать ничего не нужно. - Собственный Relay: контейнер ParleyPort из Unraid Community Apps (также в Настройки, Приложения). Введите его адрес на каждом экземпляре, который должен им пользоваться.
- Экземпляр BombVault: один из ваших экземпляров, уже доступный снаружи, с включённым Работать как Relay. Этот экземпляр затем отвечает по
/relay/connectна своём адресе, за обратным прокси и сертификатом, которые у него уже есть, и пускает только вашу группу. Введите его адрес на каждом экземпляре, который должен им пользоваться. - Без Relay: участники находят друг друга автоматически в одной сети и больше нигде.
Что видит ретранслятор. Одноимённая кнопка рядом с четырьмя вариантами показывает это для выбранного. Каждый вызов между участниками запечатывается AES-256-GCM ключом, выведенным из двенадцати слов, и этот ключ никогда не покидает ваши экземпляры. Ретранслятор узнаёт хеш, группирующий соединения, для какого экземпляра сообщение, его размер и когда оно проходит. Прямой вызов в локальной сети запечатывается так же и ещё подписывается, так что ничто не зависит от самоподписанного сертификата, который отдаёт экземпляр. Вызовы, что-то выдающие (ответы на роли, пароль restic, входы приёмника, передача ключей на хранение), ещё и подписываются ключом отправляющего участника, закрепляемым при первой встрече. См. Модель безопасности.
Что идёт через группу. Состояние защиты на странице «Экземпляры», запрос проверить один раздел сейчас, запросы ролей и ответы на них, предложения хранилища и то, что нужно приёмнику или подтягивающему, когда его роль разрешена: расположения репозиториев другого экземпляра и его пароль restic. Данные копий никогда. Они по-прежнему идут прямо в бэкенды restic. И не APP_KEY: пароль restic открывает репозитории этого экземпляра и больше ничего, ни его сохранённые секреты, ни сеансы, ни коды восстановления.
Записи, оставшиеся с времён до сопряжения. Экземпляры, добавленные по токену флота, а также принятые репозитории и источники подтягивания, настроенные с APP_KEY другого экземпляра, остаются после обновления и помечаются Сопрячь заново. Они продолжают работать: при первом запуске BombVault заменяет каждый сохранённый APP_KEY выведенным из него паролем restic. Сопрягите оба экземпляра, затем измените запись и выберите её экземпляр. До тех пор такие записи стоят в карточке Без экземпляра на странице «Экземпляры».
Единственное место, которое всё ещё принимает APP_KEY вручную, — Из старой папки с копиями, на случай, когда другой экземпляр пропал и не может ответить в группе.
Крепость¶
Крепость объединяет BombVault с другими приложениями семейства, такими как ShipLog, TowerTorch, FireSquire и TollRoll, под одной фразой из двенадцати слов. Это фраза со страницы «Сопряжение»: слова, которые сопрягают ваши экземпляры и телефоны, приводят и другие приложения. Введите слова BombVault в другом приложении или введите слова, которые показывает другое приложение, через Ввести фразу на BombVault, который ещё не состоит ни в одной группе. Когда фраза меняется, экземпляры и телефоны, с которыми сопряжён BombVault, переходят вместе с ним без нового сопряжения, а тот, что был недоступен, догонит их, как только вернётся. Старая фраза действует, пока не перейдут все устройства, но не дольше 30 дней. Устройство, которого и после этого не хватает, указано на странице «Сопряжение» и в приложении, чтобы вы могли ввести на нём фразу или удалить его.
- Имя экземпляра: единственное имя, под которым этот экземпляр виден на других своих экземплярах, на своих телефонах и в других приложениях. Если оставить его пустым, используется имя сервера Unraid.
- Другие приложения: если включено Показать другие приложения крепости, они стоят под участниками в таких же карточках, каждое со своим логотипом, если приложение его публикует.
- Разрешения: всё, что одно приложение может делать у другого, включается своим переключателем, например видеть, когда последняя резервная копия удалась, запрашивать резервную копию контейнера или просматривать резервные копии. Сначала все они включены.
- Показать фразу показывает слова рядом с QR-кодом, после того как вы введёте свой пароль. Сменить даёт крепости новую фразу, которая доходит до каждого доступного приложения и экземпляра. Старая фраза работает ещё 30 дней, а страница «Сопряжение» называет каждое устройство, до которого смена не дошла. Покинуть выводит BombVault из крепости и из его группы.
Что делают другие приложения. ShipLog просит резервную копию контейнера перед его обновлением, а BombVault оставляет обновление контейнеров, за которые отвечает ShipLog, ему самому, поэтому переключатель Обновлять после успешного резервного копирования у них остаётся выключенным. TowerTorch просит резервную копию перед обслуживанием, а FireSquire проверяет, когда в последний раз делалась резервная копия флешки. Запрос ждёт, пока идёт другое резервное копирование. TollRoll показывает BombVault в своей плитке на панели Unraid. Другие приложения читают состояние BombVault по адресам GET /api/fortress/v1/status и GET /api/fortress/v1/log, и то же самое можно прочитать с токеном API или в браузере, где выполнен вход.
Собственная резервная копия приложения. Прежде чем BombVault сделает резервную копию контейнера приложения, которое умеет само делать свою резервную копию, он забирает собственную копию этого приложения и хранит её в репозитории контейнера, но только если этот репозиторий зашифрован. Она видна в списке резервных копий контейнера с именем приложения и загрузкой, стареет вместе с копиями контейнера, вместе с ними попадает во внешние копии и вместе с ними удаляется. Если включено Возвращать резервные копии приложениям, Вернуть в снова передаёт её приложению, и она заменяет то, что у приложения есть сейчас. Этот переключатель выключен, пока вы его не включите.
Экземпляры и роли¶
Страница Экземпляры (плитка настроек, которую можно закрепить в боковой панели) показывает группу как сеть того, кто что для кого делает, с карточкой для этого экземпляра и карточкой для каждого другого участника, телефонов Android, серверов ZFS и узлов этого экземпляра. Сопряжение внизу справа ведёт на страницу сопряжения, а Добавить узел рядом добавляет узел. Какие части включены, задаётся в Настройки, Экземпляры, Несколько серверов: Экземпляры, Приёмник и Подтягивание.

Каждая карточка показывает состояние защиты участника и его роли плитками. Роль — это то, что один экземпляр делает для другого:
- Приёмник хранит внешние копии этого сервера в rest-server в режиме append-only. Этот сервер отправляет после каждой копии и ничего там удалить не может, даже если кто-то им завладеет.
- Подтягивающий забирает копии этого сервера по своему расписанию. Этому серверу для этого бодрствовать не нужно. Экземпляру, который подтягивает, нужно включённое Подтягивание, прежде чем он сможет разрешить запрос.
- Сервер ZFS принимает реплики ZFS этого сервера. Каждая запись ZFS выбирает его в Реплика в своих настройках.
- Хранитель ключа хранит запечатанную копию набора для восстановления этого сервера. См. Хранитель ключа.
Включение роли отправляет запрос, и ничего не начинается, пока кто-нибудь на другом экземпляре не нажмёт Разрешить. Запрос показывается на карточке этого экземпляра значком, а его Подробнее перечисляет его с Разрешить и Отклонить. Разрешённую роль там можно в любой момент отозвать. Пунктирная линия в сети — роль, которая ещё ждёт. Экземпляр на BombVault 9.x не может ответить на запрос, поэтому роль там активна, как только вы её включите, а запрос от экземпляра 9.x ждёт Разрешить здесь.
Подробнее на карточке открывает остальное: принятые репозитории и источники подтягивания этого участника, предложения хранилища, мониторинг, Удалить и Забыть ключ.
Под карточками находятся карточка Общий репозиторий на машине с принимающим сервером и карточка Общие репозитории на участнике. Обе относятся к общему репозиторию.
Участник может предложить своё внешнее хранилище другому участнику через группу. Другой администратор видит предложение в Подробнее участника и принимает или отклоняет его. Принятие создаёт сохранённые учётные данные и обычное место назначения после тех же проверок, что и для места, которое вы вводите сами. Место назначения приходит с включённой защитой от удаления, потому что предложение показывает рецепт для rest-server в режиме append-only, так что Как долго хранить там не действует. У каждого предложения свой вход и своя папка, поэтому новое предложение раздела, тому же участнику или другому, не затрагивает копии первого партнёра: добавьте новую строку в .htpasswd и оставьте сервер работать. Так передаются только данные подключения, но никогда данные копий. Проверить сейчас просит участника проверить репозиторий одного раздела. Участники не трогают копии друг друга: ничто на странице не запускает копирование на другом участнике, ничего там не восстанавливает и ничего там не удаляет.
Узлы устроены иначе, потому что они не участники. Узел это BombVault без веб-интерфейса, который получает команды от этого экземпляра, поэтому этот экземпляр запускает на нём копирование и восстановление и чистит его старые копии. У каждого узла есть карточка с его состоянием, версией, местом, куда идут его копии, и временем копирования каждого раздела, с кнопками Изменить назначение, Заменить и Отвязать. Новый узел показывает Ожидание узла, пока не ответит в первый раз, а отвязанный, которого нет на месте, показывает Отвязывается. См. Узлы.

Выключенные экземпляры и телефоны с закрытым приложением сохраняют свою карточку как Неактивен, серой, с указанием, когда их видели в последний раз, и стоят приглушёнными в сети, пока вы их не Удалите. Сразу после запуска этого сервера такая карточка пишет Проверка, пока группа не вернётся. Удалить работает на такой карточке, какие бы части ни были включены, и также завершает открытые запросы участника, его простаивающие слоты приёма ZFS и его ждущие запросы ключа. Карточка Экземпляры на странице сопряжения тоже перечисляет таких участников как Неактивен.
Приёмник и подтягивающий¶
На машине, которая принимает копии append-only от другого BombVault, принятые репозитории дают независимый мониторинг только для чтения на принимающем оборудовании, так что тихий сбой на дальнем конце не останется незамеченным. Включите Приёмник в Настройки, Экземпляры, затем откройте Подробнее отправляющего экземпляра на странице «Экземпляры» и добавьте принятый репозиторий (только чтение, открывается паролем restic отправляющего экземпляра, который он получает через группу сопряжения). Вы получаете:
- Опись по источникам, чтобы видеть, какие именно контейнеры, виртуальные машины и наборы папок приземлились. Копии, которые отправитель сделал до того, как у него появился собственный хост, относятся к тому же источнику.
- Последний приём по источнику, чтобы знать, насколько свеж каждый.
- Независимую проверку
restic checkна принимающем оборудовании, чтобы целостность проверялась там, где данные действительно лежат, а не только у отправителя. - Выключатель мёртвой руки: оповещение, когда источник перестаёт отправлять в заданное вами окно. Он смотрит раз в день, в 09:15. Одно оповещение приходит и тогда, когда репозиторий вообще не читается, что бы ни говорило расписание проверок, и когда за целое окно после добавления ничего не пришло. Репозиторий, добавленный до первой копии отправителя, до этого момента считается в порядке.
- Оповещения о целостности: оповещение, когда проверка на принимающей стороне не удалась. Проверка, которая не смогла открыть репозиторий, ничего не говорит о целостности, поэтому не выносит вердикта и повторяется на следующий день в то же время.
Репозиторию на другом сервере нужен вход на этот сервер: сохраните его как учётные данные и выберите их в Учётные данные в диалоге.
Приёмник строго только читает. Он никогда не пишет в принятый репозиторий, так что никогда не может нарушить гарантию append-only, на которую рассчитывает отправитель.
Подтягивающий работает наоборот: с включённым Подтягивание экземпляр читает копии другого участника по своему расписанию в собственный репозиторий для каждого источника, так что они никогда не считаются собственными копиями этого сервера. Его источники тоже стоят в подробностях этого участника: расположение репозитория, какой вид копии он хранит и как часто забирать. Пароль restic приходит через группу, но никогда не APP_KEY, а на дальней стороне больше ничего настраивать не нужно, и ей не обязательно работать. Источник только читается, и каждая сторона хранит свои учётные данные. Подтягивание выполняется в день и время, указанные в его расписании, и новый источник тоже ждёт этого времени. Подтянуть сейчас не ждёт. Подтягивание, пропущенное из-за того, что сервер был выключен, выполняется, как только он снова работает. Неудавшееся повторяется на следующий день в то же время, даже при еженедельном расписании, а неудавшееся подтягивание видно в журнале активности и отправляет одно оповещение, пока подтягивание снова не заработает. Источник rclone: отклоняется, потому что rclone дотянулся бы до него с удалёнными ресурсами этого экземпляра.
Подтянутая копия только растёт. BombVault дописывает в неё, но не очищает и не проверяет, так что то, что источник давно забыл, остаётся здесь, пока вы не удалите папку, а страница «Места назначения» её не учитывает. Она лежит в pulled/<source id> внутри собственной папки раздела. Когда эта папка переезжает, копия остаётся где была, и следующие подтягивания продолжаются там, а не копируют всё заново. Если её удалить, следующее подтягивание начнёт заново в той собственной папке, которая будет у раздела к тому моменту.
Принимающий сервер¶
Принимающая машина может запускать и rest-server, в который копируют остальные. Он настраивается, когда вы впервые разрешаете запрос Приёмник, который его просит: окно говорит, что серверу нужен принимающий сервер, и просит папку на общем ресурсе, с Новая папка, чтобы создать её, и порт (8000, если его не занимает другой контейнер). Затем BombVault:
- отказывается, если контейнер с именем
rest-serverуже существует или порт занимает другой контейнер, - скачивает
restic/rest-serverи запускает его через сокет Docker в режиме append-only с частными репозиториями и файлом входа в папке, - записывает его шаблон Unraid на флешку, чтобы контейнер оставался редактируемым на вкладке Docker, или предлагает шаблон на скачивание, если флешка недоступна,
- запускает на нём тест на подделку и показывает, отказывает ли он в удалении.
Экземпляры вашей группы затем находят сервер среди провайдеров в Из вашей группы под названием принимающей машины, а роль Приёмник предлагает его как безопасный выбор. Каждый экземпляр получает собственный логин при первом использовании сервера и пишет только в свою папку там. С включённым Приёмник в Настройки, Экземпляры, Принимающий сервер на карточке этого экземпляра снова открывает сервер. Его окно перечисляет логины в Партнёры с логином, а Отозвать логин убирает один. То, что этот экземпляр уже скопировал, остаётся в папке. Настройка также создаёт один Логин вне группы, пароль которого окно показывает один раз.
Экземпляр, который достаёт до принимающей машины только через ретранслятор, не может использовать сервер, потому что ретранслятор не несёт копий. Сначала добавьте адрес принимающей машины на странице сопряжения. Когда BombVault работает на собственном IP-адресе (например в br0), заполните Адрес для партнёров, потому что сервер слушает адрес хоста.
Принимающая машина может также держать для группы общий репозиторий и принимать копии узлов этого экземпляра по своему Адрес для узлов.
Общий репозиторий¶
Несколько серверов группы могут вместе копировать в один репозиторий restic. Общие для них данные, например одинаковый набор папок или одинаковые appdata, хранятся там только один раз, поэтому вместе им нужно меньше места, чем с отдельным репозиторием у каждого.
Один сервер группы держит репозиторий, это владелец. Только он забывает там старые копии и очищает репозиторий. Остальные серверы являются участниками: они достают до репозитория через второй rest-server в режиме append-only и могут только добавлять. Каждый сервер пишет под собственным хостом, поэтому копии не смешиваются, даже если у двух серверов есть записи с одинаковым именем.
Что для этого нужно:
- группа сопряжения,
- включённое Шифровать копии у владельца и у каждого участника, потому что каждый сервер получает собственный ключ restic,
- принимающий сервер у владельца, до которого могут достать участники. Когда BombVault работает на собственном IP-адресе, сначала заполните Адрес для партнёров в окне принимающего сервера.
Сервер держит не больше одного общего репозитория.
Настройка¶
Когда принимающий сервер работает, на странице Экземпляры его машины под экземплярами появляется карточка Общий репозиторий. Нажмите Настроить общий репозиторий, выберите Папка для общего репозитория на общем ресурсе с большим запасом места, оставьте Порт 8001, если его не занимает другой контейнер, и нажмите Настроить и запустить. Затем BombVault:
- отказывается, если контейнер с именем
rest-server-sharedуже существует или порт занимает другой контейнер, - создаёт репозиторий в папке
sharedвнутри выбранной папки, с паролем этого сервера, - запускает
restic/rest-serverкакrest-server-sharedв режиме append-only с файлом входа в папке, - на Unraid записывает его шаблон на флешку, чтобы контейнер оставался редактируемым на вкладке Docker,
- запускает на нём тест на подделку. Проверить снова на карточке запускает его ещё раз.
В разделе Участники карточка показывает каждого участника с его ключами и последней копией, просьбы о вступлении и Удалить у каждого участника.
Вступление¶
На сервере, который хочет вступить, откройте Добавить место назначения. В Из вашей группы владелец появляется второй раз, как Общий репозиторий на и его имя. Если выбрать его, владелец получит просьбу, и она появится на его карточке Общий репозиторий с Разрешить и Отклонить.
После Разрешить владелец через группу выдаёт одноразовый ключ и логин на своём втором rest-server. С их помощью участник добавляет собственный ключ restic, а владелец затем удаляет одноразовый ключ. Если участник не закончил за сутки, одноразовый ключ и логин снова пропадают, и он может попросить ещё раз. Если владелец не смог доставить участнику ответ, карточка предлагает Сообщить ещё раз.
Владелец отказывает серверу, который ещё не пишет под собственным хостом, то есть работает на более старом выпуске, а также серверу, под чьим хостом уже пишет другой участник. Два сервера делят хост, когда у них общий APP_KEY.
Когда участник вступил, в Места назначения появляется место с именем Shared with и именем владельца, со всеми выключенными разделами. Включите на странице места разделы, которые должны туда копировать. У места есть защита от удаления и нет собственных правил хранения, потому что забывает там только владелец. Туда идут только копии под собственным хостом участника, так что старые копии под хостом bombvault остаются на месте.
Владелец тоже может копировать туда свои копии: Копировать сюда и резервные копии этого сервера на его карточке добавляет такое место и у него. Для владельца эта копия лежит на его собственных дисках, и ничто не мешает ему там удалять, так что внешней копией она не считается.
Кто наводит порядок и когда¶
Забывает и очищает только владелец. Его настройки находятся в части Общий репозиторий окна Принимающий сервер, которое открывается с собственной карточки владельца на странице «Экземпляры»:
- Окно обслуживания задаёт, когда идёт очистка, ежедневно или еженедельно. Пока вы его не измените, оно начинается по воскресеньям в 03:00, а Длина окна в часах равна 6.
- Неиспользуемое место, которое может оставить очистка, в % равно 5, если вы его не измените. Чем выше значение, тем меньше перепаковки, и очистка заканчивается быстрее.
- Данные, перечитываемые после очистки, в % равно 5, если вы его не измените. После каждой очистки владелец проверяет репозиторий и перечитывает эту долю данных.
- Как долго хранить следует внешним правилам владельца для каждого раздела, а Задать своё правило даёт общему репозиторию собственное. Копии каждого сервера стареют сами по себе.
- Провести обслуживание сейчас сразу забывает, очищает и проверяет, предварительно предупредив участников.
Вне окна владелец забывает раз в день, а место возвращается со следующей очисткой. Перед очисткой он предупреждает участников, и они ничего не копируют в репозиторий, пока окно не закроется. Участник, который ещё копирует, получает до получаса, чтобы закончить, иначе очистка переносится на следующее окно. Копия, которая попадает в окно, ждёт, показывается как отложенная в журнале активности и на карточке участника, а следующий проход её догоняет.
Когда владелец не уверен, он хранит больше. Запись, которую участник удерживает из-за аномалии, сохраняет все свои копии. Участник, который не может сказать, что он удерживает, в этот раз сохраняет все свои копии. Копии под хостом, под которым не пишет ни один сервер группы, не забываются никогда. Окно также показывает место: сколько занимает репозиторий, сколько понадобилось бы серверам по отдельности и сколько это экономит. Цифры обновляются с каждым обслуживанием.
Что видят участники¶
На участнике страница «Экземпляры» содержит карточку Общие репозитории с каждым общим репозиторием, в который сервер копирует или в который просился, и с состоянием его просьбы: Ждёт согласия, Присоединяется, Участвует, Отклонено, Истекло или Не участник. Для репозитория, в котором сервер участвует, карточка показывает Кто очищает, Следующее обслуживание, Вместе с с остальными участниками, Последнее копирование сюда, а также сколько места репозиторий занимает и экономит.
Выход¶
Выйти на карточке участника выводит сервер: владелец удаляет его ключ и логин, а его место назначения там выключается. Удалить на карточке владельца выводит участника с другой стороны. В обоих случаях копии сервера остаются в репозитории и стареют по правилам владельца. У владельца они стоят в Вышедшие серверы, где Забыть резервные копии забывает их все, когда вы введёте имя сервера. Следующее окно обслуживания возвращает место.
Копии других серверов¶
Каждый сервер находит свои копии в общем репозитории на вкладке Резервные копии своих записей, как любую другую копию. Копии остальных участников находятся на странице «Восстановление» в Другие серверы.
После аварии¶
В наборе для восстановления есть глава Shared repositories. Она называет каждый общий репозиторий с его владельцем, разделы, которые туда копируют, остальных участников с их хостами и команду restic snapshots с хостом этого сервера. Набор владельца также называет порт, папку и логин его rest-server.
В аварийном мастере репозиторий показывается среди мест как Общий репозиторий на сервере и имя владельца. Новая установка, которая перенимает ключ участника, пишет под тем же хостом, потому что хост берётся из ключа. Она получает обратно своё место назначения в общем репозитории и видит и восстанавливает там только свои копии.
Новая установка, которая перенимает ключ владельца, становится владельцем вместо него. Она, как и раньше, забывает старые копии и обслуживает репозиторий и снова запускает rest-server на той же папке. Снова сопрягите её с группой, настройте её принимающий сервер на странице Экземпляры и заново задайте правила в окне принимающего сервера, потому что в наборе их нет. Как только группа достаёт до участников, новый владелец сам им сообщает. Каждый участник сначала проверяет: он добавляет в репозиторий одноразовый ключ, который может удалить только сервер с доступом к папке репозитория, и переходит к новому владельцу, как только этот ключ исчезает. Если новый владелец отвечает по другому адресу, каждый участник проводит там эту проверку со своим ключом и логином, убеждается, что находит тот же репозиторий, и только потом переводит свои места назначения на новый адрес. До тех пор он продолжает копировать на старый адрес, и его карточка сообщает, почему. Ключи, оставшиеся от таких проверок, владелец удаляет при следующем обслуживании.
Если старый владелец ещё работает, его карточка сообщает, что репозиторий теперь держит другой сервер. Вернуть снова делает его владельцем, на случай если набор по ошибке перенят на втором сервере.
Ограничения¶
- Каждый ключ читает всё. Все ключи репозитория restic открывают один и тот же мастер-ключ, поэтому каждый участник может читать копии остальных. Определения контейнеров и виртуальных машин остаются запечатанными собственным ключом каждого сервера, так что контейнеры и виртуальные машины другого сервера возвращаются только как файлы. Сервер, у которого когда-то был доступ, мог прочитать мастер-ключ, поэтому его удаление не закрывает ему доступ навсегда. Это делает только новый репозиторий.
- Владелец может удалять. Ни один участник ничего там удалить не может, но владелец обращается к папке напрямую и забывает и очищает копии каждого участника. Ошибка или захват владельца затрагивает их всех.
- Повреждение затрагивает каждый сервер. Испорченного пака не хватает каждому серверу, чьи копии его используют, поэтому общий репозиторий не заменяет вторую копию.
- Только на принимающем сервере. S3, SFTP и другие места не могут ограничить участника одним добавлением, поэтому BombVault предлагает общий репозиторий только на принимающем сервере.
- Только как цель копирования. Собственная папка раздела не может лежать в общем репозитории, потому что каждая очистка задерживала бы копии всех серверов.
- Старая история остаётся на месте. Туда попадают только копии под собственным хостом каждого сервера, и ничего не переносится из других репозиториев.
Пример: сопряжение двух серверов Unraid¶
Это одна полная настройка из описанных частей, потому что собирать их проще, увидев уже собранными.
Две машины: TOWER запускает контейнеры и отправляет копии. VAULT их принимает и обеспечивает append-only. Подставьте свои имена, адреса и пути к ресурсам.
1. Сопрягите две машины. На TOWER откройте Настройки, Сопряжение, нажмите Сгенерировать фразу и введите двенадцать слов на VAULT в Ввести фразу. Сначала задайте пароль для входа на обеих.
2. На TOWER попросите VAULT быть приёмником. На странице «Экземпляры» включите Приёмник на карточке VAULT, выберите разделы и принимающий сервер VAULT как место и отправьте запрос.
3. На VAULT разрешите. Страница «Экземпляры» на VAULT показывает запрос на карточке TOWER. Нажмите Разрешить. В первый раз VAULT просит папку для своего принимающего сервера, например user/appdata/rest-server, запускает rest-server в режиме append-only и выполняет на нём тест на подделку.
4. Снова на TOWER. С этого момента TOWER копирует на VAULT после каждой копии, а новое место назначения появляется на странице мест назначения TOWER с его защитой от удаления.
Что отвечает тест на подделку:
| Результат | Что произошло |
|---|---|
| защищено | VAULT отказал в удалении. Это единственное проходное состояние. |
| не защищено | VAULT принял удаление. --append-only отсутствует или был убран. |
| неубедительно | Ни то, ни другое. Обычно URL не тот, который использует сам restic, или учётные данные изменились. Ничего не записывается, оповещение не срабатывает. |
5. При желании следите за тем, что приходит. Включите Приёмник в Настройки, Экземпляры на VAULT, откройте Подробнее у TOWER и добавьте принятый репозиторий: нажмите одно из мест, которые перечисляет диалог. VAULT получает пароль restic от TOWER через группу, а поскольку место лежит на собственном принимающем сервере VAULT, он читает папку напрямую. Никто не набирает ни ключа, ни данных для входа.
6. Сделайте это взаимным. Повторите шаги в обратную сторону: VAULT просит TOWER стать его приёмником. Тогда каждая машина обеспечивает append-only для другой, и ни одна не может удалить копии другой.
Rest-server, который вы запускаете вручную, тоже подходит: добавьте его через Добавить место назначения как rest-server с пользователем и паролем из его .htpasswd и включите защиту от удаления. Сохраните --append-only в его параметрах. Без него дальняя сторона снова становится обычным общим ресурсом.
Локальный путь — это путь внутри контейнера
Там, где BombVault просит папку на этом сервере, вводите её относительно монтирования хоста, например user/appdata/rest-server/bombvault-containers, а не /mnt/user/appdata/.... BombVault работает в контейнере, где /mnt хоста смонтирован в другом месте. Абсолютного пути хоста внутри него не существует. Если вы вставите такой, BombVault подскажет вместо него относительный путь.
Аварийный мастер¶
Аварийный мастер возвращает сервер, которого больше нет или который настроили заново. Он запускается на странице «Восстановление» в разделе Аварийное и по кнопке Восстановить из резервной копии на странице приветствия новой установки. Он идёт в четыре шага: Доступ, Настройки, Выбор и Восстановление.
-
Доступ. Покажите BombVault ключ старых копий одним из трёх способов:
- Загрузить набор для восстановления: файл, который вы скачали при настройке. В нём лежат ключ и каждое место назначения, и BombVault заполняет остальное по нему. Набор, запечатанный age, просит идентификатор, для которого он запечатан. Он используется один раз и не сохраняется.
- Через группу: экземпляр вашей группы хранит ключ как депозит. Вам нужны двенадцать слов группы, ваш код выдачи и кто-нибудь у этого экземпляра. См. Хранитель ключа.
- Ввести ключ:
APP_KEYстарого сервера и место, где лежат его копии.
Затем BombVault пробует ключ на каждом месте назначения и сообщает по каждому, читается ли оно, не найдено, заблокировано другим ключом, недоступно или пока без учётных данных. Ничего ещё не сохранено, а ключ остаётся в памяти ограниченное время. Перенять ключ заставляет этот сервер с этого момента писать свои копии этим ключом. Отменить перенятие возвращает собственный ключ, пока не прошла первая копия. Сервер, у которого уже есть собственные копии, отказывается от перенятия и отсылает к Из старой папки с копиями. Сохранить учётные данные сохраняет учётные данные, которые набор несёт для удалённых мест назначения, и спрашивает, прежде чем заменить учётные данные, уже имеющиеся на этом сервере. 2. Настройки. Вернуть настройки восстанавливает собственные настройки BombVault из новейшего автобэкапа: места назначения, учётные данные, расписания и правила. Чтобы применить их, BombVault перезапускается через сокет Docker, так что живая база данных настроек никогда не перезаписывается под открытым дескриптором, а мастер потом продолжает сам. Вход на этом сервере сохраняется: вы по-прежнему входите с тем паролем, который используете сейчас. Секреты, которые хранил старый сервер и которые нельзя перенять, перечислены, чтобы вы могли ввести их заново. Восстановление завершает все сеансы и удаляет ключи доступа, так что потом настройте их заново. 3. Выбор. BombVault просматривает ваши копии и перечисляет найденные контейнеры, виртуальные машины, наборы папок и наборы данных ZFS. Самый новый снимок везде выбран заранее. То, что на этом сервере ещё есть, сначала выключено, потому что восстановление это заменило бы. Наборы папок после перестройки больше не знают, откуда они, поэтому они идут в выбранную вами папку. 4. Восстановление. Всё выбранное возвращается за один раз, остановленным, если вы хотите запускать каждый контейнер и виртуальную машину сами, что надёжнее всего после полной потери. Потом скачайте новый набор для восстановления: старый принадлежит прежней установке.
Общий репозиторий из набора показывается среди мест как Общий репозиторий на сервере и имя сервера, который его держит, а мастер перечисляет там только собственные копии этого сервера. См. После аварии.

Пример: новый сервер из набора для восстановления¶
Сервер TOWER погиб вместе с дисками. В нём были 23 контейнера и 2 виртуальные машины, и он копировал их и свой автобэкап в Backblaze B2. У вас есть bombvault-recovery-kit.md из менеджера паролей и новая машина с Unraid. Его старого APP_KEY больше нет, и он вам не нужен.
- Установите BombVault на новую машину и дайте ему новый
APP_KEY, как при любой новой установке. Настройте соединение для виртуальных машин в Настройки, Интеграции, SSH хоста, если хотите вернуть виртуальные машины, потому что оно нужно для их восстановления. - Запустите мастер. На Добро пожаловать в BombVault выберите Восстановить из резервной копии. На странице «Восстановление» выберите Запустить аварийный мастер в Аварийное.
- Доступ. Выберите Загрузить набор для восстановления и перетащите файл. BombVault пробует его ключ на каждом месте назначения и сообщает, например, Набор для восстановления прочитан. Его ключ открывает 0 из 2 мест назначения. Локальная папка пишет не найдено, раз диск погиб, а Backblaze B2 пишет нет учётных данных.
- Сохранить учётные данные. Набор несёт учётные данные каждого места. Нажмите Сохранить учётные данные, и места пробуются снова, так что Backblaze B2 теперь пишет читается. Набор, записанный до 10.5, содержит только учётные данные по умолчанию. Если у места всё ещё написано нет учётных данных, введите его учётные данные в Ввести недостающие учётные данные и нажмите Проверить места назначения ещё раз.
- Перенять ключ. Теперь этот сервер пишет копии старым ключом, так что новые копии подходят к старым. Свой
APP_KEYв шаблоне он сохраняет. Отменить перенятие работает, пока не прошла первая копия. - Настройки. Шаг открывается на месте, где ключ нашёл автобэкап, здесь это B2, и его адрес уже заполнен. Выберите Вернуть настройки, что читает оттуда новейший автобэкап. BombVault перезапускается, чтобы его применить, и мастер продолжает сам. Ваши места назначения, расписания и правила вернулись, а входите вы по-прежнему с паролем этого сервера. Введите заново секреты, которые перечисляет мастер, например настройки уведомлений.
- Выбор. Где находятся резервные копии? открывается на внешних копиях, когда локально ничего не осталось. BombVault читает каждое место, так что одно мёртвое не скрывает остальные, перечисляет 23 контейнера и 2 виртуальные машины и восстанавливает каждый из того места, где лежит его самый новый снимок.
- Восстановление. Включите Оставить остановленным, что надёжнее всего после полной потери, и запускайте. Что произойдёт говорит, что вернётся. Строка результата читается, например, Восстановлено 25, ошибок 0. Запустите их в Резервные копии, когда понадобится.
- Завершение. Сначала запустите базы данных, затем приложения, которые ими пользуются. Откройте Настройки, Восстановление и скачайте новый набор для восстановления, потому что старый принадлежит прежней установке. Проверьте Требует внимания в обзоре и выполните Создать копию всего сейчас, когда всё заработает.
Если автобэкапа тоже нет, шаг открывается на Пропустить — Автобэкапа у меня нет и сообщает об этом. Тогда места назначения берутся только из набора, вы заново настраиваете расписания и правила, а внешние копии ждут, пока вы не примете их копии как копии этого сервера, см. После перестройки. Выбор по-прежнему перечисляет, что хранят внешние копии. Наборы папок восстанавливаются в выбранную вами папку. Контейнеры и виртуальные машины возвращаются как обычные файлы в папку в Вернуться могут только файлы, потому что их определения лежат рядом с локальным репозиторием и в автобэкапе, а во внешней копии нет ни того, ни другого.
Плановый переезд или авария
Аварийный мастер восстанавливает собственные настройки BombVault из копии. Для планового переезда на новый сервер можно вместо этого перенести конфигурацию напрямую карточкой Экспорт / импорт настроек (переносимый файл JSON). См. Конфигурация.
Из старой папки с копиями¶
Из старой папки с копиями в Другие источники на странице «Восстановление» открывает репозиторий другого экземпляра BombVault (общий ресурс, смонтированный в /mnt, или удалённый адрес) с набором для восстановления этого экземпляра или введённым APP_KEY в одноразовом сеансе только для чтения. Просматривайте хранящиеся там контейнеры, виртуальные машины, наборы папок и наборы данных ZFS, выберите снимок и восстановите его, и восстановленный объект станет обычным локальным контейнером, виртуальной машиной или набором папок. В другой репозиторий никогда ничего не пишется, а ваши собственные настройки копирования остаются нетронутыми (сеанс живёт в памяти и истекает сам). Перенос контейнера с сервера A на сервер B не означает перенаправления ваших настроек и их последующего возврата. Это окно одноразовое: оно открывает сеанс, восстанавливает выбранное вами и забывает другой экземпляр. Если вместо этого нужна постоянная схема, где эта машина по расписанию забирает снимки другого экземпляра в собственный репозиторий, то это роль Подтягивающий на странице «Экземпляры».
Что подтянул этот сервер¶
У каждого источника, из которого этот сервер подтягивал копии, есть своя строка Получено из в Другие источники на странице «Восстановление». Подтянутая копия заперта собственным ключом этого сервера, а не ключом источника, поэтому ничего не спрашивается: ключ источника её не открывает. Наборы папок и наборы данных ZFS восстанавливаются в выбранную вами папку. Контейнеры и виртуальные машины возвращаются как обычные файлы в папку, потому что подтягивание переносит снимки, но не определения. Чтобы создать их заново, используйте набор для восстановления и автобэкап источника в аварийном мастере.
Контейнер, чьей сети на этом сервере не существует, например сети Unraid br0 на обычном хосте Docker, показывает под своей строкой выбор сети. BombVault создаёт его в выбранной вами сети вместе с его остальными сетями. Фиксированные IP и MAC-адрес принадлежали старой сети и отбрасываются, так что новая сеть назначает их сама.
Хранитель ключа¶
Хранитель ключа — экземпляр вашей группы, который держит запечатанную копию набора для восстановления этого сервера. Сам открыть копию он не может. Если этот сервер когда-нибудь будет потерян, новая установка, вступившая в вашу группу, просит у хранителя копию и открывает её вашим кодом выдачи.

- На странице «Экземпляры» включите Хранитель ключа на карточке экземпляра, который должен его хранить, и выберите Сделать депозит. Для депозита нужен пароль для входа.
- Этот сервер один раз показывает Код выдачи: двадцать букв и цифр четырьмя группами по пять. Запишите его и подтвердите кнопкой Код у меня записан. Этот сервер код не хранит, только то, что нужно для запечатывания под него депозита.
- Теперь хранитель держит депозит, а этот сервер обновляет его, когда набор меняется. Депозит ключа на карточке этого экземпляра перечисляет Депозит этого сервера у каждого хранителя с его состоянием и Депозиты, которые хранит этот сервер для остальных. Создать новый код заменяет код. Каждый хранитель переходит на новый, когда получает новый депозит.
В тот день вам понадобятся три вещи: двенадцать слов вашей группы, код выдачи и доступ к интерфейсу хранителя, где кто-то должен нажать Разрешить. В аварийном мастере выберите Через группу, выберите депозит, запросите его и введите код выдачи. Код используется на новом сервере и хранителю не отправляется. У хранителя запрос показывается в Депозит ключа с тем, кто просит, видели ли этот экземпляр там раньше и как часто он просил. Разрешить выдаёт запечатанную копию, а для разрешения нужен пароль для входа. У новой установки есть 30 минут, чтобы забрать её после «Разрешить», запрос, на который никто не ответил, истекает через день, а экземпляр, который просит слишком часто, должен ждать час.
Депозит несёт и APP_KEY каждого узла этого сервера, потому что их содержит набор. С кодом хранитель мог бы открыть их репозитории, но никогда не сможет командовать узлом, потому что для этого нужна подпись этого сервера.
Без кода копию не откроет никто, хранитель тоже. Если код потерян, создайте новый, пока этот сервер ещё работает. Если сервера уже нет, набор для восстановления и введённый APP_KEY всё равно работают. Хранитель может в любой момент удалить депозит, и владельцу тогда придётся просить снова.
Набор для восстановления¶
Это то, что делает аварийное восстановление возможным, даже когда никакого работающего BombVault нет.
Скачать набор для восстановления в карточке На экстренный случай в Настройки, Восстановление даёт вам ключ, выведенный пароль restic, каждое место назначения с репозиторием каждого раздела, учётные данные, которые нужны новой установке, чтобы до них достать, и точные команды restic, чтобы вы могли восстанавливать прямо через restic CLI на любой машине. Нужен пароль для входа. Набор печатает ключ и при выключенном шифровании, потому что определения контейнеров и виртуальных машин всегда запечатаны им. После перенятия он печатает перенятый ключ копий и APP_KEY этого сервера, который новой установке нужен только для возврата настроек. Карточка Сохраните набор для восстановления в обзоре напоминает об этом, пока вы его не сохраните.
Сервер с узлами получает в своём наборе главу Узлы. В ней указан каждый узел с его id, его APP_KEY, паролем restic, вычисленным из этого ключа, и репозиторием каждого раздела. Их открывает собственный пароль узла, а также пароль этого сервера, потому что этот сервер добавляет свой ключ в каждый репозиторий узла. Скачайте набор заново после того, как добавите узел или измените, куда идут его копии. С APP_KEY узла и его NODE_HOME новый сервер снова становится тем же узлом, см. Замена и отвязка.
Храните набор для восстановления вне сервера
Набор содержит секрет, который расшифровывает ваши копии. Храните его в надёжном месте отдельно от сервера (менеджер паролей, распечатка в сейфе). Если вы потеряете и BombVault, и APP_KEY, не имея ни набора для восстановления, ни депозита ключа, зашифрованные копии восстановить будет нельзя.
Самый новый снимок не всегда тот, который нужно восстанавливать
Начиная с restic 0.17, restic snapshots показывает размер каждого снимка. После потери данных самый новый снимок может оказаться опустошённым, поэтому не восстанавливайте снимок, который намного меньше предыдущих. После вымогателя это может быть зашифрованный снимок обычного размера. Если BombVault ещё работает, сначала посмотрите его страницу Аномалии: она называет последнюю хорошую копию, и окно восстановления выбирает её заранее. Для восстановления не нужны никакие данные аномалий BombVault, а пауза хранения только сохраняет больше снимков.
Хост копий сервера¶
Каждый сервер записывает свои копии под собственным хостом restic: bv- и двенадцать символов, вычисленных из ключа копий, например bv-3f9a0c41d2e7. Копии, сделанные до того, как у сервера появился свой хост, несут хост bombvault. Набор называет хост этого сервера, а его команды передают оба через --host, так что latest никогда не выберет копию, которую другой сервер записал в тот же репозиторий. Сервер, который перенял чужие копии, продолжает работать под хостом того сервера, потому что хост берётся из ключа. Для каждого общего репозитория, в который сервер копирует или который держит, глава набора Shared repositories называет остальные серверы в нём с их хостами.
Запечатывание набора¶
Если вы включили Шифровать экспорты с помощью age в Настройки, Система, набор запечатывается им тоже и скачивается как bombvault-recovery-kit.md.age. Он в формате ASCII armor, а не двоичный, поэтому остаётся простым текстом: вставка в менеджер паролей или печать работают точно так же, как раньше, но содержимое нечитаемо без вашего ключа.
Не храните ключ age внутри набора
Чтобы открыть запечатанный набор, нужен ваш закрытый ключ age. Храните его там, где он не зависит от самого набора, иначе вам придётся восстанавливать две вещи вместо одной. Запечатывание оправдано, когда набор хранится там, где вы не полностью контролируете доступ (общий менеджер паролей, облачные заметки, распечатка в офисе). Набор в вашем собственном сейфе уже защищён сейфом.
При включённом шифровании и без пригодного получателя скачивание отклоняется целиком. BombVault никогда не отдаёт главный ключ открытым текстом.
Если набора под рукой нет¶
Пароль нигде не хранится, он вычисляется из ключа копий, так что вы можете воспроизвести его сами, имея только ключ и оболочку:
printf 'bombvault:restic-repo' | openssl dgst -sha256 -mac HMAC -macopt hexkey:$APP_KEY -r | cut -d' ' -f1
Это HMAC-SHA256 от фиксированной строки bombvault:restic-repo с ключом из сырых байтов шестнадцатеричного APP_KEY, выведенный как 64 шестнадцатеричных символа в нижнем регистре. То же значение есть в наборе под названием «выведенный пароль restic». Это на тот день, когда набор находится там, где вас нет. На сервере, который перенял чужие копии, используйте перенятый ключ копий, то есть старый APP_KEY того сервера.
Хост получается из того же ключа и строки bombvault:host: bv- и первые двенадцать из этих символов.
echo "bv-$(printf 'bombvault:host' | openssl dgst -sha256 -mac HMAC -macopt hexkey:$APP_KEY -r | cut -c1-12)"
Для принятого репозитория используйте ключ ОТПРАВЛЯЮЩЕГО экземпляра
Репозиторий, который пришёл сюда через внешнюю копию, создан отправившей его машиной с её ключом. Пароль, выведенный из ключа принимающей машины, не подойдёт restic, и это выглядит точно как повреждённый репозиторий, хотя им не является. Это обычная причина того, что restic check на принятом репозитории снова и снова просит пароль.
Поскольку определения для восстановления лежат внутри каждого репозитория (<repo>/def, <repo>/vm-def), скопированная папка репозитория полностью автономна, так что набора вместе с репозиторием достаточно для восстановления на пустом железе. Внешняя копия и подтянутая копия хранят снимки без определений: они возвращают файлы, а контейнер или виртуальная машина создаются заново из автобэкапа.
Как вернуть дамп базы данных¶
Дамп базы данных — отдельная точка восстановления в репозитории контейнеров с тегом dbdump:<container>, содержащая один файл /dbdump/<container>.sql. BombVault перечисляет, скачивает и импортирует их на вкладке контейнера Резервные копии. Ниже те же шаги одним только restic на тот день, когда BombVault нет.
restic -r <repo> snapshots --host <host> --host bombvault --tag dbdump:<container>
restic -r <repo> dump --host <host> --host bombvault --tag dbdump:<container> latest /dbdump/<container>.sql > <container>.sql
<host> — это хост сервера из набора для восстановления.
Теги dbversion: и dbname: на каждом дампе говорят, с какой версии сервера он и какие базы данных содержит. Полный файл заканчивается строкой -- PostgreSQL database cluster dump complete или -- Dump completed.
Импортируйте его в контейнер той же или более новой версии (PostgreSQL) либо той же основной версии (MySQL и MariaDB), один раз запущенный с пустой папкой данных, чтобы он инициализировался. Хосту клиент базы данных не нужен, он есть в контейнере:
docker exec -i <container> sh -c 'exec psql -X -U "${POSTGRES_USER:-postgres}" -d postgres' < <container>.sql
docker exec -i <container> sh -c 'exec mariadb -uroot -p"$MARIADB_ROOT_PASSWORD"' < <container>.sql
docker exec -i <container> sh -c 'exec mysql -uroot -p"$MYSQL_ROOT_PASSWORD"' < <container>.sql
Для одной базы данных из полного дампа MySQL и MariaDB принимают --one-database <name> в команде клиента. Дамп PostgreSQL содержит по разделу на каждую базу данных, каждый начинается со строки \connect <name>: скопируйте этот раздел в отдельный файл и импортируйте его с -d <name> после создания базы данных.
Дамп от root несёт пользователей сервера
Полный дамп MySQL или MariaDB, снятый от root, содержит системную базу данных mysql, поэтому его импорт заменяет учётные записи нового сервера, включая пароль root, теми, что в дампе. В PostgreSQL сообщение role ... already exists для пользователя, созданного контейнером, ожидаемо и безвредно.