Установка Plex Media Server на openmediavault: полное руководство

Установка Plex Media Server на openmediavault чаще всего упирается не в сам сервер, а в права доступа к папкам с медиафайлами: контейнер запускается, но библиотека остаётся пустой, потому что пользователь, от имени которого работает Plex, не имеет доступа к общим ресурсам. Поэтому прежде чем разворачивать контейнер, стоит определиться со способом установки и заранее подготовить хранилище.

В этой статье разберём два рабочих подхода: установку через Docker с Portainer (рекомендуемый современный способ для openmediavault 6 и 7) и вариант с плагином openmediavault-compose. Отдельно рассмотрим подготовку дисков, настройку прав, проброс портов и типичные ошибки, с которыми сталкиваются пользователи домашних NAS.

Что понадобится перед установкой

Перед началом убедитесь, что система соответствует базовым требованиям. openmediavault должен быть установлен и обновлён, веб-интерфейс доступен по сети, а диски с медиаконтентом — смонтированы и видны в разделе Хранилище → Файловые системы.

Для комфортной работы Plex желательно, чтобы сервер имел достаточно оперативной памяти и процессор с поддержкой аппаратного транскодирования, если вы планируете конвертировать видео «на лету». Без транскодирования Plex работает даже на слабом железе — например, на одноплатных компьютерах вроде Raspberry Pi, но с ограничениями.

  • 🖥️ Установленный и обновлённый openmediavault 6 или 7 с доступом к веб-панели
  • 💾 Смонтированный диск или RAID-массив с папками для фильмов, сериалов и музыки
  • 🌐 Стабильное сетевое подключение, желательно по кабелю Ethernet
  • 👤 Учётная запись Plex (бесплатная регистрация на сайте сервиса)
  • 🐳 Установленный Docker и плагин openmediavault-compose (разберём ниже)

Подготовка: установка Docker и openmediavault-compose

Начиная с шестой версии openmediavault, официальный плагин Plex отсутствует, и стандартным способом развёртывания стал Docker. Удобнее всего управлять контейнерами через плагин openmediavault-compose, который добавляет в веб-интерфейс раздел для работы с compose-файлами.

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

Далее в настройках плагина укажите путь к общей папке, где будут храниться compose-файлы и данные контейнеров. Рекомендуется выделить для этого отдельную папку на диске с достаточным запасом места, например appdata. После сохранения настроек плагин автоматически установит Docker при первом запуске.

⚠️ Внимание: не размещайте конфигурацию контейнеров на системном диске openmediavault. База данных Plex со временем заметно разрастается из-за метаданных и миниатюр, и переполнение системного раздела может нарушить работу всей системы.

Создание общих папок и настройка прав доступа

Это самый ответственный этап, от которого зависит, увидит ли Plex ваши файлы. Перейдите в раздел Хранилище → Общие папки и создайте необходимые каталоги: например, media для фильмов и сериалов и appdata для конфигураций контейнеров.

Затем откройте раздел Пользователи и создайте отдельного пользователя, например plex. В правах доступа к общим папкам выдайте этому пользователю разрешение на чтение (или чтение и запись, если планируете удалять файлы через интерфейс Plex) для папки с медиа. Запомните PUID и PGID этого пользователя — их можно посмотреть через SSH командой id имя_пользователя.

id plex

вывод: uid=1001(plex) gid=100(users) ...

Именно эти числовые идентификаторы вы укажете в compose-файле, чтобы контейнер работал от имени нужного пользователя. Несовпадение PUID/PGID с владельцем папок — причина номер один, почему Plex не видит файлы после установки.

☑️ Подготовка к установке Plex

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

Установка Plex через compose-файл

Теперь перейдите в раздел Сервисы → Compose → Файлы и создайте новый файл. Вставьте в него конфигурацию для образа plexinc/pms-docker — это официальный образ Plex. Пример базовой конфигурации выглядит так:

services:

plex:

image: plexinc/pms-docker:latest

container_name: plex

network_mode: host

environment:

- PUID=1001

- PGID=100

- TZ=Europe/Moscow

- PLEX_CLAIM=

volumes:

- /путь/к/appdata/plex:/config

- /путь/к/media:/data

restart: unless-stopped

Обратите внимание на несколько моментов. Параметр PLEX_CLAIM нужен только при первом запуске: токен получают на странице plex.tv/claim, и он привязывает сервер к вашей учётной записи. Токен действует ограниченное время, поэтому получайте его непосредственно перед запуском. Режим network_mode: host упрощает сетевую настройку и обеспечивает корректную работу автоматического обнаружения сервера в локальной сети.

После сохранения файла нажмите кнопку запуска (Up) — Docker скачает образ и создаст контейнер. Процесс может занять несколько минут в зависимости от скорости интернета. Проверить состояние контейнера можно во вкладке Контейнеры того же раздела.

