Узлы¶
Узел — это BombVault без веб-интерфейса, например на VPS или на небольшом сервере у друга. Он создаёт резервные копии контейнеров и папок на своём сервере, а BombVault, на котором вы его добавляете, на этой странице он называется домашним экземпляром, говорит ему, когда создавать копии и куда их отправлять. Управляете узлом вы из веб-интерфейса домашнего экземпляра, рядом со своими записями.

Как это работает¶
- Ключ узла хранится у домашнего экземпляра. Когда вы добавляете узел, домашний экземпляр создаёт его
APP_KEY, сохраняет его запечатанную копию и один раз отдаёт его вам в compose-файле узла. С этой копией домашний экземпляр достаёт до узла и открывает его резервные копии. - Узлу не нужен открытый порт. Домашний экземпляр и узел общаются через Relay по собственному закрытому каналу, отдельно от вашей группы сопряжения. Каждый вызов начинает и подписывает домашний экземпляр, а узел не просит у него ничего, кроме своего приветствия. Единственное назначение, которому нужен открытый порт, это хранение копий на узле.
- Резервные копии никогда не идут через Relay. Узел отправляет их прямо туда, куда вы выбрали: на принимающий сервер домашнего экземпляра, в одно из его мест назначения или на rest-server на самом узле.
- Узел ничего не планирует сам. Он не запускает расписаний, не шлёт уведомлений и не входит ни в группу, ни в крепость. Домашний экземпляр запускает его копирование, следит за ходом и отправляет оповещения.
- Узел копирует контейнеры и наборы папок. Виртуальные машины, флешка, наборы данных ZFS и копия настроек самого BombVault остаются за полными установками.
Канал использует собственный Relay домашнего экземпляра, если он есть в его группе, а иначе Relay проекта, даже когда домашний экземпляр сопрягается без Relay.
Перед началом¶
- Пароль для входа на домашнем экземпляре. Добавление узла, повторный показ его compose-файла и открытие его записей требуют входа с паролем, см. Вход.
- Docker с Compose на сервере узла.
- Место для копий, одно из трёх в разделе Куда идут копии. Принимающий сервер надёжнее всего, потому что узел ничего не может там удалить.
Добавление узла¶
- На домашнем экземпляре откройте Экземпляры и выберите Добавить узел внизу справа.
-
Название. Введите, как узел будет называться здесь, например как сервер, и выберите Далее.

-
Резервные копии. Выберите, куда идут копии, и заполните то, что спрашивает это место. Копирует ежедневно в задаёт время старта обоих разделов. Домашний экземпляр предлагает полчаса после копирования своих контейнеров, чтобы оба не обращались к одним и тем же дискам одновременно. Позже на карточке можно дать каждому разделу собственный план. Выберите Далее.

-
Запуск. Окно показывает compose-файл узла с заполненными
MODE,APP_KEY,NODE_HOMEиNODE_NAME. Скопируйте его и сохранитеAPP_KEYв надёжном месте. На сервере узла:mkdir -p /opt/bombvault-node && cd /opt/bombvault-node nano docker-compose.yml # paste the file from the window docker compose up -dПеред запуском направьте том Host Data на данные, которые хотите копировать, и задайте
HOST_SOURCE_ROOTтот же путь, как показано в примере ниже. -
Окно ждёт узел. Когда узел отвечает, домашний экземпляр сообщает ему, куда идут его копии, и проверяет, что узел до них достаёт, а окно пишет vps-helsinki в сети и получает команды от этого экземпляра.

