【铁威马案例分享】docker版jellyfin 食用指南

[hee008]

【铁威马案例分享】TOS6 docker版jellyfin 食用指南
写在前面，本人文化水平不高文中难免有错别字和文法不通的地方，还望各位看官抱着能看懂就行的心态耐心食用

网络上虽然有着jellyfin部署的教程但是大多数都说的含糊其辞，没有针对咱们铁威马的专用教程。官方版本的jellyfin在编解码方面又有一些问题。下面我将针对咱们铁威马用户写一篇我自己部署docker版jellyfin并在使用中解决一些问题的教程。本帖里主要有以下几方面内容1.docker镜像拉取 2.docker内部设置 3.jellyfin的硬件编解码设置 4.jellyfin封面文字方块解决方法 5.jellyfin实现刮削方法 6.jellyfin电影合集刮削封面修改方法。 请各位看官按需索取，另外本教程有一定难度，比如需要自己解决ssh连接问题并需要有一定的liunx操作基础。
下面说一下我的部署环境：F4-423 TOS6.0.610 docker jellyfin 10.10.5

部署后jellyfin 封面


jellyfin编解码效果及cpu占用


jellyfin合集封面

[hee008]

下面是分步解析
1.docker镜像拉取

由于种种原因 大家不能正常的拉取docker镜像 我相信大家也再往上找了很多教程 在这里我给大家提供一个比较简单便捷的方法（不是最安全的）
原理就是 直接拉取docker 镜像站的文件
格式如下：docker pull 镜像站域名/jellyfin/jellyfin:latest

所以我们要做的第一步就是 在 TOS 的应用中心中安装Docker Engine和Docker Manager 两个程序



然后SSH连接到你的NAS上 并敲入拉取 jellyfin的命令（我用的客户端是finalshell）
docker pull 123.com（镜像站域名）/jellyfin/jellyfin:latest
镜像站点大家自己网上找 这些站点不会一直有效我在这里就不提供了 请注意添加域名时不用添加 https:// 直接添加后面域名就行 下面图片只做一个展示图中10.10.5 是我指定的拉取版本

[hee008]

2.docker内部设置
接上文 拉取成功后我们就要配置jellyfin了 在Docker Manager中找到刚才拉取的镜像并点击启动图标


在step2 中添加下面数据










这里解释一下 路径 /home/docker/jellyfin/config 中 /home/docker/是系统创建好的目录 你需要在此目录下提前创建子文件夹 jellyfin好方便镜像运行后在此文件夹下存储数据。我们要在这个文件夹下建立3个子文件夹分别是 cache config fonts （这个fonts我们后面会用到）至于media 则是映射到你的媒体文件夹上


创建好以后我们点击下一步 在step3中我们选择host


然后我们一直下一步 直到step7 我们勾选 启动高权限执行容器


一直下一步知道结束 直到配置成功 这里我们配置jellyfin就成功啦 我们直接点运行就可以吧jellyfin 运行起来啦
访问网址为 你的IP加8096端口号 例如： http://192.168.1.100:8096



随后我们进入jellyfin管理页面配置你的媒体库 类型 电影 指向你的电影文件夹这个我都不用说了吧 语言选Chinese 地区选china 后面的一般情况下可以不用动 也可以根据自己需求修改

[hee008]

3.jellyfin的硬件编解码设置
搞定了jellyfin 下面我们要搞 比较难搞的 编解码了 下面给大家看一下我的配置 我这套配置现在在pt站下载绝大部分文件都可以硬解和编码 速度也完全够用不存在卡顿现象（大码流 HEVC 10bit + tureHD 全景声 也不在话下）N5095 硬解cpu占用率不超过40%










言归正传 下面我们来搞定jellyfin 的编解码
1.我们的TOS6 系统已经为我们打了显卡驱动 这点我们可以通过ssh命令查看获得
硬件解码：
在ssh中输入 下面2个命令

ls -l /dev/dri

apt policy intel-opencl-icd

得到一下回应就没问题了

硬件编码： （光有了解码我们还要硬件编码来进一步降低cpu的占用）
我们要在系统上添加所需的 i915 内核参数，以启用加载 GuC 和 HuC 固件
首先输入命令
lspci -knn | grep -E "i915|xe|VGA|Display"

查看我们是否已经有i915的内核驱动 正确返回结果如下



如果你跟我显示的结果一直那么恭喜你只需要以下两条命令就可以解锁 jellyfin的硬件编解码了

下面2条命令为：

mkdir -p /etc/modprobe.d

sh -c "echo 'options i915 enable_guc=2' >> /etc/modprobe.d/i915.conf"

输入运行后 没有任何报错提示就表示成功了 然后我们要重启一次nas 再次进入jellyfin 像我一样设置编解码设置就可以了。

[hee008]

4.jellyfin封面文字方块解决方法
用过正宗的docker的兄弟们都知道 jellyfin 封面标题都会显示出方块（借用别人的图片）

下面我们来解决这个问题 还记得我们再配置的时候的后一项吗？对那个配置就是解决字体方块的第一步



第二部我们要在网上找一个以 .ttf扩展名的中文字体文件并分别命名如下6个文件并放到 homes/docker/jellyfin/fonts下

DejaVuSans.ttf
DejaVuSans-Bold.ttf
DejaVuSansMono.ttf
DejaVuSansMono-Bold.ttf
DejaVuSerif.ttf
DejaVuSerif-Bold.ttf



重启容器 刷新媒体库原来的方块就变成中文啦

[hee008]

5.jellyfin实现刮削方法

由于某些不可言喻的原因 我们会经常的被墙 所以jellyfin经常刮削不到封面所以我们要修改host来让jellyfin可以刮削到内容。我们继续用ssh打出以下内容
vi /etc/hosts
然后按i键 复制以下内容
108.156.46.56 api.themoviedb.org
108.156.46.87 api.themoviedb.org
108.156.46.80 api.themoviedb.org
108.156.46.129 api.themoviedb.org
143.244.50.86 image.tmdb.org
169.150.247.33 image.tmdb.org
143.244.50.91 image.tmdb.org
89.187.162.242 image.tmdb.org
79.127.213.217 image.tmdb.org
然后按esc
再输入
:wq

退出保存即可

[hee008]

6.jellyfin电影合集刮削封面修改方法
jellyfin在扫描建立媒体库的时候会自动生成一个电影合集的媒体库而这个媒体库默认情况下是刮削不到封面的
如下图所示


我们在第5步解决了jellyfin刮削问题的情况下只需要在没有封面的合集下方的三个小点 选择 编辑元数据 然后把里面的锁定此项目防止改动对号去掉 并保存就可以了。修改完成后更新媒体库 他自己就会刷出封面来








刷新后我们的封面就回来了

[hee008]

过年期间时间有限以上教程较为粗狂 适合有一定操作基础的人阅读 欢迎新手朋友在不明白的地方提出问提 我会不定期完善教程使其更适合大家

[2star2]

我用jellyfin倒是有一个问题，就是在浏览器上看片的时候，如果切换到其它游戏或者网页上面后，再回到看片的位置。就有可能断帧，只有声音，画面卡着不动。不知道是DOCKER的问题还是设置的问题？

[hee008]

你用的什么浏览器？ 我的 win11 firefox chrome edge 都没问题