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

Установка Plex на TrueNAS чаще всего упирается не в сам процесс развёртывания, а в ошибку с правами доступа: сервер запускается, веб-интерфейс открывается, но медиатека остаётся пустой, потому что контейнер не видит датасеты с фильмами. Поэтому перед нажатием кнопки установки важно заранее определить, какая у вас версия системы — TrueNAS CORE или TrueNAS SCALE, — и подготовить хранилище правильно.

Эти две версии принципиально различаются механизмом установки приложений. CORE построена на FreeBSD и использует систему плагинов на базе jail-окружений, а SCALE работает на Linux и разворачивает приложения в контейнерах. Инструкции для одной версии не подходят к другой, и попытка следовать чужому руководству — частая причина того, что установка зависает или приложение не стартует. Ниже разобраны оба сценария с подготовкой пулов, настройкой сети и типичными ошибками.

Подготовка: что проверить перед установкой

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

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

  • 🖥️ Проверьте версию системы: System → General покажет, установлена у вас CORE или SCALE.
  • 💾 Создайте отдельные датасеты для фильмов, сериалов и музыки в разделе Storage → Pools.
  • 🌐 Убедитесь, что у сервера есть выход в интернет и настроен DNS.
  • 👤 Заранее создайте пользователя или группу, от имени которых Plex будет читать медиафайлы.
⚠️ Внимание: не устанавливайте Plex в тот же датасет, где лежат медиафайлы. Конфигурацию приложения и данные библиотеки следует хранить раздельно — это упростит резервное копирование и переустановку сервера без потери настроек.

Установка Plex на TrueNAS CORE через плагин

В TrueNAS CORE установка выполняется через раздел Plugins в веб-интерфейсе. Найдите в списке доступных плагинов Plex Media Server и нажмите кнопку установки. Система автоматически создаст jail — изолированное окружение FreeBSD, внутри которого будет работать сервер. Процесс занимает несколько минут в зависимости от скорости интернета и дисков.

При установке вам предложат выбрать сетевые параметры. Обычно используется режим NAT с пробросом портов, но для домашней сети удобнее вариант, при котором jail получает собственный IP-адрес в вашей локальной сети — так проще открывать веб-интерфейс и настраивать удалённый доступ. После завершения установки плагин появится в списке, и его можно запустить переключателем.

Чтобы Plex увидел ваши медиафайлы, jail нужно «пробросить» датасеты через механизм точек монтирования. Остановите плагин, откройте его настройки и добавьте в разделе Mount Points пути к вашим датасетам с медиа, указав внутри jail целевые каталоги, например /media/movies. После этого запустите плагин снова.

☑️ Установка Plex на TrueNAS CORE

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

Установка Plex на TrueNAS SCALE

В TrueNAS SCALE приложения устанавливаются через раздел Apps. Перейдите в каталог приложений, найдите Plex Media Server в официальном или комьюнити-каталоге и нажмите Install. В отличие от CORE, здесь приложение разворачивается в контейнере, и все параметры задаются в одной форме установки: сетевые порты, переменные окружения, тома хранилища.

Ключевой шаг — привязка хранилища. В разделе настроек хранилища приложения добавьте ваши датасеты как Host Path и укажите точки монтирования внутри контейнера. Именно здесь чаще всего допускают ошибку: если оставить тип хранилища по умолчанию без привязки датасетов, Plex запустится, но не увидит ни одного файла. Также обратите внимание на идентификаторы пользователя и группы (PUID/PGID), от которых работает контейнер, — они должны иметь доступ на чтение к датасетам.

📊 На какой версии TrueNAS вы устанавливаете Plex?
TrueNAS CORE
TrueNAS SCALE
Ещё не выбрал версию
Планирую миграцию с CORE на SCALE

После установки дождитесь, пока статус приложения станет активным, и откройте веб-интерфейс кнопкой Web UI или вручную по адресу сервера с портом Plex. Стандартный веб-порт Plex — 32400, но в SCALE он может быть переопределён в настройках приложения, поэтому сверяйтесь с формой установки.

Сравнение установки на CORE и SCALE

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

ПараметрTrueNAS CORETrueNAS SCALE
Основа системыFreeBSDLinux
Механизм приложенийПлагины (jail)Контейнеры (Apps)
Раздел установкиPluginsApps
Доступ к медиаMount Points в jailHost Path в настройках приложения
Управление правамиПользователь внутри jailPUID/PGID контейнера

