RU

Приложения

Установка Jellyfin на Debian или Ubuntu

Установите Jellyfin из официального репозитория, опубликуйте его по HTTPS через Caddy, управляйте учётными записями и разберитесь с ограничениями перекодирования без GPU, а также с обновлениями и резервным копированием.

9 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

Это руководство объясняет, как установить Jellyfin — свободный медиасервер — из его официального репозитория. Мастер настройки проходится через SSH-туннель, затем Caddy публикует службу по HTTPS.

К концу руководства Jellyfin будет отвечать по адресу https://jellyfin.ваш-домен.com, его порт останется закрытым из Интернета, у каждого человека будет своя учётная запись, а вы будете знать, что ваш сервер реально способен транслировать без видеокарты.

Заказать сервер

Это руководство подходит для серверов, которыми вы управляете самостоятельно:

Предварительные требования

Документация Jellyfin рекомендует 8 ГБ памяти и SSD на 100 ГБ для системы, файлов Jellyfin и кэша перекодирования, не считая медиафайлов. Для удалённого доступа она советует не менее 20 Мбит/с на исходящем канале.

Используемые порты

Порт Направление Назначение Нужно ли открывать
80/tcp Входящий Проверка сертификата и перенаправление на HTTPS Да
443/tcp Входящий Доступ к Jellyfin по HTTPS Да
443/udp Входящий HTTP/3 Рекомендуется
8096/tcp Локальный HTTP-интерфейс Jellyfin Нет
8920/tcp Локальный Встроенный HTTPS, здесь не используется Нет
7359/udp Локальный Обнаружение в локальной сети, не нужно на удалённом сервере Нет

Шаг 1: проверьте брандмауэр

Терминал
sudo ufw status verbose
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 443/udp

Первая команда должна показать Status: active и входящую политику deny. Если это не так, остановитесь и включите UFW. Не добавляйте никаких правил для 8096.

Шаг 2: добавьте официальный репозиторий

Установите необходимые инструменты и ключ подписи репозитория:

Терминал
sudo apt update
sudo apt install -y curl gnupg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key | sudo gpg --dearmor --yes -o /etc/apt/keyrings/jellyfin.gpg

Только в Ubuntu включите компонент Universe, который предоставляет зависимости FFmpeg:

Терминал
sudo apt install -y software-properties-common
sudo add-apt-repository -y universe

Затем объявите репозиторий:

Терминал
export VERSION_OS="$(awk -F'=' '/^ID=/{ print $NF }' /etc/os-release)"
export VERSION_CODENAME="$(awk -F'=' '/^VERSION_CODENAME=/{ print $NF }' /etc/os-release)"
export DPKG_ARCHITECTURE="$(dpkg --print-architecture)"
cat <<EOF | sudo tee /etc/apt/sources.list.d/jellyfin.sources
Types: deb
URIs: https://repo.jellyfin.org/${VERSION_OS}
Suites: ${VERSION_CODENAME}
Components: main
Architectures: ${DPKG_ARCHITECTURE}
Signed-By: /etc/apt/keyrings/jellyfin.gpg
EOF
sudo apt update

Шаг 3: установите определённую версию

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

У пакетов есть суффикс, зависящий от вашей системы, например deb13 или ubu2404:

Терминал
. /etc/os-release
case "$ID" in
  debian) SUFFIX="deb${VERSION_ID}" ;;
  ubuntu) SUFFIX="ubu$(echo "$VERSION_ID" | tr -d .)" ;;
esac
echo "$SUFFIX"
apt-cache madison jellyfin-server | head -n 5

Установите версию, затем заблокируйте её:

Терминал
sudo apt install -y "jellyfin=12.4+${SUFFIX}" "jellyfin-server=12.4+${SUFFIX}" "jellyfin-web=12.4+${SUFFIX}"
sudo apt-mark hold jellyfin jellyfin-server jellyfin-web

Пакет также устанавливает jellyfin-ffmpeg — версию FFmpeg, адаптированную для Jellyfin. Проверьте службу:

