Набори даних ZFS¶
Набори даних ZFS — записи в списку Резервні копії, як контейнери та віртуальні машини. Запис — це один набір даних разом із кожним набором під ним. Для кожної копії BombVault робить один знімок ZFS усього дерева, тож кожен набір у ньому фіксується в один і той самий момент. Потім він читає файли кожного набору даних із цього знімка й зберігає їх через restic так само, як зберігає папку, а відразу після цього видаляє знімок. Копії дедуплікуються, кожну з них можна переглядати, а окремі файли можна відновлювати.
Копія ніколи не надсилає потік у restic і ніколи не відкочує набір даних. BombVault знищує лише знімки, які створив сам. Необов'язкова репліка — єдине місце, де використовується zfs send: вона копіює набори даних на другий сервер ZFS і копії не зачіпає.
Вимоги¶
- SSH-з'єднання з цим сервером. Набори даних ZFS використовують той самий ключ, хост і користувача, що й копії віртуальних машин. Якщо копії віртуальних машин уже працюють, то працює і це. Інакше дотримуйтесь посібника з копіювання віртуальних машин через SSH. Поля шаблону називаються Host SSH: Address, Host SSH: Port і Host SSH: User.
- Команда
zfsна цьому хості. Вона є в Unraid 6.12 і новіших та в TrueNAS SCALE. - Host Data, підключений як
/mntіз режимом доступу Read/Write - Slave. Це значення шаблону за замовчуванням. Знімок набору даних з'являється в теці.zfs/snapshotнабору лише після запуску BombVault, тому контейнер має отримувати монтування, які хост робить пізніше. - Набори даних, змонтовані нижче
/mnt. В Unraid пули лежать у/mnt/<pool>, тож це вже так.
Увімкніть розділ у Налаштування, Загальні (Набори даних ZFS). З'єднання ZFS із цим сервером у Більше на сторінці «Резервні копії» тоді відкриває З'єднання з цим сервером. Воно перевіряє SSH-з'єднання, називає користувача й хост, до яких підключається, і каже, чого бракує, якщо чогось немає. Коли з'єднання не працює, список «Резервні копії» повідомляє про це кнопкою Показати з'єднання, а картка Інтеграція з хостом в огляді показує той самий результат.
Записи та дочірні набори даних¶
Виберіть Додати на сторінці «Резервні копії», потім Набір даних ZFS. Список приходить із сервера. Виберіть набір даних, що стоїть на початку того, що ви хочете копіювати, наприклад cache/appdata, і запис охопить його та кожен набір під ним.
- Нові дочірні набори даних приєднуються самі. Набір даних, створений пізніше нижче запису, копіюється під час наступного запуску, і цей запуск називає його новим. Його перша копія читає його цілком один раз. Після цього читаються лише зміни.
- Окремі дочірні набори можна виключити. Вимкніть дочірній набір на вкладці запису «Налаштування», і він буде виключений разом з усім, що під ним. Виключений дочірній набір, якого на сервері більше немає, позначається як такий, і його можна прибрати зі списку.
- Дочірні набори, які не можна прочитати, пропускаються, але не мовчки. Запуск перелічує їх, запис показує, скільки пропущено, а картка Без резервної копії в огляді рахує кожен як незахищений. Запуск усе одно копіює все інше і не завершується помилкою через пропущений дочірній набір. Причини перелічено в таблиці кодів причин: набір даних не змонтований, у нього
canmount=off,legacyабо немає точки монтування, не завантажено ключ шифрування, доступ до знімків вимкнено або точка монтування, яку BombVault не бачить. - Пропущений набір даних не тягне за собою своїх нащадків. Набір даних із
canmount=off, який лише містить інші набори, пропускається (показується як «лише структура»), а його змонтовані дочірні набори копіюються. Зашифрований набір даних, ключ якого не завантажено, пропускається разом із дочірніми наборами, у яких той самий ключ. - Дочірні набори, які є дисками віртуальних машин або системними даними, спочатку вимкнені у вікні додавання, з причиною поруч із перемикачем. Додавання цілого пулу просить підтвердження зі списком того, що в ньому міститься.
Томи¶
Том (zvol) містить віртуальний диск, а не файли, і запис ZFS ніколи його не копіює.
- Том, який використовує віртуальна машина, копіюється разом із цією віртуальною машиною.
- Том, який не використовує жодна віртуальна машина (екстент iSCSI, від'єднаний диск), BombVault не копіює. Вікно додавання й сторінка «Резервні копії» рахують такі томи й кажуть про це. Пізніша версія копіюватиме їх.
Томи всередині дерева запису пропускаються й називаються під час кожного запуску.
Сховище Docker¶
З драйвером сховища ZFS у Docker кожен шар образу — набір даних із точкою монтування legacy. Вікно додавання згортає їх в один рядок на батька. Дерево, в якому більше ніж 20 таких наборів, не може стати записом: поки існує його знімок, Docker не може видаляти шари образів. Додайте натомість набори даних під ним, наприклад appdata.
Записи ніколи не перетинаються¶
Набір даних може належати лише одному запису. BombVault відмовляється створювати новий запис, який лежить усередині наявного або містив би його. Щоб об'єднати кілька дочірніх записів в один батьківський, спершу видаліть дочірні записи, вибравши збереження їхніх копій, а потім додайте батьківський. Кожен набір даних зберігає свою історію під своїм іменем, тож наступна копія продовжує з того місця, де зупинилися старі записи, і не читає все заново.
Зупинка контейнерів і команди навколо знімка¶
Знімок працюючої бази даних подібний до раптового відключення живлення: база даних зазвичай відновиться, але їй доводиться це робити. Кожен запис може зробити для цього дві речі, і обидві охоплюють лише момент знімка, а не всю копію.
- Зупиняти ці контейнери на час знімка. BombVault зупиняє перелічені контейнери, робить знімок і одразу запускає їх знову. Контейнери одного рівня залежностей зупиняються паралельно, спершу залежні, тож усе вікно зазвичай займає кілька секунд. Запуск показує, скільки воно тривало. Потім копія читає заморожений знімок, поки застосунки вже знову працюють. Зупиняються лише контейнери, які працювали.
- Команда до та після знімка. Вона виконується всередині вибраного вами контейнера, наприклад щоб вивантажити базу даних у набір даних саме перед знімком, нічого не зупиняючи. Якщо команда перед знімком завершилася помилкою, копія завершується помилкою, і знімок не робиться. Команда після знімка, що завершилася помилкою, показується в запуску, але копії не провалює.
Що відбувається, коли щось іде не так:
- Якщо контейнер не вдається зупинити, BombVault запускає ті, що вже зупинив, а копія завершується помилкою з назвою контейнера. Він ніколи не переходить до знімка працюючих застосунків.
- Зупинка чекає завершення поточної копії контейнера (до 30 хвилин для ручного запуску, до межі часу копіювання для планового), тож обидві ніколи не зупиняють і не запускають один і той самий контейнер одночасно.
- Перш ніж зупиниться перший контейнер, BombVault записує, які він зупиняє. Якщо BombVault убито всередині вікна, він запускає ці контейнери знову під час наступного запуску, надсилає сповіщення, а запис показує червону примітку про будь-який контейнер, який не вдалося запустити.
Автоматичні дампи баз даних виконуються разом із копією самого контейнера, а не із записом ZFS. База даних, контейнер якої копіюється лише через свій набір даних, дампа не отримує, тому дайте їй тут команду.
Контейнер може бути в цьому списку й водночас копіюватися як контейнер. Тоді його дані зберігаються двічі, у двох репозиторіях, а повний бекап зупиняє його двічі. Запис про це каже.
Відновлення¶
Відкрийте запис і виберіть Відновити або виберіть його на сторінці Відновлення. Вікно відновлення питає копію, потім Набір даних. Типово це верхній набір даних запису. У Що ви відновлюєте все або лише вибрані файли та папки. Куди пропонує:
- Відновити в сам набір даних. Файли з копії записуються в точку монтування набору даних. Файли з тим самим іменем перезаписуються, решта лишаються. Набір даних ніколи не відкочується й не замінюється. BombVault перевіряє, що набір даних змонтовано, видно й доступний для запису, один раз перед початком і знову прямо перед записом. Там, де всередині нього змонтовано дочірній набір даних, нічого не записується: дочірній набір зберігає свої файли, власника та права і відновлюється з власної копії.
- До папки. Виберіть папку нижче
/mnt. BombVault перевіряє, що папка перебуває на змонтованому пулі чи спільному ресурсі й що вільного місця достатньо. Це працює без SSH-з'єднання і для наборів даних, яких більше немає. - У новий набір даних. Назвіть набір даних, якого ще немає. Вікно пропонує
<dataset>-restored. BombVault створює його з властивостями ZFS, збереженими в копії, і відновлює в нього, див. Відновлення як новий набір даних.
Вибір Усі набори даних цієї копії як набору даних записує кожен набір даних дерева у власну підтеку вибраної вами теки. Набори даних, які в цій копії було пропущено, називаються. Щоб відновити з репозиторію іншого BombVault, скористайтеся Зі старої папки резервних копій на сторінці «Відновлення». Воно завжди відновлює в папку: усі набори даних однієї копії, кожен у свою підтеку, або один набір даних дерева, цілком чи вибрані файли.
Список контейнерів для зупинки запису пропонується і під час відновлення в сам набір даних. Ці контейнери лишаються зупиненими на все відновлення, а копії контейнерів тим часом чекають.
Страхувальний знімок¶
Перш ніж писати в набір даних, BombVault робить знімок ZFS саме цього набору даних з іменем bombvault-prerestore-<time>. Спершу зберегти знімок ZFS теперішнього стану типово ввімкнено. Щоб його вимкнути, потрібне друге підтвердження. Якщо знімок зробити не вдається, нічого не відновлюється.
BombVault ніколи не видаляє страхувальний знімок сам. Запис перелічує їх із віком і розміром та дією Видалити в кожного, а коли найстаршому більше ніж 30 днів, попереджає, бо він тримає на пулі видалені та змінені дані.
Щоб повернутися після відновлення, скопіюйте окремі файли з .zfs/snapshot/bombvault-prerestore-<time> всередині набору даних. zfs rollback <dataset>@bombvault-prerestore-<time> працює, лише поки це найновіший знімок цього набору даних. zfs rollback -r видаляє кожен новіший знімок, зокрема автоматичні.
Відновлення як новий набір даних¶
BombVault разом із кожною копією зберігає локально задані властивості ZFS кожного набору даних: стиснення, розмір запису, квоту, резервування, atime, xattr, acltype, чутливість до регістру та ваші власні користувацькі властивості. Успадковані й доступні лише для читання значення опускаються, бо вони повертаються самі. У копій, зроблених до того, як BombVault почав їх зберігати, їх немає.
- У новий набір даних виконує
zfs createз усіма збереженими властивостями. Чутливість до регістру, нормалізацію та utf8only можна задати лише так. Квоти й резервування задаються після файлів, тож вони не можуть їх відхилити. Точка монтування опускається, щоб копія не стикалася з оригіналом, як іcanmount,readonlyта налаштування шифрування, щоб відновлення могло писати. Новий набір даних під зашифрованим переймає його шифрування. Набір даних над новим має існувати. Якщо щось не вдалося після створення нового набору даних, він лишається на сервері, бо BombVault ніколи не знищує набір даних. - Відновити в сам набір даних перелічує збережені властивості поруч із відновленням. Задати й ці властивості задає ті, які наявний набір даних ще може прийняти, до запису будь-якого файла. Квоти й резервування задаються після файлів, тож вони не можуть їх відхилити. Без цього перемикача набір даних зберігає свої налаштування.
Що входить до копії¶
У копії: файли й папки кожного скопійованого набору даних з їхнім власником, правами, часовими мітками та розширеними атрибутами так, як їх зберігає restic, і локально задані властивості ZFS кожного набору даних.
Не входить до копії:
- власник і права самої верхньої папки кожного набору даних (усе під нею входить). Відновлення в сам набір даних лишає наявну верхню папку як є, відновлення в папку створює її з режимом
0755, - наявні знімки ZFS,
- дочірні набори, які були пропущені чи виключені,
- томи.
Щоб відновити на новий пул, створіть пул і відновіть кожен набір даних у новий набір даних. Чи повернуться ACL NFSv4, як їх використовує TrueNAS на наборах даних SMB, так, як ви очікуєте, поки не перевірено, тому перевірте відновлення на своїх даних, перш ніж на них покладатися.
Зашифровані набори даних¶
Зашифрований набір даних копіюється, лише поки завантажено його ключ. Інакше він пропускається з попередженням. Завантажте ключ через zfs load-key і змонтуйте набір даних. BombVault читає дані розшифрованими й зберігає їх у репозиторії restic, який зашифрований. Якщо ви вимкнули шифрування в BombVault, цей репозиторій не зашифрований.
Репліка¶
Репліка — копія наборів даних запису на другому сервері ZFS. BombVault підтримує її актуальною через zfs send і zfs receive. Перший запуск надсилає все, після цього передаються лише змінені блоки. На іншому сервері копію можна одразу змонтувати.
Репліка ніколи не замінює копію. Старіші версії, окремі файли та перевірка, як і раніше, беруться з копій, а репліка зберігає рівно стільки знімків, скільки ви задали. Актуальна репліка вважається копією поза сервером, але не резервною копією.
Репліка не чекає копію. Після кожної копії означає після запуску копіювання запису, чи вдався він, не вдався, чи йому нічого було робити. Коли в розділу ZFS не ввімкнено жодного місця призначення, а у запису немає власного репозиторію, запуск копіювання запису лише надсилає репліку, і картка «Репліка» каже про це в підказці поруч із Коли. Список «Резервні копії», шапка запису й історія запусків показують репліку: Реплікується, поки вона триває, і Репліковано з часом, коли вона закінчилася.
Лише репліка, без резервної копії в картці «Репліка» змушує весь розділ ZFS надсилати репліки й не робити копій. Власна тека та зовнішні місця призначення зберігають свої перемикачі, тож вимкнення знову копіює в них, а картка кожного запису ZFS показує перемикач розділу в його поточному положенні. Такий запис чекає першої репліки замість копії, Створити резервну копію пропонується як Реплікувати зараз, а контейнери запису зупиняються й її команди виконуються навколо знімка, як за копії. Її репліки рахуються для розкладу «раз на кілька днів», сповіщення про прострочення та охоплення.
Увімкніть її в картці Репліка на вкладці запису «Налаштування». Картка перелічує кожен набір даних і том з його станом, а Реплікувати зараз запускає прогін. У прогону репліки своє блокування, тож довга перша передача ніколи не затримує копії.
| Поле | Що задає |
|---|---|
| Реплікується на | Ціль: сервер ZFS (позначений через SSH) або спарений екземпляр. Додати сервер ZFS налаштовує новий. |
| Коли | Після кожної копії, тобто після запуску копіювання запису, або Власний план. |
| Зберігати на цільовому сервері | Скільки знімків лишається на сервері ZFS: Коротко, Помірно, Довго або Власні значення. Спарений екземпляр вирішує це сам. |
| Зберігати на цьому сервері | Скільки найновіших знімків репліки лишається й на цьому сервері. 0 або 1 зберігає лише останній. |
| Лише репліка, без резервної копії | Весь розділ ZFS надсилає репліки й не робить копій. |

Реплікувати все зараз поруч із діями копіювання, коли на сторінці «Резервні копії» вибрано плитку ZFS, надсилає репліку кожного запису ZFS, одну за одною. Пакет виконує сервер, тому він триває, коли ви залишаєте сторінку, а запис, який не може реплікуватися, називається й пропускається.
Надсилання на сервер ZFS¶
Приймати може будь-яка машина з ZFS і SSH, наприклад другий Unraid або TrueNAS. BombVault там запускати не обов'язково.
- У Налаштування, Спарювання виберіть Підключити через SSH в Сервер ZFS без BombVault або Додати сервер ZFS у картці Репліка запису.
- Введіть адресу, користувача та порт. Вікно показує відкритий ключ BombVault. Додайте його до
~/.ssh/authorized_keysкористувача на сервері. В Unraid це в Users, root, SSH keys. Залежно від Display Settings Users розташовано в меню в шапці або в Settings. У TrueNAS змініть користувача в Credentials, Users. Це ключ репліки. Він відрізняється від ключа SSH-з'єднання для віртуальних машин і хоста, тож додайте його, навіть якщо той уже авторизований. - Перевірте з'єднання. Потім вікно перелічує пули сервера. Виберіть один і задайте корінь, типово
<pool>/bombvault-replica. - Виберіть новий сервер у картці Репліка запису. Після цього в сервера з'являється власна картка на сторінці «Екземпляри», а Відкрити веде на його сторінку.
З root більше нічого не потрібно. Окремому користувачу потрібні ці права на пул цілі, які вікно теж показує:
На джерелі користувачу того ж роду потрібні ці права на верхній набір даних запису:
У цьому напрямку BombVault, який тримає запис, тримає й ключ, який може писати на сервері.
BombVault закріплює ключ хоста, який показує сервер під час першого підключення, і пізніше відмовляється від іншого. Якщо сервер перевстановили, натисніть Забути ключ хоста на сторінці сервера, і під час наступного підключення закріпиться новий ключ.
Коли хост цього сервера сам може достукатися до сервера ZFS, він спрямовує zfs send прямо у власний ssh до сервера з ключем репліки та закріпленим ключем хоста, тож потік не проходить через BombVault. Інакше потік іде через BombVault.
Надсилання на спарений екземпляр¶
Спарений BombVault може приймати репліку сам. Ніхто не отримує SSH-доступ до іншого хоста, і жоден ключ не потрапляє у файл authorized_keys.
- У картці Репліка запису виберіть спарений екземпляр ціллю або ввімкніть роль Сервер ZFS на картці цього екземпляра на сторінці «Екземпляри» й виберіть там записи ZFS. Картка показує Очікує схвалення, поки він не відповість.
- На екземплярі-приймачі відкрийте Екземпляри. Запит показується на картці екземпляра-відправника значком, а його Подробиці перелічують його. Виберіть пул і корінь на цьому сервері та скільки знімків лишається, потім натисніть Дозволити або Відхилити.
- Після Дозволити джерело надсилає за своїм планом, як на будь-яку іншу ціль.
Екземпляр-приймач приймає лише те, що охоплює схвалення: набори даних запису у свій власний корінь. Він сам виконує zfs receive, а у джерела немає способу щось там видалити чи відкотити. Так копія переживає джерело, яким хтось заволодів. Екземпляр-приймач зберігає за своїми правилами. Джерело лише пропонує правило, коли просить. Таке джерело й далі може надсилати нові знімки, і з часом вони витісняють старіші за правилом, як будь-які інші. Знімок, в імені якого стоїть дата пізніша за годинник екземпляра-приймача, не враховується правилом, поки цей час не настане.
Відкликати доступ на екземплярі-приймачі в будь-який момент завершує схвалення й повідомляє джерело, яке потім показує, що схвалення відкликано, і зупиняється. Те, що екземпляр-приймач уже тримає, лишається там. Відхилений запит лишається відхиленим. Більше наборів даних або запит після відкликання питають знову.
Екземпляр-приймач має відповідати через HTTPS. Джерело нічого не надсилає на звичайну адресу http, бо токен і дані йшли б мережею незашифрованими. Кожна передача також лишає вільною десяту частину пулу-приймача і зупиняється, перш ніж залізе в неї, тож одне джерело не може заповнити пул сервера-приймача.
Куди потрапляють дані¶
Кожен набір даних потрапляє в <root>/<server>/<pool>/<path>. Тека сервера — це ім'я екземпляра-джерела, що фіксується під час першої передачі, тож два сервери з однаковою назвою пулу ніколи не заважають одне одному. Наприклад, cache/appdata сервера під назвою tower опиняється в backup/bombvault-replica/tower/cache/appdata.
Після повторного налаштування BombVault ціль відмовляється приймати теку, яку цей BombVault заповнив раніше. Тоді картка «Репліка» пропонує Перейняти теку, і наступна репліка продовжується з копій у ній. Перейміть її, лише якщо жоден інший BombVault більше не реплікує в цю теку.
Копія на цілі доступна лише для читання. Типово вона не монтується, тож ніколи нічого не перекриває на тому сервері. У сервера ZFS, підключеного через SSH, на його сторінці є перемикач Монтувати на сервері лише для читання: коли він ввімкнений, BombVault після кожного прогону монтує там копії лише для читання, тож ви можете читати й копіювати їхні файли на цілі. Зашифровані копії лишаються заблокованими, поки не завантажено їхній ключ, а вимкнення нічого не розмонтовує. Спарений екземпляр, який приймає репліку, тримає її немонтованою. Властивості ZFS передаються разом, окрім точки монтування, sharenfs і sharesmb. Резервування reservation і refreservation теж лишаються позаду, тож копія займає лише те місце, яке потрібне її даним.
Що входить¶
Входить усе, що копіює запис, а також томи під ним, які копія пропускає. Дочірній набір даних, який ви вимкнули в записі, лишається поза. Усі набори даних одного прогону беруться з одного знімка, як у копії.
Копія, яку інший BombVault реплікує на цей сервер, далі не надсилається, бо це проріділо б історію, яка ще потрібна її джерелу. Якщо в дереві запису є така копія, запуск для цього набору даних завершується помилкою й пояснює причину, поки ви не вимкнете її в записі. Запис, який сам є такою копією, реплікуватися не може взагалі. Видалення запису чи вимкнення його репліки не чіпає такі копії та їхні знімки. Коли ви берете копію собі, як описано в розділі Як користуватися реплікою, вона вважається звичайним набором даних.
Як довго зберігаються знімки¶
На цілі нова репліка зберігає 7 щоденних і 3 щотижневі знімки. Виберіть натомість Коротко, Помірно або Довго чи задайте Власні значення. Власні значення з самих нулів зберігають усі знімки, і картка про це каже. Там видаляються лише знімки з іменем bombvault-replica-<14 digits>, і ніколи найновіший, який спільний для обох сторін.
На джерелі BombVault зберігає останній знімок репліки плюс закладку для кожного надісланого стану. Закладки не займають місця. Наступна передача починається з них.
Щоб зберігати більше й на джерелі, задайте Зберігати на цьому сервері в картці «Репліка», наприклад 7. Тоді стільки найновіших знімків репліки лишається на цьому сервері після кожної репліки, поруч із тим, що зберігає ціль. 0 або 1 зберігає лише останній. На останньому стоїть утримання (hold), щоб основа наступної передачі не була знищена випадково. На старих його немає. Кожен знімок утримує блоки, що змінилися після нього, тому кожен збережений знімок займає місце на пулі. Вимкнення репліки чи перехід на іншу ціль, а також видалення запису прибирають їх і з цього сервера. Знімки іншого запису, вкладеного нижче, лишаються. Якщо хост недоступний, поки ви видаляєте запис, знімки теж лишаються, і сторінка про це каже. Видаліть їх вручну: zfs release -r bombvault-replica <dataset>@<snapshot>, потім zfs destroy.
Файли збереженого знімка можна одразу прочитати чи скопіювати з теки .zfs/snapshot всередині набору даних або з клона, не чіпаючи набору даних чи репліки:
ls /mnt/cache/appdata/.zfs/snapshot/bombvault-replica-20261006014100
zfs clone cache/appdata@bombvault-replica-20261006014100 cache/appdata-20261006
Клон не займає місця, поки в ньому щось не зміниться. Знищіть його командою zfs destroy cache/appdata-20261006, коли закінчите, бо знімок, у якого є клон, видалити не можна.
Щоб повернутися до останнього знімка репліки, тут потрібен лише zfs rollback cache/appdata@<latest>, а на цілі нічого. Відкат усього набору даних до старішого знімка знищує кожен знімок після нього, на цьому сервері й на цілі. Останній утримується, тому спершу зніміть його утримання, потім відкотіть набір даних тут:
zfs release -r bombvault-replica cache/appdata@bombvault-replica-20261008014200
zfs rollback -r cache/appdata@bombvault-replica-20261006014100
Копію на цілі теж потрібно відкотити, але не завжди до того самого знімка, оскільки її власні правила зберігання могли його видалити. Запустіть репліку один раз. Вона зупиниться для цього набору даних, бо на цілі є новіші знімки, а картка «Репліка» та історія запусків назвуть знімок, до якого потрібно відкотити ціль: найновіший із тих, що в обох сторін ще спільні. Відкотіть копію до нього на сервері ZFS або на хості спареного екземпляра, який приймає репліку, наприклад:
zfs rollback працює з одним набором даних, тому повторіть відкати для кожного дочірнього набору, який ви теж хочете повернути. Після цього Реплікувати зараз продовжує зі спільного знімка.
Зашифровані набори даних у репліці¶
Зашифрований набір даних надсилається в сирому вигляді. На цілі він лишається зашифрованим, і ціль ніколи не бачить ключа. Бережіть ключ: він потрібен, щоб відкрити копію після відновлення, а репліка без нього нечитабельна.
Як користуватися реплікою¶
Відкрийте вкладку запису Резервні копії й клацніть рядок репліка ZFS серед місць, де зберігаються її знімки. Аркуш перелічує знімки на цілі й показує команди з вашими справжніми іменами.
Щоб подивитися старий стан, склонуйте знімок на цілі. Клон не займає місця, поки щось не зміниться, а репліка лишається недоторканою:
zfs clone backup/bombvault-replica/tower/cache/appdata@bombvault-replica-20261006014100 backup/bombvault-replica/clone-appdata
Якщо джерело вийшло з ладу, перетворіть копію на звичайний набір даних із можливістю запису на цілі:
zfs inherit -r readonly backup/bombvault-replica/tower/cache/appdata && zfs list -rH -o name -t filesystem backup/bombvault-replica/tower/cache/appdata | xargs zfs set canmount=on && zfs mount -a
Після цього BombVault перестає реплікувати в цей набір даних і його дочірні набори. Наступний запуск завершується помилкою з причиною, а те, що ви записали, лишається. Те саме стосується всього іншого, що записано в копію після її найновішого знімка: BombVault ніколи не відкочує копію. Щоб знову реплікувати туди, перенесіть потрібне з копії та знищіть її на цілі. Тоді наступний запуск надішле все заново.
Щоб повернути стан на джерело, натисніть Повернути як новий набір даних в аркуші. BombVault надсилає знімок у новий набір даних поруч з оригіналом з іменем <dataset>-bombvault-restore- плюс позначка часу. Поверх оригіналу він ніколи не пише. Дочірній набір даних, утрачений на джерелі, теж повертається, якщо в копії ще є цей знімок. Дочірній набір, у якому його немає, пропускається, і запуск про це повідомляє.
Приклад: репліка на другий сервер Unraid¶
Сервер tower копіює набір даних cache/appdata як запис ZFS. Другий сервер Unraid за адресою 192.168.1.20 без BombVault має пул backup і має зберігати копію, яку можна прочитати будь-коли.
- Відкрийте Резервні копії, потім
cache/appdata, потім його вкладку Налаштування. У картці Репліка виберіть Додати сервер ZFS в Реплікується на. - Введіть
192.168.1.20, користувачаrootі порт22. Вікно показує ключ репліки. На другому сервері вставте його в Users, root, SSH keys і натисніть Apply. Цей ключ відрізняється від ключа SSH хоста, тож додайте його, навіть якщо той уже є. - Перевірте з'єднання. Виберіть пул
backupі залиште запропонований коріньbackup/bombvault-replica. - Повернувшись на картку, ви бачите, що в Реплікується на вибрано новий сервер. Залиште Коли на Після кожної копії, залиште Зберігати на цільовому сервері на його 7 щоденних і 3 щотижневих знімках і задайте Зберігати на цьому сервері рівним
7. - Натисніть Реплікувати зараз. Перший прогін надсилає все, тож 300 ГБ лінією 1 Гбіт/с займають щонайменше 40 хвилин. Картка й список «Резервні копії» показують Реплікується, потім Репліковано з часом. Наступні прогони надсилають лише змінені блоки.
Набори даних тепер лежать у backup/bombvault-replica/tower/cache/appdata на другому сервері, лише для читання. В огляді Зовнішнє розділу ZFS рахує репліку копією поза сервером.
Щоб дістати один файл за минулий вівторок, є три способи:
-
На цьому сервері, бо Зберігати на цьому сервері тримає сім знімків:
-
На другому сервері з клоном знімка на цілі. Вкладка запису Резервні копії показує команди з вашими справжніми іменами, коли ви клацаєте рядок репліка ZFS. Видаліть клон через
zfs destroy, коли закінчите. - Через монтування, увімкнувши Монтувати на сервері лише для читання на сторінці сервера ZFS. Після наступного прогону копії стоять змонтованими лише для читання на другому сервері.
Версії, старіші за ті, що зберігає репліка, як і раніше, беруться з копій, як показує наступний приклад.
Приклад: один файл із копії ZFS¶
- Відкрийте Відновлення, виберіть плитку ZFS і клацніть
cache/appdata. - Виберіть копію, а в Набір даних той набір даних, у якому лежить файл.
- У Що виберіть Окремі файли й позначте файл.
- У Куди виберіть До папки й вкажіть папку нижче
/mnt, наприкладuser/restore. SSH-з'єднання для цього не потрібне, і це працює і для набору даних, якого більше немає. - Натисніть Відновити. Файл лягає прямо в цю папку, без шляху над ним.
Залишені знімки¶
Знімок копії називається <dataset>@bombvault-<14 digits>, наприклад cache/appdata@bombvault-20260924021500 (UTC). BombVault видаляє його одразу після копіювання. Якщо це не вдалося, наприклад тому що набір даних зайнятий або BombVault зупинили, BombVault видаляє його:
- перед наступною копією цього запису,
- під час запуску BombVault для кожного запису, зокрема й за вимкненого розділу,
- коли ви видаляєте запис,
- коли ви натискаєте Видалити зараз на записі, який показує, скільки їх залишилося.
Видаляються лише імена, що точно збігаються з bombvault- і 14 цифрами. Страхувальні знімки, ваші власні знімки та автоматичні знімки ніколи не чіпаються. Щоб видалити один вручну:
Знімок репліки називається <dataset>@bombvault-replica-<14 digits> і не є залишком. Він лишається на джерелі, поки його не замінить новіший прогін репліки, або поки його зберігає Зберігати на цьому сервері, а на цілі, поки його зберігає політика зберігання. Очищувач його ніколи не чіпає, бо збігається лише з bombvault- і рівно 14 цифрами.
Аномалії¶
Спорожнілий дочірній набір майже не змінює підсумок великого дерева, тому виявлення аномалій стежить за кожним набором даних запису окремо: у його розміру, кількості файлів, нових даних і часу restic своя історія. Ця історія належить імені набору даних, тож вона зберігається, коли дерево згодом копіюється іншим записом.
Набір даних, який попередній запуск скопіював, а цей не зміг прочитати, вважається спорожнілим, поки вибір запису не змінився. Це охоплює незавантажений ключ, незмонтований набір даних і набір, якого більше немає в дереві. Дочірній набір даних, який ви виключаєте самі, змінює вибір, тому його історія починається заново. Поки відкрита знахідка про втрачені дані, зберігання зберігає старі копії саме цього набору даних, а решту дерева очищає як звичайно.
У кожного набору даних свій рядок у моніторингу запису, який відкривається через Моніторинг на сторінці «Аномалії» і стоїть на вкладці запису Перевірка. Відкриті знахідки показано поруч із кожним набором даних. Посилання в знахідці відкриває вікно відновлення на останній добрій копії набору даних. Чи закінчився запуск, оцінюється для всього запису, бо запуск вдається чи не вдається цілком.
Самі перевірки описано в розділі Аномалії. Помічник, підключений через сервер MCP, може перелічувати точки відновлення запису ZFS, запускати його копію й читати знахідки, а підтвердження знахідки відбувається на сторінці Аномалії.
Коди причин¶
Сторінка запису, історія запусків і сповіщення називають проблему одним із цих кодів. У більшості виправлення є й поруч на сторінці.
| Код | Значення | Що робити |
|---|---|---|
ssh-missing |
У цьому контейнері не налаштовано SSH-з'єднання. | Налаштуйте SSH-з'єднання, як для копій віртуальних машин. |
host-placeholder |
Host SSH: Address усе ще заглушка, і host.docker.internal теж не відповів. |
Задайте Host SSH: Address рівним IP цього сервера в локальній мережі. |
host-fallback |
Host SSH: Address усе ще заглушка, а host.docker.internal працює. |
Нічого або задайте IP у локальній мережі. |
ssh-unreachable |
Сервер недоступний через SSH. | Перевірте адресу й порт та що SSH увімкнено. |
ssh-auth |
Сервер відхилив ключ BombVault. | Один раз виконайте на сервері команду, показану в З'єднання з цим сервером. |
zfs-not-found |
У SSH-хоста немає команди zfs. |
Спрямуйте Host SSH: Address на машину, якій належать пули. |
zfs-permission |
Користувачу SSH не можна виконувати цю команду zfs. | Використайте root або див. TrueNAS SCALE. |
uri-mismatch |
LIBVIRT_URI називає іншого хоста чи користувача, ніж поля SSH. |
Приведіть їх у відповідність або очистіть поля SSH, щоб обидва бралися з URI. |
zfs-error |
zfs повідомив про іншу помилку. | Подробиці показують його повідомлення. |
propagation-missing |
Нові монтування на хості не доходять до контейнера. | Задайте режим доступу Host Data Read/Write - Slave і перезапустіть BombVault. |
invalid-name |
Ім'я набору даних, яке BombVault не приймає. | Перейменуйте набір даних. |
name-too-long |
Набір даних у дереві надто довгий для імені знімка. | Перейменуйте його або додайте як запис набір даних під ним. |
invalid-exclude |
Шаблон виключення чи виключений дочірній набір не підходять запису. | Виправте запис, який називає повідомлення. Щоб виключити цілий дочірній набір даних, вимкніть його замість написання шаблону. |
not-found |
Набору даних на сервері немає. | Видаліть запис або створіть набір даних заново. Його копії лишаються придатними для відновлення. |
not-filesystem |
Це том, а не файлова система. | Див. Томи. |
overlaps-item |
Набір даних перетинається з наявним записом. | Див. Записи ніколи не перетинаються. |
docker-storage |
У дереві сховище образів Docker. | Див. Сховище Docker. |
nothing-readable |
Жоден набір даних запису зараз не можна прочитати. | Подивіться коди пропущених наборів даних. |
snapshot-failed |
Знімок не вдалося створити. | Подробиці показують повідомлення zfs. |
containers-busy |
Копія контейнера ще йшла, коли треба було зупиняти контейнери. | Повторіть пізніше. Планові запуски чекають самі. |
consistency-stop-failed |
Контейнер не вдалося зупинити, тому знімок не зроблено. | Перевірте контейнер або приберіть його зі списку. |
pre-snapshot-failed |
Команда перед знімком завершилася помилкою. | Подробиці запуску показують її вивід. |
container-unknown |
Переліченого контейнера не існує. | Приберіть його зі списку. |
container-is-self |
BombVault не може зупинити власний контейнер. | Приберіть його зі списку. |
leftover-snapshots |
Знімки, які BombVault не зміг видалити, досі на сервері. | Натисніть Видалити зараз, див. Залишені знімки. |
zvol |
Том у дереві, пропущено. | Див. Томи. |
canmount-off |
Ніколи не монтується (canmount=off), пропущено. |
Якщо в ньому є дані, змонтуйте його або перенесіть дані в дочірній набір даних. |
legacy-mount |
Точка монтування legacy, пропущено. | Дайте йому точку монтування нижче /mnt. |
no-mountpoint |
Немає точки монтування, пропущено. | Дайте йому точку монтування нижче /mnt. |
not-mounted |
Не змонтовано на сервері, пропущено. | Виконайте zfs mount або задайте canmount=on. |
key-not-loaded |
Зашифровано, ключ не завантажено, пропущено. | zfs load-key, потім змонтуйте. |
snapdir-disabled |
Доступ до знімків вимкнено, пропущено. | zfs set snapdir=hidden <dataset>. Тека .zfs лишається прихованою. |
not-visible |
BombVault не бачить точку монтування набору даних. | Перемістіть точку монтування нижче шляху Host Data або зіставте її в контейнер за тим самим шляхом із Read/Write - Slave. |
shfs-only |
Набір даних видно лише через /mnt/user, який приховує знімки. |
Підключіть як Host Data /mnt, а не /mnt/user. |
snapshot-not-visible |
Знімок створено, але він не з'явився всередині BombVault. | Запустіть Перевірити доступ до знімків. Див. нижче. |
snapshot-loop |
Знімок не дійшов до BombVault, бо Host Data не пропускає нові монтування. | Задайте режим доступу Host Data Read/Write - Slave і перезапустіть BombVault. |
backup-failed |
restic завершився помилкою для цього набору даних. | Подробиці запуску показують чому. |
not-reached |
Запуск закінчився раніше, ніж дійшов до цього набору даних. | Запустіть копію знову. |
gone |
Набору даних на сервері більше немає. | Нічого. Його копії лишаються придатними для відновлення. |
read-only-mount |
BombVault може лише читати набір даних, тому не може відновити в нього. | Задайте зіставлення Read/Write - Slave або відновіть у папку. |
destination-not-mounted |
Тека не на змонтованому пулі чи спільному ресурсі. | Виберіть теку на пулі чи спільному ресурсі. |
not-enough-space |
Не вистачає вільного місця в місці призначення. | Звільніть місце або виберіть іншу теку. |
safety-snapshot-failed |
Страхувальний знімок не вдалося зробити, тому нічого не відновлено. | Подробиці показують повідомлення zfs. |
safety-name-too-long |
Ім'я набору даних надто довге для страхувального знімка. | Вимкніть страхувальний знімок або відновіть у папку. |
dataset-exists |
Набір даних із таким іменем уже існує. | Виберіть нове ім'я або відновіть у сам набір даних. |
create-failed |
Новий набір даних не вдалося створити. | Подробиці показують повідомлення zfs. Перевірте, що набір даних над ним існує. |
new-dataset-not-visible |
Новий набір даних створено, але BombVault його не бачить, тому нічого не відновлено. | Набір даних лишається на сервері. Змонтуйте його нижче шляху Host Data і відновіть у нього. |
set-properties-failed |
Збережені властивості не вдалося задати, тому нічого не відновлено. | Подробиці показують повідомлення zfs. |
set-limits-failed |
Файли відновлено, але збережену квоту чи резервування задати не вдалося. | Подробиці показують повідомлення zfs. Задайте квоту чи резервування самі через zfs set. |
Перевірка того, що бачить контейнер¶
Перевірити доступ до знімків на вкладці запису «Налаштування» робить справжній знімок його дерева, шукає його всередині BombVault для кожного набору даних і знову видаляє. Це найшвидший спосіб перевірити весь шлях до першого планового запуску.
Щоб подивитися самому, виконайте це на сервері:
Кожен рядок — одне монтування всередині контейнера. Рядок набору даних показує його шлях усередині контейнера (нижче /host/user) і ім'я набору даних. Поле master:N у цьому рядку означає, що монтування отримує монтування, які хост робить пізніше, а це потрібно для доступу до знімків. Якщо його немає, задайте режим доступу Host Data Read/Write - Slave і перезапустіть BombVault.
TrueNAS SCALE¶
- Коли задано
LIBVIRT_URI(як для копій віртуальних машин у TrueNAS), BombVault бере хост SSH, користувача й порт для своїх команд zfs з URI, кожен із тих, що не задані окремо. Без копій віртуальних машин задавати нічого не потрібно:host.docker.internalу застосунку TrueNAS не розв'язується, тому BombVault сягає хоста через шлюз застосунку за замовчуванням, від імені root на порту 22. ЗадайтеLIBVIRT_HOST,LIBVIRT_SSH_USERіLIBVIRT_SSH_PORT, коли потрібна інша адреса чи користувач, вenvironmentзастосунку. - Додайте ключ SSH хоста з Налаштування, Інтеграції, SSH хоста користувачу root в Credentials, Users і ввімкніть службу SSH в System, Services. Реплікації на цей чи інший TrueNAS потрібен і ключ репліки, який інший.
- Користувачу, відмінному від root, потрібен дозвіл на верхній набір даних запису, який тоді охоплює кожен набір під ним:
Відновлення в новий набір даних потребує ще create на наборі даних над ним, а задання збережених властивостей потребує дозволу на ці властивості.
У сеансі SSH без root у TrueNAS у шляху немає /usr/sbin. Тоді BombVault викликає /usr/sbin/zfs напряму.
- Host Data застосунку має бути шляхом хоста над наборами даних, наприклад /mnt/tank, а не ixVolume. Зі шляхом хоста застосунок передає BombVault нові монтування хоста (rslave), які потрібні для доступу до знімків. Усе налаштування застосунку див. у розділі TrueNAS SCALE.