Перейти к содержимому

Статья 134 из 141

Гайды

Jellyfin на VPS: личный медиасервер в Docker, мастер настройки и медиатеки

Jellyfin — бесплатный медиасервер с открытым кодом. Он раскладывает ваши видео, музыку и фото по медиатекам, подтягивает обложки и описания и показывает всё через браузер, приложения для телефона и телевизора. Подписок и аккаунтов в чужом облаке нет.

Используйте Jellyfin для собственной медиатеки: домашних видео, записей, купленного контента без DRM, свободно распространяемых материалов.

Инструкция проверена на Ubuntu 24.04 с Jellyfin 12.4 в ноябре 2026. Для теста мы сгенерировали короткие ролики и картинки встроенным в образ ffmpeg.

Ресурс Значение
RAM от 1 ГБ. На тесте сервер занимал около 150 МБ без нагрузки
vCPU 2 и больше, если возможно перекодирование
Диск объём медиатеки плюс 1–5 ГБ под базу, обложки и кэш
Софт Docker и Compose

Главное ограничение VPS здесь: диск и процессор. Про диск ниже, про процессор в разделе о перекодировании.

Окно терминала
mkdir -p /opt/jellyfin/{config,cache,media} && cd /opt/jellyfin
chown -R 1000:1000 /opt/jellyfin
nano docker-compose.yml
services:
jellyfin:
image: jellyfin/jellyfin:latest
user: 1000:1000
ports:
- "127.0.0.1:8096:8096/tcp"
volumes:
- ./config:/config
- ./cache:/cache
- type: bind
source: ./media
target: /media
read_only: true
environment:
- JELLYFIN_PublishedServerUrl=https://media.example.com
restart: unless-stopped
Окно терминала
docker compose up -d
docker compose ps

Это пример из официальной документации с двумя изменениями. Порт 8096 слушает только 127.0.0.1, наружу его выпустит Nginx. Порт 7359/udp для автопоиска в локальной сети на VPS не нужен. Медиатека смонтирована только на чтение: Jellyfin не сможет случайно удалить или испортить файлы.

Jellyfin узнаёт фильмы по имени папки и файла. Лучше всего формат «Название (Год)»:

/opt/jellyfin/media/
├── movies/
│ ├── Отпуск в горах (2024)/
│ │ └── Отпуск в горах (2024).mp4
│ └── Выпускной (2025)/
│ └── Выпускной (2025).mkv
└── photos/
└── 2025-лето/

Сериалы кладите в отдельную папку: Название/Season 01/Название S01E01.mkv. Загружать файлы удобно через SFTP или rsync, или синхронизировать с компьютера через Syncthing. После загрузки выполните chown -R 1000:1000 /opt/jellyfin/media.

Поддомен media.example.com с A-записью на сервер (DNS). Конфиг /etc/nginx/sites-available/jellyfin:

server {
listen 80;
server_name media.example.com;
client_max_body_size 20M;
location / {
proxy_pass http://127.0.0.1:8096;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_buffering off;
}
}
Окно терминала
ln -s /etc/nginx/sites-available/jellyfin /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d media.example.com

proxy_buffering off убирает задержки при перемотке видео. Подробнее: Nginx, Let’s Encrypt.

Пройдите мастер сразу после запуска. Пока администратор не создан, первый открывший страницу сам станет администратором.

Откройте https://media.example.com. Мастер на русском, если браузер на русском языке.

  1. Jellyfin приветствует вас! Задайте Имя сервера (по умолчанию это ID контейнера) и язык интерфейса. Следующее.

Первый шаг мастера Jellyfin: имя сервера и язык

  1. Расскажите о себе. Имя пользователя администратора и пароль. Пароль обязателен, используйте длинный.
  2. Установка и настройка медиатеки. Нажмите Добавить медиатеку:
    • Тип содержания: «Фильмы», «Сериалы», «Музыка», «Домашние видео и фото» и другие;
    • Отображаемое название: например «Фильмы»;
    • Папки → + → путь внутри контейнера, например /media/movies → Ок;
    • внизу Ок.

