跳至主内容

容器部署

非官方测试版翻译

本页面由 PageTurner AI 翻译(测试版)。未经项目官方认可。 发现错误? 报告问题 →

容器镜像

官方容器镜像:jellyfin/jellyfin jellyfin Docker Pull Count
此镜像同时发布于 GitHub 容器仓库:ghcr.io/jellyfin/jellyfin

LinuxServer.io 镜像:linuxserver/jellyfin linuxserver jellyfin Docker Pull Count

hotio 镜像:ghcr.io/hotio/jellyfin

Jellyfin 在 Docker HubGitHub 容器仓库 上提供多架构官方容器镜像。 这些镜像基于 Debian 系统,并直接从 Jellyfin 源代码构建

提供多个标签用于追踪不同构建和版本级别。

  • latest 始终追踪最新稳定版,包括主版本和次版本更新

  • X(如 10)追踪主版本,即最新的 10.Y.Z 版本

  • X.Y(如 10.11)追踪次版本,即最新的 10.11.Z 版本

  • X.Y.Z(如 10.11.0)追踪特定发行版本

  • X.Y.Z.YYYYMMDD-HHMMSS(如 10.11.0.20251020-004604)追踪特定打包构建版本

此外,还有多个第三方提供非官方容器镜像,包括 LinuxServer.ioDockerfile)项目和 hotioDockerfile)。这些镜像基于 Ubuntu 系统,使用官方 Jellyfin Ubuntu 二进制包构建。

安装指南

若要以特定用户/组身份运行 jellyfin,请替换 uid:gid 值。若要使用默认用户,请完全省略 user 参数。

非官方测试版翻译

本页面由 PageTurner AI 翻译(测试版)。未经项目官方认可。 发现错误? 报告问题 →

警告

如果您希望在 Windows 或 macOS 上使用,请改为原生安装 Jellyfin。Windows macOS

虽然在 Windows 或 macOS 主机上通过 Docker 运行 Jellyfin 是可行的,但这不受官方支持。已知在非 Linux 平台的 Docker 中运行时某些功能会失效,特别是:

在非 Linux 平台上通过 Docker 运行 Jellyfin 将无法获得任何技术支持。

创建一个如下所示的 docker-compose.yml 文件。

services:
jellyfin:
image: jellyfin/jellyfin
container_name: jellyfin
# Optional - specify the uid and gid you would like Jellyfin to use instead of root
user: uid:gid
ports:
- 8096:8096/tcp
- 7359:7359/udp
volumes:
- /path/to/config:/config
- /path/to/cache:/cache
- type: bind
source: /path/to/media
target: /media
- type: bind
source: /path/to/media2
target: /media2
read_only: true
# Optional - extra fonts to be used during transcoding with subtitle burn-in
- type: bind
source: /path/to/fonts
target: /usr/local/share/fonts/custom
read_only: true
restart: 'unless-stopped'
# Optional - alternative address used for autodiscovery
environment:
- JELLYFIN_PublishedServerUrl=http://example.com
# Optional - may be necessary for docker healthcheck to pass if running in host network mode
extra_hosts:
- 'host.docker.internal:host-gateway'

然后在 docker-compose.yml 所在目录执行:

docker compose up

若要在后台运行容器,请在上述命令中添加 -d 参数。

您可以通过阅读官方 Docker 文档了解更多 Docker 使用信息。