Jellyfin на VPS: свой Netflix без подписки

1. Зачем Jellyfin на VPS, а не дома

Дома тоже можно запустить медиасервер — но тогда он работает только пока включён ваш компьютер. VPS работает круглосуточно. Смотрите фильм в отпуске, включаете что-то в дороге с телефона — сервер всегда онлайн.

Jellyfin — это форк Emby, который в 2018 году закрыл исходный код. Команда разработчиков ушла и создала полностью открытую альтернативу. Сегодня это зрелый проект с десятками тысяч звёзд на GitHub и активным сообществом.

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

Потребности Jellyfin зависят от того, как вы будете смотреть видео. Есть два принципиально разных режима — прямое воспроизведение и транскодирование. Подробнее о них в разделе 8, но уже сейчас нужно понять: на дешёвом VPS лучше настроить прямое воспроизведение.

3. Установка через Docker Compose

Если Docker ещё не установлен — поставьте его одной командой:

curl -fsSL https://get.docker.com | sh

Создайте структуру папок

Три папки для Jellyfin: конфигурация, кэш (миниатюры, метаданные), медиатека.

mkdir -p /opt/jellyfin/{config,cache}
mkdir -p /mnt/media/{Фильмы,Сериалы,Музыка}

Папка /mnt/media — ваша медиатека. Можно использовать любой путь, главное — один и тот же везде.

Docker Compose файл

services:
  jellyfin:
    image: jellyfin/jellyfin:latest
    container_name: jellyfin
    restart: unless-stopped
    ports:
      - "127.0.0.1:8096:8096"    # Только localhost — доступ через Nginx
    volumes:
      - /opt/jellyfin/config:/config
      - /opt/jellyfin/cache:/cache
      - /mnt/media:/media:ro       # :ro = read-only, Jellyfin не меняет файлы
    environment:
      - JELLYFIN_PublishedServerUrl=https://jellyfin.example.ru

Замените jellyfin.example.ru на свой поддомен. Порт привязан к 127.0.0.1 — снаружи он недоступен, Nginx будет проксировать запросы.

cd /opt/jellyfin
docker compose up -d

# Проверить что запустился
docker ps | grep jellyfin
docker logs jellyfin --tail 20

Через 10–20 секунд Jellyfin будет доступен локально на http://127.0.0.1:8096. Пока Nginx не настроен — откройте мастер через SSH-туннель:

ssh -L 8096:127.0.0.1:8096 user@IP_ВАШЕГО_VPS

# После этого откройте в браузере: http://localhost:8096

4. Первоначальная настройка

Откройте http://localhost:8096 в браузере — запустится мастер настройки. Он пройдёт через несколько шагов.

5. Структура медиатеки — правила именования

Это самое важное для правильной работы Jellyfin. Если файлы названы неправильно, Jellyfin не сможет найти к ним постеры и описания, или вообще не покажет их в библиотеке. Правил немного, но их нужно соблюдать точно.

Фильмы

Каждый фильм — в отдельной папке. Папка и файл называются одинаково: «Название (Год)».

/mnt/media/Фильмы/
├── Интерстеллар (2014)/
│   └── Интерстеллар (2014).mkv
├── Дюна (2021)/
│   ├── Дюна (2021).mkv
│   └── Дюна (2021).ru.srt   # субтитры — называются так же
└── Inception (2010)/
    └── Inception (2010).mkv

Сериалы

Сериал → папка сезона → эпизоды. Сезоны называются «Season 01», «Season 02» — именно так, с ведущим нулём.

/mnt/media/Сериалы/
└── Чернобыль (2019)/
    └── Season 01/
        ├── Чернобыль - S01E01.mkv
        ├── Чернобыль - S01E02.mkv
        ├── Чернобыль - S01E03.mkv
        ├── Чернобыль - S01E04.mkv
        └── Чернобыль - S01E05.mkv

Нельзя использовать в именах файлов символы: : / \ | ? * " < > — они зарезервированы в файловых системах Windows и вызывают проблемы при переносе.

Как загрузить файлы на VPS

# Один файл
scp "Дюна (2021).mkv" user@IP:/mnt/media/Фильмы/"Дюна (2021)"/

# Целую папку с сериалом
rsync -avP "Чернобыль (2019)/" user@IP:/mnt/media/Сериалы/"Чернобыль (2019)/"

6. Nginx + SSL: доступ по красивому домену

Сейчас Jellyfin доступен только локально на порту 8096. Настроим Nginx как обратный прокси и добавим SSL-сертификат от Let's Encrypt — тогда сервер будет доступен по адресу https://jellyfin.example.ru.

Добавьте DNS-запись

В панели DNS вашего домена добавьте A-запись:

Установите Nginx и Certbot

apt update
apt install -y nginx certbot python3-certbot-nginx

Создайте конфиг Nginx

Jellyfin использует WebSocket для уведомлений и синхронизации просмотра. Для этого нужен отдельный блок /socket с заголовком Upgrade.

server {
    listen 80;
    server_name jellyfin.example.ru;

    # Обычные запросы → Jellyfin
    location / {
        proxy_pass         http://127.0.0.1:8096;
        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;
    }

    # WebSocket — нужен для уведомлений и SyncPlay
    location /socket {
        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;
    }
}

# Активировать сайт
ln -s /etc/nginx/sites-available/jellyfin /etc/nginx/sites-enabled/

# Проверить синтаксис (должно быть "test is successful")
nginx -t && systemctl reload nginx

# Получить сертификат — certbot добавит HTTPS-блок и редирект HTTP→HTTPS
# (замените на ваш домен и email)
certbot --nginx -d jellyfin.example.ru --non-interactive   --agree-tos --email admin@example.ru --redirect

# Перезапустить Nginx с SSL
systemctl reload nginx

7. Мобильные приложения

После настройки домена ваш Jellyfin доступен с любого устройства — нужно только указать адрес сервера в приложении.

Подключение к серверу в приложении

При первом запуске приложение спросит адрес сервера. Введите:

https://jellyfin.example.ru

Затем войдите с логином и паролем, которые вы создали при настройке.

Просмотр в браузере

Jellyfin прекрасно работает в браузере — просто откройте https://jellyfin.example.ru в Chrome или Firefox. Браузер поддерживает прямое воспроизведение H.264 без транскодирования. Для H.265 (HEVC) Chrome будет транскодировать на сервере — в этом случае лучше использовать мобильное приложение или Microsoft Edge на Windows (Edge поддерживает H.265 напрямую через кодеки Windows).

8. Direct Play и транскодирование

Это ключевое понятие в Jellyfin. От него зависит, будет ли видео идти плавно или с тормозами.

Как обеспечить Direct Play

Главный совет: храните фильмы в формате H.264 / MKV или MP4. Это самый поддерживаемый кодек — его «понимают» почти все устройства напрямую.

Как проверить что происходит при просмотре

Во время воспроизведения нажмите на индикатор в левом нижнем углу экрана — откроется информация о сессии. Ищите строку:

Конвертация в H.264 для максимальной совместимости

Если файл в H.265 или другом формате — конвертируйте на VPS через FFmpeg:

ffmpeg -i "Фильм (2024).mkv"   -c:v libx264 -crf 20 -preset slow   -c:a copy   "Фильм (2024) - h264.mkv"

-crf 20 — качество (18 = лучше, 28 = хуже, 20 — хороший баланс). Конвертация займёт время: примерно 1–3 часа для 2-часового фильма на 2 vCPU.

Частые проблемы