Как установить и управлять плагинами Plex вручную

Important: все инструкции применимы только на машине, где запущен Plex Media Server. На устройствах, где запущен только клиент (Plex Media Player), плагин установить нельзя.

Что было с каталогом плагинов Plex и почему он закрылся

Plex официально отключил Plugin Directory в октябре 2018 года. Компания объяснила решение сочетанием низкой активности пользователей (менее 2% базы) и зависимости каталога от устаревшего протокола, который сложно поддерживать в современных клиентах. В блоге Plex отметили, что многие задачи удобнее решать отдельными приложениями, например, Tautulli.

Определение: Плагин Plex — это расширение в виде пакета (.bundle), которое добавляет источник контента или утилиту в интерфейс Plex.

Это означало, что централизованного репозитория больше нет, но сам механизм плагинов остался: можно вручную помещать пакеты в папку Plug‑ins сервера. Plex публично подтвердил, что ручная установка останется доступна «в обозримом будущем».

Когда стоит использовать плагины сейчас

• Если вы хотите добавить нестандартные источники (например, сайты, сетевые сервисы) или специальные утилиты.
• Для ретро‑интеграций, которые официально не поддерживаются в современных приложениях.
• Для локальных скриптов и инструментов, которые дают администратору дополнительные метрики и функции.

Когда плагины не подходят

• Если нужна официальная, поддерживаемая интеграция на долгий срок. Плагины могут бросить разработчики.
• Для потоковых сервисов с DRM — плагин обычно не решит проблему легального доступа.

Подготовка файлов и требования

• Формат плагина: файл с расширением .bundle. Обычно это архив или уже распакованная папка с расширением .bundle.
• Источники: форумы Plex (раздел Plugins), GitHub, Reddit и сообщество неопубликованных магазинов. Проверьте репутацию автора.
• Разархивация: если вы скачали архив, извлеките из него .bundle. Оставляйте только сам .bundle — все лишнее можно удалить.
• Права доступа: у сервера Plex должны быть права на чтение каталога Plug‑ins.

Как вручную установить плагин в Plex шаг за шагом

1. Получите доступ к компьютеру или диску, где запущен Plex Media Server.
2. Найдите файл плагина с расширением .bundle и распакуйте его, если он в архиве.
3. Откройте папку Plug‑ins сервера.

Доступ к папке Plug‑ins можно получить двумя способами:

• Через интерфейс: щёлкните правой кнопкой на иконке Plex в панели задач и выберите Open Plugins Folder.
• Вручную: перейдите в папку установки Plex на диске.

Пути по умолчанию

Windows: %LOCALAPPDATA%\Plex Media Server\Plug-ins
macOS: ~/Library/Application Support/Plex Media Server/Plug-ins
Linux: $PLEX_HOME/Library/Application Support/Plex Media Server/Plug-ins

4. Перетащите или скопируйте папку .bundle в Plug‑ins. Установка завершается — инсталлятора нет.
5. Перезапустите Plex Media Server, если плагин не появился автоматически.

Примечание: имена плагинов внутри папки должны иметь расширение .bundle, а не .bundle.zip или другие. Если вы видите вложенные архивы — извлеките их.

Как автоматически устанавливать и обновлять плагины через Unsupported App Store

Unsupported App Store — неофициальный магазин плагинов, который долгое время использовали продвинутые пользователи Plex. Он упрощает установку, управление и обновления. Обратите внимание: проект больше не активно разрабатывается, но остаётся поддерживаемым сообществом.

Как это работает

1. Сайдлоадьте Unsupported App Store как обычный .bundle в папку Plug‑ins по описанному выше методу.
2. Откройте Plex и перейдите в раздел Online Content. Магазин появится как отдельный источник.
3. Устанавливайте плагины из каталога магазина: магазин сам раскладывает .bundle в Plug‑ins и умеет проверять обновления.

Преимущества магазина

• Автоматические обновления плагинов через магазин.
• Удобный интерфейс для поиска и установки.
• Источники проверяются сообществом, что снижает риск установки битых пакетов.

Ограничения

• Магазин неофициальный и не гарантирует вечную совместимость.
• Может отсутствовать поддержка новых версий Plex клиента.

Как использовать установленные плагины в Plex

• На десктопе: в левой панели Plex вы увидите разделы или плитки для установленных плагинов.
• На мобильных устройствах, телевизорах и стриминговых коробках плагины обычно доступны через раздел Online Content.
• Нажмите на плитку плагина, чтобы открыть его каталог медиа или интерфейс.

Замечание: некоторые плагины добавляют свои настройки в панель администратора Plex Media Server, другие работают как внешние источники и не имеют настроек внутри Plex.

Как удалить плагин

1. Откройте папку Plug‑ins, где вы ранее скопировали .bundle.
2. Удалите соответствующий .bundle файлом: щёлкните правой кнопкой и выберите Delete или используйте клавишу Delete.
3. Перезапустите сервер Plex, если плагин остаётся видимым.

Важно: удаление .bundle — единственный способ убрать плагин, встроенной функции удаления в Plex клиентах нет.

Отладка и частые ошибки

Проблема: плагин не появляется в интерфейсе

• Проверьте, что папка называется с расширением .bundle и расположена в правильной папке Plug‑ins.
• Перезапустите Plex Media Server.
• Проверьте логи Plex на предмет ошибок парсинга плагина.