⚠️ Внимание: пути в секции volumes указываются как абсолютные пути на хосте, а не относительные. Точный путь к общей папке можно посмотреть в её свойствах в веб-интерфейсе openmediavault — обычно это что-то вроде /srv/dev-disk-by-uuid-....
📊 Каким способом вы устанавливаете Plex на openmediavault?
Через Docker и openmediavault-compose
Через Portainer
Вручную через SSH и docker run
Ещё только выбираю способ

Первый запуск и настройка библиотек

После запуска контейнера откройте в браузере адрес http://IP-адрес-сервера:32400/web. Если токен PLEX_CLAIM был указан корректно, сервер уже будет привязан к вашей учётной записи. В противном случае интерфейс предложит войти и заявить сервер вручную.

Далее создайте библиотеки: нажмите «Добавить библиотеку», выберите тип (фильмы, сериалы, музыка) и укажите путь внутри контейнера — в нашем примере это /data или его подпапки. Plex начнёт сканирование и загрузку метаданных: постеров, описаний, рейтингов.

Чтобы медиафайлы корректно распознавались, придерживайтесь рекомендуемой структуры именования. Для фильмов — Название (год)/Название (год).mkv, для сериалов — Название/Season 01/S01E01.mkv. Подробные правила именования описаны в официальной документации Plex, и их соблюдение заметно снижает число ошибок распознавания.

Почему Plex не видит папку /data или она пустая

Проверьте три вещи. Во-первых, правильность пути хоста в секции volumes compose-файла — опечатка в пути приводит к монтированию пустого каталога. Во-вторых, совпадение PUID/PGID с владельцем папки на хосте (команда ls -la покажет владельца). В-третьих, права на чтение для группы или остальных пользователей на всей цепочке каталогов, а не только на конечной папке.

Сравнение способов установки Plex на openmediavault

Существует несколько подходов к развёртыванию Plex, и у каждого есть свои особенности. Сводная таблица поможет выбрать подходящий вариант под ваш уровень подготовки.

СпособСложностьОбновленияКому подходит
openmediavault-composeНизкаяЧерез веб-интерфейсБольшинству пользователей OMV 6/7
PortainerСредняяЧерез интерфейс PortainerТем, кто управляет несколькими контейнерами
docker run через SSHСредняяВручнуюОпытным пользователям терминала
Прямая установка пакета на DebianВысокаяЧерез aptНе рекомендуется — риск конфликтов с OMV

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

Самая частая жалоба — сервер запущен, но недоступен из сети. Проверьте, открыт ли порт 32400 в межсетевом экране (если он включён в openmediavault), и что контейнер использует network_mode: host либо корректный проброс портов. Также убедитесь, что клиент и сервер находятся в одной подсети для первоначальной настройки.

Вторая распространённая ситуация — ошибка «Сервер недостаточно мощный для конвертации видео» при воспроизведении. Это означает, что процессор не справляется с транскодированием. Решения: включить прямое воспроизведение (Direct Play) в настройках клиента, использовать файлы в совместимых с вашими устройствами форматах или настроить аппаратное транскодирование, если его поддерживает ваш процессор и подписка Plex Pass.

Если после обновления контейнера сервер «потерял» библиотеки, скорее всего, путь к /config в новом контейнере отличается от прежнего, и Plex создал чистую конфигурацию. Проверьте, что том с конфигурацией смонтирован в ту же папку на хосте, где лежит ваша прежняя база.

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

Можно ли установить Plex на openmediavault без Docker?

Теоретически можно установить deb-пакет Plex напрямую в систему, так как openmediavault основан на Debian. Однако это не рекомендуется: ручная установка может конфликтовать с пакетной базой OMV и усложняет обновления. Docker-способ изолирует Plex от системы и считается стандартным для современных версий.

Нужна ли платная подписка Plex Pass для работы сервера?

Нет, базовые функции — потоковое воспроизведение вашей медиатеки, организация библиотек, удалённый доступ — доступны бесплатно. Plex Pass добавляет аппаратное транскодирование, мобильную синхронизацию и некоторые другие возможности.

Как обновить Plex, установленный в Docker?

В разделе Сервисы → Compose остановите контейнер, выполните загрузку нового образа (Pull) и запустите контейнер заново. Конфигурация и библиотеки сохранятся, так как они хранятся в примонтированной папке на хосте, а не внутри контейнера.

Почему Plex долго сканирует библиотеку при первом запуске?

При первом сканировании Plex загружает метаданные и создаёт миниатюры для каждого файла — на больших коллекциях это занимает заметное время и нагружает диск и процессор. Можно отключить генерацию миниатюр в настройках библиотеки, чтобы ускорить процесс.

Работает ли Plex на Raspberry Pi с openmediavault?

Да, Plex работает на ARM-платах, включая Raspberry Pi, при использовании образа с поддержкой соответствующей архитектуры. Однако транскодирование видео на таком железе практически недоступно — рассчитывайте на прямое воспроизведение совместимых форматов.