Окно можно закрыть, не дожидаясь ответа узла. Тогда его карточка показывает Ожидание узла, а домашний экземпляр сообщит ему, куда идут копии, как только узел появится.
Пример: VPS, который копирует на принимающий сервер¶
Домашний экземпляр работает на машине Unraid по имени tower, на которой запущен принимающий сервер. Обратный прокси публикует его как https://backup.tower.example.org. На VPS vps-helsinki работают Nextcloud и Caddy, их данные лежат в /srv/appdata.
- На
tower: Экземпляры, Добавить узел, названиеvps-helsinki, Далее. - Выберите Принимающий сервер этого экземпляра и введите
https://backup.tower.example.orgв поле Адрес для узлов. Контейнеры домашнего экземпляра копируются в 02:30, поэтому окно предлагает 03:00. Оставьте это время и выберите Далее. -
На VPS сохраните файл из окна, поменяв тома и
HOST_SOURCE_ROOTпод/srv/appdata:services: bombvault-node: image: junkerderprovinz/bombvault:latest restart: unless-stopped hostname: bombvault-node container_name: bombvault-node volumes: - ./config:/config - /var/run/docker.sock:/var/run/docker.sock - /srv/appdata:/host/user environment: MODE: node APP_KEY: "<filled in by home>" NODE_HOME: "<filled in by home>" NODE_NAME: "vps-helsinki" PLATFORM: generic HOST_SOURCE_ROOT: /srv/appdata -
docker compose up -d. Через несколько секунд окно наtowerсообщает, что узел в сети, и Резервные копии идут в https://backup.tower.example.org. - В 03:00 домашний экземпляр запускает копирование узла. На следующее утро карточка Узлы в обзоре показывает последнюю копию
vps-helsinki, а Резервные копии перечисляют его контейнеры в отдельном разделе.
Как находятся данные контейнера на обычном хосте с Docker, описано в разделе Определение источника копии.
Куда идут копии¶
У каждого узла одно назначение для обоих разделов. Изменить назначение на его карточке меняет его, когда узел в сети. Новое место получает новые репозитории, а копии в старом месте остаются там, где были.
Принимающий сервер этого экземпляра¶
Узел пишет на принимающий сервер домашнего экземпляра в режиме append-only: он может добавлять копии, но не может удалить ни одной. Там он получает собственный логин, названный по имени узла, и по одному репозиторию на раздел в своей папке. Домашний экземпляр добавляет в каждый репозиторий свой ключ и сам их чистит, потому что узел этого не может.
Узел достаёт до сервера по Адрес для узлов, который вы задаёте на втором шаге или в окне Принимающий сервер. Обычно узел отправляет копии из интернета, поэтому адрес должен быть одним из этих:
https://, например за обратным прокси, Pangolin или туннелем. Если сервер показывает собственный сертификат, а не сертификат публичного центра, вставьте его в формате PEM в поле Сертификат.http://с частным IP-адресом, например10.0.0.5в канале WireGuard или100.101.102.103в Tailscale.
Простой http:// на публичный адрес отклоняется, потому что узел отправлял бы копии через интернет без шифрования. Когда вы меняете адрес, домашний экземпляр сообщает об этом каждому узлу на приёмнике, а узел, которого сейчас нет, узнает, когда вернётся.
Место назначения¶
Узел пишет в одно из мест назначения домашнего экземпляра, до которого достаёт сам: в сервис S3 или на сервер REST, по https:// или по частному адресу. Его репозитории лежат там в bombvault-node-<node id>-containers и bombvault-node-<node id>-files.
Узел входит с сохранёнными учётными данными, созданными для него, и они должны отличаться от тех, с которыми в это место пишет домашний экземпляр. Если окно сообщает, что таких нет, сначала добавьте их. С этими учётными данными узел обычно может удалять то, что лежит в месте назначения, в отличие от принимающего сервера, и окно об этом предупреждает.
Хранить на узле¶
Узел сам хранит свои копии за собственным rest-server в режиме append-only, а домашний экземпляр подтягивает копию каждого раздела в своё хранилище. Это подходит узлу, которому домашний экземпляр не может предложить место. Это единственное назначение, которому нужен открытый порт.

- В поле Адрес узла введите, где домашний экземпляр достаёт до узла: его публичный адрес и свободный порт, например
https://203.0.113.7:8443, без папки в конце.http://используйте только с частным адресом, как выше. - Узел запускает на этом порту контейнер
bombvault-node-rest-serverс репозиториями в папкеbombvault-nodeвнутри Host Data. Сhttps://он создаёт сертификат для этого адреса, а домашний экземпляр его закрепляет. - Пропустите порт через брандмауэр узла, чтобы домашний экземпляр мог до него достать. Порт, который на узле занят другим контейнером, отклоняется с именем этого контейнера.
Домашний экземпляр подтягивает раздел сразу после того, как на узле закончилось его копирование, а для подстраховки каждый час в четверть, даже при выключенном Подтягивание. Подтянутое остаётся у домашнего экземпляра, как любая подтянутая копия, даже когда узла уже нет. Узел сам чистит свои репозитории, когда его просит домашний экземпляр, потому что его rest-server не принимает удалений, а его наборы папок пропускают папку bombvault-node, так что он никогда не копирует собственные копии.
Когда узлы создают копии¶
Расписанием каждого узла владеет домашний экземпляр. Карточка показывает план для каждого раздела, например Контейнеры ежедневно в 2:00 и Папки еженедельно (вс) в 4:00. Щелчок открывает тот же редактор, что и в Расписаниях, а изменение сохраняется сразу.