Проблема: плагин выдаёт ошибки при загрузке контента

• Убедитесь, что у плагина актуальная версия под вашу версию Plex.
• Проверьте, не блокирует ли ваш фаервол исходящие запросы, если плагин обращается к внешним API.
• Смотрите логи плагина (часто внутри .bundle есть лог‑механизм).

Проблема: плагин вызывает падение сервера

• Удалите плагин из папки Plug‑ins быстрым способом и перезапустите сервер.
• Если сервер не стартует, временно переименуйте папку Plug‑ins, чтобы исключить все плагины.

Совет по логам

Логи Plex находятся в папке с данными сервера. На macOS это обычно ~/Library/Logs/Plex Media Server, на Windows — %LOCALAPPDATA%\Plex Media Server\Logs.

Безопасность и конфиденциальность

• Источник плагина. Загружайте плагины только из заслуживающих доверия репозиториев. Пакеты .bundle могут содержать скрипты, которые выполняют сетевые запросы или записывают логи.
• Права доступа. Запускайте Plex под учётной записью с минимально необходимыми правами. Не давайте серверу излишних привилегий.
• Сетевой доступ. Если плагин обменивается данными с внешними сервисами, проверьте политику конфиденциальности автора.
• GDPR и персональные данные. Если плагин собирает метрики пользователей, убедитесь, что это соответствует локальным законам и политике вашей сети.

Совместимость и примечания по версиям

Ментальная модель: плагин — это независимый модуль, который может сломаться из‑за изменений платформы. Оценивайте зрелость плагина прежде, чем использовать его в продакшене.

• Plex меняет внутренние API и клиентские протоколы. Старые плагины могут перестать работать после обновлений Plex.
• Unsupported App Store помогает смягчить проблему обновлений, но не устраняет риск несовместимости.

Таблица совместимости (ориентировочно)

Ролевые чек‑листы перед установкой плагина

Администратор сервера

• Проверить репозиторий и историю обновлений плагина.
• Создать резервную копию папки Plug‑ins и конфигураций Plex.
• Убедиться в доступности логов и прав на файловую систему.

Power‑user

• Испытать плагин в отдельной тестовой среде.
• Оценить, какие внешние сервисы использует плагин.
• Настроить уведомления о падениях сервера.

Обычный пользователь

• Попросить администратора установить плагин.
• Не устанавливать плагины с неизвестных источников.

Процедура быстрой установки (SOP)

1. Скачайте .bundle с доверенного источника.
2. Сделайте резервную копию текущей папки Plug‑ins.
3. Перенесите .bundle в папку Plug‑ins.
4. Перезапустите Plex Media Server.
5. Проверьте работу плагина и логи на ошибки.
6. Зафиксируйте версию плагина в реестре (см. шаблон ниже).

Шаблон реестра плагинов

План отката и реагирование на инциденты

Если после установки плагина сервер нестабилен:

1. Удалите .bundle из папки Plug‑ins.
2. Перезапустите сервер.
3. Восстановите папку Plug‑ins из резервной копии, если нужно.
4. Проанализируйте логи для причины сбоя.
5. При необходимости заблокируйте доступ плагина к сети через фаервол.

Критерии приёмки

• Плагин корректно отображается в интерфейсе Plex.
• Контент загружается без ошибок и задержек более 5 секунд.
• Нет критических сообщений в логах Plex после 30 минут работы.
• Плагин не требует привилегий, превышающих необходимые для чтения/записи своих файлов.

Тестовые сценарии

• Установить плагин и проверить, что его плитка появляется в Online Content.
• Перезагрузить сервер и подтвердить сохранение состояния плагина.
• Обновить плагин вручную (если доступно) и проверить работу без ошибок.
• Симулировать недоступность внешнего API и убедиться, что плагин деградирует корректно.

Альтернативные подходы

• Использовать сторонние приложения для той же задачи (например, Tautulli для аналитики).
• Развернуть отдельный медиасервер или контейнер с расширенной поддержкой интеграций.
• Писать небольшие внешние скрипты, которые не зависят от плагин‑архитектуры Plex.

Частые вопросы

Вопрос: Будут ли плагины работать после крупного обновления Plex?

Ответ: Не гарантированно. Некоторые плагины перестанут работать после обновлений внутреннего API. Перед обновлением Plex протестируйте плагины в тестовой среде.

Вопрос: Можно ли автоматизировать установку плагинов на несколько серверов?

Ответ: Да, скрипты копирования .bundle и перезапуска Plex позволяют массово распространять плагины, но следует учитывать права доступа и совместимость.

Резюме

• Официальный каталог плагинов Plex закрыт, но механика плагинов осталась и доступна для ручной установки.
• Для установки используйте .bundle и поместите его в папку Plug‑ins на сервере Plex.
• Unsupported App Store упрощает управление и обновления, но остаётся неофициальным.
• Всегда проверяйте источник плагина и держите резервные копии. Следите за логами и ограничивайте сетевые привилегии плагина.

Если вам нужна помощь с конкретным .bundle или вы хотите чек‑лист под вашу платформу, опишите систему (Windows/macOS/Linux) и мы подготовим адаптированную инструкцию.