Як запустити Plex на Docker: повний посібник

У цій статті ми розглянемо, як запускати Plex у контейнерах Docker. Ми розглянемо два популярні образи контейнерів Plex Docker і те, що вам потрібно знати перед створенням контейнера Docker для Plex. Але найголовніше, ми разом пройдемо весь процес встановлення Plex на Docker для серверів Linux і Windows.

Незалежно від того, чи є ви досвідченим користувачем Docker, чи тільки починаєте, ця стаття надасть вам все необхідне для початку роботи з Plex у контейнерах Docker.

Без зайвих слів, давайте зануримося!

Застереження. Зверніть увагу, що в наступній статті обговорюється встановлення Plex Media Server на Docker. Однак ми хочемо уточнити, що в RapidSeedbox ми не запускаємо Plex на Docker в наших seedbox'ах (з міркувань продуктивності). Якщо у вас є сервер Rapidseedbox, ми пропонуємо встановити Plex через наш зручний додатки в один клікспеціально розроблений для клієнтів RapidSeedbox. Але якщо ви вирішите встановити Plex на Docker, ви визнаєте і приймаєте, що робите це на свій страх і ризик, використовуючи власні ресурси, і берете на себе повну відповідальність за налаштування і обслуговування. Ми не можемо гарантувати продуктивність, стабільність або сумісність Plex на Docker, оскільки це виходить за рамки рекомендованих нами методів встановлення.

Зміст. 

1. Як запустити Plex Media Server у докер-контейнерах? 
2. Зображення контейнерів Plex Docker. 
3. Перш ніж створити Docker-контейнер для Plex Media Server
4. Запуск Plex на Docker (Linux та Windows).
   1. Запуск Plex Docker на Linux
   2. Запуск Plex Docker у Windows. 
5. Відкриваємо Plex Media Server. 
6. Поширені запитання про Docker Plex. 

1. Як запустити Plex Media Server у докер-контейнерах? 

Можливо, ви вже знайомі з Plex Media Server (PMS) - без сумніву, найпотужніший медіа-сервер з усіх існуючих. Одна з чудових речей у PMS - це те, що його можна встановити практично будь-де (на macOS, Windows, Linux, NAS, телевізорах, Raspberry Pi тощо). І, звичайно, завдяки технології контейнеризації Docker, ви також можете запускати Plex в контейнері Docker, що робить цей потужний медіа-сервер простим в управлінні і розгортанні.

Запуск Docker на Plex дає вам багато переваг. Це не лише полегшує керування та розгортання (як згадувалося раніше), але й робить його більш портативним, масштабованим, стабільним та узгодженим. Крім того, використання Docker допоможе вам створити ізольоване середовище для Plex і його залежностей, що дозволить вашій медіасистемі Plex залишатися повністю захищеною.

Якщо коротко, які кроки потрібно зробити, щоб запустити Plex на Docker? 

• Визначте, який образ Docker використовувати. На Docker Hub ви можете знайти попередньо зібрані образи, зокрема офіційний образ Plex від PlexInc та образ linuxserver.
• Налаштуйте мережу. Before creating a Docker container, you would first need to configure the networking parameters of your Plex Docker container. There are three modes: bridge, macvlan, and host.
• Створіть контейнер Plex Docker. Ви можете створити контейнер за допомогою готового зображення (рекомендується) або створити свій власний. 
• Після того, як контейнер встановлено, ви можете розпочати його налаштування. Вам потрібно налаштувати папки мультимедіа та вказати, які файли слід включити до бібліотеки Plex. Ви також можете налаштувати мережеві параметри та параметри віддаленого доступу.

2. Зображення контейнерів Plex Docker. 

Docker надає багато образів, доступних для Plex (не безпосередньо для Plex Media Server). Ви також можете знайти образи для Plex Meta Manager або PlexPy. 

Два найпопулярніші образи контейнерів для Plex Media Server :

• plexinc/pms-docker: Зображення plexinc/pms-docker (by плексин) є офіційним контейнером Plex Media Server. Ви також можете відвідати їхню сторінку Репозиторій GitHub. 
• linuxserver/plex: Зображення linuxserver/plex (від linuxserver.io) це контейнер PMS, наданий вам LinuxServer.io. Ви також можете дізнатися більше про цей проект, відвідавши їхню сторінку Репозиторій GitHub. 