Терминал
systemctl status jellyfin --no-pager
curl -fsS http://127.0.0.1:8096/health

Последняя команда должна вернуть Healthy. С вашего компьютера порт должен оставаться закрытым:

Терминал
nc -vz -w 5 IP_ВАШЕГО_СЕРВЕРА 8096

Эта команда должна завершиться ошибкой. Если nc недоступен, откройте http://IP_ВАШЕГО_СЕРВЕРА:8096 в браузере: страница не должна загрузиться. Если соединение установилось, остановите Jellyfin командой sudo systemctl stop jellyfin и исправьте брандмауэр, прежде чем продолжать.

Шаг 4: подготовьте медиафайлы

Создайте каталог, доступный для чтения службе Jellyfin и для записи вашему пользователю:

Терминал
sudo mkdir -p /srv/media/movies /srv/media/shows /srv/media/music
sudo chown -R ВАШ_ПОЛЬЗОВАТЕЛЬ:jellyfin /srv/media
sudo chmod -R u=rwX,g=rX,o= /srv/media
sudo find /srv/media -type d -exec chmod g+s {} +

С вашего компьютера отправьте файлы с помощью rsync:

Терминал
rsync -avh --progress ./my-videos/ ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_ВАШЕГО_СЕРВЕРА:/srv/media/movies/

Шаг 5: завершите работу мастера через SSH-туннель

С вашего компьютера откройте туннель и оставьте эту сессию открытой:

Терминал
ssh -L 8096:127.0.0.1:8096 ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_ВАШЕГО_СЕРВЕРА

Откройте http://localhost:8096, затем следуйте мастеру:

  1. Выберите язык.
  2. Создайте учётную запись администратора с длинным уникальным паролем.
  3. Добавьте медиатеки, выбрав каталоги из /srv/media, либо пропустите этот шаг.
  4. Выберите язык метаданных.
  5. Оставьте отмеченным пункт Разрешить удалённый доступ к данному серверу: за прокси ваши посетители будут рассматриваться как удалённые.

Шаг 6: ограничьте Jellyfin локальной петлёй

Войдите, затем откройте Панель управления > Сетевые параметры и укажите:

Поле Значение Назначение
Привязка к адресу в локальной сети 127.0.0.1 Jellyfin слушает только на самом сервере
Известные прокси 127.0.0.1 Jellyfin принимает заголовки X-Forwarded-* от Caddy

Сохраните, затем перезапустите службу и проверьте, на каких адресах она слушает:

Терминал
sudo systemctl restart jellyfin
sudo ss -ltnp | grep 8096
sudo grep -A1 -E '<(KnownProxies|LocalNetworkAddresses)>' /etc/jellyfin/network.xml

Порт должен отображаться только на 127.0.0.1:8096. SSH-туннель продолжит работать.

Без известного прокси Jellyfin игнорирует адрес, который передаёт Caddy, и считает всех посетителей локальными: ограничения удалённого доступа тогда перестают действовать.

Шаг 7: опубликуйте Jellyfin по HTTPS

Добавьте этот сайт в /etc/caddy/Caddyfile или в файл из /etc/caddy/sites/:

caddyfile
jellyfin.ваш-домен.com {
	reverse_proxy 127.0.0.1:8096
}

Caddy передаёт WebSocket, используемые Jellyfin, без особых настроек. Не включайте полный журнал доступа для этого сайта: некоторые URL Jellyfin могут содержать параметр api_key.

Терминал
sudo caddy fmt --overwrite /etc/caddy/Caddyfile
sudo -u caddy caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile
sudo systemctl reload caddy

Проверка результата

Терминал
curl -I http://jellyfin.ваш-домен.com
curl -fsS https://jellyfin.ваш-домен.com/health

Первая команда должна вернуть перенаправление 308 на HTTPS, вторая — Healthy. Затем войдите на https://jellyfin.ваш-домен.com, запустите видео и убедитесь, что оно начинает воспроизводиться. В приложениях Jellyfin укажите этот же адрес в качестве сервера.