Первичная настройка Plex после установки

После первого входа в веб-интерфейс Plex предложит войти в учётную запись или создать новую. Затем мастер настройки попросит добавить библиотеки: выберите тип контента (фильмы, сериалы, музыка) и укажите пути к каталогам внутри контейнера или jail — тем самым точкам монтирования, которые вы настроили ранее. Если каталоги отображаются пустыми, вернитесь к настройкам хранилища и прав доступа.

Далее Plex начнёт сканировать файлы и подгружать метаданные: обложки, описания, рейтинги. На больших коллекциях это занимает заметное время и нагружает диски, поэтому не пугайтесь, если первые часы сервер работает медленнее обычного. Для удалённого доступа к библиотеке включите соответствующую опцию в настройках сервера — Settings → Remote Access — и убедитесь, что порт проброшен на роутере, если требуется доступ извне.

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

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

Самая частая жалоба — библиотека пуста, хотя файлы на дисках есть. Причина почти всегда в правах: пользователь, от имени которого работает Plex, не имеет доступа на чтение к датасетам. Проверьте ACL датасетов в разделе Storage и убедитесь, что соответствующему пользователю или группе выданы права как минимум на чтение. В SCALE дополнительно сверьте PUID/PGID приложения.

Вторая распространённая ситуация — веб-интерфейс не открывается. Проверьте, запущено ли приложение или плагин, какой порт назначен, и не блокирует ли соединение межсетевой экран. В CORE с NAT-конфигурацией jail веб-интерфейс может быть доступен по нестандартному адресу — посмотрите его в настройках плагина.

  • 📁 Пустая библиотека — проверьте точки монтирования и права ACL на датасеты.
  • 🔌 Веб-интерфейс недоступен — убедитесь, что приложение запущено и порт указан верно.
  • 🎞️ Тормозит воспроизведение — возможная причина в транскодировании; проверьте загрузку CPU и настройки качества на клиенте.
  • 🔄 Приложение не обновляется — перезапустите его и проверьте доступ сервера в интернет.
Почему Plex не видит файлы, хотя пути указаны верно

Частая скрытая причина — регистр и структура каталогов. Путь внутри контейнера (например, /media/movies) — это не тот же путь, что на хосте (/mnt/pool/movies). Plex видит только то, что смонтировано внутрь его окружения. Проверьте соответствие Host Path и точки монтирования в настройках приложения.

Обновление и обслуживание Plex-сервера

Регулярные обновления важны и для самой TrueNAS, и для Plex. В CORE плагины обновляются из раздела Plugins, в SCALE — через обновление приложения в разделе Apps. Перед крупными обновлениями системы имеет смысл сделать снапшот датасета с конфигурацией Plex — ZFS позволяет откатиться за секунды, если что-то пойдёт не так.

Отдельно следите за состоянием дисков и пула: настройте регулярные задачи scrubbing и S.M.A.R.T.-тесты, если это ещё не сделано. Медиасервер работает с дисками постоянно, и раннее обнаружение деградации пула убережёт коллекцию от потери. Резервное копирование конфигурации TrueNAS (файл настроек системы) тоже стоит выполнять периодически — оно сохраняется через System → General → Save Config.

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

Можно ли перенести Plex с TrueNAS CORE на SCALE без потери библиотеки?

Да, но напрямую jail в контейнер не конвертируется. Обычно создают новое приложение в SCALE и переносят каталог с метаданными Plex, либо настраивают сервер заново и дают ему пересканировать коллекцию. Перед миграцией сделайте резервную копию данных конфигурации Plex.

Какой порт использует Plex на TrueNAS?

Стандартный веб-порт Plex — 32400. Однако в SCALE порт может быть изменён в настройках приложения, а в CORE с NAT-конфигурацией адрес зависит от параметров jail. Точное значение смотрите в настройках установленного приложения.

Почему Plex не воспроизводит видео в 4K?

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

Нужен ли отдельный датасет для настроек Plex?

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

Что делать, если приложение Plex не запускается в SCALE?

Проверьте логи приложения в разделе Apps — там обычно видна причина сбоя. Часто проблема связана с занятым портом, неверными путями хранилища или недостатком ресурсов. Исправьте параметры в форме настроек и перезапустите приложение.