Перейти до змісту

Усунення несправностей

Коротка добірка поширених питань. Повну таблицю усунення несправностей на боці хоста для VM через SSH (permission-denied, перевірка ключа хоста, відсутні змінні шаблону та інше) див. у посібнику з резервного копіювання VM через SSH на GitHub.

Щось підключено неправильно

Відкрийте /spike у вебінтерфейсі. Перевірка інтеграції з хостом тестує кожне монтування та CLI (сокет Docker, libvirt, restic, qemu-img, rclone) і повідомляє про будь-які відсутні частини. Починайте звідси, перш ніж припускати помилку: відсутнє монтування чи недоступний хост з'являється негайно.

Я не можу дістатися до вебінтерфейсу

BombVault подає HTTPS з коробки на порту 3443 (самопідписаний сертифікат), тож відкрийте https://<your-unraid-ip>:3443. Прийміть попередження про самопідписаний сертифікат або поставте BombVault за зворотним проксі з власним сертифікатом. Якщо ви запускаєте з HTTP_ONLY=true, він натомість подає звичайний HTTP на порту 3000 (призначено для використання за проксі, що термінує TLS).

Я втратив свій APP_KEY

APP_KEY виводить пароль репозиторію restic. Без нього (і без набору для відновлення ключа шифрування) зашифровані резервні копії не можна відновити. Ось чому Панель докучає вам завантажити набір для відновлення. Див. Зовнішнє копіювання та відновлення. Згенеруйте ключ командою openssl rand -hex 32 і збережіть його поза сервером, перш ніж покладатися на будь-яку резервну копію.

Резервне копіювання VM не з'єднується

Резервне копіювання VM спілкується з libvirt через SSH, ніколи через монтування.

  • Переконайтеся, що SSH увімкнено на хості й публічний ключ BombVault авторизований у /root/.ssh/authorized_keys (Налаштування, Система, Резервне копіювання VM через SSH показує ключ і кнопку Перевірити з'єднання).
  • У кастомній мережі br0.x задайте LIBVIRT_HOST на свою LAN IP Unraid (контейнер не може дістатися до хоста через host.docker.internal там). Увімкніть Налаштування, Docker, Доступ хоста до кастомних мереж.
  • Якщо ви змінили порт SSH Unraid, задайте LIBVIRT_SSH_PORT відповідно.
  • Повна покрокова діагностика (тест досяжності, маршрутизація VLAN, Permission denied (publickey), Host key verification failed) є в посібнику з резервного копіювання VM через SSH.

Живий знімок VM не запустився

Живі знімки потребують гостьового агента qemu, встановленого у VM, і диска на /mnt/cache (або /mnt/diskX), не /mnt/user. На вимкненій VM живий автоматично відкочується до коректного. Коректне резервне копіювання вимикає VM, резервує диски, потім перезапускає її, тож воно завжди узгоджене.

Резервне копіювання завершилося помилкою "repository is already locked"

Це зазвичай осиротіле блокування restic, залишене, коли контейнер було оновлено чи перезапущено посеред операції. BombVault виявляє доказово осиротіле блокування, примусово очищує його та повторює один раз, автоматично. Якщо воно зберігається, скористайтеся Налаштування, Цілісність та обслуговування, Розблокувати для ураженого домену, щоб очистити застаріле блокування вручну. Справжня проблема все ж виринає, а не ховається.

Моя зовнішня копія не сталася після резервного копіювання

Зовнішня реплікація за принципом найкращих зусиль за задумом, тож збій зовнішнього ніколи не провалює локальне резервне копіювання. Перевірте зовнішній розклад для цього домену (Налаштування, Розклади): порожній розклад реплікує після кожного локального резервного копіювання, а періодичність відправляє рідше. Скористайтеся Реплікувати зараз на вкладці Зовнішнє для запуску за запитом і спостерігайте за індикатором реплікації на Панелі.

Відновлення перервалося, перш ніж почалося

Перш ніж щось буде зупинено чи видалено, відновлення запускає передпольотну перевірку конфліктів: воно перевіряє, що статична IP контейнера та опубліковані порти хоста вільні. Якщо інший контейнер уже тримає один із них, воно перериває роботу з чітким, дієвим повідомленням замість того, щоб залишити напівзавершене відновлення. Звільніть конфліктний порт чи IP, потім повторіть.

Звичайний експорт завершився помилкою замість запису файлу

Якщо шифрування age ввімкнене (Налаштування), але не задано дійсного отримувача, експорт завершується помилкою з чітким повідомленням замість запису відкритого тексту. Додайте дійсного отримувача (публічний ключ age або публічний ключ SSH) або вимкніть шифрування, якщо ви маєте намір, щоб експорт був у відкритому тексті. Див. Можливості.

Контейнер постійно перезапускається чи виглядає несправним

BombVault повідомляє про справність/несправність з власного /api/health. Інструмент автовідновлення (наприклад Autoheal) може перезапустити його автоматично, якщо механізм коли-небудь зависне. Перевірте журнал контейнера та звіт /spike на предмет основної причини.

Досі застрягли?