Де можна дізнатися більше про ці (та інші) зображення Plex? 

• Перейдіть на Docker Hub. Це хмарне сховище образів контейнерів Docker. Він дозволяє користувачам зберігати, обмінюватися та розповсюджувати образи Docker. Швидкий пошук на Docker Hub за ключовим словом "Plex" покаже вам доступні результати.

• Як ви побачите, ви знайдете багато зображень у форматі Plex. І, звичайно, ви можете завантажити будь-який з двох популярних образів контейнерів і знайти вичерпну документацію з цього офіційного репозиторію Docker. 

То в чому ж різниця між plexinc/pms-docker та linuxserver/plex? 

Although both Docker images allow you to run PMS in a containerized environment, and both are based on Linux Ubuntu, they do have differences. First, pms-docker is maintained by the official Plex team, while linuxserver/plex is maintained by the LinuxServer.io community. The other two differences in both images are that pms-docker uses “shell” as its preferred language, while linuxserver/plex relies on Dockerfile. Finally, another crucial distinction is that linuxserver/plex uses an open license under (GNU General Public License v3.0 only). 

На закінчення, якщо ви зосередитеся на запуску Plex на Docker, обидва варіанти є однаково чудовими з точки зору функціональності та можливостей; який з них ви оберете, буде залежати від вашого конкретного використання, ресурсів та вимог. 

3. Перед створенням Docker-контейнера для Plex Media Server

Перш ніж створювати Docker-контейнер для Plex, зверніть увагу на наступне: 

• a. Ви намагаєтеся запустити Plex Media Server на Seedbox?
• b. Яку ОС використовувати для запуску образу Plex Docker?
• c. Define the container’s and dependencies’ configuration. 
• d. Вирішіть, який тип мережі використовувати. 

a. Ви використовуєте Plex Media Server на Seedbox?

Plex Media Server можна використовувати в поєднанні з сідбокс (seedbox). You can use the high-speed connections, robust infrastructure, and remote accessibility that the seedbox provides. With Plex Media Server on a seedbox, you can provide seamless media streaming, centralized library management, and sharing capabilities, enhancing your media consumption experience.

Як запустити Plex Media Server на Seedbox (без Docker!)?

Почати роботу з Plex на Seedbox простіше, ніж розгортати його з нуля. RapidSeedbox пропонує "Програми одним кліком". Це попередньо сконфігуровані програми (включаючи Plex), які можна легко встановити на ваш Seedbox одним клацанням миші. 

Щоб запустити Plex на вашому посівному контейнері.

• Перейдіть до клієнтського кабінету Rapidseedbox. Переконайтеся, що ваш VPS Seedbox оновлений. Ознайомтеся з цією інструкцією, щоб дізнатися, як розпочати роботу з додатками в один клік та користуватися ними.
• Відкрийте інсталятори OCI у меню ліворуч і знайдіть Plex. Майте на увазі, що не всі seedbox'и оптимізовані для потокового мовлення. Натисніть на значок шестерні праворуч, щоб встановити його. І все; перейдіть до розділу "Встановлені програми", де ви побачите встановлену програму Plex. Натисніть на значок ключа, щоб побачити облікові дані та URL-адресу.
• Для першокласного перегляду потокового мовлення ми рекомендуємо План Stream від Rapidseedboxякий запускається поверх потрібного апаратного забезпечення.

b. Яку ОС використовувати для запуску образу Plex Docker? 

Docker працює по-різному у Linux, macOS та Windows. Він (включно з plexinc/pms-docker та linuxserver/plex) є рідним для Linux. Отже, запуск Plex Docker на комп'ютері з Linux дуже рекомендується.

Running your Plex Docker container on Windows or macOS would require a virtual machine to run a stripped-down Linux environment. So, if you are running the Plex container on Windows, you’ll have to mount the /config directory as a volume to ensure that the metadata and settings for your Plex-сервер are persisted. This is crucial for maintaining your Plex library and user accounts and ensuring a seamless viewing experience for your users.

c. Визначте конфігурацію контейнера та залежності. 

