Установка omv-extras начинается с проверки версии openmediavault: пакет openmediavault-omvextrasorg для OMV 6 не подойдёт к OMV 7, и попытка поставить несовместимую сборку завершится ошибкой зависимостей apt. Узнать версию системы можно в веб-интерфейсе в разделе Диагностика → Системная информация или командой dpkg -l | grep openmediavault в терминале.
Плагин omv-extras — это сторонний репозиторий, который расширяет стандартный набор плагинов openmediavault. Без него недоступны такие популярные дополнения, как Docker-интеграция через openmediavault-compose, KVM для виртуальных машин, ZFS, MergerFS, SnapRAID и ряд других инструментов. Именно поэтому установка omv-extras — практически обязательный шаг после развёртывания NAS на базе OMV.
Подготовка системы перед установкой
Перед тем как ставить omv-extras, систему нужно привести в актуальное состояние. Устаревшие пакеты — частая причина конфликтов зависимостей при подключении нового репозитория.
Выполните обновление через веб-интерфейс (Система → Управление обновлениями) или из консоли:
apt update && apt upgrade -yТакже убедитесь, что у сервера есть доступ в интернет и корректно настроены DNS-серверы. Проверить это можно командой ping -c 3 deb.debian.org — если пакеты не проходят, репозиторий omv-extras просто не сможет загрузиться.
⚠️ Внимание: перед установкой omv-extras и любыми экспериментами с плагинами сделайте резервную копию конфигурации OMV — например, через плагин openmediavault-backup или клонирование системного диска. Откат после неудачной установки плагинов без бэкапа может потребовать переустановки системы.
- 🔍 Проверьте версию OMV и разрядность системы (omv-extras работает на 64-битных установках)
- 🌐 Убедитесь в наличии стабильного интернет-соединения на сервере
- 💾 Сохраните резервную копию конфигурации и важных данных
- 🧩 Определите заранее, какие плагины из репозитория вам нужны
Установка omv-extras через консоль
Самый надёжный способ — установка одной командой через SSH или локальный терминал от имени пользователя root. Официальный скрипт установки автоматически определяет версию OMV и подключает подходящий репозиторий:
wget -O - https://github.com/OpenMediaVault-Plugin-Developers/packages/raw/master/install | bashСкрипт скачивает пакет openmediavault-omvextrasorg, соответствующий вашей версии системы, устанавливает его через apt и подтягивает зависимости. Процесс занимает от одной до нескольких минут в зависимости от скорости соединения и мощности железа.
После завершения обновите страницу веб-интерфейса с очисткой кэша браузера (обычно Ctrl + F5). В меню Система должен появиться новый пункт omv-extras, а в разделе плагинов — дополнительные пакеты из нового репозитория.
Альтернативная установка через веб-интерфейс
Если консоль по какой-то причине недоступна, пакет можно поставить через графический интерфейс. Для этого потребуется вручную скачать файл .deb нужной версии из репозитория разработчиков плагинов и загрузить его в систему.
Порядок действий следующий: перейдите в раздел Система → Плагины, нажмите кнопку загрузки (иконка со стрелкой вверх), выберите скачанный файл openmediavault-omvextrasorg и подтвердите установку. После этого обновите список плагинов — репозиторий omv-extras подключится автоматически.
Важно скачивать пакет именно для своей версии OMV. Версии репозитория для OMV 5, 6 и 7 несовместимы между собой, и установка «чужого» пакета приведёт к ошибке зависимостей.
☑️ Проверка после установки omv-extras
Настройка репозитория и доступные разделы
После установки откройте Система → omv-extras — здесь включаются дополнительные разделы репозитория. По умолчанию активен основной репозиторий, а остальные включаются по необходимости.
| Раздел | Назначение | Когда включать |
|---|---|---|
| Основной репозиторий | Стабильные плагины omv-extras | Всегда, включён по умолчанию |
| Testing | Тестовые версии плагинов | Только для экспериментов, не на боевом сервере |
| Docker / Compose | Интеграция Docker и openmediavault-compose | Если планируете запускать контейнеры |
| Backports ядра | Более свежее ядро Debian | При проблемах с поддержкой нового железа |
После изменения настроек нажмите Сохранить и дождитесь обновления списков пакетов. Новые плагины появятся в разделе Система → Плагины.
Установка плагинов из omv-extras
Теперь можно ставить нужные расширения. Откройте Система → Плагины, найдите требуемый пакет через строку поиска, отметьте его и нажмите кнопку установки. Система сама разрешит зависимости.
- 🐳 openmediavault-compose — управление Docker-контейнерами и стеками через docker-compose
- 🖥️ openmediavault-kvm — виртуальные машины на базе KVM прямо из веб-интерфейса
- 📦 openmediavault-snapraid — защита данных от отказа дисков через снапшоты чётности
- 🔗 openmediavault-mergerfs — объединение нескольких дисков в единое пространство
- 🛡️ openmediavault-zfs — поддержка файловой системы ZFS
Ставьте плагины по одному и проверяйте работу каждого перед установкой следующего. Так проще локализовать проблему, если что-то пойдёт не так.
Куда ставить Docker и какие каталоги подготовить
Для openmediavault-compose рекомендуется заранее создать на данных-диске (не на системном) отдельные общие папки: для файлов compose, для постоянных данных контейнеров и для конфигураций. Пути к ним затем указываются в настройках плагина. Не размещайте данные контейнеров на системном диске — он быстро переполнится.
Типичные ошибки и их решение
Чаще всего пользователи сталкиваются с ошибкой GPG error или предупреждением о недоверенном репозитории при выполнении apt update. Обычно это решается повторным запуском установочного скрипта — он заново импортирует ключи репозитория.
Вторая распространённая ситуация — пункт omv-extras не появляется в меню после установки. Причина почти всегда в кэше браузера: выполните жёсткое обновление страницы или откройте интерфейс в режиме инкогнито.
⚠️ Внимание: не включайте тестовый (testing) репозиторий на сервере с важными данными. Тестовые версии плагинов могут содержать ошибки, вплоть до потери доступа к разделам веб-интерфейса.
Если плагин установился, но не работает, проверьте журнал командой journalctl -xe и статус служб через systemctl status. Возможная причина — конфликт с ранее установленными вручную пакетами, которые дублируют функциональность плагина.
Обновление omv-extras при смене версии OMV
При мажорном обновлении openmediavault (например, с 6 на 7) репозиторий omv-extras нужно привести в соответствие с новой версией. Официальный сценарий обновления — через скрипт omv-release-upgrade, который корректно переключает репозитории, включая omv-extras.
Перед мажорным обновлением рекомендуется отключить необязательные плагины и убедиться, что данные контейнеров и виртуальных машин вынесены на отдельные диски. После обновления проверьте работоспособность каждого плагина и при необходимости переустановите несовместимые.
Минорные обновления внутри одной версии OMV проходят штатно через Система → Управление обновлениями и не требуют дополнительных действий с репозиторием.
Часто задаваемые вопросы
Безопасен ли omv-extras и кто его поддерживает?
Репозиторий разрабатывается командой OpenMediaVault Plugin Developers — это устоявшийся проект сообщества, тесно связанный с экосистемой OMV. Тем не менее это сторонний репозиторий, поэтому базовые меры предосторожности (резервные копии, отказ от testing-ветки на боевом сервере) остаются обязательными.
Можно ли установить omv-extras на OMV, развёрнутый поверх Debian?
Да, если openmediavault установлен поверх чистого Debian поддерживаемой версии, установка omv-extras выполняется тем же скриптом. Главное — чтобы версия пакета соответствовала версии OMV.
Что делать, если после установки пропал доступ к веб-интерфейсу?
Подключитесь по SSH и проверьте статус службы: systemctl status openmediavault-engined. Попробуйте перезапустить её командой systemctl restart openmediavault-engined и выполнить omv-firstaid для сброса настроек веб-интерфейса. Если проблема сохраняется, изучите вывод journalctl -xe на предмет ошибок зависимостей.
Нужно ли удалять omv-extras перед обновлением OMV?
Нет, специально удалять репозиторий не требуется — скрипт omv-release-upgrade обрабатывает его автоматически. Достаточно убедиться, что все плагины обновлены до актуальных версий.
Как полностью удалить omv-extras?
Сначала удалите все плагины, установленные из репозитория, затем выполните apt remove openmediavault-omvextrasorg и обновите списки пакетов командой apt update. Удаление самого репозитория до удаления зависимых плагинов может оставить в системе «осиротевшие» пакеты.