Добавление медиатеки в Jellyfin: тип содержания и папка /media/movies

  1. Выбор языка метаданных. По умолчанию стоит английский. Выберите русский, чтобы описания и названия подтягивались на русском, где они есть.
  2. Настройка удалённого доступа. Флажок «Разрешить удалённый доступ к данному серверу» оставьте включённым: вы заходите через интернет.
  3. Вы готовы! → Завершение. Откроется страница входа.

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

Медиатека «Фильмы» в Jellyfin

Пользователей для семьи добавляйте в Панель управления → Пользователи. Каждому можно открыть только нужные медиатеки.

Перекодирование и прямое воспроизведение

Заголовок раздела «Перекодирование и прямое воспроизведение»

Если клиент не умеет воспроизводить формат файла, Jellyfin перекодирует видео на лету через ffmpeg. На домашних серверах этим занимается видеокарта. На VPS видеокарты нет: в Панель управления → Воспроизведение → Перекодирование поле Аппаратное ускорение стоит в значении «Ничего», и вся работа ложится на процессор.

Настройки перекодирования в Jellyfin без аппаратного ускорения

Программное перекодирование одного потока 1080p занимает несколько ядер. Два-три зрителя одновременно легко загрузят VPS на 100%. Поэтому:

  • Храните видео в форматах, которые понимают ваши клиенты без перекодирования: обычно H.264 и AAC в MP4 или MKV. Тогда работает прямое воспроизведение, и сервер только отдаёт файл.
  • Подготовьте файлы заранее на своём компьютере, а не на сервере.
  • В приложении выставляйте качество «Максимальное» или «Авто». Ручное снижение битрейта включает перекодирование.
  • Субтитры в формате SRT безопаснее встроенных PGS: картинки-субтитры часто вшиваются в видео через перекодирование.
  • В параметрах медиатеки можно выключить извлечение изображений Trickplay и глав. Это предпросмотр при перемотке, и его генерация на слабом VPS долго грузит процессор после каждого добавления файлов.

Посмотреть, идёт ли поток напрямую или перекодируется, можно в Панель управления: в карточке активного сеанса указан способ воспроизведения. Нагрузку на сервер проверяйте по этой инструкции.

  • Медиатека быстро растёт: час видео 1080p занимает 2–8 ГБ. Прикиньте объём заранее и выберите тариф с запасом по диску. Тариф можно сменить позже.
  • Кэш и обложки лежат в /opt/jellyfin/cache и /opt/jellyfin/config. Следите за местом: df -h.
  • Прямое воспроизведение 1080p занимает 5–20 Мбит/с на зрителя. Канала VPS хватит на нескольких зрителей, но скорость до вашего дома зависит от маршрута. Проверьте пинг до локации.
Окно терминала
cd /opt/jellyfin
docker compose pull && docker compose up -d

Пользователи, медиатеки, история просмотров и настройки лежат в /opt/jellyfin/config. Его и бэкапьте:

Окно терминала
docker compose stop
tar -czf /root/jellyfin-config-$(date +%F).tar.gz -C /opt/jellyfin config
docker compose start

Медиафайлы бэкапьте отдельно, если у вас нет их копии в другом месте. Подробнее: бэкапы.

  • Порт 8096 слушает только 127.0.0.1, наружу открыт только Nginx на 443. Закройте остальное файрволом.
  • Не создавайте пользователей без пароля.
  • Не делайте медиатеку публичной: Jellyfin рассчитан на личное использование.
Симптом Причина и решение
Медиатека пустая после сканирования Jellyfin не может прочитать папку. Выполните chown -R 1000:1000 /opt/jellyfin/media и пересканируйте медиатеку
Фильмы распознаны неправильно Имена не по шаблону. Переименуйте в «Название (Год)/Название (Год).mp4» и пересканируйте
Видео подтормаживает, CPU на 100% Идёт программное перекодирование. Проверьте способ воспроизведения в панели и переведите файлы в H.264/AAC
Мастер не открывается, сразу страница входа Мастер уже пройден. Если это сделали не вы, удалите контейнер и папку config и начните заново
Приложение не находит сервер Укажите адрес вручную: https://media.example.com. Автопоиск работает только в локальной сети
Ошибки при перемотке через Nginx Добавьте proxy_buffering off и заголовки Upgrade