When running Docker containers, you need a YAML file to define the containers’ and dependencies’ configuration. This YAML file is also known as Docker Compose. It allows you to specify the configuration of your containers, including networks and volumes, in a single file. Without a YAML file, you must manually specify each configuration setting for every container you launch. This can be time-consuming, error-prone, and difficult to maintain, especially when running multiple containers that depend on each other.

For instance, you can use Docker Compose to define your container configuration using a YAML file. If you use Docker Compose, you will create a compose YAML file, such as ./docker-compose.yml and modify it to your needs. 

Як отримати Docker Compose? 

Якщо у вас є технологія контейнеризації, така як Docker CE (Community Edition) і Docker Desktop, то, швидше за все, у вас також є Docker Compose. Давайте з'ясуємо, яку версію docker-compose у нас встановлено. Ви можете зробити це за допомогою наступної команди у вашому CLI або терміналі:

$ докер-композитна версія

d. Вирішіть, який тип мережі використовувати для Plex Docker. 

Існує три типи мережевих методів, які ви можете використовувати для запуску Plex Docker з вашої хост-машини: 

• Мостова мережа: Цей тип мережі використовується за замовчуванням. Він створює нову мережу на хості і запускає контейнери в ній. Мережа підключається до фізичної мережі через внутрішній маршрутизатор. Docker налаштовує цей маршрутизатор на перенаправлення портів Plex до контейнерів. 
• Мережа хостів: Для цього використовується IP-адреса хоста Docker. Мережа хоста робить так, що мережа контейнера виглядає як мережа хоста, а не окрема.
• Macvlan networking: Цей мережевий метод створює новий віртуальний комп'ютер (контейнер).

Як правило, методи Host і Macvlan є простішими у налаштуванні. Але іноді вам може знадобитися лише метод моста (наприклад, коли потрібно переадресувати порти). Прості у використанні шаблони можна знайти за адресами https://hub.docker.com/r/plexinc/pms-docker. Використовуйте ці шаблони для створення вашого YML-файлу (наприклад, docker-compose.yml у каталозі вашого проекту). Але пам'ятайте про форматування під час створення YML-файлу, оскільки вам потрібно буде замінити значення у YML-файлах на ваші значення. Деякі з цих значень, які вам потрібно буде замінити: часовий пояс, токен Plex_CLAIM, томи, мережевий режим, IP-адреса, рекламний IP або мапування портів. Детальніше про налаштування цих параметрів у наступних розділах. 

4. Запуск Plex на Docker (Linux та Windows).

For this Plex on Docker install demonstration, we will run Docker on both Linux and Windows. As mentioned in the previous section, it is recommended to run Plex Docker on Linux and not on Windows. Yet, many people do not have access to Linux machines. 

Що ми будемо використовувати в нашій демонстрації? Ми будемо використовувати Docker Desktop для Windows, а для Ubuntu Linux ми будемо використовувати Docker CE. You can also use alternative Docker engines (for containerization) such as Подман., Кубернетиабо OpenShift. 

Крім того, ми також будемо використовувати Docker Compose (який постачається з Docker Desktop та Docker CE), який є дуже важливим для керування нашим контейнером (або образом), запущеним на хості. 

a. Запуск Plex Docker у Linux

Ми будемо використовувати Docker CE, встановлений на машині Ubuntu Linux. Встановлення Docker CE виходить за рамки цього посібника. 

• Переконайтеся, що ваша система оновлена за допомогою наступної команди:

• Щоб перевірити версію Docker, встановлену у вашій системі, скористайтеся наступною командою: 

• Давайте перевіримо поточну версію Docker Compose. Скористаємося наступною командою:  

• Переконаємося, що рушій Docker активний. Для цього скористаємося наступною командою:

• Додамо і призначимо нового користувача docker до групи docker. Ця дія дозволить користувачеві запускати команди Docker без використання "sudo" кожного разу.

i. Створимо постійні томи для Plex. 

Наступні команди створять три каталоги (база даних, транскод і медіа) всередині каталогу plex. Ці томи забезпечать збереження ваших даних після перезапуску контейнера, оновлення або перезавантаження сервера.

ii. Створимо YAML-файл і додамо мережеву конфігурацію. 

Як згадувалося у попередньому розділі, вам знадобиться YAML-файл для визначення конфігурації контейнера та залежностей. Давайте почнемо зі створення цього файлу. 

• Наступна команда створить yml-файл за допомогою текстового редактора vi. 