Управление учётными записями

В разделе Панель управления > Пользователи создайте по учётной записи на каждого человека с помощью Добавить пользователя. Для просмотра своих материалов используйте сами учётную запись без прав администратора.

Для каждой учётной записи проверьте эти настройки:

  • ограничьте доступ только нужными медиатеками;
  • включите Скрыть этого пользователя с экрана входа, чтобы не раскрывать список учётных записей;
  • укажите значение в поле Неудачные попытки входа до блокировки пользователя, например 5. Эта блокировка по умолчанию не включена, а по достижении порога учётная запись отключается;
  • снимите отметку Разрешить воспроизведение видео, для которого потребуется перекодирование, если сервер не справляется.

В Jellyfin нет встроенной двухфакторной аутентификации: требуйте длинные уникальные пароли. Чтобы снова включить заблокированную учётную запись, администратор снимает отметку Заблокировать пользователя в её профиле. Поэтому держите про запас вторую учётную запись администратора.

Ограничения без GPU

Jellyfin может воспроизвести файл четырьмя способами, от самого лёгкого до самого затратного:

Режим Обработка Нагрузка на сервер
Direct Play Файл отправляется как есть Почти нулевая
Remux Контейнер меняется, потоки сохраняются Низкая
Direct Stream Аудио конвертируется, видео сохраняется От низкой до умеренной
Transcode Видео перекодируется на лету Очень высокая

Чтобы работать в комфортных условиях:

  • Отдавайте предпочтение форматам, которые ваши устройства воспроизводят нативно, сверяясь с таблицей совместимости кодеков.
  • Контролируйте режим воспроизведения на панели управления во время трансляции: она показывает, перекодируется ли видео и почему.
  • Запретите перекодирование видео для нужных учётных записей. Несовместимый файл тогда может не воспроизвестись, но не перегрузит сервер.
  • Ограничьте число потоков в разделе Панель управления > Воспроизведение > Перекодирование параметром Количество перекодирующихся подпотоков. Сервер остаётся отзывчивым, но воспроизведение может прерываться.
  • Не задавайте слишком низкий лимит скорости в разделе Воспроизведение > Трансляция. Видео, скорость которого превышает Ограничение потоковой скорости интернет-трансляции, Мбит/с, перекодируется под этот лимит.
  • Следите за диском: временные файлы попадают в /var/cache/jellyfin/transcodes. Заложите примерно размер вашего самого большого файла, умноженный на число одновременных потоков.

Если на вашем сервере есть совместимый GPU, следуйте документации Аппаратное ускорение. Учитывайте также пропускную способность и объём трафика вашего тарифа: каждый поток потребляет скорость, близкую к скорости файла.

Обновление Jellyfin

Jellyfin не умеет откатываться назад: при первом запуске миграции изменяют данные. Прочитайте примечания к выпуску и делайте резервную копию перед любым обновлением.

Посмотрите установленную версию и доступные:

Терминал
jellyfin --version
sudo apt update
apt-cache madison jellyfin-server

После резервного копирования замените 12.4 на целевую версию:

Терминал
. /etc/os-release
case "$ID" in
  debian) SUFFIX="deb${VERSION_ID}" ;;
  ubuntu) SUFFIX="ubu$(echo "$VERSION_ID" | tr -d .)" ;;
esac
TARGET=12.4
sudo apt-mark unhold jellyfin jellyfin-server jellyfin-web
sudo apt install -y "jellyfin=${TARGET}+${SUFFIX}" "jellyfin-server=${TARGET}+${SUFFIX}" "jellyfin-web=${TARGET}+${SUFFIX}"
sudo apt-mark hold jellyfin jellyfin-server jellyfin-web
sudo journalctl -u jellyfin --no-pager -n 50

Резервное копирование и восстановление

Начиная с Jellyfin 10.11, Панель управления > Резервные файлы > Создать резервный файл создаёт архив при работающем сервере. Он сохраняется в /var/lib/jellyfin/data/backups, для этого требуется не менее 5 ГБ свободного места, а восстанавливается он с той же страницы. Копируйте эти архивы за пределы сервера.

