本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

Jellyfin 是一款自由软件媒体系统,旨在让用户完全掌控媒体内容的管理与流媒体播放。作为 Emby 和 Plex 等专有媒体系统的替代方案,Jellyfin 可通过专用服务器向多终端设备(如智能电视、手机、电脑)提供媒体服务。该项目源自 Emby 3.5.2 版本,后移植至 .NET Core 框架,实现了全平台兼容。Jellyfin 坚持自由软件理念,无许可费用、无功能限制、无隐藏条款,由社区团队协作开发维护。
通过 docker run 命令启动容器,基本格式如下:
docker run -d \ -p 8096:8096 \ --name=<容器名称> \ -v <媒体文件路径>:/media \ -v <配置文件路径>:/config \ -v /etc/localtime:/etc/localtime:ro \ -e HEALTHCHECK_COMMAND=<健康检查命令> \ -e HEALTHCHECK_ACTION=<健康检查失败操作> \ -e UMASK=<文件创建权限掩码> \ -e PUID=<用户ID> \ -e PGID=<组ID> \ binhex/arch-jellyfin
-p 8096:8096:将容器内 Jellyfin 默认 Web 端口 8096 映射到主机端口 8096,用于访问 Web 管理界面和流媒体服务。-v <媒体文件路径>:/media:挂载主机媒体文件目录(如电影、音乐存储路径)到容器内 /media 目录,Jellyfin 将从该目录读取媒体文件。-v <配置文件路径>:/config:挂载主机配置文件目录到容器内 /config 目录,用于持久化存储 Jellyfin 配置、元数据等。-v /etc/localtime:/etc/localtime:ro:挂载主机本地时间文件(只读),确保容器内时间与主机同步。-e HEALTHCHECK_COMMAND=<健康检查命令>(可选):自定义容器健康检查命令。-e HEALTHCHECK_ACTION=<健康检查失败操作>(可选):健康检查失败时执行的操作(如 restart 重启容器)。-e UMASK=<文件创建权限掩码>:设置容器内创建文件的权限掩码(如 000 表示无权限限制,022 表示默认权限)。-e PUID=<用户ID>:运行容器的用户 ID,用于控制文件访问权限(需与主机用户 ID 匹配)。-e PGID=<组ID>:运行容器的组 ID,用于控制文件访问权限(需与主机组 ID 匹配)。容器启动后,通过以下地址访问 Jellyfin Web 界面:
<主机IP>:8096
以下为部署示例(替换 <> 中的占位符为实际值):
docker run -d \ -p 8096:8096 \ --name=jellyfin-media-server \ -v /media/movies:/media \ # 主机电影存储目录 -v /apps/docker/jellyfin/config:/config \ # 主机配置文件目录 -v /etc/localtime:/etc/localtime:ro \ -e UMASK=000 \ # 文件创建权限掩码 -e PUID=1000 \ # 运行用户ID(示例值) -e PGID=1000 \ # 运行组ID(示例值) binhex/arch-jellyfin
PUID(用户 ID)和 PGID(组 ID)用于确保容器内进程对挂载目录有正确的访问权限。可通过以下命令获取当前用户的 UID 和 GID:
id <用户名>
示例输出(假设用户为 mediauser):
uid=1000(mediauser) gid=1000(mediauser) ...
则 PUID=1000,PGID=1000。
确保主机挂载的媒体文件目录和配置文件目录对 PUID/PGID 对应的用户有读写权限,避免因权限不足导致媒体文件无法访问或配置无法保存。
HEALTHCHECK_COMMAND 和 HEALTHCHECK_ACTION 为可选参数,用于自定义容器健康检查逻辑,如未特殊需求可省略。
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录方式配置轩辕镜像加速服务,包含7个详细步骤
在 Linux 系统上配置轩辕镜像源,支持主流发行版
在 Docker Desktop 中配置轩辕镜像加速,适用于桌面系统
在 Docker Compose 中使用轩辕镜像加速,支持容器编排
在 k8s 中配置 containerd 使用轩辕镜像加速
在宝塔面板中配置轩辕镜像加速,提升服务器管理效率
在 Synology 群晖NAS系统中配置轩辕镜像加速
在飞牛fnOS系统中配置轩辕镜像加速
在极空间NAS中配置轩辕镜像加速
在爱快ikuai系统中配置轩辕镜像加速
在绿联NAS系统中配置轩辕镜像加速
在威联通NAS系统中配置轩辕镜像加速
在 Podman 中配置轩辕镜像加速,支持多系统
配置轩辕镜像加速9大主流镜像仓库,包含详细配置步骤
无需登录即可使用轩辕镜像加速服务,更加便捷高效
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429