Вузли¶
Вузол — це BombVault без вебінтерфейсу, наприклад на VPS або на невеликому сервері в друга. Він створює резервні копії контейнерів і папок на своєму сервері, а BombVault, на якому ви його додаєте, на цій сторінці він зветься домашнім екземпляром, каже йому, коли створювати копії та куди їх надсилати. Керуєте вузлом ви з вебінтерфейсу домашнього екземпляра, поруч зі своїми записами.

Як це працює¶
- Ключ вузла зберігається в домашнього екземпляра. Коли ви додаєте вузол, домашній екземпляр створює його
APP_KEY, зберігає його запечатану копію й один раз віддає його вам у compose-файлі вузла. З цією копією домашній екземпляр дістається до вузла й відкриває його резервні копії. - Вузлу не потрібен відкритий порт. Домашній екземпляр і вузол спілкуються через реле власним закритим каналом, окремо від вашої групи спарювання. Кожен виклик починає й підписує домашній екземпляр, а вузол не просить у нього нічого, крім свого привітання. Єдине призначення, якому потрібен відкритий порт, це зберігання копій на вузлі.
- Резервні копії ніколи не йдуть через реле. Вузол надсилає їх просто туди, куди ви вибрали: на приймальний сервер домашнього екземпляра, до одного з його місць призначення або на rest-server на самому вузлі.
- Вузол нічого не планує сам. Він не запускає розкладів, не надсилає сповіщень і не входить ні до групи, ні до фортеці. Домашній екземпляр запускає його копіювання, стежить за перебігом і надсилає сповіщення про збої.
- Вузол копіює контейнери й набори папок. Віртуальні машини, флешка, набори даних ZFS і копія налаштувань самого BombVault лишаються за повними встановленнями.
Канал використовує власне реле домашнього екземпляра, якщо воно є в його групі, а інакше реле проєкту, навіть коли домашній екземпляр спарюється без реле.
Перш ніж почати¶
- Пароль для входу на домашньому екземплярі. Додавання вузла, повторний показ його 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.