• Після створення yml-файлу вам потрібно буде ввести конфігурацію контейнера, яка включає ключові аспекти для Plex, мережі та томів.

• Ми будемо використовувати метод Host Networking (але ви також можете використовувати режими macvlan або мостової мережі). Як згадувалося раніше, вам потрібно замінити лише такі дані, як 'name', 'host', 'TimeZone', 'Plex Claim' і 'volumes'. 

docker run \
-d \
-name plex \ -name plex \
-мережа=хост \
-e TZ="” \
-e PLEX_CLAIM="” \
-v /plex/database:/config \
-v /plex/transcode:/transcode \
-v /plex/media:/data \
plexinc/pms-docker

Примітка. Пам'ятайте про правильне форматування YML-файлу при його створенні. Нижче наведено приклад правильного форматування цього файлу. Наприклад, почніть з версії файлу Compose, потім сервіси > назва сервісів і т.д. 

iii. Запустіть контейнер Plex Docker. 

Use the following command to start your Docker container defined in a docker-compose.yml file in detached mode. The detached mode means that your Docker container (specified in the docker-compose.yml) file will continue to run even if you close the terminal or log out of the server. 

Примітка: Тип конфігурації Host Networking використовує мережу хоста, а не мережу ізольованого контейнера (наприклад, у режимі моста). Отже, технічно вам не потрібно переадресовувати порти. Насправді, network_mode "хост" несумісний з port_bindings. 

iv. Get Your PUID, PGID, and Plex Claim Token

Before you start your Plex Docker container, you’ll need three things: ПУІД, PGID, and your Plex Claim Token.
These identify your user permissions and link your Docker container to your Plex account.

Here’s how to find them:

1. Open your terminal and run: id yourusername Copy the numbers after uid= і gid= — That’s your ПУІД і PGID.
2. Get your Plex Claim Token:
   • Visit https://plex.tv/claim
   • Log in and copy the temporary token (it expires in 4 minutes).
3. Use these values in your Docker command or Compose file: -e PUID=1000 -e PGID=1000 -e PLEX_CLAIM=claim-abc123xyz

Without these, Plex may fail to save settings or detect libraries correctly.
(As of today, Plex still requires a valid claim token for first-time setup.)

b. Запуск Plex Docker у Windows. 

Для запуску Plex Docker у Windows ми будемо використовувати Docker Desktop. Це програмне забезпечення дозволяє створювати, тестувати та розгортати додатки за допомогою контейнерів. Воно доступне для операційних систем Windows і Mac. До нього входять всі необхідні компоненти для створення та керування контейнерами, такі як Docker engine, Docker CLI, Docker Compose та Kubernetes.

Примітка. Якщо ви хочете встановити Plex на Docker, ви, ймовірно, вже маєте спосіб запуску контейнерів Docker. Встановлення Docker Desktop виходить за рамки цього посібника. 

i. Як витягнути образ Plex на робочий стіл Docker? 

• Open and ensure Docker Desktop is running. You can use the Docker icon on the shortcut menu to verify whether Docker Desktop is running. 

• Відкрийте термінал або командний рядок з правами адміністратора. You can also run the following commands from the PowerShell terminal (if you are using Windows). We will pull the official Plex media server container using the following “pull command”: 

• Образ контейнера Docker почне завантажуватися. 
• Після того, як ви побачите результат "pull complete" без помилок, ви успішно витягнете образ на ваш комп'ютер. 

• Тепер давайте повернемося до перевірки платформи Docker Desktop. Перейдіть до лівого бічного меню і відкрийте "Зображення". Якщо PMS-докер було успішно витягнуто, ви побачите його тут. Проте, як ви можете помітити, образ знаходиться у статусі "невикористаний". 

ii. Запустимо контейнер Plex Docker.  

Якщо у вас немає каталогів Plex у Windows, саме час їх створити. 

Open PowerShell and create a new directory to store your Plex data by running the following command:

mkdir ~/plexdata

Примітка. Ви можете вибрати будь-який каталог, який вам подобається, замінивши ~/plexdata на бажаний шлях.

• Перейдіть на стільницю Docker > Зображення > plexinc/pms-docker. Якщо ви натиснете на зображення, ви побачите всю детальну інформацію про нього, включно з ієрархією, шарами, вразливостями та пакунками. 

