Установка Jellyfin на Debian или Ubuntu
Установите Jellyfin из официального репозитория, опубликуйте его по HTTPS через Caddy, управляйте учётными записями и разберитесь с ограничениями перекодирования без GPU, а также с обновлениями и резервным копированием.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
Это руководство объясняет, как установить Jellyfin — свободный медиасервер — из его официального репозитория. Мастер настройки проходится через SSH-туннель, затем Caddy публикует службу по HTTPS.
К концу руководства Jellyfin будет отвечать по адресу https://jellyfin.ваш-домен.com, его порт останется закрытым из Интернета, у каждого человека будет своя учётная запись, а вы будете знать, что ваш сервер реально способен транслировать без видеокарты.
Заказать сервер
Это руководство подходит для серверов, которыми вы управляете самостоятельно:
Предварительные требования
- Сервер amd64 или arm64 под управлением Debian 12 или 13 либо Ubuntu 22.04 или 24.04
- Доступ по SSH под пользователем с правами
sudo - Активный UFW, настроенный по руководству Настройка брандмауэра UFW без потери SSH-доступа
- Caddy, установленный по руководству Caddy как обратный прокси с автоматическим HTTPS
- DNS-запись A для
jellyfin.ваш-домен.com, указывающая наIP_ВАШЕГО_СЕРВЕРА, например по руководству Создание записи A - Достаточно места на диске для ваших медиафайлов, метаданных и кэша перекодирования
Документация 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, затем следуйте мастеру:
- Выберите язык.
- Создайте учётную запись администратора с длинным уникальным паролем.
- Добавьте медиатеки, выбрав каталоги из
/srv/media, либо пропустите этот шаг. - Выберите язык метаданных.
- Оставьте отмеченным пункт Разрешить удалённый доступ к данному серверу: за прокси ваши посетители будут рассматриваться как удалённые.
Шаг 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/:
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 updateSuites должно быть равно 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 jellyfinLocalNetworkAddresses и 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 | headNo space left on device во время воспроизведения
Кэш перекодирования заполнил диск:
df -h /var/cache/jellyfin
sudo du -sh /var/cache/jellyfin/transcodes