Если после установки 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 — контрольные точки
Если wget недоступен или GitHub заблокирован в вашей сети, альтернативный путь — вручную скачать deb-пакет для своей версии со страницы релизов проекта и установить его:
dpkg -i openmediavault-omvextrasorg_*.deb
apt --fix-broken install
Точное имя файла и актуальная ссылка зависят от версии OMV, поэтому берите их только с официальных страниц проекта omv-extras.org, а не со сторонних зеркал.
Настройка репозиториев в веб-интерфейсе
После установки откройте Система → 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.