Медиа‑сервер на Linux с Docker и DockSTARTer

Домашний медиа‑сервер на Linux: телевизор и коллекция фильмов

Что вы получите из этой статьи

Полная инструкция по установке Docker и DockSTARTer на Linux.
Выбор приложений для медиатеки, управление контейнерами и базовые настройки.
Практические советы по аппаратной части, папкам, правам доступа и резервному копированию.
Набор полезных дополнительных материалов: чек‑листы, сниппеты docker‑compose, матрица совместимости ARM vs x86, схема принятия решений и план отката.

Почему Docker подходит для медиа‑сервера

Docker упаковывает приложение и его зависимости в контейнеры. Контейнеры изолированы от основной ОС, что снижает риск конфликтов и облегчает обновления. Для медиа‑сервера это означает быстрое развертывание Plex, Emby, Sonarr, Radarr и других сервисов, а также простое управление через инструменты вроде Portainer и Ouroboros.

Определение: контейнер — легковесная изолированная среда для запуска приложения вместе с его библиотеками и настройками.

Важно: DockSTARTer — это скрипт/набор конфигураций, автоматизирующий установку и настройку популярных медиа‑контейнеров поверх Docker.

Основные понятия в одну строчку

Docker: платформа для запуска контейнеров.
DockSTARTer: помощник для быстрой установки набора медиа‑контейнеров.
Portainer: веб‑интерфейс для управления Docker.
Ouroboros: автоматическое обновление Docker‑контейнеров.

Требования к серверу

ОС: любая современная Linux‑дистрибуция, кроме Arch (DockSTARTer несовместим).
Процессор: для транскодинга выбирайте CPU с достаточной производительностью; для лёгкого использования подойдёт Intel/AMD среднего уровня или Raspberry Pi 4 для базовых задач.
Память: минимум 2–4 ГБ, желательно 8 ГБ для параллельных потоков и дополнительных сервисов.
Хранилище: объем зависит от вашей коллекции — выделите отдельный диск или RAID/NAS, если много видео.
Сеть: стабильный Ethernet обеспечит лучшие результаты при стриминге на Smart TV и несколько устройств одновременно.

Примечание: на ARM (Raspberry Pi) некоторые образы могут быть недоступны — проверяйте совместимость конкретных контейнеров.

Шаг 1: Установка Git и Curl

Откройте терминал на сервере или подключитесь по SSH. Установите Git и Curl — они нужны для загрузки DockSTARTer.

Для Debian‑based (Debian, Ubuntu, Raspbian):

sudo apt update
sudo apt install curl git -y

Для Fedora:

sudo dnf install curl git -y

Для RHEL/CentOS с Yum:

sudo yum install curl git -y

Совет: используйте sudo только при необходимости; убедитесь, что у вас есть доступ root или пользователь в sudoers.

Шаг 2: Установка DockSTARTer

Есть два подхода: автоматический скрипт (быстро) и ручная установка (больше контроля).

Установка через официальный скрипт

bash -c "$(curl -fsSL https://get.dockstarter.com)"
sudo reboot

Скрипт сделает большую часть работы автоматически. Если вы доверяете репозиторию — этот путь самый быстрый.

Ручная установка (рекомендуется при повышенной осторожности)

git clone https://github.com/GhostWriters/DockSTARTer "/home/${USER}/.docker"
sudo bash /home/${USER}/.docker/main.sh -i
sudo reboot

Ручной метод клонирует репозиторий и запускает установщик локально, давая вам возможность просмотреть файлы перед запуском.

Важно: если система перезагружается автоматически, убедитесь, что вы сохранили незавершённые настройки или сессии.

Шаг 3: Запуск DockSTARTer и выбор приложений

Запустите интерфейс DockSTARTer:

sudo ds

Терминал установки DockSTARTer

В меню выберите Конфигурация, затем Полная настройка. Скрипт пройдёт по пунктам и предложит список приложений. Навигация: стрелки вверх/вниз, пробел — выбор, Enter — подтверждение.

Общие приложения для медиасервера:

Plex — полнофункциональный медиа‑сервер.
Emby — альтернатива Plex, гибкая по настройкам.
Jellyfin — свободная альтернатива Plex/Emby (Open Source).
Airsonic — музыкальный сервер.
CouchPotato / Radarr — автоматическая загрузка фильмов.
Sonarr — автоматическая загрузка сериалов.
Deluge / Transmission — BitTorrent‑клиенты.
HTPC Manager — единая панель для ряда приложений.