• Запустіть контейнер Plex, перейшовши на Робочий стіл Plex > Зображення > Виберіть зображення > Натисніть кнопку "Запустити". 

• At this step, when you Run your new container, you’ll get Optional Settings, which are really mandatory to be able to use Plex Media Server. 

Примітка. Ваш новий контейнер Plex Docker не має інформацію про запущену мережу (міст, оверлей або macvlan). Він бачить лише поточний мережевий інтерфейс (разом з IP-адресою), шлюз, таблицю маршрутизації, служби DNS і деяку іншу мережеву інформацію. У цьому випадку ми не налаштовували файл Docker Compose заздалегідь, як у випадку з конфігурацією Linux, тому тут, на робочому столі Docker, ви зможете легко налаштувати параметри мережі. 

• У меню "Запустити новий контейнер". Дайте вашому новому контейнеру ім'я (пробіли не допускаються) і створіть мапу всіх портів контейнера (які йому потрібні для роботи з Plex) і хост-машини, щоб вивести Plex у зовнішній світ. Візьміть приклад з малюнка нижче. 
• Якщо не назвеш ім'я. Docker Desktop згенерує випадкову назву.

• At the bottom of this menu, map your container volume with the host machine volume. 
• Натисніть "Виконати", щоб створити контейнер Plex. 
• Зачекайте, поки контейнер запуститься. 

iii. Перевірка журналів і виводу. 

Ви можете відстежувати його хід, перейшовши до "Контейнери" > plexinc/pms-docker:latest > "Журнали". 

• Or you can also check logs from the terminal, CLI, or PowerShell, by issuing the following command:

• Можливо, ви помітили кілька деталей у виведенні логів: 
  • The container was initialized, and the user-provided files were available in a certain directory (var/run/s6/etc., in our container).
  • Контейнер гарантує, що надані користувачем файли мають правильні дозволи. Він також застосовує виправлення прав власності та дозволів до контейнера.
  • Він запускає і завершує три пов'язані між собою скрипти: Сценарії ініціалізації контейнера PMS, сценарій апаратного перекодування і підключення тюнера, а також сценарій оновлення PMS. 
  • Контейнер запускається і перевіряє служби Plex Media Server. 
  • У журналі також з'являється помилка "Critical: libusb_init failed". Ця помилка зазвичай вказує на те, що виникла проблема під час ініціалізації бібліотеки libusb. Це кросплатформенна бібліотека, яка надає низькорівневий доступ до USB-пристроїв. Наразі ми не будемо використовувати USB. 

• Якщо ви вже перевірили журнали і вас все влаштовує, поверніться до Docker Desktop > Containers. 
• Зверніть увагу, що наш новий контейнер Plex_On_Docker запущено і до нього прив'язано порти. Отже, ви зможете отримати до нього доступ і використовувати його. 

c. Інші способи запуску Plex Docker?

Ви також можете запустити контейнер Plex без використання Docker Compose (хоча це не рекомендується).

• Використовуйте наступну команду, але змініть значення відповідно до ваших потреб. Наприклад, змініть назву і TZ. Крім того, замініть ~/plexdata на каталог, який ми створили раніше, а /mnt/user/Media на каталог, де знаходяться ваші медіафайли.

Примітка. З міркувань безпеки (і за замовчуванням) запуск контейнера за допомогою команди "docker run" не відкриває жодного порту для зовнішнього світу. Щоб зробити порт, наприклад, порти Plex (1900/UDP, 32400/TCP, 32410/UDP, 32412/UDP, 32413/UDP, 32414/UDP, 32469/TCP і 8324/TCP) доступним для служб за межами вашого Docker-контейнера (або доступним для інших Docker-контейнерів, запущених в іншій мережі), вам слід скористатися прапором -publish або -p. Цей прапорець явно створює правило брандмауера всередині контейнера. Іншими словами, він зіставляє порт контейнера з портом на хості Docker (із зовнішнім світом). Це метод мостової мережі. 

5. Відкриваємо Plex Media Server. 

Тепер, коли ваш контейнер успішно працює, ви можете спробувати отримати доступ до веб-інтерфейсу Plex. 

