最新

NAS 怎么用 Docker 部署 Jellyfin 影视库

家里几台设备各存一份电影,找片和续播都要重来。讲清容器怎么建、媒体目录怎么摆、硬解和字幕怎么设,以及卡顿时先查哪一环。

几台设备各存一份电影,找片、续播、字幕都得重新来一遍。Jellyfin 这类媒体服务器把片库集中到 NAS 上,电视、手机、平板打开就能接着看,也不依赖厂商的云服务。

入口在哪

  • NAS 的容器管理界面。群晖叫 Container Manager,威联通叫 Container Station,其它品牌可能直接叫 Docker,不同版本名称略有差别。
  • 命令行。SSH 登录 NAS 后用 docker 命令部署,适合界面里找不到对应选项的情况。
  • 社区套件。部分 NAS 的应用中心能直接装,装完仍然要手动配置媒体目录。
  • Jellyfin 自己的网页端,部署完成后用 8096 端口打开,第一次进入是初始化向导。

具体步骤

  1. 先在存储卷里建三个目录:媒体目录放影片,配置目录存数据库和设置,缓存目录放转码临时文件,三者不要混在一起。
  2. 媒体目录按「电影/片名 (年份)/文件」和「剧集/剧名/季/集」的结构摆放,命名越规整,后面识别越省事。
  3. 在容器界面拉取 jellyfin 镜像,映射 8096 端口,把上面三个目录分别挂载到容器内的对应路径。
  4. 设置运行身份。用 PUID 和 PGID 指定 NAS 上的用户,避免容器以最高权限写入,之后一堆文件权限麻烦。
  5. 需要硬件转码就把显卡设备节点映射进容器,再给对应权限;不做这一步只能软解,高码率片子容易卡。
  6. 启动容器,浏览器打开 NAS 地址加 8096 端口,按向导建管理员账号,添加媒体库,选好内容类型和语言。
  7. 在电视或手机装 Jellyfin 客户端,填局域网地址登录。先确认局域网能播,再考虑外网访问。

几个坑

  • 权限不对。容器起来了但媒体库是空的,多数是挂载目录的读取权限没给到运行用户。
  • 目录结构太随意。文件名里混着压制组信息、多余括号和后缀,识别率会明显下降。
  • 把配置目录放在会被同步或快照的路径。数据库在运行中被复制,容易损坏。
  • 字幕编码不对。外挂字幕出现乱码,先转成通用编码再放回去,不要直接改后缀。
  • 端口冲突。NAS 上已有服务占用 8096,改宿主机端口即可,容器内端口不用动。
  • 急着开外网访问。直接把端口映射到公网风险很高,优先用内网穿透或反向代理,并配好账号密码和 HTTPS。

怎么验证

  • 容器状态是运行中,日志里没有反复重启的记录。
  • 网页端显示的影片数量和实际文件数对得上,封面和信息也能刷出来。
  • 播一部高码率片子,在控制台看是直接播放还是转码,转码时 CPU 占用是否正常。
  • 手机客户端在局域网内播放正常,拖动进度条能续播,字幕能显示。

常见问题

和 Emby、Plex 有什么区别

三者功能接近,都做媒体库管理和转码,差别主要在授权方式和客户端支持。选哪个更多看手上有什么设备,装之前先用少量影片试一遍最稳。

播放卡顿先查什么

先看是直接播放还是转码。转码卡说明 CPU 或核显吃不住,降码率或者开硬件转码;直接播放还卡,多半是网络带宽或无线信号的问题。

外网访问安全吗

把端口直接暴露到公网不安全。更稳妥的是通过内网穿透或反向代理访问,开启 HTTPS,账号用强密码,必要时再叠加一层访问控制。

一句话总结:Jellyfin 部署本身不难,难在目录结构、权限和转码这三件事,先把局域网播放跑通,再谈外网访问。