OMV-Extras.org для OpenMediaVault: установка, настройка и решение ошибок

Если после установки OpenMediaVault в списке плагинов нет нужных инструментов — Docker, Portainer, ZFS, flashmemory — значит, в систему ещё не подключён репозиторий omv-extras.org, и без него веб-интерфейс NAS остаётся урезанным до базовых функций. Проверить это просто: откройте раздел Система → Плагины и поищите пакет openmediavault-omvextrasorg — если его нет, репозиторий не установлен.

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

Что такое omv-extras.org и зачем он нужен

OMV-Extras — это внешний репозиторий пакетов для OpenMediaVault, который расширяет стандартный набор плагинов системы. Сам проект OpenMediaVault намеренно держит ядро минималистичным, а всё «тяжёлое» — контейнеризацию, альтернативные файловые системы, оптимизацию под флеш-накопители — выносится в omv-extras.

После подключения репозитория в разделе плагинов появляются дополнительные пункты, а в боковом меню — отдельный раздел OMV-Extras, где переключателями включаются нужные репозитории. Именно отсюда большинство пользователей ставят Docker и Portainer для запуска контейнеров вроде Plex, Nextcloud или Home Assistant.

  • 🐳 Docker CE и Portainer — запуск контейнерных приложений прямо на NAS.
  • 💾 openmediavault-flashmemory — снижает износ USB-флешек и SD-карт, с которых загружается система.
  • 🗄️ ZFS и другие файловые системы — расширенные варианты хранения данных.
  • 🧩 Дополнительные плагины: snapraid, mergerfs, kernel-инструменты и другие, набор зависит от версии OMV.

Проверка совместимости версий перед установкой

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

omv-version

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

apt update && apt upgrade -y
⚠️ Внимание: установка omv-extras на неподдерживаемую версию OpenMediaVault (например, пакет для OMV 6 на систему OMV 7) может сломать менеджер пакетов. Всегда сверяйте версию системы с инструкцией на сайте omv-extras.org для вашего релиза.

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

Штатный способ установки — одна команда, которая скачивает установочный скрипт с omv-extras.org и выполняет его. Потребуется доступ по SSH или локальный терминал с правами root.

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

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

☑️ Установка OMV-Extras — контрольные точки

Выполнено: 0 / 5

Если wget недоступен или GitHub заблокирован в вашей сети, альтернативный путь — вручную скачать deb-пакет для своей версии со страницы релизов проекта и установить его:

dpkg -i openmediavault-omvextrasorg_*.deb

apt --fix-broken install

Точное имя файла и актуальная ссылка зависят от версии OMV, поэтому берите их только с официальных страниц проекта omv-extras.org, а не со сторонних зеркал.

📊 Как вы чаще всего подключаетесь к своему OpenMediaVault?
SSH по локальной сети
Только веб-интерфейс
Монитор и клавиатура напрямую
Ещё не установил OMV

Настройка репозиториев в веб-интерфейсе

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

ОпцияНазначениеКогда включать
Docker CEРепозиторий Docker для контейнеровЕсли планируете Portainer, Plex, Nextcloud
Docker ComposeПлагин управления compose-файламиДля запуска стеков контейнеров из веб-интерфейса
BackportsБолее свежие пакеты DebianПри необходимости новых версий ПО
Testing / ExtrasТестовые плагины сообществаТолько для опытных пользователей

Порядок действий простой: включите нужный переключатель, нажмите Сохранить, затем дождитесь обновления списков пакетов. После этого переходите в Система → Плагины — там появятся новые пакеты, например openmediavault-compose для работы с Docker.

Установка Docker и Portainer через OMV-Extras

Главная причина, по которой пользователи ищут omv-extras.org, — это контейнеры. В свежих версиях OMV вместо отдельного плагина Portainer используется плагин openmediavault-compose: он ставит Docker и даёт веб-интерфейс для файлов docker-compose.yml. В более старых версиях Portainer устанавливался отдельной кнопкой прямо из раздела omv-extras.

Типовой порядок такой: включить репозиторий Docker, установить плагин compose, задать путь к общей папке для данных контейнеров и только потом разворачивать приложения. Данные контейнеров размещайте на диске с данными, а не на системном накопителе — особенно если OMV загружается с флешки.

Почему нельзя хранить данные контейнеров на системной флешке

Контейнеры (особенно медиасерверы с базами метаданных) генерируют постоянные мелкие записи. USB-флешки и SD-карты не рассчитаны на такой режим и быстро деградируют. Плагин flashmemory снижает износ системы, но тома контейнеров всё равно следует выносить на HDD/SSD.

Типичные ошибки при установке и их решение

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

  • 🌐 Ошибка скачивания скрипта — проверьте доступ сервера к интернету: ping -c 3 github.com и настройки DNS в Сеть → Интерфейсы.
  • 📦 Конфликт зависимостей — выполните apt --fix-broken install и повторите установку; перед этим убедитесь, что система обновлена.
  • 🔁 Раздел omv-extras не появился — очистите кэш браузера или откройте веб-интерфейс в режиме инкогнито; интерфейс OMV агрессивно кэшируется.
  • ⚙️ Плагины не отображаются после включения репозитория — нажмите кнопку проверки обновлений в разделе плагинов и дождитесь завершения.
⚠️ Внимание: не устанавливайте пакеты omv-extras вручную с неофициальных сайтов и форумов. Поддельный или устаревший deb-пакет может содержать вредоносный код либо несовместимые зависимости — берите файлы только с omv-extras.org и официального репозитория проекта на GitHub.

Если после всех действий пакетный менеджер остаётся в сломанном состоянии, посмотрите подробный вывод apt install -f — он показывает, какой именно пакет вызывает конфликт. В крайнем случае omv-extras можно удалить командой apt remove openmediavault-omvextrasorg, вернуться к стабильному состоянию и повторить установку по инструкции для вашей версии.

Обновление и удаление OMV-Extras

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

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

Удаление, если оно понадобилось, выполняется одной командой:

apt remove openmediavault-omvextrasorg

Учтите, что вместе с репозиторием перестанут обновляться и все установленные из него плагины, а часть из них может быть удалена как зависимость.

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

Безопасно ли устанавливать omv-extras?

Репозиторий поддерживается командой разработчиков плагинов OpenMediaVault и является фактическим стандартом экосистемы — его рекомендует само сообщество OMV. Тем не менее это сторонний источник пакетов, поэтому ставьте его только с официального сайта omv-extras.org и держите систему обновлённой.

Почему после установки не появился раздел omv-extras в меню?

Чаще всего виноват кэш браузера: интерфейс OMV кэширует скрипты, и новый пункт меню не подгружается. Очистите кэш, откройте панель в режиме инкогнито или выйдите из учётной записи и войдите снова.

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

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

OMV-Extras совместим с Raspberry Pi?

Да, репозиторий поддерживает ARM-сборки OpenMediaVault, включая Raspberry Pi. Установочный скрипт сам определяет архитектуру. На слабых устройствах обязательно ставьте плагин flashmemory, если система загружается с SD-карты.

Что делать, если скрипт установки не скачивается?

Проверьте DNS и доступ к GitHub с сервера. Если доступ ограничен, скачайте deb-пакет для своей версии OMV с официальной страницы проекта на другом устройстве, перенесите его на сервер и установите через dpkg -i с последующим apt --fix-broken install.