- Узел, которого не было, запускает пропущенные копии, как только вернётся. Домашний экземпляр проверяет каждые пять минут.
- Занятый узел спрашивают снова через пять минут.
- Пока домашний экземпляр чистит старые копии узла, узел ничего не запускает, пока тот не закончит. На принимающем сервере и на самом узле это окно открывается каждое воскресенье в 03:00 и длится до шести часов. В месте назначения оно следует плану внешних копий домашнего экземпляра для этого места. Домашний экземпляр хранит копии по собственному правилу раздела в Как долго хранить или по правилу места назначения, если оно у него есть.
- В списке запусков узла копии и восстановления, запущенные домашним экземпляром, помечены как запущенные домашним экземпляром.
Наблюдение за узлами¶
Карточка Узлы в обзоре перечисляет каждый узел с его состоянием, последней копией, ошибками и открытыми аномалиями. Она появляется, как только у вас есть узел.

Домашний экземпляр отправляет одно оповещение на эпизод через свои каналы уведомлений, а следующее только после того, как эпизод закончился:
- Копирование не удалось, например BombVault: vps-helsinki: backup failed, с записью и причиной. Эпизод заканчивает следующая удачная копия этой записи.
- Узел недоступен, например BombVault: vps-helsinki is out of reach. Домашний экземпляр ждёт столько, сколько составляет самый короткий выключатель мёртвой руки на репозиториях узла: 26 часов, если вы его не меняли, или 6 часов, пока у узла ещё нет назначения.
Наблюдение приёмника на домашнем экземпляре охватывает и каждый репозиторий узла, с выключателем мёртвой руки и ежедневным restic check в 04:00, см. Приёмник и подтягивающий.
Записи узла¶
В Резервные копии списки «Контейнеры» и «Папки» показывают под вашими записями раздел для каждого узла. Собственный контейнер узла в нём не показан. Создать резервную копию в меню записи запускает её копирование на узле, а Открыть открывает её страницу.
В разделе узла в списке «Папки» кнопка Добавить набор папок добавляет набор папок на узле, а Изменить в меню набора меняет его. Обе открывают то же окно, что и для ваших собственных наборов. Выбор папок в нём просматривает папки узла, но не создаёт там новых.

Страница записи узла показывает На и имя узла и перечисляет её копии. Восстановить у одной из них восстанавливает запись на узле и заменяет то, что там сейчас. Контейнер для этого останавливается, как и на домашнем экземпляре.

Через домашний экземпляр вам доступен фиксированный список собственных маршрутов узла: его контейнеры, наборы папок, запуски и аномалии, а также их копирование и восстановление. Настройки, ключи и хранилище узла остаются недоступны, и ничто в этом списке ничего не удаляет. См. Узлы в API.
Замена и отвязка¶
Заменить снова показывает compose-файл узла после входа с паролем. Используйте это, чтобы перенести узел на другой сервер или пересобрать его: запустите файл там и выключите старый сервер. Тот же APP_KEY и тот же NODE_HOME снова делают его тем же узлом, с его копиями и историей. Домашний экземпляр хранит для каждого узла его наборы папок, контейнеры со всем, что нужно, чтобы создать их заново, и запуски. Когда узел стартует с пустой папкой config, домашний экземпляр снова принимает его, сообщает, куда идут его копии, и возвращает ему всё это до следующей копии, так что узел может восстановить контейнер, которого уже нет. На новом сервере узел, который сам хранит свои копии, начинает с пустых репозиториев. Его прежние копии остаются в тех, что подтянул домашний экземпляр. Два сервера с одинаковым APP_KEY считаются одним узлом, поэтому никогда не запускайте оба.
Отвязать отпускает узел. Он перестаёт получать команды от домашнего экземпляра и больше ничего не копирует. Его копии остаются там, где лежат, как и каждая копия, которую подтянул домашний экземпляр. Его логин на принимающем сервере удаляется, а домашний экземпляр перестаёт следить за его репозиториями. Узел, которого нет на месте, когда вы его отвязываете, сохраняет карточку в состоянии Отвязывается, пока не узнает об этом. Отвязанный узел больше не примет никакой домашний экземпляр с тем же APP_KEY. Чтобы снова использовать сервер, добавьте его как новый узел и запустите с новым compose-файлом и пустой папкой config.
Безопасность¶
Если домашний экземпляр захвачен, злоумышленник управляет и его узлами, а узел распоряжается Docker на своём сервере, то есть там у него права root. Защитите домашний экземпляр паролем и не выставляйте его в интернет. Если захвачен узел, злоумышленник не получает ни группу сопряжения, ни крепость, ни другой узел, ни другой репозиторий и не может удалить историю на принимающем сервере. Подробности в разделе Узлы в модели безопасности.
В наборе для восстановления есть глава Узлы с APP_KEY каждого узла, его паролем restic и его репозиториями, так что вы можете вернуть узел или восстановить его копии обычным restic.