Обязательно отметьте:

Ouroboros — автоматическое обновление контейнеров.
Portainer — веб‑интерфейс управления Docker.

Выбор зависит от сценариев использования: только стриминг, автоматическая загрузка, медиасервер + PVR и т.д.

Примечание по выбору образов на ARM

Некоторые образы официально не собираются для ARM. Для Raspberry Pi ищите образы с поддержкой armhf/arm64 или сборки из сообществ (Jellyfin и некоторые образы Plex доступны для ARM).

Шаг 4: Настройка параметров сервера

DockSTARTer задаст ряд вопросов: часовой пояс, hostname, UID/GID, расположение папок для медиа и конфигов. Подсказки:

Часовой пояс: выбирайте “Use System”, если системный часовой пояс корректен.
Hostname: “Use System” или “Enter New” при необходимости.
UID/GID: обычно безопасно выбрать “Use System” — это упростит доступ к файлам.
Конфигурация Docker: храните в домашней директории пользователя или на выделенном диске.
Папки для медиа: укажите пути к папкам с Movies, TV, Music; если их нет — DockSTARTer предложит создать.

Меню конфигурации приложений DockSTARTer

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

После финальной конфигурации подтвердите создание контейнеров — DockSTARTer загрузит образы и запустит контейнеры.

Лог финальной конфигурации DockSTARTer

Доступ к интерфейсам приложений

Emby: http://YourServerIpAddress:8096
Portainer: http://YourServerIpAddress:9000 — при первом заходе создайте admin‑аккаунт.
Plex обычно доступен на порту, указанном в конфигурации (обычно 32400), или через интерфейс Plex.

Замена YourServerIpAddress на фактический IP вашего сервера.

Примеры команд и сниппеты

Ниже — несколько полезных сниппетов, которые часто применяются при управлении Docker‑средой.

Перечислить все контейнеры:

docker ps -a

Посмотреть логи контейнера:

docker logs -f

Обновление контейнеров вручную через Ouroboros не требуется, но можно запустить обновление:

docker run --rm -v /var/run/docker.sock:/var/run/docker.sock ghostwriter/ouroboros

Пример минимального docker‑compose для Portainer (если хотите установить отдельно):

version: '3.3'
services:
  portainer:
    image: portainer/portainer-ce:latest
    container_name: portainer
    restart: always
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - portainer_data:/data
    ports:
      - 9000:9000
volumes:
  portainer_data:

Совет: DockSTARTer создаёт подобные разделы автоматически — ручная настройка нужна, если вы предпочитаете полный контроль.

Структура папок и права доступа (рекомендации)

Рекомендуемая структура:

/home//docker/config — конфиги контейнеров
/srv/media/movies — фильмы
/srv/media/tv — сериалы
/srv/media/music — музыка
/srv/backups — резервные копии

Права доступа: убедитесь, что UID/GID, используемые контейнерами, имеют доступ к этим папкам. Частая практика — назначать общую группу media и давать ей права.

Пример установки прав:

sudo chown -R youruser:media /srv/media
sudo chmod -R 775 /srv/media

Резервное копирование и обновления

Регулярно делайте бэкап конфигов DockSTARTer и Docker volume’ов.
Ouroboros автоматизирует обновления контейнеров, но обязательно проверяйте логи после обновлений.
Перед массовыми обновлениями делайте снимок конфигов и базы данных (особенно для Plex/Emby/Jellyfin).

Мини‑методология для обновления:

Бэкап конфигов и баз данных.
Применить обновление на тестовой копии (если есть).
Обновить контейнеры (Ouroboros/ручной).
Проверить логи и функциональность.

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

Нет доступа к файлам: проверьте UID/GID и права на директории.
Контейнер не стартует: смотрите docker logs .
Порты заняты: убедитесь, что локальные порты не конфликтуют (например, 8096, 9000, 32400).
Проблемы с ARM: ищите альтернативные образы или используйте x86‑сервер.

Примеры команд для отладки:

docker inspect 
docker logs -f

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

Веб‑интерфейс Portainer доступен по порту 9000.
Plex/Emby/Jellyfin запускаются и индексируют медиабиблиотеку.
Транскодинг работает для одного тестового 1080p‑потока.
Права на директории корректны, контейнеры имеют доступ к файлам.