Ручной способ подходит перед обновлением, поскольку сохраняет всю конфигурацию и выполняется при остановленной службе:

Терминал
sudo systemctl stop jellyfin
sudo mkdir -p /var/backups/jellyfin
sudo tar -czpf "/var/backups/jellyfin/jellyfin-$(date +%F)-$(dpkg-query -W -f='${Version}' jellyfin-server).tar.gz" /etc/jellyfin /var/lib/jellyfin
sudo systemctl start jellyfin
sudo chmod -R go-rwx /var/backups/jellyfin

Имя файла содержит версию: восстанавливайте его с этой же версией. Убедитесь, что архив содержит базу данных:

Терминал
sudo sh -c 'tar -tzf "$(ls -1t /var/backups/jellyfin/*.tar.gz | head -n 1)" | grep "jellyfin.db$"'

Для восстановления замените имя архива:

Терминал
ARCHIVE=/var/backups/jellyfin/jellyfin-2026-11-18-12.4+deb13.tar.gz
sudo systemctl stop jellyfin
sudo mv /var/lib/jellyfin /var/lib/jellyfin.bak
sudo mv /etc/jellyfin /etc/jellyfin.bak
sudo tar -xzpf "$ARCHIVE" -C /
sudo systemctl start jellyfin

Эти резервные копии не содержат ваши медиафайлы. Храните /srv/media отдельно, например с помощью rsync в другое место.

Если что-то пошло не так

Unable to locate package jellyfin или ошибка репозитория

Проверьте файл репозитория и название вашей версии:

Терминал
cat /etc/apt/sources.list.d/jellyfin.sources
sudo apt update

Suites должно быть равно bookworm, trixie, jammy или noble. URIs должно заканчиваться на debian или ubuntu.

Version '12.4+...' for 'jellyfin' was not found

Переменная SUFFIX пуста, либо такой версии нет для вашей системы. Выполните echo "$SUFFIX", затем сравните с выводом apt-cache madison jellyfin-server.

Неудовлетворённые зависимости jellyfin-ffmpeg в Ubuntu

Компонент Universe не включён. Повторите команду add-apt-repository из шага 2, затем sudo apt update.

address already in use

Другая программа использует порт 8096:

Терминал
sudo ss -ltnp | grep 8096
sudo journalctl -u jellyfin --no-pager -n 50

Ошибка 502 в браузере

Jellyfin остановлен или не слушает 127.0.0.1:8096. Проверьте командами systemctl status jellyfin --no-pager и curl -fsS http://127.0.0.1:8096/health. При первом запуске после обновления миграции могут занять время.

Интерфейс недоступен после изменения сетевых параметров

Исправьте конфигурацию напрямую, при остановленной службе:

Терминал
sudo systemctl stop jellyfin
sudo nano /etc/jellyfin/network.xml
sudo systemctl start jellyfin

LocalNetworkAddresses и KnownProxies должны содержать каждый по <string>127.0.0.1</string>.

Удалённые подключения отклоняются

Убедитесь, что пункт Разрешить удалённый доступ к данному серверу отмечен в разделе Панель управления > Сетевые параметры и что профиль пользователя это тоже разрешает.

Медиатека остаётся пустой

Вероятно, у службы нет доступа к файлам:

Терминал
sudo -u jellyfin ls -la /srv/media/movies

При ошибке Permission denied повторите команды из шага 4, затем снова запустите сканирование медиатеки.

Воспроизведение прерывается или процессор загружен на 100 %

Видео, вероятно, перекодируется. Проверьте режим воспроизведения на панели управления, затем примените советы из раздела об ограничениях без GPU. Ошибки преобразования находятся в файлах /var/log/jellyfin:

Терминал
sudo ls -lt /var/log/jellyfin | head

No space left on device во время воспроизведения

Кэш перекодирования заполнил диск:

Терминал
df -h /var/cache/jellyfin
sudo du -sh /var/cache/jellyfin/transcodes

Ссылки