Jellyfin

软件简介

Emby 首发于 2012 年媒体管理软件，在 2018 年前后从开源转变闭源软件，Jellyfin 是 Emby 2018 最后版本克隆继续作为开源项目完善。两者的客户端都支持桌面浏览器、手机、平板和电视等大部分主流平台，对 MKV/RMVB/AVI 等容器格式支持实时和异步转码，是同类软件中标杆。

安装软件

硬件环境：QNAP/威联通 NAS Intel x86_64

NAS 开通 SSH 服务，方便登录使用命令行操作 docker。

SSH 登录后，看到挂载的根目录是 /share/CACHEDEV1_DATA，

# 如容器相关
/share/CACHEDEV1_DATA/Container
# 如视频文件
/share/CACHEDEV1_DATA/Multimedia

设置 Jellyfin 持久化配置和缓存目录，避免删除或升级容器后数据丢失

mkdir -p /share/CACHEDEV1_DATA/Container/jellyfin/config
mkdir -p /share/CACHEDEV1_DATA/Container/jellyfin/cache

从 jellyfin 官方镜像创建一个容器实例并启动

docker run -d \
 --name jellyfin \
 --net=host \
 --volume /share/CACHEDEV1_DATA/Container/jellyfin/config:/config \
 --volume /share/CACHEDEV1_DATA/Container/jellyfin/cache:/cache \
 --mount type=bind,source=/share/CACHEDEV1_DATA/Multimedia/,target=/media \
 --restart=unless-stopped \
 jellyfin/jellyfin

参数说明：

--name 容器实例命名为 jellyfin，可按需更改；
--restart 如果异常退出或停止则自动重启容器，用户手动停止除外；
--volume,-v 宿主机目录:容器目录 映射容器目录为宿主机的，可按需修改映射宿主机目录，如 -v /tmp/log:/data/log/mediacenter；
--mount 挂载目录 类似 --volume
--net=host 使用宿主机网络

浏览器打开 http://NAS 的 IP 地址:8096 就可以访问，首次登录设置 admin 管理员用户名和密码，添加视频文件目录完成后即可播放。

如果访问异常，在启动时参数后台运行 -d 改为 -it 前台交互运行，可在终端输出日志，观察哪里出问题

docker run -it \
 --name jellyfin \
 --net=host \
 --volume /share/CACHEDEV1_DATA/Container/jellyfin/config:/config \
 --volume /share/CACHEDEV1_DATA/Container/jellyfin/cache:/cache \
 --mount type=bind,source=/share/CACHEDEV1_DATA/Multimedia/,target=/media \
 --restart=unless-stopped \
 jellyfin/jellyfin

常见问题

外挂 ASS 字幕乱码

通常是字幕文件使用中文字体，而系统缺失导致。查看后台日志后根据提示处理。浏览器打开 jellyfin ，新开两个浏览器标签页，一个播放乱码的视频，另一个打开 jellyfin 首页，点击右上角用户图标 - Administration - Dashboard - Advanced - Logs ，类似

[Parsed_subtitles_3 @ 0x55e419f8e980] fontselect: (方正黑体\_GBK, 400, 0) -> /usr/share/fonts/truetype/FangZhengHeiTi-GBK-1.ttf, 0, FZHTK--GBK1-0 从日志看是因缺失方正黑体字体导致乱码。将缺失字体复制到 NAS 任意共享目录，通过 SSH 登陆 NAS，然后从共享目录复制到容器实例里面后解决。

docker cp /share/CACHEDEV1_DATA/Multimedia/FangZhengHeiTi-GBK-1.ttf jellyfin:/usr/share/fonts/truetype/

注：以上提到目录和前面安装步骤相关，按需修改即可。

总结

Jellyfin 功能完善简单易用，作为 Emby 免费开源替代，可满足大部分个人和家庭用户需求。

Jellyfin ​

软件简介 ​

安装软件 ​

常见问题 ​

总结 ​

Jellyfin

软件简介

安装软件

常见问题

总结