Матрица совместимости ARM vs x86

Компонент	ARM (Raspberry Pi)	x86 (Intel/AMD)
Plex	ограниченная поддержка, платные фичи на ARM	полная поддержка, аппаратный транскодинг лучше
Jellyfin	хорошо поддерживается	отлично поддерживается
Emby	частично	полно
Radarr/Sonarr	доступны сборки	доступны сборки
Portainer/Ouroboros	работает	работает

Пояснение: ARM хорош для энергосбережения и базовых задач, но для многопоточного транскодинга предпочтителен x86.

Риски и меры смягчения

Потеря данных: настроить регулярный бэкап и внешний диск/облачное хранилище.
Непредвиденные сбои после обновления: тестовый стенд и контрольные точки.
Безопасность Web UI: ограничьте доступ через брандмауэр и используйте безопасные пароли.

Чек‑лист по безопасности

Обновить ОС и Docker до последних стабильных версий.
Использовать сложные пароли для аккаунтов в Portainer/Emby/Plex.
Открывать порты только при необходимости, использовать проброс через VPN для удалённого доступа.
Настроить бэкапы конфигов и баз данных.

Роль‑ориентированные чек‑листы

Администратор:

Установил Docker и DockSTARTer.
Настроил Portainer и Ouroboros.
Проверил права на каталоги и сделал бэкап.

Пользователь (домашний):

Подключил медиаплеер (TV, Kodi, приложение Plex).
Протестировал воспроизведение и субтитры.
Сообщил об ошибках администратору.

Техник/интегратор:

Проверил сетевую конфигурацию и QoS.
Настроил аппаратный транскодинг, если доступен.

План отката (простая инструкция)

Остановить проблемные контейнеры: docker stop .
Восстановить конфиги из бэкапа.
Запустить контейнеры повторно: docker compose up -d или через Portainer.
В случае серьёзных проблем — откатить на снимок виртуальной машины или образ диска.

Decision flowchart

flowchart TD
  A[Начало: Нужно ли быстро развернуть медиа‑сервер?] -->|Да| B{Имеется Raspberry Pi?}
  B -->|Да| C[Использовать Raspberry Pi + DockSTARTer]
  B -->|Нет| D[Использовать x86 сервер]
  C --> E{Нужен аппаратный транскодинг?}
  D --> E
  E -->|Да| F[Выбрать CPU с QuickSync или GPU]
  E -->|Нет| G[ARM x86 подходят]
  F --> H[Установить Docker, DockSTARTer, выбрать Plex/Jellyfin]
  G --> H
  H --> I[Добавить Portainer и Ouroboros]
  I --> J[Тестировать и бэкапить]

Тестовые кейсы и приёмка

Интеграционное тестирование: воспроизведение фильма 1080p на двух устройствах одновременно.
Сценарий отказа: отключение сети на 1 минуту, проверка автоматического восстановления контейнеров.
Тест прав доступа: запуск контейнера с пользователем, не имеющим доступа к файлам — ожидать отказ и лог ошибки.

Советы по улучшению и альтернативы

Если Docker кажется слишком сложным, рассмотрите готовые медиасервер‑дистрибутивы (LibreELEC, OSMC, OpenMediaVault).
Для облачной синхронизации можно подключить rclone или Nextcloud внутри контейнера.
Если важен открытый код — используйте Jellyfin вместо Plex.

Краткие шаблоны и команды для повседневной эксплуатации

Просмотр загруженных образов: docker images
Удаление ненужных образов: docker image prune -a
Обновление системы: sudo apt update && sudo apt upgrade -y

Глоссарий (1 строка)

Транскодинг: конвертация видео в реальном времени для совместимости с устройством клиента.

Заключение

Docker и DockSTARTer дают ясный путь к быстрому развёртыванию мощного медиа‑сервера на Linux. Правильный выбор железа и аккуратная настройка прав доступа, резервного копирования и обновлений обеспечат стабильную работу. Следуйте чек‑листам, тестируйте воспроизведение и имейте план отката — и ваш сервер будет служить долго.

WANTED: Если нужно, могу подготовить готовый docker‑compose для Plex/Jellyfin с учётом вашей конфигурации дисков и UID/GID.