OMV Extras в openmediavault: установка, настройка и решение проблем

Если после установки openmediavault в разделе плагинов не хватает нужных инструментов — Docker, KVM, ZFS, SnapRAID — причина почти всегда одна: не подключён сторонний репозиторий OMV Extras. Без него стандартный набор плагинов ограничен базовыми расширениями, а большая часть возможностей домашнего NAS остаётся недоступной.

OMV Extras — это неофициальный, но фактически стандартный репозиторий дополнений для openmediavault, который поддерживается сообществом и добавляет в веб-интерфейс десятки плагинов. В этой статье разберём, как его установить на актуальные версии OMV, какие плагины стоит поставить в первую очередь и что делать, если установка завершается ошибкой.

Что такое OMV Extras и зачем он нужен

OMV Extras (omv-extras.org) — это дополнительный репозиторий пакетов, который расширяет стандартный каталог плагинов openmediavault. Сам по себе openmediavault — это веб-панель управления NAS на базе Debian, но её официальный репозиторий намеренно минимален. Всё, что выходит за рамки базовых задач, сообщество выносит в omv-extras.

После подключения репозитория в разделе Система → Плагины появляются дополнительные категории: виртуализация, контейнеры, файловые системы, инструменты резервного копирования и мониторинга. Фактически именно через omv-extras большинство пользователей запускают Docker и Compose на своём NAS.

Совместимость версий OMV и omv-extras

Каждая мажорная версия openmediavault требует своей версии omv-extras: пакет для OMV 6 не подойдёт для OMV 7 и наоборот. Установочный скрипт обычно сам определяет версию системы, но при ручной установке пакета несовпадение версий приведёт к ошибкам зависимостей.

Проверить свою версию можно в веб-интерфейсе на странице Система → Информация либо командой в терминале:

omv-version

⚠️ Внимание: версии OMV 5 и старше уже не получают обновлений. Если у вас старая система, разумнее запланировать обновление OMV, а не искать архивные пакеты omv-extras — старые репозитории могут быть отключены.

Установка OMV Extras через терминал

Самый надёжный способ — официальный установочный скрипт, который сам определяет версию OMV, добавляет репозиторий и ключи подписи. Подключитесь к NAS по SSH под пользователем root (или через sudo) и выполните:

wget -O - https://github.com/OpenMediaVault-Plugin-Developers/installScript/raw/master/install | sudo bash

Скрипт выполнит несколько действий: проверит версию системы, добавит репозиторий omv-extras в источники APT, импортирует GPG-ключ и установит плагин openmediavault-omvextrasorg. После завершения обновите страницу веб-интерфейса — в разделе Система появится пункт omv-extras.

Если скрипт отработал без ошибок, дополнительных действий не требуется. Весь дальнейший управление репозиторием ведётся через веб-интерфейс.

Что включить после установки

Откройте Система → omv-extras — здесь собраны переключатели дополнительных репозиториев. Вам не обязательно включать всё сразу: активируйте только то, что действительно планируете использовать.

• 🐳 Docker repo — добавляет официальный репозиторий Docker; без него плагин Compose не сможет установить движок контейнеров.
• 💾 Backports — backports-репозиторий Debian с более свежими версиями пакетов; полезен для новых ядер и драйверов.
• 🧪 Testing repo — тестовые версии плагинов; на «боевом» NAS лучше не включать без необходимости.
• 📦 Proxmox kernel — опция установки ядра Proxmox, которую часто выбирают ради встроенной поддержки ZFS.

После изменения переключателей нажмите Сохранить и дождитесь обновления списков пакетов. Затем переходите в Система → Плагины и ставьте нужные расширения.

Популярные плагины из omv-extras

Каталог репозитория велик, но несколько плагинов встречаются почти в каждой домашней сборке NAS. Рассмотрим основные.

