OEC-T改造手记(三):避坑指南!在Armbian上完美安装并配置Jellyfin
2026/5/5 9:36:32 网站建设 项目流程

经历了基础搭建和文件同步,我的OEC-T终于迎来了最终使命——成为家庭媒体中心。我选择了Jellyfin这款开源免费的媒体服务器软件。然而,从安装、配置到刮削媒体信息,整个过程可谓“坑”不断,特此整理成避坑指南。

一、安装方式的选择与国内源配置

最初,我试图通过CasaOS的应用商店直接安装Jellyfin的Docker镜像,但镜像拉取屡屡失败,更换多个国内镜像站也无果。最终,我选择了更直接的apt安装方式,但这同样需要配置国内软件源。

1. 添加Jellyfin官方仓库的国内镜像
访问https://mirrors.cernet.edu.cn/list/jellyfin可查看国内镜像站列表。我选择了南京大学的镜像。

# 1. 安装HTTPS传输支持sudoaptinstallapt-transport-https# 2. 导入Jellyfin GPG密钥curl-fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key|sudogpg --dearmor -o /etc/apt/keyrings/jellyfin.gpg# 3. 添加仓库 (注意:jammy对应Ubuntu 22.04,请根据你的系统版本修改)echo"deb [signed-by=/etc/apt/keyrings/jellyfin.gpg] https://mirror.nju.edu.cn/jellyfin/ubuntu jammy main"|sudotee/etc/apt/sources.list.d/jellyfin.list

2. 安装Jellyfin

sudoaptupdatesudoaptinstalljellyfin

安装完成后,服务会自动创建,但先不要启动,我们需要先解决存储空间问题。

二、迁移数据目录:拯救捉襟见肘的系统盘

默认安装会将数据、缓存等存放在系统盘(/var/lib/jellyfin),对于OEC-T的小容量eMMC来说是灾难。我们必须将其迁移到之前挂载的大硬盘上。

1. 停止服务并编辑环境文件

sudosystemctl stop jellyfinsudonano/etc/default/jellyfin

2. 修改或添加以下关键配置
找到或添加以下行,指向你的新硬盘挂载目录(例如我的是/home/pzzhao/download/jellyfin):

# 自定义目录配置 JELLYFIN_DATA_DIR="/home/pzzhao/download/jellyfin/data" JELLYFIN_CONFIG_DIR="/home/pzzhao/download/jellyfin/config" JELLYFIN_LOG_DIR="/home/pzzhao/download/jellyfin/logs" JELLYFIN_CACHE_DIR="/home/pzzhao/download/jellyfin/cache" # 核心:确保服务启动参数包含这些目录 JELLYFIN_SERVICE_OPT="--service --datadir $JELLYFIN_DATA_DIR --cachedir $JELLYFIN_CACHE_DIR --configdir $JELLYFIN_CONFIG_DIR --logdir $JELLYFIN_LOG_DIR"

3. 创建目录并迁移数据(如适用)

# 创建所有目录sudomkdir-p /home/pzzhao/download/jellyfin/{data,config,logs,cache}# 设置所有权给jellyfin用户sudochown-R jellyfin:jellyfin /home/pzzhao/download/jellyfin# 可选:如果旧目录已有数据(如首次安装后已运行过),可以迁移过来sudocp-r /var/lib/jellyfin/* /home/pzzhao/download/jellyfin/data/2>/dev/null||true

4. 重启服务并验证

sudosystemctl daemon-reloadsudosystemctl start jellyfinsudosystemctl status jellyfin# 检查状态

访问http://你的OEC-T-IP:8096,如果能打开设置向导,说明迁移成功。

三、避坑指南:媒体库刮削失败问题排查

设置好媒体库后,Jellyfin无法从豆瓣等渠道刮削影片元数据(封面、简介等)。经排查,主要有两个原因。

⚠️ 坑一:数据目录权限不足
Jellyfin服务以jellyfin用户运行,它需要对数据目录有写入权限。

# 检查目录权限ls-la /home/pzzhao/download/jellyfin/data/# 如果所属用户/组不是jellyfin,或者权限过窄,使用chown和chmod修复sudochown-R jellyfin:jellyfin /home/pzzhao/download/jellyfin# 更宽松的权限设置(生产环境建议细化权限)sudochmod-R755/home/pzzhao/download/jellyfin

⚠️ 坑二(最隐蔽):ffmpeg路径问题
通过apt安装的Jellyfin,其自带的ffmpegffprobe位于/usr/lib/jellyfin-ffmpeg/下,并不在系统的默认PATH中。这导致Jellyfin在转码或调用这些工具时失败,进而影响刮削等功能。

解决方案:创建符号链接到系统路径

sudoln-sf /usr/lib/jellyfin-ffmpeg/ffmpeg /usr/bin/ffmpegsudoln-sf /usr/lib/jellyfin-ffmpeg/ffprobe /usr/bin/ffprobe

执行后,在终端输入ffmpeg -version测试,应能正常显示版本信息。

四、配置为系统服务(补充)

通常apt安装后服务已就绪。你可以使用以下命令管理:

# 启用开机自启sudosystemctlenablejellyfin# 常用命令sudosystemctl start|stop|restart|status jellyfin# 查看实时日志sudojournalctl -u jellyfin -f

总结与成果

至此,所有“坑”已被填平。我的网心云OEC-T成功变身为一个:

  1. 存储充足:所有媒体文件和数据都存放在外接大容量SSD上。
  2. 同步自动化:通过Syncthing从下载机自动获取新影片。
  3. 功能完善的媒体中心:Jellyfin提供精美的海报墙、流畅的转码播放,支持全平台客户端。

这台成本低廉的“矿渣”设备,经过一番折腾,终于完美融入了我的数字生活。希望这个系列记录能帮助你少走弯路,享受DIY的乐趣!

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询