linuxserver/jellyfin
LinuxServer.io 提供的 Jellyfin 容器，是一款自由软件媒体系统，支持媒体管理与流式传输，具备跨平台特性、定期更新和用户权限映射功能。
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
LinuxServer.io Jellyfin 容器
LinuxServer.io 团队提供的此容器具有以下特点：
- 定期及时的应用更新
- 简单的用户映射（PGID、PUID）
- 带有 s6 overlay 的自定义基础镜像
- 每周基础操作系统更新，通过整个 LinuxServer.io 生态系统的通用层减少空间占用、停机时间和带宽消耗
- 定期安全更新
关于 Jellyfin
https://github.com/jellyfin/jellyfin 是一款自由软件媒体系统，让您能够掌控媒体的管理和流式传输。作为专有软件 Emby 和 Plex 的替代方案，它可通过多个应用程序从专用服务器向终端用户设备提供媒体服务。Jellyfin 源自 Emby 3.5.2 版本，已移植到 .NET Core 框架以实现全面的跨平台支持。它无附加条件、无高级功能限制、无隐藏目的，由团队协作开发以打造更优质的产品。
支持的架构
利用 docker manifest 实现多平台支持，拉取 lscr.io/linuxserver/jellyfin:latest 即可获取适合您架构的镜像，也可通过标签指定特定架构：
| 架构 | 可用 | 标签 |
|---|---|---|
| x86-64 | ✅ | amd64- |
| arm64 | ✅ | arm64v8- |
版本标签
| 标签 | 可用 | 描述 |
|---|---|---|
| latest | ✅ | Jellyfin 稳定版本 |
| nightly | ✅ | Jellyfin 夜间构建版本 |
应用设置
Web 界面地址：http://<您的IP>:8096，更多信息参见https://jellyfin.org/docs/general/quick-start.html%E3%80%82
硬件加速配置
Intel
启用基于 OpenCL 的色调映射需参考 https://mods.linuxserver.io/?mod=jellyfin 并遵循 https://jellyfin.org/docs/general/administration/hardware-acceleration/intel/#configure-and-verify-lp-mode-on-linux%E3%80%82
树莓派
- OpenMAX (MMAL)：需挂载设备和库
--device=/dev/vcsm:/dev/vcsm --device=/dev/vchiq:/dev/vchiq -v /opt/vc/lib:/opt/vc/lib - V4L2：需挂载视频设备
--device=/dev/video10:/dev/video10 --device=/dev/video11:/dev/video11 --device=/dev/video12:/dev/video12
Intel/AMD/NVIDIA
- Intel/AMD：挂载
/dev/dri设备--device=/dev/dri:/dev/dri - NVIDIA：需安装 https://github.com/NVIDIA/nvidia-container-toolkit%EF%BC%8C%E8%BF%90%E8%A1%8C%E6%97%B6%E6%B7%BB%E5%8A%A0
--runtime=nvidia -e NVIDIA_VISIBLE_DEVICES=all。
部署示例
Docker Compose
yaml--- services: jellyfin: image: docker.xuanyuan.run/linuxserver/jellyfin:latest container_name: jellyfin environment: - PUID=1000 - PGID=1000 - TZ=Etc/UTC - JELLYFIN_PublishedServerUrl=http://192.168.0.5 #可选 volumes: - /path/to/jellyfin/library:/config - /path/to/tvseries:/data/tvshows - /path/to/movies:/data/movies ports: - 8096:8096 - 8920:8920 #可选 - 7359:7359/udp #可选 - 1900:1900/udp #可选 restart: unless-stopped
Docker CLI
bashdocker run -d \ --name=jellyfin \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Etc/UTC \ -e JELLYFIN_PublishedServerUrl=http://192.168.0.5 `#optional` \ -p 8096:8096 \ -p 8920:8920 `#optional` \ -p 7359:7359/udp `#optional` \ -p 1900:1900/udp `#optional` \ -v /path/to/jellyfin/library:/config \ -v /path/to/tvseries:/data/tvshows \ -v /path/to/movies:/data/movies \ --restart unless-stopped \ lscr.io/linuxserver/jellyfin:latest
参数说明
| 参数 | 功能 |
|---|---|
-p 8096:8096 | HTTP web 界面 |
-p 8920 | HTTPS web 界面（需自备证书） |
-e PUID=1000 | 用户 ID（通过 id your_user 获取） |
-e PGID=1000 | 组 ID |
-e TZ=Etc/UTC | 时区（如 Asia/Shanghai） |
-v /config | 配置文件存储路径 |
-v /data/... | 媒体文件路径（可添加多个） |
维护与更新
更新容器
bash# Docker Compose docker-compose pull jellyfin && docker-compose up -d # Docker CLI docker pull docker.xuanyuan.run/linuxserver/jellyfin:latest && docker stop jellyfin && docker rm jellyfin && docker run ...（使用原参数）
查看日志
bashdocker logs -f jellyfin
版本信息
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' jellyfin
版本历史
- 06.10.24: 修复 fontconfig 缓存路径
- 13.08.24: 基于 Ubuntu Noble 重建
- 04.07.23: 弃用 armhf 架构
- 07.12.22: 迁移到 s6v3 基础镜像
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 jellyfin 镜像标签
docker pull docker.xuanyuan.run/linuxserver/jellyfin:<标签>
DockerHub 原生拉取命令
docker pull linuxserver/jellyfin:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"