• 🐋 openmediavault-compose — управление Docker-контейнерами и файлами docker-compose прямо из веб-интерфейса; замена устаревшей связки с Portainer для базовых задач.
• 🖥️ openmediavault-kvm — виртуальные машины на KVM с настройкой через браузер.
• 🗄️ openmediavault-zfs — поддержка пулов ZFS (требует совместимого ядра).
• 🔄 openmediavault-snapraid — защита данных через SnapRAID для массивов с дисками разного размера.
• 📊 openmediavault-wetty — веб-терминал для доступа к консоли без SSH-клиента.

Установка любого плагина стандартная: отметьте его в списке и нажмите Установить. Зависимости подтянутся автоматически.

Типичные ошибки и их решение

Чаще всего проблемы возникают не с самим omv-extras, а с сетью, ключами или устаревшими источниками. Разберём основные сценарии.

Ошибка GPG-ключа при apt update. Если APT ругается на отсутствующий или недействительный ключ репозитория, повторно запустите установочный скрипт — он переустановит ключи. Ручное добавление ключей тоже возможно, но скрипт делает это корректнее.

Репозиторий недоступен. Проверьте, что у NAS есть доступ в интернет и корректно работает DNS:

ping -c 3 openmediavault.org

Пункт omv-extras не появился после установки. Очистите кэш браузера или откройте панель в режиме инкогнито — веб-интерфейс OMV агрессивно кэшируется. Также помогает перезапуск службы:

systemctl restart openmediavault-engined

⚠️ Внимание: не добавляйте репозиторий omv-extras вручную через правку /etc/apt/sources.list, если точно не знаете формат записи для вашей версии. Некорректная строка источника может сломать обновление всей системы, включая базовые пакеты openmediavault.

⚠️ Внимание: перед обновлением OMV на новую мажорную версию (например, с 6 на 7) сверьтесь с официальной документацией проекта: часть плагинов omv-extras требует отдельной процедуры миграции, а несовместимые плагины рекомендуется удалить до обновления.

Альтернатива

установка пакета вручную:Если скрипт недоступен, можно скачать .deb-пакет openmediavault-omvextrasorg для вашей версии OMV со страницы релизов проекта omv-extras и установить его командой dpkg -i с последующим apt -f install для разрешения зависимостей. Этот способ требует точного знания версии системы.

Обновление и удаление omv-extras

Обновляется репозиторий вместе с системой: пакет openmediavault-omvextrasorg приходит через обычный механизм обновлений в разделе Система → Управление обновлениями. Отдельных действий не требуется — достаточно регулярно применять обновления OMV.

Если нужно удалить omv-extras, сначала удалите все плагины, установленные из этого репозитория, и только затем сам пакет. Удаление репозитория при активных плагинах оставит «осиротевшие» пакеты, которые перестанут обновляться и могут конфликтовать при апгрейде системы.

Часто задаваемые вопросы

Безопасно ли использовать OMV Extras?

Репозиторий поддерживается командой разработчиков плагинов openmediavault и является фактическим стандартом экосистемы. Тем не менее это сторонний источник: включайте только нужные компоненты и не активируйте testing-репозиторий на системе с важными данными.

Можно ли установить Docker без omv-extras?

Технически да — вручную через официальный репозиторий Docker и CLI. Но вы потеряете интеграцию с веб-интерфейсом OMV: плагин Compose, управление файлами compose и мониторинг контейнеров доступны только через omv-extras.

Установочный скрипт зависает или выдаёт ошибку сети. Что делать?

Проверьте DNS-настройки NAS (раздел Сеть → Интерфейсы), доступность интернета и корректность системного времени — неверные часы ломают проверку TLS-сертификатов. При повторных сбоях попробуйте ручную установку .deb-пакета для вашей версии OMV.

Нужно ли переустанавливать omv-extras после обновления OMV?

При обновлении в рамках одной мажорной версии — нет. При переходе на новую мажорную версию OMV процедура зависит от официальных инструкций проекта: обычно требуется установка пакета omv-extras, соответствующего новой версии системы.

Где найти список всех доступных плагинов?

Актуальный список виден прямо в веб-интерфейсе после подключения репозитория: Система → Плагины. Описания и статус поддержки каждого плагина также публикуются на сайте и форуме проекта omv-extras.