Перейти к содержанию

Устранение неполадок

Короткий FAQ. Полную таблицу устранения неполадок на стороне хоста для 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 guest agent, установленный в 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 на предмет основной причины.

Всё ещё застряли?