• Щоб відкрити новий Plex на контейнері Docker, відкрийте веб-браузер і перейдіть за адресою http://localhost:32400/web. Відкриється екран входу до Plex, де ви можете увійти або створити новий обліковий запис. 

Примітка. Вам слід запустити веб-браузер на комп'ютері, на якому запущено Docker-контейнер (хост). Ви також можете запустити Plex Media Server на іншому комп'ютері у тій самій мережі, якщо ви налаштували необхідні мережеві параметри.

• На цьому кроці, якщо ви включите токен Plex Claim у файл Docker Compose, ваша конфігурація автоматично активує і зв'яже сервер Plex з вашим обліковим записом Plex. 
• Once you sign in, follow the on-screen instructions to set up your Plex server and add your media files.

a. Не вдається відкрити графічний інтерфейс Plex? 

Якщо вам не вдається відкрити localhost:32400/web для вашого контейнера Plex Media Server, встановленого з докерного образу plexinc/pms-docker, спробуйте наступне: 

• Перевірте стан контейнера: Переконайтеся, що контейнер Plex використовує команду "docker ps". Якщо контейнер не запущено, запустіть його за допомогою команди docker start , де - це ідентифікатор контейнера Plex. З наведених нижче даних видно, що контейнер Plex_On_Docker є справним. 

• Перевірте порт контейнера: Ви також можете побачити відкриті порти у виведенні вище. Контейнер відкриває хост-системі декілька портів, які використовуються для зв'язку з медіасервером Plex. Повний список портів, відкритих контейнером і зіставлених з хост-системою. Завжди переконайтеся, що порт за замовчуванням для Plex - 32400 і він правильно зіставлений з хост-системою. Наприклад, виконайте у докері -p 32400:32400 plexinc/pms-docker. З наведених вище результатів видно, що Plex дійсно зіставлено з портом 32400/TCP (порт HTTP за замовчуванням, який використовується для веб-доступу). 

• Перевірте брандмауер: Переконайтеся, що брандмауер не блокує підключення до сервера Plex. Можливо, вам доведеться додати виняток до брандмауера для порту 32400. Для брандмауера Windows перейдіть до брандмауера Windows Defender з розширеною безпекою і натисніть на "Правила вхідних підключень" на лівій панелі. Створіть нове правило, яке фільтрує з'єднання на основі порту (дозволити 32400). 

• Спробуйте зайти за IP-адресою: Замість того, щоб використовувати localhost, спробуйте отримати доступ до сервера Plex за IP-адресою хост-машини. Ви можете знайти IP-адресу за допомогою команди ipconfig у командному рядку Windows. Наприклад, якщо ваша IP-адреса 192.168.1.100, ви можете отримати доступ до сервера Plex за адресою 192.168.1.100:32400/web.

• Перевірте журнали контейнера Plex: Використовуйте команду docker logs для перевірки журналів для контейнера Plex. Це може допомогти вам діагностувати будь-які проблеми, що перешкоджають коректній роботі контейнера.

b. Hardware Transcoding and Updates

If you have Plex Pass, you can enable hardware transcoding to reduce CPU load.

For Intel or AMD GPUs:

For NVIDIA GPUs:

Then, in Plex:
Перейдіть на Settings ▸ Transcoder ▸ Enable hardware acceleration.

Keeping Plex updated:
Run these two commands regularly:

This pulls the newest image (tagged останній) and restarts your container without losing your settings.

6. Часті запитання:

Висновок. 

Ми сподіваємося, що ця стаття допомогла вам налаштувати та запустити ваш Plex Media Server у Docker-контейнерах.

Незалежно від того, чи ви професіонал у Docker, чи новачок, запуск Plex на Docker може запропонувати ряд переваг і гнучкості.

Не соромтеся експериментувати та досліджувати безліч можливостей, доступних з контейнерами Plex Docker. Якщо у вас виникли питання, проблеми або пропозиції, будь ласка, залиште їх у розділі коментарів нижче.

Як завжди, щасливої трансляції!

Відмова від відповідальності за освітні цілі: Цей матеріал розроблено виключно в освітніх цілях. Компанія RapidSeedbox не підтримує і не заохочує будь-яку діяльність, пов'язану з порушенням авторських прав або незаконною діяльністю, пов'язаною з торрентуванням. Завжди дотримуйтесь законів і правил, що стосуються авторських прав у вашій юрисдикції.